Zigbee2MQTT setup
Prerequisites:
- SLZB-07x Zigbee USB coordinator.
- Computer or Raspberry Pi where Zigbee2MQTT or Home Assistant with ZHA will run.
- Home Assistant + ZHA or Zigbee2MQTT software installed.
Steps:
- Install Zigbee2MQTT
Follow the installation instructions for Zigbee2MQTT based on your system: https://www.zigbee2mqtt.io/guide/installation/ - Connect the Zigbee USB Coordinator:
Plug the SLZB-07x Zigbee USB coordinator into an available USB port on your computer or Raspberry Pi - Configure Zigbee2MQTT:
– Open the Zigbee2MQTT configuration file (usually located at /opt/zigbee2mqtt/data/configuration.yaml or similar).
– Find the section related to the coordinator configuration:
Configuration for SLZB-07/MGx
serial: port: /dev/ttyUSB0 # Specify the correct serial port for your coordinator rtscts: true adapter: ember
Some SLZB-07 dongles may have adapter: ezsp from facrory, you can update dongle to use ember
Configuration for SLZB-07pX
serial: port: /dev/ttyUSB0 # Specify the correct serial port for your coordinator rtscts: false adapter: zstack
– Ensure that the port matches the serial port where your coordinator is connected. The port might be different based on your system.TIP:
For homeassistant: Go to "Settings" → "System" → "Hardware" → Select the 3 dot menu in the upper right corner → "All Hardware" → Scroll to "ttyUSB" and find your adapter → Copy Device path like "/dev/serial/by-id/usb-*"
For linux: list USB devices via command: ls /dev/ttyUSB* - Start Zigbee2MQTT Service:
Start or restart the Zigbee2MQTT service to apply the changes made to the configuration file. - Pairing Devices:
Once Zigbee2MQTT is running and configured with the coordinator, you can start pairing Zigbee devices:
– Put your Zigbee devices (sensors, bulbs, etc.) into pairing mode according to their respective instructions.
– Use Zigbee2MQTT’s interface or command-line tools to initiate the pairing process. Follow the Zigbee2MQTT documentation for the specific commands or steps required. - Device Control and Monitoring:
After successfully pairing your devices, you can control and monitor them using Zigbee2MQTT’s interface or via MQTT messages, depending on your setup.
Additional Resources:
- Zigbee2MQTT Documentation: The official Zigbee2MQTT documentation provides detailed guides, troubleshooting tips, and a list of compatible devices https://www.zigbee2mqtt.io/