POPP ZB-Shield was developed with Zigbee technology to control actuators and sensors as a self-powered Zigbee GPIO Adapter.

The technical specifications of ZB-Shield can be viewed at that link.

Get to know your POPP ZB-Shield

ZB-Shield Pinout

Below are the pinouts for the ZB-Shield.

Important safety information

Please read this and other device guides carefully. Failure to follow the recommendations set forth by POPP & CO. may be dangerous or cause a violation of the law. The manufacturer, importer, distributor, and/or reseller will not be held responsible for any loss or damage resulting from not following any instructions in this guide or in other materials.

Keep product away from open flames and extreme heat. Avoid direct sun light or heat exposure.


ZB-Shield is intended for indoor use in dry locations only. Do not use in damp, moist, and / or wet locations.

Quick start

Install ZB-Shield on Raspberry Pi

OS: Linux - Raspian "Stretch" or higher:


The ZB-Shield uses the same port as Bluetooth. To use ZB-Shield, you must deactivate Bluetooth before ZB-Sheild can form a connection to your RPi.

  • Open an SSH connection to your system, use Putty (Link), you can find out how to connect Putty to RPi in this link: SSH Putty to RPi.

    • Find the IP of your RPi by accessing your WiFi router interface (ie. is the most common ip login for a WiFi router, if you do not know, refer to your WiFi routers instruction manual).
    • Location the page listing all connected devices and their IP addresses.
    • Note down the IP of your raspberrypi

      In the above example image, the raspberrypi IP Address is "".

  • Enter the user "pi".
  • Enter your password "raspberry" (standard).
  • Now enter the following command.
sudo nano /boot/config.txt
  •  Add the following line depending on the hardware version of RPi that you are using.

Raspberry Pi 3


Raspberry Pi 4

  • Exit the Editor with Ctrl X and save with Y.
  • Reboot the system with:
sudo reboot
  • Login with SSH again, enter your username and password.
  • Check if the port ttyAMA0 is available with:
dmesg | grep tty


Compatible software and setup guides

In order for the ZB-Shield to be used with your software of choice, it must support Zigbee bridge library. Below is a list of all the known software that is compatible to ZB-Shield and how to set them up.