Skip to content

Commit

Permalink
Add Get device mode capabilities action to Sensibo (#36736)
Browse files Browse the repository at this point in the history
* Add Get device mode capabilities action to Sensibo

* Tiny style tweaks

---------

Co-authored-by: c0ffeeca7 <[email protected]>
  • Loading branch information
gjohansson-ST and c0ffeeca7 authored Jan 7, 2025
1 parent 1750ed6 commit 9c33a5d
Showing 1 changed file with 24 additions and 5 deletions.
29 changes: 24 additions & 5 deletions source/_integrations/sensibo.markdown
Original file line number Diff line number Diff line change
Expand Up @@ -147,17 +147,30 @@ To customize the settings of Pure Boost, you can use the custom `sensibo.enable_

## Custom actions

### Get device mode capabilities

As the below custom actions [Full state](#full-state) and [Climate react](#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.

1. Go to [Developer Tools](https://my.home-assistant.io/redirect/server_controls/).
2. Switch to the **Actions** page.
3. Use the `sensibo.get_device_capabilities` action.
4. Select the `climate` entity as the target.
5. Select the `hvac_mode` from the available list.
6. 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.

To see the options for each field to use this action:
{% tip %}

Use the [Get device mode capabilities](#get-device-mode-capabilities) action to provide a list of capabilities.

1. Switch to the relevant HVAC mode (not all HVAC modes have the same options).
2. Retrieve the options for `fan_modes` and `swing_modes` from the climate entity's attributes.
3. Retrieve the option set from the respective select entity for `horizontal_swing` and `light` if those are present.
{% endtip %}

### Assume state

Expand All @@ -183,7 +196,13 @@ You can configure your Climate React settings using the `sensibo.enable_climate_

- 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. From that point, you can see what the API requires and how to write from the Climate React switch attribute.
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.

{% tip %}

Use the [Get device mode capabilities](#get-device-mode-capabilities) action to provide a list of capabilities.

{% endtip %}

Example for low threshold state:

Expand Down

0 comments on commit 9c33a5d

Please sign in to comment.