{"id":1637,"date":"2012-02-20T19:26:24","date_gmt":"2012-02-20T23:26:24","guid":{"rendered":"http:\/\/www.braindeadprojects.com\/blog\/?p=1637"},"modified":"2012-02-20T19:26:24","modified_gmt":"2012-02-20T23:26:24","slug":"an-upgrade-to-ubiquiti","status":"publish","type":"post","link":"http:\/\/www.braindeadprojects.com\/blog\/what\/an-upgrade-to-ubiquiti\/","title":{"rendered":"An upgrade to Ubiquiti"},"content":{"rendered":"

I’ve been _extremely_ impressed with the quality of Engenius<\/a>‘ products, most specifically the EOC-2610.<\/a> For the 2 years that I’ve had my two units in service, I’ve had very little issue with them.<\/p>\n

Recently my workplace ordered a batch of Ubiquiti products from DoubleRadius<\/a>. Ubiquiti is loved by the WISP<\/a> world, and (mostly) utilize Atheros<\/a> boards – just as the Engenius products do. Both also have stock firmware that’s also based off OpenWRT<\/a>. Being inspired, I purchased some equipment myself.<\/p>\n

Part of the reason the Ubiquiti gear seems to be more popular is their excellent support and web forum. Engenius is notoriously difficult to get any answers out of. I’ve still yet to get a copy of their firmware source required by the GPL, and I gave up long ago trying to get anywhere. Luckily, the few questions I did have were answered by simply expirementing.<\/p>\n

This weekend I began the migration to Ubiquiti. My first rollout involves a Rocket M2<\/a> and a 120 degree sector antenna<\/a>. For the past few weeks I’ve been working on adding a more recent version of the excellent CoovaChilli to the device. I have located a version of the CoovaAP firmware <\/a>that runs natively on a Rocket M2, however it lacked a number of features (non-Chilli related) that I was hoping for. After much searching, I’ve been able to locate a 5.3 SDK (which features AirControl and the built-in spectrum analyzer).<\/p>\n

\"AirView\"<\/a>
The AirView built in spectrum analyzer<\/figcaption><\/figure>\n

As I mentioned, it took quite a bit of searching to obtain the SDK. According to Kevin Perry at Ubiquiti\u00a0 “We’ve had to temporarily remove the SDKs from our site to comply with US export control regulations. Once approved, we will be able to continue providing SDKs. ”\u00a0 I’ve not heard anything new, and that correspondence is from September of 2011.<\/p>\n

Of course, the Internet is a not only a compendium of 140-word-or-less Tweets about what someone just ate for dinner, it’s also a giant archive of the past<\/a>. And with a bit of searching, I came across the SDK still hosted (albeit hidden) on Ubiquiti’s site.<\/p>\n

Unfortunately the latest SDK is 5.5, and not 5.3. I’ve not had luck locating it (and it does contain the patch for the SkyNet worm<\/a>), so I’m working off 5.3 for the time being. I’ve locked down access to the web interface to prevent infection from the worm.<\/p>\n

\"CoovaLogo2_0\"<\/a>
The CoovaChilli Captive Portal<\/figcaption><\/figure>\n

With the SDK in tow, I began the work of inserting CoovaChilli<\/a> into the system. Ubiquiti ensures important services stay running by having them spawned (and respawned if needed) via inittab. The stock inittab on the system is basic, handling only login and a couple of runlevel items. Prior to \/sbin\/init starting, the system runs a bash script \/init. This in turn handles filesystem mounts, makes a handful of device nodes, copies a number of files into place, partially configures sysinit, and sets the timezone. It also calls ubntconf which gleans information from the nvram variables, prior to executing the traditional \/sbin\/init.<\/p>\n

ubntconf is a closed source application, although it’s pretty easy to glean most of it’s operations by simply running strings<\/a> on it (It is an ELF<\/a> not a script). Depending upon nvram variables that are set, different scripts are dropped into \/etc\/sysinit. Additionally, items are added to \/etc\/inittab like this:<\/p>\n

\n

null::respawn:\/bin\/pppd eth0
\nnull::respawn:\/bin\/lighttpd -D -f \/etc\/lighttpd.conf
\nnull::respawn:\/bin\/dropbear -F -d \/etc\/persistent\/dropbear_dss_host_key -r \/etc\/
\npersistent\/dropbear_rsa_host_key -p 22<\/p>\n<\/blockquote>\n

Each of these entries will respawn the corresponding service should it crash. Using their system as a model, I created my own config creator “chilliconf” to add entries to inittab for the chilli daemon, in addition to the necessary iptables rules in \/etc\/sysinit, and a few modifications to their use of dnsmasq (I wanted to syslog DNS queries offsite). When I later added NProbe<\/a> to my firmware, I also used my chilliconf configurator to add it to the inittab.<\/p>\n

My chilliconf configurator, like ubntconf, is called from the \/init script.<\/p>\n

One thing of note – any daemon listed in the inittab file needs to actually run in the foreground (so calling the process a daemon isn’t entirely accurate). This is for the obvious reason that the initiating process fork()s<\/a> then exits – so inittab will continually respawn the service until you run out of resources.<\/p>\n

\"No<\/a>
All original functionality is still there. It's a like a cyborg version of itself.<\/figcaption><\/figure>\n

I used the 3.6SDK version of CoovaAP<\/a> as a model for my web interface. Adding a tab was fairly easy – the web interface is maintained as the ubnt-web package in the SDK. Most of the web CGI is PHP\/FI<\/a> (with a couple of functions added to PHP to facilitate saving configs and reading values). The code is extremely readable, and easy to figure out.<\/p>\n

When you save your settings in the Ubiquiti web interface, you’re presented with a blue message bar asking if you’d like to test or apply your settings. In either case, you’ll be disconnected for a moment while the system reconfigures itself. This appears to be done via a call to the original \/init script. The blue bar is a bit of a problem when adding a new tab to the menu.<\/p>\n

The background image for the blue bar (msg.png) is originally\u00a0 745 pixels, and the screen width is set to 790 pixels. With an added tab, the screen width becomes 866 pixels. Using GIMP<\/a> I resized this image to 821 pixels.<\/p>\n

\"The<\/a>
Resize the blue background to fit.<\/figcaption><\/figure>\n