homeassistant-tpi-thermostat

一个基于OpenTherm或EBUS协议的智能温控器。

功能

使用TPI算法智能控制锅炉的出水温度，节约供暖系统功耗并让室温更稳定（对冷凝炉+地暖效果更加，常规炉或暖气散热片也可以使用）
支持高温、低温上限（DEADHAND），超过或不足时退出TPI算法转为通断控制
可适配HA中各类温控器协议的接入方式，但是要求必须能够支持打开/关闭加热以及出水温度设置功能，以及接入一个温度传感器
支持TPI参数自适应、自学习（试验功能）

使用方法

将 custom_components文件夹拷贝到 home-assistant系统的/config目录下。

configuration.yaml的配置示例：

climate:
  - platform: tpi_thermostat
    name: heater_therm_new
    unique_id: climate.thermostat_tpi_test
    heater_switch: switch.thermostat_fake2
    keep_alive:
      minutes: 1
    target_sensor: sensor.cgllc_cgd1st_4d9d_temperature
    tempurature_input_entity: input_text.eb_ch_set
    target_temp: 23.5
    initial_hvac_mode: "off"
    cold_tolerance: 0.5
    hot_tolerance: 0.5
    auto_tpi: false
    tpi_kp: 0.966
    tpi_ti: 1100.0
    heater_temp_min: 40.0
    heater_temp_max: 65.0

配置参数

Key	Type	Required	Default	Description
`heater_switch`	string(entity_id)	yes	-	用于设置点火/供暖开关的switch entity
`target_sensor`	string(entity_id)	yes	-	用于测量室温的温度传感器，必须是一个sensor entity
`heater_temp_topic`	string	yes¹	-	用于设置水温的MQTT Topic名，如果设置了，就必须设置heater_temp_payload，如果设置了`tempurature_input_entity`就不要填写。
`heater_temp_payload`	string	yes¹	-	用于设置水温的MQTT Payload内容，原则上水温数值会加入到Payload之后，如此项设置为 'chset'，则将水温设置为55摄氏度系统会发送'chset55'到MQTT。如果设置了`tempurature_input_entity`就不要填写。
`tempurature_input_entity`	string(entity_id)	yes¹	-	一个TEXT_INPUT的entity id。会通过set_value服务将水温设置进入。可通过另行配置自动化联动实际的水温设置逻辑。如果填写了`heater_temp_topic`则此项无效。如果填写了此项，无需填写MQTT相关配置
`max_temp`	float	no	-	前端面板可设置的最高目标温度
`min_temp`	float	no	-	前端面板可设置的最低目标温度
`name`	string	no	autogenerated	温控器的显示名
`unique_id`	string	no	autogenerated	温控器在HA中的unique_id
`cold_tolerance`	float	no	0.5	目标温度下的控制宽度，建议保留默认值
`hot_tolerance`	float	no	0.5	目标温度上的控制宽度，建议保留默认值
`deadhand`	float	no	2	高低温上限，当室温超过或低于 deadhand/2 的时候，会自动停止TPI
`auto_tpi`	boolean	no	`true`	TPI参数（KP和TI）自动配置功能，实验室功能。如果开启，`tpi_kp`与`tpi_ti`参数会被忽略而通过一次通断控制自动测算
`tpi_kp`	float	no	0.966	建议参数为0.37-0.96之间，越是天气较冷或房屋保温效果较差的地方越大
`tpi_ti`	float	no	1100	建议参数为550-1100之间，越是天气较冷或房屋保温效果较差的地方越大
`heater_temp_min`	float	no	40	锅炉最低出水温度，地暖+冷凝炉建议设置为32-35度。常规炉建议设置在40-45度
`heater_temp_max`	float	no	70	锅炉最高出水温度，地暖建议设置为50-60度。常规炉+暖气片系统建议设置在60-70度
`target_temp`	float	no	-	系统重启时初始目标温度，根据需求设置。
`keep_alive`	timedelta	no	60 seconds	每一轮的控制周期的时间间隔，一般无需修改。

致谢

TPI算法和自动调参方法受到Ali, Saqib的论文 Development of tpi temperature control algorithm for thermostat for maximum comfort and high energy efficency ( https://www.politesi.polimi.it/handle/10589/196985?mode=complete ) 的启发

homeassistant-tpi-thermostat

A smart thermostat use tpi to control heater water temperature with EBUS or OpenTherm Protocal.

Features

Utilizes the TPI algorithm for intelligent control of the boiler's output water temperature, saving energy consumption in the heating system and stabilizing room temperature more effectively (especially beneficial for condensing boilers + underfloor heating, but also applicable to conventional boilers or radiators).
Supports high and low-temperature limits (DEADHAND); exceeds or falls short, the system switches from the TPI algorithm to on/off control.
Compatible with various thermostat protocols in HA (Home Assistant), requiring support for heating on/off and output water temperature setting, as well as integration with a temperature sensor.
Supports adaptive and self-learning TPI parameters (experimental feature).

How to Use

Copy the custom_components folder to the /config directory of your home-assistant system.

Example configuration in configuration.yaml:

climate:
  - platform: tpi_thermostat
    name: heater_therm_new
    unique_id: climate.thermostat_tpi_test
    heater_switch: switch.thermostat_fake2
    keep_alive:
      minutes: 1
    target_sensor: sensor.cgllc_cgd1st_4d9d_temperature
    tempurature_input_entity: input_text.eb_ch_set
    target_temp: 23.5
    initial_hvac_mode: "off"
    cold_tolerance: 0.5
    hot_tolerance: 0.5
    auto_tpi: false
    tpi_kp: 0.966
    tpi_ti: 1100.0
    heater_temp_min: 40.0
    heater_temp_max: 65.0

Configuration Parameters

Key	Type	Required	Default	Description
heater_switch	string(entity_id)	yes	-	The switch entity for setting the ignition/heating switch.
target_sensor	string(entity_id)	yes	-	The temperature sensor entity for measuring room temperature.
heater_temp_topic	string	yes¹	-	The MQTT Topic name for setting water temperature. If set, heater_temp_payload must also be set; if temperature_input_entity is used, do not fill this.
heater_temp_payload	string	yes¹	-	The MQTT Payload for setting water temperature. The temperature value is appended to the Payload; if set as 'chset', setting the temperature to 55°C would send 'chset55' to MQTT. If temperature_input_entity is used, do not fill this.
temperature_input_entity	string(entity_id)	yes¹	-	A TEXT_INPUT entity id. The water temperature is set via the set_value service. This can be linked with automation for actual water temperature setting logic. If heater_temp_topic is filled, this is ignored. If filled, MQTT configuration is not needed.
max_temp	float	no	-	The maximum target temperature that can be set from the frontend.
min_temp	float	no	-	The minimum target temperature that can be set from the frontend.
name	string	no	autogenerated	The display name of the thermostat.
unique_id	string	no	autogenerated	The unique_id of the thermostat in HA.
cold_tolerance	float	no	0.5	The control width below the target temperature, default value is recommended.
hot_tolerance	float	no	0.5	The control width above the target temperature, default value is recommended.
deadhand	float	no	2	The high/low temperature limits. When room temperature exceeds or falls below half of deadhand, TPI stops.
auto_tpi	boolean	no	true	Automatic configuration of TPI parameters (KP and TI), an experimental feature. If enabled, tpi_kp and tpi_ti are ignored and calculated automatically through a control cycle.
tpi_kp	float	no	0.966	Recommended parameter between 0.37-0.96, higher values for colder weather or less insulated homes.
tpi_ti	float	no	1100	Recommended parameter between 550-1100, higher values for colder weather or less insulated homes.
heater_temp_min	float	no	40	The minimum output water temperature for the boiler. For underfloor heating + condensing boilers, 32-35°C is recommended. For conventional boilers, 40-45°C.
heater_temp_max	float	no	70	The maximum output water temperature for the boiler. For underfloor heating, 50-60°C is recommended. For conventional boilers + radiators, 60-70°C.
target_temp	float	no	-	The initial target temperature when the system restarts. Set according to needs.
keep_alive	timedelta	no	60 seconds	The time interval for each control cycle, usually does not need modification.

Acknowledgments

The TPI algorithm and automatic tuning method were inspired by the paper by Ali, Saqib titled "Development of tpi temperature control algorithm for thermostat for maximum comfort and high energy efficiency" (https://www.politesi.polimi.it/handle/10589/196985?mode=complete).

sunfang1cn / homeassistant-tpi-thermostat Goto Github PK