ARTICLE · INTELLIGENCE

战地情报 · 详情页

来自尧图项目组的一线实战观察与深度解析

PowerCalc 快速上手:不装智能插头,估算 Home Assistant 里每台设备的耗电量

PowerCalc 快速上手:不装智能插头,估算 Home Assistant 里每台设备的耗电量

PowerCalc 快速上手:不装智能插头,估算 Home Assistant 里每台设备的耗电量

【免费下载链接】homeassistant-powercalcHome Assistant Custom component to calculate estimated power consumption of lights and other appliances项目地址: https://gitcode.com/GitHub_Trending/ho/homeassistant-powercalc

家里几百盏灯在 Home Assistant 里能开关、能调光,但没有一盏能告诉你它现在到底用了几瓦电?PowerCalc 就是解决这件事的 Home Assistant 自定义组件:它用虚拟功率传感器估算灯光及其他用电设备的功耗,不需要智能插头,也不需要任何其他硬件。

项目定位:它吃什么、吐什么

一句话:把 HA 里已有的实体(灯、风扇、音箱等)和亮度、色温、风速等属性作为输入,输出虚拟功率(W)、能量(kWh)传感器,外加成本、电表和分组汇总传感器。适合家里智能设备很多、但没给每个设备配电表、又想看清电费花在哪的开发者。内置档案库收录了 600+ 份实测功率档案,以灯光为主,设备型号命中后开箱即用。

配置完成后,设备页面的 Sensors 区域会多出 Power 和 Energy 两个虚拟传感器:

安装与首次配置

两种安装方式,推荐 HACS:在 HACS 默认仓库中搜索powercalc安装。手动安装则:

git clone https://gitcode.com/GitHub_Trending/ho/homeassistant-powercalc cp -r homeassistant-powercalc/custom_components/powercalc /config/custom_components/

然后在configuration.yaml末尾加一行并重启 HA:

powercalc:

重启后进 设置 → 设备与服务,添加 powercalc 集成,选择 Global Configuration 按向导设置全局选项。之后 PowerCalc 会自动扫描整个 HA 实例,按制造商和型号匹配受支持的设备,并弹出提示让你创建传感器——向导里会直接显示已自动检测到的型号,比如下图中light.kitchen被匹配为 signify 的 LTW001,点 Next 确认即可:

预期结果:重启后对应设备的页面出现 Power 和 Energy 传感器,并且这些实体自动挂到设备页的 Sensors 分组里。如果没出现,去日志里搜 powercalc 相关报错。

策略速查表

设备不在档案库里时,需要自己写 YAML。常用写法对照如下:

YAML 写法含义作用
- entity_id: light.kitchen绑定的源实体最小配置,传感器挂在该设备上
manufacturer: signify+model: LTW001手动指定档案自动识别失败或强制使用某个 LUT
linear:内min_power: 0.5/max_power: 8按亮度在最小/最大功率间线性估算没有实测档案的可调光灯
fixed:内power: 20开启时固定 20 W只有开/关两态的电器
standby_power: 0.5关闭时的功耗待机能耗

一个完整最小示例——没有档案的落地灯,用 linear 策略估算:

powercalc: sensors: - entity_id: light.livingroom_floorlamp linear: min_power: 0.5 max_power: 8

重启后这盏灯下会出现虚拟 Power 和 Energy 传感器:亮度 50% 时按线性比例估算约 4.25 W,能量值随之积分累积,无需再写任何代码。

⚠️ 避坑与适用场景

  • 估算不是测量。档案库里的设备用默认的 LUT(查找表)模式最准;手动指定manufacturer/model时务必和实物一致,否则估算曲线是错的。
  • 传感器没出现时,开 debug 日志能看到完整发现过程,定位快很多:
logger: default: warning logs: custom_components.powercalc: debug
  • 新建的能量传感器出现在 Energy Dashboard 里可能要等最长 1 小时,属正常现象,别急着反复改配置。
  • 什么时候选它:想让全屋耗电可见、又不想给每个设备买智能插头。什么时候别选:需要计量级精度(比如电费分摊对账)时,还是用真实电表或智能插头的功率通道;设备在 HA 里完全没有实体可绑定时,先用智能插头实测,或自己测量后给档案库贡献一份 profile。

下一步

  1. 完整走一遍快速开始流程(含关闭自动发现):Quick Start
  2. 对照 lut / linear / fixed / composite 四种策略的完整参数:策略文档
  3. 翻一遍内置档案目录,确认自家设备是否已支持:profile_library/

【免费下载链接】homeassistant-powercalcHome Assistant Custom component to calculate estimated power consumption of lights and other appliances项目地址: https://gitcode.com/GitHub_Trending/ho/homeassistant-powercalc

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

RELATED READING

延伸阅读

更多一线实战笔记与深度复盘,助您持续精进