补偿

补偿 integration集成将 Home Assistant 与您的设备、服务等连接和集成。 [Learn more] 从其他 sensors传感器返回有关事物的信息,例如水箱中的水位。 [Learn more] 中获取 state状态保存实体的感兴趣信息,例如灯是开还是关。每个实体只有一个状态,并且状态一次只保存一个值。但是,实体可以存储与该状态相关的属性,例如亮度、颜色或测量单位。 [Learn more]。它将补偿后的值作为状态导出到一个单独的 entity实体表示 Home Assistant 中的传感器、执行器或功能。实体用于监控物理属性或控制其他实体。实体通常是设备或服务的一部分。 [Learn more] 中,并将以下值作为属性导出:entity_idcoefficients。一个多项式(默认是线性)被拟合到提供的所有数据点中。

配置

要启用补偿传感器,请将以下行添加到您的 configuration.yamlconfiguration.yaml 文件是 Home Assistant 的主要配置文件。它列出了要加载的集成及其特定配置。在某些情况下,需要直接在 configuration.yaml 文件中手动编辑配置。大多数集成可以在 UI 中配置。 [Learn more] 文件中。 在更改了configuration.yamlconfiguration.yaml 文件是 Home Assistant 的主要配置文件。它列出了要加载的集成及其特定配置。在某些情况下,需要直接在 configuration.yaml 文件中手动编辑配置。大多数集成可以在 UI 中配置。 [Learn more] 文件后,重启 Home Assistant 以应用更改。 该集成现在显示在集成页面的 设置 > 设备与服务 下。其实体在集成卡片上以及实体标签上列出。

# 示例 configuration.yaml 条目
compensation:
  media_player_db_volume:
    source: media_player.yamaha_receiver
    attribute: volume_level
    unit_of_measurement: dB
    data_points:
      - [0.2, -80.0]
      - [1.0, 0.0]

  media_player_zone_2_db_volume:
    source: media_player.yamaha_receiver_zone_2
    attribute: volume_level
    unit_of_measurement: dB
    # 确保当源传感器的值小于 0.2 时,传感器的值不会低于 -80.0
    lower_limit: true
    # 确保当源传感器的值大于 1.0 时,传感器的值不会高于 0.0
    upper_limit: true
    data_points:
      - [0.2, -80.0]
      - [1.0, 0.0]

Configuration Variables

source string Required

要监控/补偿的实体。

data_points list Required

数据点转换的集合,格式为 [uncompensated_value, compensated_value]。例如,[1.0, 2.1]。所需的数据点数量等于多项式的 degree + 1。例如,线性补偿(degree: 1)至少需要 2 个数据点。

unique_id string (Optional)

唯一标识此传感器的 ID。将此设置为唯一值以允许通过用户界面进行自定义。

attribute string (Optional)

要监控/补偿的源属性。当省略时,将使用源的状态值。

degree integer (Optional, default: 1)

多项式的度数。例如,线性补偿 (y = x + 3) 的度数为 1,二次补偿 (y = x2 + x + 3) 的度数为 2,等等。

precision integer (Optional, default: 2)

定义计算值的精度,通过 round() 的参数。

unit_of_measurement string (Optional)

定义传感器的测量单位(如果有)。

lower_limit boolean (Optional, default: false)

启用传感器的下限。下限由数据集 (data_points) 的最低 uncompensated_value 定义。例如,如果最低的 uncompensated_value1.0,配对的 compensated_value0.0,则任何小于 1.0source 状态将产生补偿状态 0.0

upper_limit boolean (Optional, default: false)

启用传感器的上限。上限由数据集 (data_points) 的最大 uncompensated_value 定义。例如,如果最大的 uncompensated_value5.0,配对的 compensated_value10.0,则任何大于 5.0source 状态将产生补偿状态 10.0