Request Device Support

Introduction

This page provides guideline to get new devices integrated and supported in the deCONZ REST-API.

Check Supported Devices

The first step should be checking if the device is already supported or in in investigation. The Supported Devices Wiki page provides information on already integrated devices and links to GitHub issues for ongoing device integration.

If the the device is listed and links to GitHub issues are present please use the existing issues for requests, comments and discussion.

Create New Device Request

If the new device is not listed under Supported Devices or no GitHub issue exits a new issue should be created, with the information as described below.

Required screenshots

• Clusters of the node, by clicking the right node circle
• Node Info Panel
• Basic cluster's attributes as shown in the Cluster Info Panel, with the data returned by read. Please note that at least "Manufacturer Name" and "Model Identifier" must be populated with data (therefore, must not be empty), otherwise that information will not be usable. For battery powered devices, after pressing read it is required to wake-up the device by pressing a button or any other means of interaction.
• Further clusters (if available) including Simple Metering, Electrical Measurement, Power Configuration, Thermostat. Again, please ensure data has been read prior to taking any screenshots.

In the following, you find examples of appropriate screenshots:

Screenshot of the Basic cluster

Screenshot of the Node Info Panel

Note to include a screenshot in a GitHub issue just copy it to clipboard and paste it in the GitHub issue editor.

Debug Output (optional upon request)

Debug prints provide further more detailed data on send and received commands. To enable verbose logging start deCONZ on the command line as follows:

$ deCONZ --dbg-info=1 --dbg-aps=1 --dbg-zcl=1 --dbg-zdp=1 --http-port=80