Gecko Zigbee Python interface
This is a pure Python implementation of a IEEE802.15.4 and ZigBee network stack that works with MicroPython.
It was developed for the Silicon Labs Gecko boards used in Ikea Tradfri devices. The firmware port of MicroPython lives in osresearch/micropython/ports/efm32. The underlying ZigBee radio interface also lives in the machine specific port for that board; this is the hardware agnostic software stack that processes the packets.
For more information on the project, see Ikea+Micropython lightning talk.
See the README in the MicroPython port for details on building and installing using OpenOCD + SWD.
ampy.py you can
install all of the code from the
ZbPy directory into the flash on the device.
ZigBee network layers
- Phyiscal layer (handled by the radio, supported via
- NWK - Network Layer:
- Security Layer (not really a layer, an optional part of the NWK header)
- APS - Application Support Layer:
- ZCL - ZigBee Cluster Library:
Most of the layers are sufficiently implemented to join an existing Zigbee network, receive a 16-bit short network address, decrypt+validate and encrypt+mac messages encrypted with the AES-CCM mode.
The Application and Cluster layers are only partially implemented right now; the messages are decoded but not mapped to functionality. Perhaps parts of ZigPy can be ported to MicroPython to provide these mappings.
It is easiest to use
zbsniff in this tree, talking to an
Ikea device on
/dev/ttyACM0, which will output a PCAP file
on stdout. You can pipe this to
wireshark to trace what
is going on:
zbsniff | wireshark -k -i -
However, there is lots of "noise" in the Zigbee protocol with repeat messages, acks, etc that make the wireshark display messy.
Don't display acks:
!(wpan.frame_type == 0x2)
Don't display repeats:
(!(wpan.frame_type == 0x1) || wpan.src16 == zbee_nwk.src)