Home Assistant 中用 tado.add_meter_reading 动作向 Tado Energy IQ 提交燃气/电表读数【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io在 Home Assistant 的 Tado 集成中tado.add_meter_reading动作用于把家用燃气表或电表的一次读数推送到 Tado Energy IQ 服务从而在 Tado 端追踪能耗并核算供暖费用。本文完整覆盖该动作的 UI 配置步骤、YAML 写法与参数说明并给出一个每日定时提交燃气表读数的自动化完整示例读完后你可以直接在自己的 Home Assistant 中复现这条传感器读数 → Tado 云的能耗上报链路。动作能做什么Add meter reading添加电表读数动作会把一条电表读数发送到 Tado Energy IQ。Energy IQ 是 Tado 提供的能耗追踪功能可以用来跟踪家庭能耗、掌握供暖成本的变化趋势。一个典型用法是编写一个自动化定期例如每天一次读取家里的燃气表或电表传感器然后把数值提交给 Tado。整条链路只涉及两个环节——Home Assistant 侧的能耗传感器如sensor.gas_consumption和 Tado 云端的 Energy IQ 账户不需要在本地维护任何额外的数据库。需要注意该动作的定位它不支持 target区域、设备、实体、标签都不需要也不可用。与其他需要指定entity_id的动作不同这个动作通过config_entryTado 配置条目来定位提交目标因为电表读数本身就是整个 Tado 家庭级别的账户数据与某个具体实体无关。从用户界面配置动作如果你偏好可视化地搭建自动化和脚本Home Assistant 的 UI 会逐步引导你完成该动作的配置全程无需手写 YAML。操作步骤如下前往SettingsAutomations scenes设置 自动化与场景。打开一个已有的自动化或脚本或选择Create automationCreate new automation创建自动化 创建新自动化。如果是新建自动化先在When当部分添加触发条件脚本不需要触发条件脚本是由其他流程调用时运行的。在Then do然后做部分点击Add action添加动作。在搜索框中搜索并选择Tado: Add meter reading。选择Config entry配置条目并填写Reading读数。点击Save保存。由于该动作不支持 target在 UI 中不会提示你选择区域、设备、实体或标签。UI 中的选项选项说明是否必填Config entry要把电表读数添加到哪个 Tado 配置条目是Reading电表读数单位为 m³ 或 kWh不能带小数是在 YAML 中调用在 YAML 中该动作的名称为tado.add_meter_reading。最基本的示例如下action: tado.add_meter_reading data: config_entry: ef2e84b3dfc0aee85ed44ac8e8038ccf reading: 1234关于config_entry的取值有一个实用技巧先在 UI 中把该动作配置好然后切换到 YAML 模式直接读取系统生成的配置条目 ID 即可无需到处翻找。YAML 中的选项选项说明类型是否必填config_entry要把电表读数添加到哪个 Tado 配置条目string是reading电表读数单位为 m³ 或 kWh不能带小数integer是两点值得留意reading的类型是integer即整数。如果你的传感器以 m³ 计且读数带小数提交前应做取整如 Jinja 的| int过滤器否则不符合参数要求。单位 m³ 或 kWh 由 Tado 账户侧的能耗类型决定动作本身只负责把数值送上去。实战示例每日定时提交燃气表读数下面这个自动化把燃气表读数在每天夜里提交到 Tado Energy IQalias: Submit daily gas reading to Tado triggers: - trigger: time at: 00:00:00 actions: - action: tado.add_meter_reading data: config_entry: ef2e84b3dfc0aee85ed44ac8e8038ccf reading: {{ states(sensor.gas_consumption) | int }}示例中的reading使用模板{{ states(sensor.gas_consumption) | int }}从sensor.gas_consumption实体读取当前累计值并用| int取整后提交。你可以把传感器换成自己家中实际的电表/燃气表实体把00:00:00换成合适的上报时刻。与 Tado 集成的关系及注意事项tado.add_meter_reading是 Tado 集成 提供的动作之一。了解底层集成对正确使用该动作很重要通信方式Tado 是一个 Hub 类集成通过 Tado 官方网站使用的非官方 APICloud Polling云轮询与 my.tado.com 通信。电表读数同样经由这条云端链路提交因此需要 Home Assistant 能正常访问 Tado 云端。认证方式自 2025 年 3 月 21 日起Tado 改用了设备码Device Code认证流程集成发起设备码并在浏览器中引导你到 Tado 认证服务器确认、登录完成授权。若集成提示重新认证按此流程操作即可。限流风险自 2026 年 1 月 1 日起Tado 对 API 实行了基于每日配额的严格限流且配额因订阅类型而异。若配额耗尽集成可能认证失败或无法接收新数据限流于每天 12:00CET重置。因此如果受限流影响可考虑在 Tado 集成文档中说明的自定义轮询间隔custom polling interval基础上减少不必要的轮询为提交读数这类写操作留出配额空间。动作成熟度从变更日志 core-2025.2 可以看到该动作在 2025.2 版本中修复过文案的复数错误Fix wrong plural on tado.add_meter_reading action说明它属于经过维护的正式动作而非实验性功能。相关的 Tado 动作该动作常与 Tado 集成提供的其他动作配合使用例如把每日提交能耗读数与按时段调节温度放在同一个供暖管理自动化里Set climate timertado.set_climate_timer让 Tado 温控实体如暖气片阀门在指定时长内加热到目标温度相当于手动 boost结束后恢复计划。Set water heater timertado.set_water_heater_timer对水加热器做类似的限时开关。Set climate temperature offsettado.set_climate_temperature_offset校准 Tado 温控设备的温度偏差可用一个位置更好的外部温度传感器来持续同步偏移量。小结tado.add_meter_reading是 Home Assistant 中把本地能耗传感器数据接入 Tado Energy IQ 的官方通道参数只有两个——config_entrystring必填和readinginteger单位 m³ 或 kWh 的整数读数必填且不带 target。推荐的做法是先在 UI 中配置好动作以获取配置条目 ID再切到 YAML 模式把reading替换为指向你家居能耗传感器的模板配合time触发器即可搭建一条稳定的每日能耗上报自动化。【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考