View source for NWA

From Openmoko

Jump to: navigation, search

You do not have permission to edit this page, for the following reasons:

  • The action you have requested is limited to users in the group: Administrators.
  • You must confirm your email address before editing pages. Please set and validate your email address through your user preferences.

You can view and copy the source of this page:

Return to NWA.

Personal tools



WiFi on the freerunner has some problems, see WiFi Managers.

So I decided to start a project to concentrate all the ideas about an ideal (but simple) GUI applet to manage WiFi connection.

The project is actually only a prealpha prototype to discover issues and implementation solutions. When ideas and needs will be clear it may be reimplemented in a more elegant way and with your preferred toolkit, now I'm using what I know better, C++ and QT with fast and dirty coding style!

It actually manages wpa_supplicant trough dbus and spawns udhcpc directly, replicating some Network Manager features. When a solid rock network manager will be available for the freerunner, and will handle the specific device capabilities/issues, NWA may be migrated to use it's api.

Please partecipate with contributions, ideas, hints as this may become your preferred WiFi manager for a while!!! feel free to edit this or the discussion page, and to contact me by email at nicola.mfb at


A supplicant

The main target is to use wpa_supplicant in a decent way, e.g. as a supplicant! You'll add your preferred wifi networks at home, at work, at your friend house and so on, and it will scan silently for them, connect when they are available and show a notification window/sound to alert you.

User has to be able to:

  • enable/disable configured networks (for example any open network sometime is not desiderable)
  • change the networks priority (for example use any open network only if other are not available)
  • add new network manually or from scanning the area
  • configure advanced network properties, WPA enteprise, EAP, LEAP, TTLS etc.

Static IP vs DHCP

The user should be able to use dhcp or static ip addresses.

DNS handling

It has to be able to restore some default DNS when exiting dhcp (eg. opendns, last used dns ...), suggestions on possible solutions are appreciated.

System tray applet

A sys tray icon should be showed changing it's aspect to reflect connection status. It should indicate:

  • inactive state (wifi disabled)
  • scanning
  • associated
  • complete (associated + authenticated)
  • key renewal
  • complete + ip address received from dhcp or set manually
  • signal strenght when associated
  • historical signal strenght (like a graph scrolling every x seconds)
  • foreign networks presence

Some special handling is required for Window Managers that does not support sys tray specification (like E17).

Popup messages

Popup transient messages should be showed when:

  • connection fully complete, showing the received ip address
  • disconnection
  • wifi card enabled/disabled
  • network found (if not connected)

The last has to be defined better, should you signal a new network only one? only one per session? etc.


Popup has to be associated with sounds to warn the user not looking at the device.

please suggest some free sounds in every format supported by FSO/gstreamer

As alternative some software synthetizer may be used.


The configuration file should be in xml format, a default one will be provided that scan and connect to any open network, so the user may use NWA out of the box. When the user changes settings, the default file is copied in $HOME/.nwa.conf, that one will override the default.

The GUI must be complete but simple and should not allow the user to break the configuration with random clicks, all advanced tasks may be achieved editing the configuration file manually:

  • dhcp client to use
  • custom scripts to launch at iface up/down, ip received
  • ...

Device Integration

NWA prefers FSO frameworkd based distro but should be capable to run on everywhere, actually it works fine on my laptop too.

2.6.29 kernel workaround

On OM 2.6.29 kernels wifi is broken, software putting down the interface (e.g. wpa supplicant in some cases) will break ar6000 module. A workaround has to be implemented and activable in the configuration file.

Power Managment

With some AP the atheros power managment creates problems, NWA should support disabling it.


It has to restore automagically the connection on suspend/resume cycles (the prototype does that without any special code as the nature of how it works).

Development status/issues

Wpa_supplicant dbus interface is not complete, if you quit the program in some hard way (signaling, closing X, etc) network definitions will not be deleted and at the next run NWA will be crazy, some workarounds:

  • kill wpa_supplicant at startup, it' not nice
  • implementimplemented a remove/readadd interface to wpa when NWA is starting (it should delete all network definition, to be tested)
  • bore wpa_supplicant authors to implement the full dbus interface a new version of dbus interface is on the road
  • implements signal handling hooks (howewer a kill -9 will bypass it)

Another problem is that wpa_supplicant when connects to a networks signal only the state change and not the network id or network dbus path. This is a big problem as I would have the dhcp/static ip configuration associated to that and not to the essid as it may be the same between different networks.

Using the bssid to disambiguate the network may not be always possible for example when connecting to two big WDS networks with the same essid and thousand of AP.

Please comment the above problem and suggest alternatives. I'll add dhcp/static ip support when things will be clear

as wpa_supplicant does not signal the connected network we have to retrieve the essid with standard AF_INET ioctl, so qnetutils.cpp has to be improvedqnetutils.cpp now read the essid of the associated network.

The qt stylesheet has to be improved.

A 2.6.29 rude workaround was implemented, when you quit the NWA it does not kill udhcpc and deconfigure eth0 from wpa_supplicant (always remove networks) but simply release the FSO WiFi resources, removing the interface without deconfiguring. It works only sometimes. We may think to rmmod/insmod ar6000 but it's a very crude hack and sometimes kernel opses.

A startup script, launched when supplicant association is complete, is already implemented, it's a crude way to disable power management if needed.

The second problem for static ip support is that I have to study a bit more rtnetlink to implement static ip without calling exeternals command :) in the mean time I'm planning to support per-network per-essid command file execution and dhcp disabling, so you may use some script to configure the interface with a static address. It should be sufficient for a prototype.

Actually destroying a running thread when application quits leads an "application crashed" on E, I'm not caring of it now a better clean and quit handler has to be implemented.

To play sounds notification spawning a shell sound player may be weight and slow, so I think it's better to use FSO, while to have speech synthesis the script approach may be acceptable, parameter passing has to be implemented in the configuration file (network name, ip address and so on) just use $IFACE$ and $IP$ when you want it be automagically replaced with their respective values.

It seems as udhcpc when got an ip address set/unset/set_again the ipaddress, this is strange. The problem is not present with dhcpcd. Updates: this happens with udhcpc on a Cisco MDS wifi network and not with common AP.

FSO returns random errors when PlaySound is used while a sound is already played on debian sid there is no default dmix alsa configuration, this has to be declared in NWA prerequisites

Some small coding fixes need to be done, and some stupid comments removed :)

The first prealpha prototype is quite ready, it was developed on debian with Matchbox and matchbox-panel as sys trayer, under E qt balloon sys tray messages are showed in a random position on the screen, so some special work around is needed a primitive and animated "tooltip" was implemented. Multiple not overlapping message showing are not supported a queue handler has to be implemented. I preferred to avoid qt sys tray baloon message on not-E wm too, as if the tray icon is in a middle/left position (becouse other tray icon are present), in some cases they are not readable.


Some guys asked for a preview, if you feel adventurous and want to join and test the prototype do the following:

echo "src/gz noko-testing-armv4t" >/etc/opkg/noko-feed.conf
opkg install nwa

This was tested only on OM2009 testing 5 + opkg update/upgrade

Please note the not versioning is used so if you want to upgrade you have to:

opkg remove nwa
opkg update
opkg install nwa

Source is cooming soon.


NWA read $HOME/.nwa.conf configuration file, if it does not exists it read /usr/share/nwa/defaultconfiguration.xml. When you change some configuration with the GUI the default file is copied in $HOME/.nwa.conf.

All common configuration is done in the GUI, for advanced usage you may edit your $HOME/.nwa.conf file (copy it if it does not exists yet)

Example configuration file

<xml version="1.0">                                                                             
<!-- This is the default configuration file for nwa, and contains a                             
     basic configuration for the openmoko freerunner.                                           
     The user configuration file is $HOME/.nwa.conf and overrides this -->                      

<!-- in the following section we define all possible dhcp clients -->
  <dhcpclient name="udhcpc -f -i $IFACE$" default="yes"/>
  <dhcpclient name="none" />
<!-- autoenable wlan interface activation at startup -->
 <autoenable value="yes" />
<!-- interface card, usually eth0, on some distro is eth1 (hackable1) -->
 <iface name="eth0" maxquality="255"/>
<!-- here are stored the network definitions, the default allows to connect
     to every open ap -->
  <network name="Any Open" key_mgmt="NONE" enabled="yes"/>
<!-- scripts that are runned when wpa_supplicant complete authentication and when it disconnects
     if you run nwa as non privileged user you may define a sudo call to launch/kill the dhcpcd c
     (disabiling the main dhcp section setting it to none -->
 <ifupscript path="logger NWA iface $IFACE$ up"/>
 <ifdownscript path="logger NWA iface $IFACE$ down"/>
<!-- scripts that are runned when the iface get/lose an ip address -->
 <ipupscript path="logger NWA iface $IFACE$ got ip $IP$"/>
 <ipdownscript path="logger NWA iface $IFACE$ losed ip $IP$"/>
 <brokenkernelhack value="no"/>
 <apscan mode="1"/>
 <!-- disable/enable fso use to:
     * enable/disable wifi
     * use idlenotifyer to bring up display on popup message and at startup
     * play notification sound with gstreamer -->
 <usefso value="true"/>
 <upsound path="/usr/share/nwa/sounds/bonus.ogg"/>
 <downsound path="/usr/share/nwa/sounds/gameover.ogg"/>
<!-- alwaysshowwindow if yes it show the window at startup (normally if systray is available it's hided until you click on it) -->
 <alwaysshowwindow value="no" />