Ubiquiti UniFi AP


Architecture: MIPS
Vendor: Atheros
Bootloader: U-boot
System-On-Chip: Atheros (AR7240)
CPU Speed: 400 Mhz
Flash-Chip: MX25L6405D
Flash size: 8 MiB
Wireless: AR9287
Switch: none
Ethernet ports: 1x Gigabit, POE capable
USB: No 1)
Serial: Yes, settings

Hardware Photo

Click to zoom


Since r23904 this device is supported in trunk and in future stable release.
12.09 includes this AP as stable.

Installing a new Firmware Image

  1. Device get IP address from DHCP
  2. Login inside the AP with ssh ubnt@ip_address (password ubnt)
  3. Find the image like "openwrt-ar71xx-ubnt-unifi-*-factory.bin" on openwrt binary repository and download inside /tmp.
  4. Use the ubiquity fwupgrade utils to reflash it:
    fwupdate.real -m openwrt-ar71xx-ubnt-unifi-*-factory.bin -d

fwupdate.real can complain about the version of the firmware image, because it is built with prefix "XM" instead of the "BZ" of the unifi image (trunk r38381 works). To change you will have to download the OpenWRT Image builder, patch the Makefile at target/linux/ar71xx/image (replace XM with BZ around line 844:

$(eval $(call SingleProfile,UBNTXM,$(fs_64k),UBNTUNIFI,ubnt-unifi,UBNT-UF,ttyS0,115200,XM,BZ,ar7240))
Or just replace characters 4-6 in the firmware image file

Upgrading OpenWRT

If you have already installed OpenWrt and like to reflash for e.g. upgrading to a new OpenWrt version you can upgrade using the sysupgrade command line tool. It is important that you put the firmware image into the ramdisk (/tmp) before you start flashing.

LuCI Web Upgrade Process
Terminal Upgrade Process
  • Login as root via SSH on your access point ip
  • Use the following commands to upgrade:
    cd /tmp/
    wget http://downloads.openwrt.org/.../openwrt-ar71xx-ubnt-unifi-*-sysupgrade.bin
    sysupgrade -i /tmp/openwrt-ar71xx-ubnt-unifi-*-sysupgrade.bin


A male-strip is on board to connect your TTL capable serial converter. Use the following settings: 115200 8N1.

Click to zoom


How to connect to JTAG interface, and how to reflash the device with JTAG tools

See port.jtag for more JTAG details.

Specific Configuration

The UniFi ap has 2 leds, the orange one can be configured adding something like:

config 'led'
	option 'name' 'lan'
	option 'sysfs' 'ubnt:orange:dome'
	option 'trigger' 'netdev'
	option 'dev' 'br-lan'
	option 'mode' 'tx rx' 
at the end of /etc/config/system

Also its possible to change the led status manually.

  1. static, use 1 for on, 0 for off:
    echo 1 > /sys/class/leds/ubnt\:orange\:dome/brightness
    echo 1 > /sys/class/leds/ubnt\:green\:dome/brightness
    echo 0 > /sys/class/leds/ubnt\:green\:dome/brightness
    echo 0 > /sys/class/leds/ubnt\:orange\:dome/brightness
  2. blinking
    1. blinking on, interval 1000ms, orange led:
      echo timer > /sys/class/leds/ubnt\:orange\:dome/trigger
      echo 1000 > /sys/class/leds/ubnt\:orange\:dome/delay_on
      echo 1000 > /sys/class/leds/ubnt\:orange\:dome/delay_off
    2. blinking off:
      echo 0 > /sys/class/leds/ubnt\:orange\:dome/delay_off

Back to top

toh/ubiquiti/unifi.txt · Last modified: 2014/01/24 04:45 by djzort