Sensibo
Integrates Sensibo
Prerequisites
Please click here
If you create the API key using a dedicated user (and not your main user), then in the Sensibo app log you will be able to distinguish between actions done in the app and actions done by Home Assistant.
Configuration
To add the Sensibo integration to your Home Assistant instance, use this My button:
Sensibo can be auto-discovered by Home Assistant. If an instance was found, it will be shown as Discovered. You can then set it up right away.
Manual configuration steps
If it wasn’t discovered automatically, don’t worry! You can set up a manual integration entry:
-
Browse to your Home Assistant instance.
-
In the bottom right corner, select the
Add Integration button. -
From the list, select Sensibo.
-
Follow the instructions on screen to complete the setup.
Binary sensors
For motion sensors (supported by Sensibo Air devices), this integration provides the following sensors:
- Motion
- Alive
- Main sensor
For climate devices, these sensors are available:
- Room presence (for Air devices with an attached motion sensor)
For Pure devices, these sensors are available:
- Pure Boost Enabled
- Pure Boost linked with AC
- Pure Boost linked with Presence
- Pure Boost linked with Outdoor Air Quality
For all devices, these sensors are available:
- Filter Clean Required
Button
You can reset your filter check by using the button available on climate devices.
By pressing the button, you tell your device that you have cleaned or replaced the filter.
Number entities
By using the number entities you can calibrate the temperature and hunmidity of your device.
These entities are disabled by default.
Select entities
For supported devices, this integration provides support to set the following modes by the select entity:
- Light
Sensor entities
For all devices, these sensors are available:
- Filter last reset
- Feels Like
- Timer end time
For motion sensors (supported by Sensibo Air devices), this integration provides the following sensors:
- Temperature
- Humidity
For diagnostics, not automatically displayed on dashboards, these sensors are available for motion sensors:
- Voltage
- Rssi
For Pure devices, these sensors are available:
- PM2.5
- Pure Boost Sensitivity
For AirQ device, these sensors are available:
- TVOC
- CO2
For Element device, these sensors are available:
- PM 2.5
- TVOC
- CO2
- Ethanol
- Air quality
For climate devices, these sensors are available:
- Climate React low temperature threshold
- Climate React high temperature threshold
Switch entities
For climate devices, these switches are available:
Support to enable/disable a timer to delay a start or stop (depending on the current state) of your device.
The switch uses a timer of 60 minutes delay. You can choose a custom delay using the custom sensibo.enable_timer
action. See Timer.
Support to enable/disable Climate React
Usage of the Climate React switch requires that the action has been configured previously in the app or by using the custom sensibo.enable_climate_react
action. See Climate React
For Pure devices, this integration provides support to enable/disable Pure Boost.
To customize the settings of Pure Boost, you can use the custom sensibo.enable_pure_boost
action. See Pure Boost
Custom actions
Get device mode capabilities
As the below custom actions Full state and Climate react both require their inputs to be exactly what the API requires, this custom action will provide the capabilities for the device for a certain HVAC mode to help the users on using those actions properly.
- Go to Developer Tools.
- Switch to the Actions page.
- Use the
sensibo.get_device_capabilities
action. - Select the
climate
entity as the target. - Select the
hvac_mode
from the available list. - Select Perform action to retrieve the available options per capability for that particular
climate
entity.
From the provided dictionary, copy the case-sensitive options as needed into other action calls used in automations or scripts.
Full state
You can send a full state command to Sensibo instead of single commands using the sensibo.full_state
action.
All fields are required to be according to Sensibo API specifications and are case-sensitive.
Assume state
For devices which are also controlled in other ways or often goes out of sync with Sensibo there is a sensibo.assume_state
action.
With this action you can tell Sensibo if your device is currently running or not without sending a new command to you device.
Pure Boost
You can configure your Pure Boost settings using the sensibo.enable_pure_boost
action.
- Enable Pure Boost will enable the action with configured settings
Using Geo integration for Pure Boost is only possible by pre-configuration of Presence within the app.
Timer
You can enable a timer with a custom delay using the sensibo.enable_timer
action that is provided.
Climate React
You can configure your Climate React settings using the sensibo.enable_climate_react
action.
- Configuring this action also turns Climate React on
When using the action, the state needs to be set to precisely what Sensibo API expects. The first time it’s recommended to use the app to configure it.
Example for low threshold state:
on: true
fanLevel: "high"
temperatureUnit: "C"
targetTemperature: 23
mode: "cool"
swing: "fixedBottom"
horizontalSwing: "fixedLeft"
light: "on"
Adding a quick switch example
If you want a “Quick Switch” to turn your AC On / Off, you can do that using the following Switch Template
:
switch:
- platform: template
switches:
ac:
friendly_name: "AC"
value_template: "{{ is_state('climate.ac', 'cool') or is_state('climate.ac', 'heat') or is_state('climate.ac', 'dry') or is_state('climate.ac', 'fan_only') }}"
turn_on:
action: climate.set_hvac_mode
target:
entity_id: climate.ac
data:
hvac_mode: "cool"
turn_off:
action: climate.set_hvac_mode
target:
entity_id: climate.ac
data:
hvac_mode: "off"