Zigbee Devices

Here's a full guide to adding Zigbee devices to your CUBE setup.

1. Install Zigbee Adapters

If you have followed the optional steps for Zigbee when installing CUBE, you can jump to Step 2 to initialize your dongle as your Zigbee network coordinator.

Before adding a Zigbee device, you need a Zigbee adapter, typically a USB dongle. Insert the Zigbee adapter into the USB port of the device running CUBE OS.

For Virtual Machine Users: After inserting the Zigbee adapter, add it to the virtual machine settings and restart CUBE. Detailed steps can be found in the virtual machine installation guide.

1.1 Compatible Adapters

CUBE is compatible with various Zigbee adapters from different manufacturers. It currently supports protocol stacks such as EZSP, Deconz, Zstack, and Zigate. Although any adapter supporting these protocol stacks can be used, the following are recommended:

  1. SONOFF ZBDongle-MAX

  2. SONOFF ZBDongle-PMG24

  3. SONOFF ZBDongle-LMG21

  4. SONOFF ZBDongle-E

  5. SONOF ZBDongle-P

  6. SMLIGHT SLZB-06 / 06M

  7. SkyConnect Zigbee (EZSP)

Others listed by developer @darkxst

2. Initialize Zigbee

1

To add a device, click the “Add Device” button on the device’s homepage.

2

Start pairing, and select “Continue Setup” in the pop-up window to automatically detect your inserted Zigbee adapter.

Once the adapter is automatically discovered, select the Zigbee adapter you wish to use from the list and click “Confirm” to complete the configuration.

3

If your Zigbee adapter is not detected, you may manually add it by inputting the necessary information:

  • Serial Path: Check the “All Hardware” section on the settings page for the serial port path of the inserted Zigbee adapter.

  • Protocol Stack Type: Currently supports EZSP, Deconz, ZStack, and Zigate. Check the adapter’s purchase site for the corresponding protocol stack type.

  • Port Speed: Optional, not applicable to all Zigbee adapters.

  • Data Flow: Optional, not applicable to all Zigbee adapters.

4

Submit the configuration by clicking confirm. If successful, you can add Zigbee devices. In case of a failure, check the specific error message.

Since a Zigbee network can only have one adapter configuration, multiple setups are not supported. If a configured adapter is removed and then reinserted, it will attempt to automatically restore itself without needing reconfiguration.

3. Add Zigbee Devices

1

After configuration, on the add device page, click “Start Pairing” to add Zigbee devices in pairing mode automatically.

If your Zigbee device is not found, ensure the device is in network configuration mode and check for excessive surrounding radio interference.

2

Discovered Zigbee devices will then be added to your CUBE OS, ready to assign a room or edit the name.

The total number of Zigbee devices that can be added is limited, depending on the adapter's hardware and firmware.

In certain cases, you need to add extra router devices (e.g. smart plugs, lights, signal repeaters) to add more battery-powered devices like sensors.

4. Potential Compatibility

CUBE is compatible with hundreds of Zigbee devices. However, substantial differences exist between products from different manufacturers due to the complexity and wide range of devices. This means compatibility with all devices cannot be guaranteed, but improvements will be made iteratively.

Please direct you to check the https://cube-web.ewelink.cc/ to check the compatibility.

PreviouseWeLink Wi-Fi DevicesNextMatter (Beta) Devices

Last updated