Taipower Bimonthly Energy Cost homeassistant下载 - Taipower Bimonthly Energy Cost homeassistant代码下载

Taipower Bimonthly Energy Cost homeassistant

PowerBuilder

v0.53.7

下载

Taipower-Bimonthly-Energy-Cost-homeassistant

Calculate Taipower (Taiwan Power Company) bi-monthly (60 days) bill amount from kWh sensor on Home Assistant.
在Home Assistant (HA) 内以kWh sensor (千瓦⋅时电度传感器) 计算每期(60日历天) 电费帐单金额.
请注意**目前只支援"非時間電價-非營業用的表燈用電" 計費** 模式.
**可支援多次設定, 增加多個台電電表來源分別計算**

1) Install by HACS - 使用HACS 安装

1.1) 推荐使用HACS 安装:

请在HACS 的Integrations内搜索Taipower bimonthly cost并安装后,
依照UI 提示安装即可:

UI 第一行请输入要引用为电费计算的"即时kWh" 的utility meter sensor (请看本说明下方附录I 章节了解如何增设utility meter).
UI 第二行请输入本期电费计算周期的第一天的日期(格式为YYYY-MM-DD, 此为过去的日期, 俗称的上次抄表日期, 而非未来的下次抄表日期).

之后即可使用sensor.<您在設定UI 第一行輸入的傳感器名稱>_power_cost显示本期电费统计, 并可使用sensor.<您在設定UI 第一行輸入的傳感器名稱>_kwh_cost给HA 内建的能源面板作为独立电费单价来源作为个回路(设备) 单独计算电费使用(请看本说明下方附录章节).
(例如您UI 第一行输入"sensor.AA", 完成后可使用"sensor.sensor_AA_power_cost" 与"sensor.sensor_AA_kwh_cost")

2) Manual Install - 手动安装(推荐使用第1 章节的HACS 安装日后更新方便很多)

2.1) 手动安装(推荐使用第1 章节的HACS 安装日后更新方便很多):

下载本专案档案后解压缩, 拷贝custom_components到您Home Assistant 内的configuration 目录下(通常是config ),
目录结构看起来会像如下:

 <config directory>/
|-- custom_components/
|   |-- taipower_bimonthly_cost/
|       |-- __init__.py
|       |-- config_flow.py
|       |-- const.py
|       |-- etc...
|           |-- translations
|           |-- etc...

2.2) 然后重启(reboot) Home Assistant:

接下来请重新启动(reboot) HA.

2.3) 于Home Assistant 内新增整合元件:

请至HA 内的设定-> 装置与服务-> 整合-> 新增整合(位于右下角的按钮) -> 于跳出的设定整合选单内搜索Taipower bimonthly cost并安装. 之后依照UI 提示进行即可:

UI 第一行请输入要引用为电费计算的"即时kWh" 的utility meter sensor (请看本说明下方附录I 章节了解如何增设utility meter).
UI 第二行请输入本期电费计算周期的第一天的日期(格式为YYYY-MM-DD, 此为过去的日期, 俗称的上次抄表日期, 而非未来的下次抄表日期).

之后即可使用sensor.sensor_<您在設定UI 第一行輸入的傳感器名稱>_power_cost显示本期电费统计, 并可使用sensor.sensor_<您在設定UI 第一行輸入的傳感器名稱>_kwh_cost给HA 内建的能源面板作为独立电费单价来源作为个回路(设备) 单独计算电费使用(请看本说明下方附录章节).
(例如您UI 第一行输入"sensor.AA", 完成后可使用"sensor.sensor_AA_power_cost" 与"sensor.sensor_AA_kwh_cost")

Appendix I (附录I): 如何新增即时kWh 的`utility meter` sensor 作为能源计算引用?

请在configuration.yaml内加入总用电utility meter , 程式码如下:

 utility_meter :
  bimonthly_energy :
    source : sensor.total_power # 這是您想用來計算電費的 kWh 來源傳感器.

如此即可在设定UI 的第一行输入sensor.bimonthly_energy作为电费计算功能的计算来源.

Appendix II (附录II): How to convert from W to kWh - 如何将W 转换为kWh?

一般来说大部分的电量侦测硬体是回传W (瓦特), 如果想要将W 转换为电度kWh 给utility meter使用的话,
可于configuration.yaml内的sensor:段落内加入如下的程式码即可完成转换工作:

  - platform : integration
    source : sensor.your_W_sensor # 這是您原始的用電 "W (瓦特)" 偵測器.
    name : total_power # 這是要交給 utility meter 的名稱.
    unit_prefix : k
    method : trapezoidal
    round : 3

Appendix III (附录III): How to work with new Home Assistant (After 2021.8.0) build-in Energy function?

从Home Assistant 2021.8.0 版以后新增了内建的"能源" 面板功能, 可以分别计算每日用电与每日电费, 配合新增上述1.2 项次的程式后,
只要于HA 主页左侧能源面板-> 能源面板内右上角三个小点(设定) -> 能源设定-> 电网耗能-> 编辑耗能(铅笔图示) -> 新增项目内选择独立价格实体-> 于下拉选单内选择sensor.(初始设定输入sensor名称)_kwh_cost (目前电度单价) 后按下储存即可.
(注意: 能源面板最多需要2 个小时后才会开始显现数值, 给HA 一点计算时间的耐心)

Appendix IV (附录IV): Use old fully manual setup method, but it WITH auto notify function!

如果您对Home Assistant 里面的各种手动设定熟悉, 可以使用旧的全手动设定, 好处是您可以获得在每期电费结算时会自动推播本期电费费用与用电度数的讯息功能!
设定方法请参考以下连结内的旧版使用说明:
https://github.com/cnstudio/Taipower-Bimonthly-Energy-Cost-homeassistant/blob/main/Docs/old_manual_readme.md

展开

附加信息