EnergyZero

EnergyZero 集成可将 EnergyZero API 平台接入 Home Assistant。

该集成可从 EnergyZero 获取动态电价和燃气价格,帮助您了解当天的价格走势,并据此调整能源使用方式。

EnergyZero 的转售合作伙伴:

配置

此集成可通过 UI 配置。前往 设置 > 设备与服务 添加。

使用场景

能源仪表板 中,您可以使用 current hour 价格实体,根据 EnergyZero 的价格来计算每小时的用电或用气成本。您也可以将某个动作与模板传感器结合,在仪表板图表中显示未来 24 小时的价格。

数据更新

该集成每 10 分钟轮询一次 EnergyZero API,以更新 Home Assistant 中的数据。

已知限制

通过 API 获取的价格是包含增值税的基础价格,但能源公司通常还会收取其他费用,例如能源税采购成本。该集成没有提供将这些费用直接加入价格的配置选项,不过您可以为此创建一个模板传感器

传感器

EnergyZero 集成会为燃气价格和电价创建多个传感器实体。

电力市场价格

每天大约在 14:00 UTC,会发布次日的新价格。

  • currentnext hour 电力市场价格
  • 当日平均电价
  • 最低电价
  • 最高电价
  • 价格最高的时间点
  • 价格最低的时间点
  • 当前价格相对于最高价的百分比

燃气市场价格

对于动态燃气价格,只会创建显示 currentnext hour 价格的实体,因为燃气价格始终会固定 24 小时;新价格会在每天早上 05:00 UTC 发布。

动作

电价和燃气价格通过动作提供。这些动作会将价格数据填充到响应数据中。

动作:获取燃气价格

energyzero.get_gas_prices 动作可让您获取燃气价格。config_entry 的值可在 Developer toolsActions 选项卡中找到:选择目标实体后切换到 YAML 即可查看。

数据属性可选说明示例
config_entry要使用的配置条目 ID1b4a46c6cba0677bbfb5a8c53e8618b0
incl_vat定义价格是否包含增值税false
start获取价格的开始时间。默认为当天 00:00:002023-01-01 00:00:00
end获取价格的结束时间。默认为当天 00:00:002023-01-01 00:00:00
Tip

您可以在开发者工具中通过动作获取 config_entry:使用任一 EnergyZero 动作,然后查看 YAML。

响应数据

响应数据是一个字典,其中包含以字符串和浮点数形式表示的燃气时间戳与价格。

{
  "prices": [
    {
      "timestamp": "2023-09-25 03:00:00+00:00",
      "price": 1.1
    },
    {
      "timestamp": "2023-09-25 04:00:00+00:00",
      "price": 1.05
    }
  ]
}

动作:获取电价

energyzero.get_energy_prices 动作可让您获取电价。config_entry 的值可在 Developer toolsActions 选项卡中找到:选择目标实体后切换到 YAML 即可查看。

数据属性可选说明示例
config_entry要使用的配置条目 ID1b4a46c6cba0677bbfb5a8c53e8618b0
incl_vat定义价格是否包含增值税false
start获取价格的开始时间。默认为当天 00:00:002023-01-01 00:00:00
end获取价格的结束时间。默认为当天 00:00:002023-01-01 00:00:00
Tip

您可以在开发者工具中通过动作获取 config_entry:使用任一 EnergyZero 动作,然后查看 YAML。

响应数据

响应数据是一个字典,其中包含以字符串和浮点数形式表示的电力时间戳与价格。

{
  "prices": [
    {
      "timestamp": "2023-09-25 03:00:00+00:00",
      "price": 0.05
    },
    {
      "timestamp": "2023-09-25 04:00:00+00:00",
      "price": 0.12
    }
  ]
}

模板

您可以创建模板传感器,在图表中显示价格,或计算包含所有费用的每小时价格。

使用响应数据的价格传感器

要使用动作返回的响应数据,您可以创建一个每小时更新一次的模板传感器。

template:
  - trigger:
      - trigger: time_pattern
        hours: "*"
    action:
      - action: energyzero.get_energy_prices
        response_variable: prices
        data:
          config_entry: 1b4a46c6cba0677bbfb5a8c53e8618b0
          incl_vat: true
    sensor:
      - name: Energy prices
        device_class: timestamp
        state: "{{ now() }}"
        attributes:
          prices: '{{ prices }}'

含全部费用的价格传感器

要计算包含全部费用的每小时价格,您可以创建一个模板传感器,根据当前价格、能源税和采购成本进行计算。

template:
  - sensor:
      - name: EnergyZero all-in current price
        unique_id: allin_current_price
        icon: mdi:cash
        unit_of_measurement: "€/kWh"
        state_class: measurement
        state: >
          {% set energy_tax = PUT_HERE_THE_PRICE %}
          {% set purch_costs = PUT_HERE_THE_PRICE %}
          {% set current_price = states('sensor.energyzero_today_energy_current_hour_price') | float(0) %}
          {{ (current_price + energy_tax + purch_costs) | round(2) }}

移除集成

该集成遵循标准的集成移除步骤。如果您还使用了模板传感器,则需要手动将其删除。

To remove an integration instance from Home Assistant

  1. Go to Settings > Devices & services and select the integration card.
  2. From the list of devices, select the integration instance you want to remove.
  3. Next to the entry, select the three-dot menu. Then, select Delete.