Skip to content

Integrations

Integrations abstract how ControllerX receives the events from the controllers. Each integration is responsible for listening to a state, an event or an MQTT topic, and for decoding the controller events into actions that ControllerX understands.

These are the integrations supported by ControllerX.

Integrations with mappings

These integrations have a default mapping for specific controllers (see supported controllers).

Integration Configuration value
Zigbee2MQTT z2m
deCONZ deconz
ZHA zha
Homematic homematic
Lutron Caséta lutron_caseta
Shelly shelly
Shelly for HASS shellyforhass
Tasmota tasmota

Custom integrations

These integrations do not have a default mapping, so they are meant to be used with a custom mapping.

Integration Configuration value
State state
MQTT mqtt
Event event

Example

The integration name can be placed directly in the integration parameter:

example_app:
  module: controllerx
  ...
  integration: z2m
  ...

Or in the name parameter inside integration, in case you want to add other integration parameters:

example_app:
  module: controllerx
  ...
  integration:
    name: z2m
    listen_to: mqtt
  ...