| Title | Wireless mesh networking toolkit |
| Section | net |
| Category | Network |
| Maintainer | Roberto Riggio (roberto.riggio@create-net.org) |
| Depends | +kmod-tun |
| WWW | http://www.wing-project.org/ |
| Description | Wing is a wireless mesh routing software. The routing protocol is derived from Roofnet. It supports multiple radio interfaces and link quality routing using the ETX, ETT, and WCETT metrics. |
This package adds support for the wing protocol type in the interface section of the network configuration. This protocol type does not need an ifname option set in the interface section. The interface name is derived from the section name, e.g. config interface mesh would result in an interface named wing-mesh. The IP address is automatically generated by the initialization scripts using the last 3 bytes of the first wireless interface used to build the mesh backhaul. Network interfaces using the wing protocol are associated to a Tap interface which is configured as $prefix.X.X.X and uses multi-hop routing.
config 'interface' 'mesh' option 'proto' 'wing' option 'profile' 'bulk' option 'rc' 'static' option 'link_scheduler' 'fcfs' option 'metric' 'wcett' option 'prefix' '6' option 'debug' 'true'
| Option | Type | Mandatory | Default | Description |
|---|---|---|---|---|
| profile | String | No | bulk | Click modular router's configuration template (only bulk is available at the moment). |
| rc | String | No | static | Rate control algorithm (static, madwifi, autoratefallback, probetx). |
| link_scheduler | String | No | fcfs | Link scheduling algorithm (only fcfs is available at the moment). |
| metric | String | No | wcett | Link metric (ETX, ETT, WCETT). |
| prefix | Integer | No | 6 | First byte of the mesh interface's IP address. |
| debug | Boolean | No | True | Enable verbose debug. Logs are saved at /var/log/wing-$ifname.log. |
In order to build the mesh backhaul, the wing protocol exploits wireless interfaces operating in monitor mode. At least one of such interfaces must be defined in /etc/config/wireless, as for example:
config 'wifi-device' 'wifi0' option 'type' 'atheros' option 'hwmode' '11g' option 'channel' '1'
config 'wifi-iface' option 'device' 'wifi0' option 'mode' 'monitor'
All the wireless interfaces operating in monitor mode define in /etc/config/wireless are automatically used by the wing protocol. Note that both the hwmode and the channel options can be omitted.
The mesh interface can be brought up and down using the standard OpenWRT commands:
ifup mesh
and
ifdown mesh