IEEE 802.15.4 ZigBee Transceiver
C++ Python CMake C Lua Shell
Latest commit 2f5e196 Oct 6, 2016 @bastibl update cmake modules

README.md

Hi!

This is an IEEE802.15.4 O-QPSK transceiver for GNU Radio, based on Thomas Schmid's implementation.

Development

Like GNU Radio, this module uses master and next branches for development, which are supposed to be used with the corresponding GNU Radio branches. I recommend staying up-to-date by using the next branch.

Features

  • The O-QPSK PHY encapsulated in a hierarchical block.
  • The CSS PHY, also encapsulated in a hierarchical block (Limitation: Packets need to have a fixed length).
  • A block that implements the Rime communication stack. Rime is a lightweight communication stack designed for Wireless Sensor Networks and is part of the Contiki Operating System.
  • A transceiver flow graph with USRP <-> PHY <-> MAC <-> Network layer (Rime) <-> UDP Socket / APP which resembles pretty well the ISO/OSI structure.
  • A sample application which visualizes sensor values. The application shows how easy it is to connect an external program to the flow graph by using Socket PDU blocks.
  • An IEEE 802.15.4 and Rime dissector for Wireshark.

Some interesting properties:

  • Packets can be piped to Wireshark.
  • The complete physical modulation is done with plain GNU Radio blocks.
  • It is interoperable with TelosB sensor motes.
  • It is interoperable with Contiki.
  • It uses a block to tag packet bursts with tx_sob and tx_eob tags. This tags are understood by the UHD blocks and allow fast switching between transmission and reception.

You can find the firmware that I used to test interoperability with TelosB motes in the contiki folder. The firmware is based on Contiki v2.6. There is another README file in the Contiki folder that describes how to compile and use the firmware.

Dependencies

  • g++ >= 4.6 (for C++11 support)

  • gr-foo (Wireshark Connector, Packet Pad and Burst Tagger blocks)
    https://github.com/bastibl/gr-foo.git

  • python-matplotlib (if you want to run the GUI sample application)
    sudo apt-get install python-matplotlib

Installation

git clone git://github.com/bastibl/gr-ieee802-15-4.git
cd gr-ieee802-15-4
mkdir build
cd build
cmake ..
make
sudo make install
sudo ldconfig

The hierarchical block has to be installed separately: Open examples/ieee802_15_4_*_PHY.grc in gnuradio-companion and generate (hotkey F5) the flow graph. This installs the hierarchical block in your home, where gnuradio-companion can find it (typically ~/.grc_gnuradio).

Usage

Open the examples/transceiver_*.grc flow graph with gnuradio-companion and check if all blocks are connected. Enable either the UHD blocks to interface with real hardware or the Packet Pad block to loop back the samples. Open some Rime connections and connect messages sources or Socket PDUs. You can easily connect to the Socket PDU blocks with netcat. Netcat can be started for example with

nc -u localhost 52001

There are also startup scripts in the apps folder.

Have fun!