Skip to main content

Home Assistant SkyConnect is a USB dongle supporting Zigbee and Thread/Matter. This guide covers common issues.

SkyConnect Not Detected

USB connection issues:

  • USB 2.0 port: Use USB 2.0 port - USB 3.0 causes interference
  • Extension cable: Use USB extension to move away from computer
  • Power: Ensure adequate USB power
  • HA restart: Restart Home Assistant after connecting
  • Check hardware: Settings > System > Hardware should show device

ZHA vs Zigbee2MQTT

Choosing Zigbee software:

  • ZHA: Built into Home Assistant, easy setup
  • Zigbee2MQTT: More device support, requires MQTT broker
  • Can't use both: Choose one - can't run both on same stick
  • Migration: Switching requires re-pairing all devices

Zigbee Devices Not Pairing

Pairing problems:

  • Permit join: Enable pairing in ZHA or Z2M
  • Reset device: Factory reset Zigbee device first
  • Close to stick: Pair devices close to SkyConnect
  • Interference: Keep away from WiFi router and USB 3.0
  • Channel: Change Zigbee channel if interference suspected

Thread/Matter Support

Using SkyConnect for Matter:

  • Multi-protocol: Can run Zigbee and Thread simultaneously
  • Thread border router: Enable Thread in SkyConnect settings
  • Matter devices: Add Matter-over-Thread devices
  • Firmware: Keep firmware updated for Matter support

Performance Optimization

Getting best results:

  • Central location: Position for best coverage
  • Add routers: Mains-powered devices extend mesh
  • Channel selection: Avoid WiFi channel overlap
  • Firmware updates: Check for SkyConnect firmware updates