https://github.com/bastibl/gr-ieee802-15-4

IEEE 802.15.4 ZigBee Transceiver
https://github.com/bastibl/gr-ieee802-15-4

802-15-4 ieee iot sdr zigbee

Last synced: 10 days ago
JSON representation

IEEE 802.15.4 ZigBee Transceiver

• Host: GitHub
• URL: https://github.com/bastibl/gr-ieee802-15-4
• Owner: bastibl
• License: gpl-3.0
• Created: 2013-03-05T11:51:25.000Z (over 11 years ago)
• Default Branch: maint-3.10
• Last Pushed: 2023-07-28T12:51:17.000Z (over 1 year ago)
• Last Synced: 2024-10-08T21:05:43.024Z (28 days ago)
• Topics: 802-15-4, ieee, iot, sdr, zigbee
• Language: C++
• Homepage: https://www.wime-project.net
• Size: 883 KB
• Stars: 274
• Watchers: 24
• Forks: 87
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-gnuradio - gr-ieee802-15-4 - zigbee (GnuRadio Software)

README

        
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 *maint* branches for development.

These branches are supposed to be used with the corresponding GNU Radio

branches. This means: the *maint-3.7* branch is compatible with GNU Radio 3.7,

*maint-3.8* is compatible with GNU Radio 3.8, etc.

## 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

- GNU Radio

- 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

Please see [www.wime-project.net](https://www.wime-project.net/installation/)

for installation instructions.

## 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!