How to Use Zigbee with Raspberry Pi: Step-by-Step Guide

To use Zigbee with a Raspberry Pi, connect a Zigbee USB adapter (like the CC2531 or ConBee II) to the Pi, then install and configure software such as Zigbee2MQTT or deCONZ to manage Zigbee devices. This setup allows the Raspberry Pi to communicate with Zigbee sensors and smart devices wirelessly.

Syntax

Using Zigbee with Raspberry Pi involves these main parts:

• Zigbee USB adapter: Hardware that plugs into the Pi's USB port to send and receive Zigbee signals.
• Software: Programs like Zigbee2MQTT or deCONZ that control the adapter and connect Zigbee devices to the Pi.
• Configuration files: Settings files where you specify device details and network options.

bash

sudo apt update && sudo apt install -y git make gcc

# Clone Zigbee2MQTT repository
git clone https://github.com/Koenkk/zigbee2mqtt.git
cd zigbee2mqtt

# Install dependencies
npm ci

# Start Zigbee2MQTT
npm start

Example

This example shows how to install and start Zigbee2MQTT on Raspberry Pi with a CC2531 USB adapter.

It demonstrates updating the system, installing dependencies, cloning the Zigbee2MQTT software, and running it to connect Zigbee devices.

bash

sudo apt update && sudo apt upgrade -y
sudo apt install -y git curl build-essential

# Install Node.js (required for Zigbee2MQTT)
curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt install -y nodejs

# Clone Zigbee2MQTT
git clone https://github.com/Koenkk/zigbee2mqtt.git
cd zigbee2mqtt

# Install dependencies
npm ci

# Edit configuration.yaml to set serial port (e.g., /dev/ttyACM0)
# nano data/configuration.yaml

# Start Zigbee2MQTT
npm start

Output

[Info] Starting Zigbee2MQTT...
[Info] Coordinator firmware version: 20211201
[Info] Zigbee network started
[Info] MQTT connected
[Info] Waiting for devices to join...

Common Pitfalls

Common mistakes when using Zigbee with Raspberry Pi include:

• Not identifying the correct USB device path (e.g., /dev/ttyACM0 vs /dev/ttyUSB0).
• Missing dependencies like Node.js or build tools.
• Using incompatible Zigbee adapters or outdated firmware.
• Not configuring the software's configuration.yaml properly.

Always check device permissions and ensure the user has access to the serial port.

yaml

Wrong configuration example:
serial:
  port: /dev/ttyUSB1  # Incorrect port

Right configuration example:
serial:
  port: /dev/ttyACM0  # Correct port for CC2531

Quick Reference

Summary tips for using Zigbee with Raspberry Pi:

• Use a supported Zigbee USB adapter like CC2531 or ConBee II.
• Install Node.js 18+ before Zigbee2MQTT.
• Find your adapter's device path with ls /dev/tty*.
• Edit configuration.yaml to set the correct serial port.
• Run Zigbee2MQTT with npm start and watch logs for device joins.

Key Takeaways

Connect a compatible Zigbee USB adapter to Raspberry Pi to enable Zigbee communication.

Install and configure Zigbee2MQTT or deCONZ software to manage Zigbee devices.

Ensure the correct serial port is set in the configuration to avoid connection issues.

Install all required dependencies like Node.js before running Zigbee software.

Check device permissions and adapter firmware for smooth operation.