What You'll Need

Step-by-Step Setup

Use USB extension cable: Connect the dongle via a USB extension cable (at least 1 meter) to reduce interference from USB 3.0 ports.
Plug in the dongle: Connect to your Home Assistant server, Raspberry Pi, or computer running your smart home software.
Identify the device: In Linux, run "ls /dev/serial/by-id/" to find the dongle. It will appear as something like "usb-ITead_Sonoff_Zigbee_..."
For Zigbee2MQTT: Edit configuration.yaml and add the serial port path. Set adapter type to "ezsp" for the SONOFF dongle.
For Home Assistant ZHA: Go to Settings → Devices & Services → Add Integration → Zigbee Home Automation. Select the serial port.
Initialize the network: The software will create a new Zigbee network. This takes about a minute.
Set Zigbee channel: Choose a channel that doesn't conflict with your Wi-Fi (channels 15, 20, or 25 are often good choices).
Start pairing devices: Enable pairing mode in your software, then put your Zigbee devices into pairing mode.

Device not detected: Use USB extension cable to avoid USB 3.0 interference. Try a different USB port. Check dmesg/journalctl for connection messages.
Poor Zigbee range: Position antenna vertically. Add Zigbee router devices (powered switches, plugs). Move dongle away from other electronics.
Devices failing to pair: Move device within 5 feet of dongle during initial pairing. Factory reset the device first. Check if device is truly Zigbee (not Z-Wave).
Firmware update needed: Download latest firmware from SONOFF. Use zigpy-cli or cc2538-bsl to flash. Backup settings before updating.
Network instability: Change Zigbee channel to avoid Wi-Fi interference. Rebuild the network after adding router devices. Check for firmware updates.