Revision 27 as of 2008-11-26 23:41:35

Clear message

Locked History Actions

UbntStations

OLSRd on Ubiquity XStations

Hardware description: http://www.ubnt.com

Ubiquity Networks provide a SDK for their Firmware (AirOS). The SDK and the cross-compiler Toolchain can be found at the support section of their homepage. I created a patch for the SDK 3.2 which supports most of their products. I tested it on a pair of NanoStation5. My Testimage can be found [attachment:XS5.ar2313.v3.2.3-rc.SDK.081127.0009.bin here]. It was builded using [attachment:UBNT_SDK3.2.3-rc_with_olsrd-01.patch this] patch and [attachment:UBNT_SDK3.2.3-rc_files-01.tar.gz this] additional files. It contains olsrd and some modfifications in order to build and install it. It also contains a modification of the webinterface which allows the use of no gateway at the network configuration because a static default route destroys dynamic routing.

Some screenshots of the Webinterface Modifications: UbntStationsScreens

You can build your own Image on Debian/Ubuntu by invoking the following commands: 

# mkdir ubnt
# cd ubnt
# wget http://www.ubnt.com/downloads/sdk/toolchain-mips-ls_0.1-1.deb
# dpkg -i toolchain-mips-ls_0.1-1.deb
# wget http://www.ubnt.com/downloads/XS-fw/v3.2.3-rc/SDK.UBNT.v3.2.3-rc.4063.tar.bz2
# tar xjf SDK.UBNT.v3.2.3-rc.4063.tar.bz2

download the patch and the additional files to this directory

# cd SDK.UBNT.v3.2.3-rc.4063
# patch -p1 < ../UBNT_SDK3.2.3-rc_with_olsrd-01.patch
# tar xzf ../UBNT_SDK3.2.3-rc_files-01.tar.gz

now we have to download and copy the olsrd source

# cd apps/gpl/olsrd
# wget http://www.olsr.org/releases/0.5/olsrd-<version>.tar.bz2
# tar --strip 1 olsrd-<version>.tar.bz2
# rm olsrd-version.tar.bz2
# cd ../../../
# make xs5

The patch should also work for their 2.4GHz equipment. You can build a image for this Hardware by replacing the xs5 with a xs2. I don't tested the patch with this Hardware so be sure that you know what you are doing.

After building the Image it can be installed via the AirOS Webinterface. If the interface complaints about a wrong image file you have to upgrade AirOS to a newer version which allows the use of third party firmware images (AirOS 3.1.1 worked for me).

If you have successfully installed the image you can turn on olsrd using the enable button at the services section of the Web Interface. By default the following Configuration is used 

DebugLevel 0
IpVersion 4
AllowNoInt yes
Pollrate 0.025
TcRedundancy 2
MprCoverage 7
LinkQualityFishEye 1
LinkQualityWinSize 100
LinkQualityDijkstraLimit 0 10.0
LinkQualityLevel 2
UseHysteresis no
FIBMetric "flat"
ClearScreen yes
Willingness 3
LinkQualityAging 0.1
LinkQualityAlgorithm "etx_fpm"

# Don't remove olsrd_txtinfo from this file
# as this plugin is used by the Webinterface
# to display the OLSR Info
LoadPlugin "olsrd_txtinfo.so.0.1"
{
        PlParam "Accept" "127.0.0.1"
}

Interface "eth0"
{
        HelloInterval 5.0
        HelloValidityTime 125.0
        TcInterval 2.0
        TcValidityTime 500.0
        MidInterval 25.0
        MidValidityTime 500.0
        HnaInterval 25.0
        HnaValidityTime 500.0
}
Interface "ath0"
{
        HelloInterval 5.0
        HelloValidityTime 125.0
        TcInterval 2.0
        TcValidityTime 500.0
        MidInterval 25.0
        MidValidityTime 500.0
        HnaInterval 25.0
        HnaValidityTime 500.0
}

You can also download your own olsrd.conf via the Webinterface. If you download an own configuration file be sure that include the configuration lines for the txtinfo plugin as this plugin is needed by the Web Inteface to show the OLSR Info.

If you want to edit the olsrd.conf via ssh or telnet you have to make sure that it gets stored inside the persistent storage area of the flash. Create the Configuration file inside the /etc/persistent/ directory and invoke the following command: 

# /bin/cfgmtd -p /etc/ -w

After that you have to reboot.

For further questions or additional information please send me an email: equinox@spreadspace.org

Version History

SDK 3.2.3-rc

  • Patch v01: ([attachment:UBNT_SDK3.2.3-rc_with_olsrd-01.patch Patch], [attachment:XS5.ar2313.v3.2.3-rc.SDK.081127.0009.bin Image]):
    • This quite the same as Patch v06 for SDK 3.2

SDK 3.2

Build Instructions

# mkdir ubnt
# cd ubnt
# wget http://www.ubnt.com/downloads/sdk/toolchain-mips-ls_0.1-1.deb
# dpkg -i toolchain-mips-ls_0.1-1.deb
# wget http://www.ubnt.com/downloads/sdk/ubnt-lsX-SDK-v3.2.3743.tar.bz2
# tar xjf ubnt-lsX-SDK-v3.2.3743.tar.bz2

download the patch to this directory

# cd ubnt-lsX-SDK-v3.2.3743
# patch -p1 ../UBNT_SDK3.2_with_olsrd-06.patch
# make xs5

Patches and Images

  • Patch v06 ([attachment:UBNT_SDK3.2_with_olsrd-06.patch Patch], [attachment:XS5.ar2313.v3.2.SDK.081106.2050.bin Image]):
    • added txtinfo config directly to the default configuration as this is more flexible
  • Patch v05 ([attachment:UBNT_SDK3.2_with_olsrd-05.patch Patch], [attachment:XS5.ar2313.v3.2.SDK.081106.0634.bin Image]):
    • added OLSR Info sites (can be viewed/selected at the main site under 'Extra info')
  • Patch v04 ([attachment:UBNT_SDK3.2_with_olsrd-04.patch Patch], [attachment:XS5.ar2313.v3.2.SDK.081106.0330.bin Image]):
    • switched back to OLSR 0.5.6 because of some problems with 0.5.6-r2
    • current olsrd.conf can now be downloaded via the Web Interface
  • Patch v03 ([attachment:UBNT_SDK3.2_with_olsrd-03.patch Patch], [attachment:XS5.ar2313.v3.2.SDK.081105.2244.bin Image]):
    • fixed issues with default gateway
    • disabled httpinfo in default config (this plugin needs way to much memory)
  • Patch v02 ([attachment:UBNT_SDK3.2_with_olsrd-02.patch Patch], [attachment:XS5.ar2313.v3.2.SDK.081105.1817.bin Image]):
    • switched to OLSR 0.5.6-r2
  • Patch v01: ([attachment:UBNT_SDK3.2_with_olsrd-01.patch Patch], [attachment:XS5.ar2313.v3.2.SDK.081104.0432.bin Image]):
    • Initial Release