Skip to content

Configuration

José Antonio Jiménez Campos edited this page Apr 22, 2022 · 19 revisions

To configure your device, it is necessary to create a JSON string that contains all information about accessories, GPIOs, buttons, relays, sensors, LEDs, displays...

The JSON data has two sections:

Section Key Description
Config "c" Section containing all the objects & name / value pairs for configuration of the device
Accessories "a" Section containing all the accessory objects controlled by the device

JSON Layout

The JSON configuration is made of up two distinct sections:

{
  "c": {
    // Configuration options
  },
  "a": [
    // Accessories
  ]
}

Refer to the Config and Accessories for details on the options available for each of these sections.

JSON can be written in multiple lines, but it is highly recommended to use only a single line because it will result in a smaller in size and use less device memory.

NOTE: If you make changes in your JSON that involve accessory types, number of used accessories or change the order of them, you must check Reset HomeKit ID from within setup mode and remove your device from HomeKit; and then you must pair it again.

See here some examples and templates

Clone this wiki locally