Skip to end of metadata
Go to start of metadata


This page will show you step-by-step how to interface a NimbeLink cape to the BeagleBone Black/Green.

Hardware Requirements

BeagleBone Black at Digi-Key
BeagleBone Green at Digi-Key
NimbeLink Beaglebone Black IOT cape:
NL-AB-BBBC at Digi-Key
XBee XB24CZ7WIT-004 at Digi-Key

Software Requirements


Install latest console image to eMMC

Today the latest version is: 2016-01-03 (these are just weekly snapshots, so always check for the latest)

Insert microSD into pc adapter and check device node name (in our case /dev/sdd):

Download the *.img.xz and matching *.bmap file, and write to microSD card via bmaptools:

Insert microSD into the first BeagleBone Black/Green and wait for flashing procedure to finish. (device should shutdown)

Enable g_serial on usb mini connector

Since we will be using an NimbeLink cape, we will be losing access to the J1 serial debug header on the baseboard.  So let's enable "g_serial" over the usb mini by default.  We can have current am335x_evm boot script to this for us, by removing "udhcpd"


Let's remove udhcpd

On the next reboot:

Using gtkterm we can get access via:

Install common tools

For this project we are going to use just a few tools on top of the base console image.

Update /boot/uEnv.txt to use the correct dtb for NimbeLink and eMMC usage

Install device tree overlays for NimbeLink cape

Update Kernel (the 2016-01-03 default kernel lacks the driver for the iio based temp sensor we are using in this example.)

Install Exoline

Disable eth0

Cleanup and Shutdown system via:

Install NimbeLink and powerup BeagleBone Black/Green and verify cape is installed, since j1 debug is hidden use the usb port:


Clone eMMC

Insert a microSD into BeagleBone Black/Green that we will use to clone the eMMC to the additional device.

Run "beaglebone-black-make-microSD-flasher-from-eMMC.sh" script


Shutdown system via:

Remove "microSD" and flash other BeagleBone Black/Green devices.

XBee Setup

Download and install XCTU: http://www.digi.com/products/xbee-rf-solutions/xctu-software/xctu

Test, with both Xbee's installed in their ownNimbeLink cape:

Temperature Sensor

Add device:

Look at the device:


Script the conversion using bc:

Now send that data padded with a cksum over the serial port:

and load the iio driver if not loaded (assumes root)

tie into cron



We need P9.30 for SPIDEV1, which is the enter key on the LCD7, so disable P9.30 in BB-BONE-LCD7-01-00A3.dts