Skip to main content

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:

  1. Install Zigbee2MQTT
    Follow the installation instructions for Zigbee2MQTT based on your system: https://www.zigbee2mqtt.io/guide/installation/
  2. Connect the Zigbee USB Coordinator:
    Plug the SLZB-07x Zigbee USB coordinator into an available USB port on your computer or Raspberry Pi
  3. 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*

  4. Start Zigbee2MQTT Service:
    Start or restart the Zigbee2MQTT service to apply the changes made to the configuration file.
  5. 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.
  6. 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/