hubo1989 / luci-commotion

Commotion configuration pages for the LuCI web interface

luci-commotion

Commotion configuration pages for the LuCI web interface.

luci-commotion is selected as a default build option in Commotion-Router (https://github.com/opentechinstitute/commotion-router)

Roadmap

Version 1.2

• Import / Export functionality for Commotiond profiles
• re-runnable setup wizard
• Status-page auto-updating values
• Updated Nearby Mesh devices
• Command Line Setup Wizard (Possibly not in this repo as it will not be luci-based.)
• Babel Integration

Version 2.0

• lua-info plugin for less memory-intesive access to OLSR info
• mesh-agnostic network-viz

luci-theme-commotion

The LuCI Commotion Theme was designed for the Commotion Wireless Project's openwrt-based software and is included by default in the commotion-feeds package, which is called by the commotion-router setup script.

Design changes should follow the Human Interface Guidelines described on the main project site.

This theme appears as luci-theme-commotion in Commotion-Router's menuconfig options

Links

• Commotion Wireless Project
• Commotion Human Interface Guidelines
• Commotion-Router source code
• Commotion-Feeds source code

Commotion-apps

Commotion-apps contains a LuCI application portal for OpenWRT. It relies on the Commotion service manager to find nearby applications on the network.

The LuCI application portal adds some pages to the Commotion-Router menu. The main page shows all local applications on the mesh that have been approved by the node administrator. There are also pages for creating an application, as well as administrator pages for approving/blacklisting apps and changing settings related to applications.

Commotion-apps is selected as a default build option in Commotion-Router (https://github.com/opentechinstitute/commotion-router).

Advertising applications

Applications are advertised on a Commotion mesh network using Avahi/mDNS. Each application should have a .service file in the /etc/avahi/services/ directory. The structure of the service file should follow this template:

<?xml version="1.0" standalone='no'?><!--*-nxml-*-->
<!DOCTYPE service-group SYSTEM "avahi-service.dtd">

<service-group>
  <name replace-wildcards="yes">Service Name on %h</name>

  <service>
    <type>_commotion._tcp</type> <!-- _svc-type.sub-type._tcp|udp -->
    <domain-name>mesh.local</domain-name>
    <!--<host-name>%h.mesh.local</host-name>--> <!-- DON'T set hostname, because avahi will fail to resolve it when using mesh.local domain-->
    <port>443</port> <!--optional-->
    <txt-record>name=Example Application</txt-record>
    <txt-record>ttl=2</txt-record> <!--optional: how many hops away the service should be advertised-->
    <txt-record>uri=https://commotionwireless.net</txt-record> <!-- IP address or URL of service host -->
    <txt-record>type=collaboration</txt-record>
    <txt-record>type=circumvention</txt-record> <!-- each type should have its own txt-record -->
    <txt-record>fingerprint=FA7E03D576F9A6752194CFCBE402C455B7F0F8C8894F7C05F17ECE500D2DC648</txt-record> <!--fingerprint and signature are generated using serval-dna-->
    <txt-record>signature=E07B1282AE1601C334CEA861DF795D57D00603BA00D97F382720F4146DDCD4427973D171C89BCA0EAAF1D72E9EF0DB2367CE07BBFFF6FF27FF01F1DFBEB65D0B</txt-record>
    <txt-record>icon=https://exampleapplication.com/icon.png</txt-record>
    <txt-record>description=Commotion is an open-source communication tool that uses mobile phones, computers, and other wireless devices to create decentralized mesh networks.</txt-record>
    <txt-record>lifetime=86400</txt-record>
    <txt-record>version=1.0</txt-record>
    
  </service>
</service-group>

Commotion Splash

luci-commotion-splash is an OpenWRT package that adds a LuCI web user interface for configuring the popular Nodogsplash captive portal.

Commotion Splash is selected as a default build option in Commotion-Router (https://github.com/opentechinstitute/commotion-router).

Changelog

7 May 2013: Release v1.0
29 Aug 2013: Release v1.1.1
28 Dec 2013: Release v1.2

Commotion Dashboard Helper

Scripts and configuration to send data to a bigboard gatherer, along with LuCI interface for configuration.

Commotion Dashboard Helper is selected as a default build option in Commotion-Router (https://github.com/opentechinstitute/commotion-router).

Commotion Debug Helper

Commotion Debug Helper is a LuCI based bug collector for users to quickly gather relevant data for OpenWRT router issues

Commotion Debug Helper is selected as a default build option in Commotion-Router (https://github.com/opentechinstitute/commotion-router).

Commotion Lua Helpers

A set of lua "helper" modules for Commotion packages.

Commotion Lua Helpers are selected as a default build option in Commotion-Router (https://github.com/opentechinstitute/commotion-router)