Binary Sensor Map¶
binary_sensor_map sensor platform allows you to map binary sensor
to values. When a given binary sensor is on, the value associated with it in this platform’s configuration will be published.
This sensor is mostly used for touch devices but could be used for any
binary_sensor that publishes its
Add your binary sensors as
channels to the binary sensor map. The binary sensor map then publishes a value depending
on the type of the binary sensor map and the values specified with each channel.
This platform currently supports two measurement types:
SUM, and others might get added later.
You need to specify which type of mapping you want with the
type: configuration value:
GROUPEach channel has its own value. The sensor publishes the average value of all active binary sensors.
# Example configuration entry sensor: - platform: binary_sensor_map id: group_0 name: 'Group Map 0' type: GROUP channels: - binary_sensor: touchkey0 value: 0 - binary_sensor: touchkey1 value: 10 - binary_sensor: touchkey2 value: 20 - binary_sensor: touchkey3 value: 30 # Example binary sensors using MPR121 component mpr121: id: mpr121_first address: 0x5A binary_sensor: - platform: mpr121 channel: 0 id: touchkey0 # ...
SUMEach channel has its own value. The sensor publishes the sum of all active binary sensors values.
# Example configuration entry sensor: - platform: binary_sensor_map id: group_0 name: 'Group Map 0' type: sum channels: - binary_sensor: bit0 value: 1 - binary_sensor: bit1 value: 2 - binary_sensor: bit2 value: 4 - binary_sensor: bit3 value: 8 binary_sensor: - platform: gpio pin: 4 id: bit0 - platform: gpio pin: 5 id: bit1 - platform: gpio pin: 6 id: bit2 - platform: gpio pin: 7 id: bit3 # ...
name (Required, string): The name of the sensor.
type (Required, string): The sensor type. Should be one of:
channels (Required): A list of channels that are mapped to certain values.
binary_sensor (Required): The id of the binary sensor to add as a channel for this sensor.
value (Required): The value this channel should report when its binary sensor is active.
All other options from Sensor.