hb-deconz-tools

Homebridge deCONZ Tools

Homebridge deCONZ Tools

Copyright © 2022-2024 Erik Baauw. All rights reserved.

This repository provides a standalone installation of the command-line utilities from Homebridge deCONZ:

• deconz, to discover, monitor, and interact with deCONZ gateways.
  See the deconz Command-Line Utility in the Wiki for more info.
• otau, to download and analyse over-the-air-upgrade firmware files for Zigbee devices.
  The firmware files are downloaded into the current directory from the zigbee-OTA repository, using the files names as expected by the deCONZ OTAU plugin.

Each command-line tool takes a -h or --help argument to provide a brief overview of its functionality and command-line arguments.

Prerequisites

You need a deCONZ gateway to connect the Homebridge deCONZ Tools to your ZigBee devices (lights, plugs, sensors, switches, ...). For Zigbee communication, the deCONZ gateway requires a ConBee II or Conbee USB stick, or a RaspBee II or RaspBee Raspberry Pi shield.
I recommend to run deCONZ with its GUI enabled, even on a headless system. When needed, you can access the deCONZ GUI over screen sharing.

The Homebridge deCONZ tools communicate with the deCONZ gateway using the local REST API, provided by its REST API plugin. These tools run independently from the Phoscon web app, see deCONZ for Dummies.