Generic hygrostat
The generic_hygrostat
humidifier integration集成将 Home Assistant 与您的设备、服务等连接和集成。 [Learn more] is a virtual hygrostat implemented in Home Assistant. It uses a sensor and a switch connected to a humidifier or dehumidifier under the hood. When in humidifier mode, if the measured humidity is less than the target humidity, the humidifier will be turned on and turned off when the required humidity is reached. When in dehumidifier mode, if the measured humidity is greater than the target humidity, the dehumidifier will be turned on and turned off when required humidity is reached. One Generic Hygrostat entity can only control one switch. If you need to activate two switches, one for a humidifier and one for a dehumidifier, you will need two Generic Hygrostat entities.
配置
要将 Generic hygrostat helper 添加到您的 Home Assistant 实例中,请使用此 My 按钮:
手动配置步骤
如果上述 My 按钮不起作用,您也可以手动执行以下步骤:
-
浏览到您的 Home Assistant 实例。
-
转到
设置 > 设备与服务。 -
在屏幕顶部,选择标签:Helpers。
-
在右下角,选择
创建助手 按钮。 -
从列表中选择 Generic hygrostat。
-
按照屏幕上的说明完成设置。
Configuration using our user interface provides a more limited subset of options, making this integration more accessible while covering most use cases.
If you need more specific features for your use case, the manual YAML-configuration section of this integration might provide them.
YAML configuration
Alternatively, this integration can be configured and set up manually via YAML
as well. To enable the generic hygrostat in your installation, add the
following to your configuration.yaml
configuration.yaml 文件是 Home Assistant 的主要配置文件。它列出了要加载的集成及其特定配置。在某些情况下,需要直接在 configuration.yaml 文件中手动编辑配置。大多数集成可以在 UI 中配置。 [Learn more] file:
# Example configuration.yaml entry
generic_hygrostat:
- name: Bedroom
humidifier: switch.humidifier_plug
target_sensor: sensor.outside_humidity
Configuration Variables
An ID that uniquely identifies this humidifier. Set this to a unique value to allow customization through the UI.
entity_id
for humidifier or dehumidifier switch, must be a toggle device.
entity_id
for a humidity sensor, target_sensor.state must be humidity.
Set initial target humidity. This value will be used as a fallback when the previous setpoint is not available.
Whether the switch specified in the humidifier option to be treated as a humidifier or a dehumidifier device. Must be either “humidifier” or “dehumidifier”
Set a minimum amount of time that the switch specified in the humidifier option must be in its current state prior to being switched either off or on.
Set a minimum amount of difference between the humidity read by the sensor specified in the target_sensor option and the target humidity that must change prior to being switched on. For example, if the target humidity is 45 and the tolerance is 3 the humidifier will start when the sensor equals or goes below 42. It is advised to set this parameter equal or above your sensor precision. This parameter is only used on target_sensor changes and is ignored on initialization, on manual operation or humidifier.turn_on
action.
Set a minimum amount of difference between the humidity read by the sensor specified in the target_sensor option and the target humidity that must change prior to being switched off. For example, if the target humidity is 45 and the tolerance is 3 the humidifier will stop when the sensor equals or goes above 48. It is advised to set this parameter equal or above your sensor precision. This parameter is only used on target_sensor changes and is ignored on initialization, on manual operation or humidifier.turn_on
action.
Set a keep-alive interval. If set, the switch specified in the humidifier option will be triggered every time the interval elapses. Use with humidifiers and dehumidifiers that shut off if they don’t receive a signal from their remote for a while. Use also with switches that might lose state. The keep-alive call is done with the current valid humidifier integration state (either on or off).
Set the initial state. This value is used as a fallback when a previous state is not available.
Set the humidity used by away
mode. If this is not specified, the mode feature will not be available.
If this parameter is set to True
, the target humidity for the away
mode is fixed at away_humidity
level and cannot be changed. An attempt to set the target humidity will effectively set the humidity for the normal
mode. This can be used to independently control mode and target humidity.
Time for min_cycle_duration
and keep_alive
must be set as “hh:mm:ss” or it must contain at least one of the following entries: days:
, hours:
, minutes:
, seconds:
or milliseconds:
. Alternatively, it can be an integer that represents time in seconds.
Full YAML configuration example
To be added to the configuration.yaml
configuration.yaml 文件是 Home Assistant 的主要配置文件。它列出了要加载的集成及其特定配置。在某些情况下,需要直接在 configuration.yaml 文件中手动编辑配置。大多数集成可以在 UI 中配置。 [Learn more] file.
generic_hygrostat:
- name: Bedroom
humidifier: switch.humidifier_plug
target_sensor: sensor.outside_humidity
min_humidity: 30
max_humidity: 70
target_humidity: 50
dry_tolerance: 3
wet_tolerance: 0
device_class: "humidifier"
min_cycle_duration:
seconds: 5
keep_alive:
minutes: 3
initial_state: true
away_humidity: 35
away_fixed: True
sensor_stale_duration: 00:15:00