热水器实体

平台实体派生自homeassistant.components.water_heater.WaterHeaterEntity

特性

Tip

属性应该始终只从内存返回信息,而不执行 I/O(如网络请求)。实现 update()async_update() 来获取数据。

名称类型默认值说明
min_tempfloat110°F可设定的最低温度。
max_tempfloat140°F可设定的最高温度。
current_temperaturefloatNone当前温度。
target_temperaturefloatNone我们试图达到的温度。
target_temperature_highfloatNone我们试图达到的温度上限。
target_temperature_lowfloatNone我们试图达到的温度下限。
target_temperature_stepfloatNone可以增加或减少目标温度支持的步长。
temperature_unitstrNotImplementedErrorTEMP_CELSIUSTEMP_FAHRENHEITTEMP_KELVIN 之一。
current_operationstringNone当前的操作模式。
operation_listList[str]None可能的操作模式列表。
supported_featuresList[str]NotImplementedError支持的功能列表。
is_away_mode_onboolNone离开模式的当前状态。

允许的操作模式是基本组件中指定的状态,并且 water_heater 组件的实现不能不同。

属性必须遵循 temperature_unit 中定义的单位。

状态

状态说明
STATE_ECO节能模式,提供节能和快速加热。
STATE_ELECTRIC仅电动模式,消耗最多的能源。
STATE_PERFORMANCE高性能模式。
STATE_HIGH_DEMAND满足热水器尺寸较小时的高要求。
STATE_HEAT_PUMP加热速度最慢,但消耗的能量较少。
STATE_GAS仅天然气模式,使用最多的能源。
STATE_OFF热水器已关闭。

支持的功能

支持的功能通过使用 WaterHeaterEntityFeature 枚举中的值来定义 和 使用按位或 (|) 运算符进行组合。

说明
TARGET_TEMPERATURE温度可设定
OPERATION_MODE运行模式可设定
AWAY_MODE可设置离开模式
ON_OFF可以打开或关闭

方法

set_temperatureasync_set_temperature

设置热水器应将水加热到的温度。

set_operation_modeasync_set_operation_mode

设置热水器的运行模式。必须在操​​作列表中。

turn_away_mode_onasync_turn_away_mode_on

将热水器设置为离开模式。

turn_away_mode_offasync_turn_away_mode_off

将热水器设置回之前的运行模式。关闭离开模式。

turn_onasync_turn_on

打开热水器。

turn_offasync_turn_off

关闭热水器。