Skip to content

Sparrow Border Router and Serial Radio

Joakim Eriksson edited this page Jun 12, 2017 · 11 revisions

Sparrow Border Router

The Sparrow border router is based on the Contiki native border router but improved with many new features and fixes.

Features

  • Full serialisation of packetbuf attributes
  • Supports slave-mode for serial-radio over TCP connection (access point mode)
  • Supports update of serial-radio via the border router
  • CRC32 used for reliable communication between border router and serial radio

The Sparrow border is in the directory products/sparrow-border-router and can be run using:

> cd products/sparrow-border-router
> make connect-full PORT=/dev/tty<Your-Serial-Radio>
> ...

Note: This assumes that you already have a Sparrow serial radio attached in a USB port. Read next section on how to program a device with the serial radio firmware.

Sparrow Serial Radio

The Sparrow serial radio is based on the Contiki serial radio or slip-radio but improved with a more advanced protocol for configuring the radio and uses CRC32 over the link to detect bad packets. It is also improved so that it can be reprogrammed using TLV's and the same OTA mechanism over the serial link.

Features

  • Most radio parameters configurable over serial
  • Several different modes including - serial radio, sniffer and RSSI scan
  • CRC32 used for reliable communication between serial radio and border router

To program a device with the serial radio go to the directory products/sparrow-serial-radio and build images and upload to the device (or build a regular firmware and program over USB).

> cd products/sparrow-serial-radio
> make images TARGET=zoul-sparrow BOARD=remote
[...]
Creating image archive for serial-radio.images INC=0
>

Now there is an image built - either upload that via regular OTA / serial. The below show how to upgrade if you have the (old) serial radio already running via a sparrow-border-router:

> make upload-local TARGET=zoul-sparrow BOARD=remote

If you do not have any boot loader and OTA available on the RE-MOTE you can program it using the rescue image that can be produced using:

> make IMAGE=1 TARGET=zoul-sparrow BOARD=remote
> make rescue-image TARGET=zoul-sparrow BOARD=remote

Make sure the RE-MOTE is connected via USB

> make upload-rescue-image TARGET=zoul-sparrow BOARD=remote

Sparrow serial radio with SubGHz

To build the serial radio with support for sub-ghz make use of the following:

> make IMAGE=1 MAKE_WITH_868=1 TARGET=zoul-sparrow BOARD=firefly-reva

This will enable larger packets and 802.15.4g format of the PHY header. (you can also build with MAKE_WITH_920=1 for 920 MHz support).