2025.3.4
首页 ▸ Integrations ▸

Sensibo

将 Sensibo 设备集成到 Home Assistant。

前提条件

请点击 这里 注册以获取 API 密钥。

Tip

如果您使用专用用户（而不是主用户）创建 API 密钥， 那么在 Sensibo 应用程序日志中，您将能够区分 应用程序中的操作和 Home Assistant 的操作。

配置

要将 Sensibo integration 添加到您的 Home Assistant 实例中，请使用此 My 按钮：

Sensibo 可以被 Home Assistant 自动发现。如果发现了实例， 它将显示为 已发现。您可以立即进行设置。

手动配置步骤

如果没有自动发现，请不要担心！您可以设置一个 手动集成条目：

二进制传感器

对于 motion sensors（支持 Sensibo Air 设备），此集成提供以下传感器：

  • 动作
  • 处于活跃状态
  • 主要传感器

对于气候设备，可以使用以下传感器：

  • 房间存在（对于带有附加运动传感器的 Air 设备）

对于 Pure 设备，可以使用以下传感器：

  • Pure Boost 启用
  • Pure Boost 连接到空调
  • Pure Boost 连接到存在
  • Pure Boost 连接到室外空气质量

对于所有设备，可以使用以下传感器：

  • 需要清洁过滤器

按钮

您可以通过使用气候设备上的按钮重置过滤器检查。

按下按钮时，您告诉设备您已清洁或更换过滤器。

数字实体

通过使用数字实体，您可以校准设备的温度和湿度。

这些实体默认情况下是禁用的。

选择实体

对于支持的设备，此集成提供对通过选择实体设置以下模式的支持：

  • 灯光

传感器实体

对于所有设备，这些传感器可用：

  • 过滤器上次重置
  • 体感温度
  • 定时器结束时间

对于运动传感器（支持 Sensibo Air 设备），此集成提供以下传感器：

  • 温度
  • 湿度

对于诊断，未在仪表板上自动显示，这些传感器可用于运动传感器：

  • 电压
  • Rssi

对于 Pure 设备，这些传感器可用：

  • PM2.5
  • Pure Boost 敏感度

对于 AirQ 设备，这些传感器可用：

  • TVOC
  • CO2

对于 Element 设备，这些传感器可用：

  • PM 2.5
  • TVOC
  • CO2
  • 乙醇
  • 空气质量

对于气候设备，这些传感器可用：

  • 气候反应低温阈值
  • 气候反应高温阈值

开关实体

对于气候设备，这些开关可用：

支持启用/禁用定时器以延迟启动或停止（根据当前状态）您的设备。

该开关使用 60 分钟的延迟定时器。您可以使用自定义 sensibo.enable_timer 操作选择自定义延迟。查看 定时器。

支持启用/禁用气候反应

使用气候反应开关的操作要求之前已在应用程序中配置该操作，或使用自定义 sensibo.enable_climate_react 操作。查看 气候反应

对于 Pure 设备，此集成提供启用/禁用 Pure Boost 的支持。

要自定义 Pure Boost 的设置，您可以使用自定义 sensibo.enable_pure_boost 操作。查看 Pure Boost

自定义操作

获取设备模式功能

由于以下自定义操作 完整状态 和 气候反应 都要求其输入与 API 要求完全一致，此自定义操作将为设备提供某个 HVAC 模式的功能，以帮助用户正确使用这些操作。

  1. 转到 开发者工具。
  2. 切换到 操作 页面。
  3. 使用 sensibo.get_device_capabilities 操作。
  4. 选择 climate 实体作为目标。
  5. 从可用列表中选择 hvac_mode。
  6. 选择 执行操作 以检索该特定 climate 实体每个功能的可用选项。

从提供的字典中，根据需要将区分大小写的选项复制到自动化或脚本中使用的其他操作调用中。

完整状态

您可以使用 sensibo.full_state 操作向 Sensibo 发送完整状态命令，而不是单个命令。

所有字段的要求必须符合 Sensibo API 规范，并且区分大小写。

Tip

使用 获取设备模式功能 操作提供功能列表。

假设状态

对于以其他方式控制或经常与 Sensibo 不同步的设备，有一个 sensibo.assume_state 操作。

使用此操作，您可以告诉 Sensibo 您的设备当前是否正在运行，而无需向您的设备发送新命令。

Pure Boost

您可以使用 sensibo.enable_pure_boost 操作配置您的 Pure Boost 设置。

  • 启用 Pure Boost 将启用具有配置设置的操作

使用 Geo 集成进行 Pure Boost 仅通过在应用程序中预先配置存在实现。

定时器

您可以使用提供的 sensibo.enable_timer 操作启用具有自定义延迟的定时器。

气候反应

您可以使用 sensibo.enable_climate_react 操作配置您的气候反应设置。

  • 配置此操作还会开启气候反应

使用该操作时，状态需要设置为 Sensibo API 所期望的确切内容。第一次推荐使用应用程序进行配置。

Tip

使用 获取设备模式功能 操作提供功能列表。

低阈值状态的示例：

on: true
fanLevel: "high"
temperatureUnit: "C"
targetTemperature: 23
mode: "cool"
swing: "fixedBottom"
horizontalSwing: "fixedLeft"
light: "on"

添加快速开关示例

如果您想要一个“快速开关”来打开/关闭您的空调，可以使用以下 Switch Template：

switch:
  - platform: template
    switches:
      ac:
        friendly_name: "空调"
        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"