Important: This documentation covers Yarn 1 (Classic).
For Yarn 2+ docs and migration guide, see yarnpkg.com.

Package detail

homebridge-deconz-converter

pirstone86Apache-2.00.5.0TypeScript support: included

Homebridge plugin for converting Deconz roller shutters interpreted as light into Homekit Window Covering type.

homebridge-plugin, deconz, phoscon, conbee, dresden-elektronik, dresdenelektronik, roller-shutter, window-covering

readme

Homebridge Deconz Converter

This plugin is used to convert deCONZ accessories that are not light into their correct HomeKit type.

Accessories converted :

  • Roller shutters
  • NodOn Multifonctions module

Configuration

You must retreive you API Key to connect to you deCONZ instance. See here how to proceed.

Then list all lights and get uniqueId of all accessories you want to add with this request:

GET {{host}}/api/{{API_KEY}}/lights

Finally, use the plugin interface to fill information or fill config.json as below:

"platforms": [
  {
    "platform": "HomebridgeDeconzConverter",
    "host": "http://10.0.1.15",
    "apiKey": "AABBCCDDEE",
    "rollerShutters": [
      {
        "displayName": "Bedroom",
        "uniqueId": "20:92:8a:ff:ff:aa:e7:43-01"
      }
    ]
  }
]

Add as many roller shutters as you want in the rollerShutters array.

Development

TypeScript needs to be compiled into JavaScript before it can run. The following command will compile the contents of your src directory and put the resulting code into the dist folder.

npm run build

You can use watch to link the plugin to Homebridge and rebuild on each change.

npm run watch

Install globally Hombridge

npm i -g homebridge

Then run in a separate terminal the Homebridge server with the following parameters:

$ homebridge -D -I

Access to the Homebridge GUI at http://localhost:8080

changelog

CHANGELOG

0.4.0 (2023-11-18)

Added

  • Handle Contact Sensors devices

0.3.0 (2022-06-16)

Added

  • Add NodOn Multifonctions modules

0.2.0 (2022-01-05)

Added

  • Use WebSocket to get shutters position changes

0.0.1 (2022-01-05)

Initial commit