Digital I/O

Required Parameters

To add a digital input or a digital output device, such as pushbuttons or a LED status indicator, the following parameters are required.

id · string · required

A unique identifier for the device.

Example: pushbuttons

type · string · required

Indicates the type of device. For this type of device, it is always digitalInputOutput.

Example: digitalInputOutput

addressMap · string · required

The name of the device’s address map on the controller.

Example: pushbuttons_address_map

disabled · bool · required

Indicates whether the device is enabled or disabled. A value of true means the device is disabled, while false means the device is enabled.

Optional Parameters

The following parameters can be added to digital input or output devices; however, they are optional and not required. These parameters provide additional functionality to the device.

retainInputs · bool

This parameter indicates if the inputs should be retained or not. If true, when input changes state, it will keep the value for 10 seconds.

Note that this parameter is relevant only for digital inputs, not for outputs.

controlMap · string

The name of the device’s control map on the controller.

Example: indicators_rgb7_control

Example

The snippet below demonstrates two different digital input/output devices, highlighting both the required and optional parameters.

[
  {
    "id": "pushbuttons",
    "type": "digitalInputOutput",
    "addressMap": "pushbuttons_address_map",
    "retainInputs": true,
    "disabled": false
  },
  {
    "id": "indicators",
    "type": "digitalInputOutput",
    "controlMap": "indicators_rgb7_control",
    "addressMap": "indicators_address_map",
    "disabled": false
  }
]

When configuring a digital input or output device, ensure that all required parameters are correctly specified to avoid configuration errors. Optional parameters can provide additional functionality and control but are not necessary for basic operation. Always verify that the paths provided for addressMap and controlMap are accurate and that the files exist in the specified locations.