2025.3.4
首页 ▸ Integrations ▸

通用恒温器

generic_thermostat 气候 integration集成将 Home Assistant 与您的设备、服务等连接和集成。 [Learn more] 是在 Home Assistant 中实现的恒温器。它使用一个传感器和一个连接到加热器或空调的开关。当处于加热模式时，如果测量的温度低于目标温度，加热器将打开，并在达到所需温度时关闭。当在空调模式时，如果测量的温度高于目标温度，空调将打开，并在达到所需温度时关闭。一个通用恒温器实体只能控制一个开关。如果您需要激活两个开关，一个用于加热器，另一个用于空调，则需要两个通用恒温器实体。

配置

要将 通用恒温器 helper 添加到您的 Home Assistant 实例中，请使用此 My 按钮：

手动配置步骤

如果上述 My 按钮不起作用，您也可以手动执行以下步骤：

  • 浏览到您的 Home Assistant 实例。

  • 转到 设置 > 设备与服务。

  • 在屏幕顶部，选择标签：Helpers。

  • 在右下角，选择 创建助手 按钮。

  • 从列表中选择 通用恒温器。

  • 按照屏幕上的说明完成设置。

Note

使用我们的用户界面进行配置提供了一个更有限的选项子集，使该集成更易于访问，同时涵盖大多数用例。

如果您需要更具体的功能，手动的 YAML 配置部分 可能会提供它们。

YAML 配置

另外，此集成也可以通过 YAML 手动配置和设置。 要启用 integration集成将 Home Assistant 与您的设备、服务等连接和集成。 [Learn more]，您需要将其添加到您的 configuration.yamlconfiguration.yaml 文件是 Home Assistant 的主要配置文件。它列出了要加载的集成及其特定配置。在某些情况下，需要直接在 configuration.yaml 文件中手动编辑配置。大多数集成可以在 UI 中配置。 [Learn more] 文件中。 在更改了configuration.yamlconfiguration.yaml 文件是 Home Assistant 的主要配置文件。它列出了要加载的集成及其特定配置。在某些情况下，需要直接在 configuration.yaml 文件中手动编辑配置。大多数集成可以在 UI 中配置。 [Learn more] 文件后，重启 Home Assistant 以应用更改。 该集成现在显示在集成页面的 设置 > 设备与服务 下。其实体在集成卡片上以及实体标签上列出。

# 示例 configuration.yaml 条目
climate:
  - platform: generic_thermostat
    name: 书房
    heater: switch.study_heater
    target_sensor: sensor.study_temperature

Configuration Variables

Looking for your configuration file?
name string Required, default: 通用恒温器

恒温器的名称。

unique_id string (Optional)

唯一标识此恒温器的 ID。将其设置为唯一值以允许通过用户界面自定义。

heater string Required

用于加热器开关的 entity_id，必须是一个切换设备。当 ac_mode 设置为 true 时变为空调开关。

target_sensor string Required

温度传感器的 entity_id，target_sensor.state 必须是温度。

min_temp float (Optional, default: 7)

设置可用的最小设定点。

max_temp float (Optional, default: 35)

设置可用的最大设定点。

target_temp float (Optional)

设置初始目标温度。如果未设置此变量，则启动时目标温度将被设置为 null。从版本 0.59 开始，如果在重启前设置过目标温度，它会保留设置的目标温度（如果可用）。

ac_mode boolean (Optional, default: false)

将 heater 选项中指定的开关视为冷却设备而不是加热设备。

min_cycle_duration time | integer (Optional)

设置在切换为关闭或开启之前，heater 选项中指定的开关必须保持其当前状态的最短时间。如果设置了 keep_alive 选项，本选项将被忽略。

cold_tolerance float (Optional, default: 0.3)

设置target_sensor 选项中传感器读取的温度与目标温度之间必须变化的最小差异，才能切换开关。例如，如果目标温度是 25 且公差是 0.5，则当传感器等于或低于 24.5 时，加热器将启动。

hot_tolerance float (Optional, default: 0.3)

设置 target_sensor 选项中传感器读取的温度与目标温度之间必须变化的最小差异，才能切换关闭开关。例如，如果目标温度是 25 且公差是 0.5，则当传感器等于或高于 25.5 时，加热器将停止。

keep_alive time | integer (Optional)

设置保活间隔。如果设置，heater 选项中指定的开关将在每次间隔到期时触发。与在一段时间内未收到遥控信号而关闭的加热器和空调单元一起使用。也可与可能丢失状态的开关一起使用。保活调用是基于当前有效的气候集成状态（打开或关闭）。当设置 keep_alive 时，将忽略 min_cycle_duration 选项。

initial_hvac_mode string (Optional)

设置初始 HVAC 模式。有效值为 off、heat 或 cool。值必须用双引号括起来。如果未设置此参数，建议设置 keep_alive 值。这有助于对齐 generic_thermostat 和 heater 状态之间的任何差异。

away_temp float (Optional)

设置 preset_mode: away 使用的温度。

comfort_temp float (Optional)

设置 preset_mode: comfort 使用的温度。

eco_temp float (Optional)

设置 preset_mode: eco 使用的温度。

home_temp float (Optional)

设置 preset_mode: home 使用的温度。

sleep_temp float (Optional)

设置 preset_mode: sleep 使用的温度。

activity_temp float (Optional)

设置 preset_mode: activity 使用的温度。

precision float (Optional)

该设备所需的精度。可用于匹配您实际恒温器的精度。支持的值为 0.1、0.5 和 1.0。该值也用作设置目标温度的步长。

Default:

0.1 对于摄氏度和 1.0 对于华氏度。

target_temp_step float (Optional)

设置目标温度所需的步长。支持的值为 0.1、0.5 和 1.0。

Default:

等于 precision。

min_cycle_duration 和 keep_alive 的时间必须设置为 “hh:mm:ss”，或必须至少包含以下一个条目：days:、hours:、minutes:、seconds: 或 milliseconds:。或者，它可以是一个代表时间（以秒为单位）的整数。

当前 generic_thermostat 气候平台支持 ‘heat’、‘cool’ 和 ‘off’ HVAC 模式。您可以通过将 HVAC 模式设置为 ‘off’ 来强制您的 generic_thermostat 避免启动。

请注意，当将预设模式更改为外出时，您也会强制目标温度的变化，一旦预设模式再次设置为无，则会恢复该目标温度。

完整的 YAML 配置示例 

climate:
  - platform: generic_thermostat
    name: 书房
    heater: switch.study_heater
    target_sensor: sensor.study_temperature
    min_temp: 15
    max_temp: 21
    ac_mode: false
    target_temp: 17
    cold_tolerance: 0.3
    hot_tolerance: 0
    min_cycle_duration:
      seconds: 5
    keep_alive:
      minutes: 3
    initial_hvac_mode: "off"
    away_temp: 16
    precision: 0.1

相关主题