Zigbee Gateway Hat for Raspberry Pi 3

From LinkSprite Playgound
Jump to: navigation, search


Linker ZigBee gateway module is one kind of Linker modules which can communicate with up to 32 ZigBee node devices. It is powered by Marvell 88MZ100 ZigBee microcontroller SoC chip. This ZigBee offers advantages for many application scenarios, including lighting control, smart metering, home/building automation, remote controls and health care applications.

Zigbee Gateway Hat 1.jpg

Zigbee Gateway Hat 2.jpg

Zigbee Gateway Hat 3.jpg

Zigbee Gateway Hat 4.jpg


  • Marvell MZ100 ZigBee SoC chip
  • A ZigBee compliant platform and IEEE802.15.4-2003/2006 transceiver
  • 32 bit ARM Cortex M3 microcontroller running at 32 or 64 MHz with Marvell’s proven peripheral IPs
  • On-chip DC-DC converter that can directly take input range from 2 volt to 3.6 volt
  • UART serial communication protocol
  • Linker port with 4 pins
  • 3.3V


we will show how to interface Deepcam ZigBee sensors to LinkSpriteIO using the Linker ZigBee gateway, and serves as a basic framework for home automation sensors application.


RaspBerry Pi x 1

ZigBee Gateway module x 1

ZigBee water leaking detector x 1

For simplicity, this tutorial uses only one ZigBee sensor: ZigBee water leak detector.


1. Register and login www.linksprite.com

Go to www.linksprite.io, create an account if you don’t have one, and login, create a DIY device. The type is 00(Custom device type). The device name and device group can be arbitrary. The following summarizes:

Go to www.linksprite.io

Create an account and login

Create a device with type 00, and arbitrary device name and group name.

Zigbee gateway V1.0 5.png

Obtain deviceID

Zigbee gateway V1.0 6.png

Obtain apikey

Zigbee gateway V1.0 7.png

2. Hardware connection

According to the following diagram to connect Raspberry Pi, ZigBee gateway and other equipment.

Zigbee gateway V1.0 8.png

3. Download the ZigBee gateway demo code

Turn on Raspberry Pi, open a terminal and download the zigBee gateway code from the github. We also need to modify thedeviceID and apikey with yours, run the code and add a ZigBee device.

Download source files

git clone https://github.com/delongqilinksprite/zigbee-raspberry.git

Modify apikey and deviceID using the ones obtained above.

    cd zigbee-raspberry          
    vim zigbee.py  

Zigbee gateway V1.0 9.png

Note: You have to install pyserial in the system.

4. Add the first device

Run the ZigBee.py program

python zigbee.py   

Zigbee gateway V1.0 10.png

Press and hold the RST pin hole of the water sensor until the green LED blink fast. Now we can start to add device by ‘Ctrl + C’:

Zigbee gateway V1.0 11.png

Zigbee gateway V1.0 12.png

Till now, we added water detector successfully to the ZigBee gateway. Now we can observe the status of the water detector onwww.linksprite.io web portal. Water detector is a water leakage detector, when we place it on the place that has water, we can see status change on the web portal.

Zigbee gateway V1.0 13.png

5. How to add more ZigBee devices

Follow the steps above, we have been able to add a device, and we continue to add other devices. In the case of ZigBee.py program:

Press and hold the reset for several seconds, the sensor’s Green LED flashing rapidly, enter the reset State Press Linker button add equipment,wait for complete When you are finished adding the device, get the zone type information, equipment added At this point, the gateway can already get sensor alarm information, and can be uploaded to the LinkSprite.io

More sensors can be found at here.