SLZB-07/Px/MGx

USB coordinators SLZB-07x series

Zigbee2MQTT setup

Prerequisites:

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:

Device update

Update using the web tool

SLZB-07/MGx:


If you get an error:

TIP: You can insert a screwdriver near the antenna to make it easier to disassemble the case.

image.png

SLZB-07pX:

If you get error:

image.png

Update using third-party tools

Flashing via Home Assistant addons

SLZB-07/MGx; https://github.com/home-assistant/addons/tree/master/silabs_flasher
Example config:

image.png

SLZB-07Px: https://github.com/tube0013/tubeszb_addons/tree/main/tzb-cc2652-flasher/
Example configuration:

image.png

Community firmware

SLZB-07/MGx


SLZB-07P7

SLZB-07P10

Sorry, there is no community firmware at this time.

Zigbee Router mode

General information:

image.png

USB stick in Zigbee router mode expands your existing Zigbee network:

Important: you need to pair the stick to your Zigbee network for it to start working as Zigbee router

Configuring device as Zigbee router

Flashing router firmware

Manuall pairing activation

If after flashing the device did not pair or you need to pair the device in another location, you can do this!

SLZB-07/MGx:
SLZB-07Px:

Troubleshooting

Сoordinator does not detect the dongle

The dongle appears offline after a while

This may not be true. Z2M marks ZigBee devices as offline if they do not report anything for a long time, but the router firmware has nothing to report (the device does not have any sensors) so the system may mark it as offline.

If the device is truly offline, all devices that were connected through it will become unavailable.

If the device offline then the most likely reason is that it is outside the coverage area of ​​your Zigbee network.

Thread setup

Addon setup

  1. Flash the Thread firmware. Please follow this manual for device update instructions https://smlight.tech/support/manuals/books/slzb-07pxmgx/page/device-update
  2. Install the OTBR addon into your Home Assistant OS (HAOS)

    image.png
    If your HA is installed in docker you can try this docker container https://hub.docker.com/r/bnutzer/otbr-tcp

  3. Complete the settings:
    In the "Device" option, select the serial port of your dongle.
    In the "Baudrate" option, select 460800.
    - For SLZB-07/Mg24/MG26
    Hardware flow control: ENABLED

    - For SLZB-07p7/p10
    Hardware flow control: DISABLED
  4. Run the addon

System setup

Setting Up the Matter add-on and Integration

  1. Go to the Home Assistant interface and navigate to Settings > Devices & Services.
  2. Click on Add integration and search for Matter.
  3. Keep checkbox Use the official Matter Server Supervisor add-on and click Submit.
  4. Wait untill installation of Matter Integration and Matter Server add-on is completed.
  5. Head over to the Left panel within Home Assistant and Click Settings and choose Add-ons. Go to the Matter Server add-on. Start the Matter Server add-on. Here we would suggest as well to click both Start on boot and Watchdog.

Set-up and configuring the Integrations

  1. Now, let's install the required integration: Thread and OpenThread Border Router.
  2. Go back to the Home Assistant interface and navigate to Settings > Devices & Services.
  3. Basically, all two should be autodiscovered so you just need to configure them. If they are not, click on Add integration and search for them there.
  4. OpenThread Border Router – no configurations, just add.
  5. Thread Integration – click Configure and make sure you have OpenThread Border Router under Preferred network line, and it contains an icon with key+phone. If not, do the following:
  1. Start the add-on. Here we would suggest as well to click both Start on boot and Watchdog.

Reboot your Home Assistant server

  1. Once all Home Assistant components are installed, we reccomend to reboot your Home Assistant server.

Pre-set up your phone

  1. Install Home Assistant app on your Android phone from Play store. At the time of this video, we were unable to pair Matter-over-Thread device via iPhone.
  2. Install Google Home app from Play store. It is recommended by Home Assistant developers and we were not able to pair our Thread devices without installed Google Home app.
  3. Open Home Assistant app and sync it with your Home Assistant server. Your phone and Home assistant server should be in the same Wi-Fi network.
  4. In app, go to Settings – Companion app -> Click Troubleshooting and click Sync Thread Credentials.
  5. Wait until message Home Assistant and this device use the same network. If you see another message, namely Added network from Home Assistant to this device – you need to click on Sync Thread Credentials again, until you get that message about the same network.
  6. If you are not getting message Home Assistant and this device use the same network - try to reset your Google Play Services (remove all data, usually by App settings -> Erase data -> Clear All Data, but namings depend on the smartphone model).

Adding the Matter Device

  1. With the Matter integration set up, grab your Matter device and Android smartphone. Make sure Bluetooth is enabled on your phone.
  2. Open the Home Assistant app and navigate to Settings > Devices & Services -> Devices Tab.
  3. Click the + ADD DEVICE button at the borrom right part of the screen to add a device, choose Add Matter device.
  4. Follow the on-screen instructions in the app. You'll likely need to scan a QR code located on your Eve Energy socket or enter pairing code manually. We did it with QR-code scanning.
  5. Home Assistan app on your phone can as Which app to open? Select other and then Home assistant.
  6. The app will guide you through pairing the device with your Thread network. It should pass through this satuses:
  1. Note:

Verifying Connection and Control

  1. Once the pairing is complete, head back to the Home Assistant interface. You should see your Eve Energy socket listed on your Dashboard or under the Devices section .
  2. Click on the device to access its controls. You should be able to turn the socket on and off remotely within the Home Assistant interface.

Congratulations! You've successfully connected your Matter-over-Thread device to Home Assistant using the OpenThread Border Router and Matter Integrations. Now you can enjoy the benefits of Matter's secure and interoperable smart home ecosystem.

TIP:
You can refer to the Home Assistant documentation for Matter and Thread for more troubleshooting steps https://www.home-assistant.io/integrations/thread/