Home Assistant HomematicIP Cloudreset_energy_counter 动作完全指南——重置计量实体的能耗计数器【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io本文以 Home Assistant 官方文档中的homematicip_cloud.reset_energy_counter动作文档为主体详解如何将 Homematic IP 计量实体measuring entity的能耗计数器归零包括从 UI 可视化配置到 YAML 声明式写法、唯一必填参数entity_id支持all关键字批量重置、仅管理员可调用的权限限制以及该动作在 HomematicIP Cloud 集成中的定位与周边动作的关系。读完本文你可以按月结算周期自动归零电能计量、批量重置所有计数器并理解该动作与 Homematic IP 云接入点Access Point的交互前提。动作概览把能耗计数器清零Reset energy counter动作YAML 标识为homematicip_cloud.reset_energy_counter所属域为homematicip_cloud的作用非常明确将 Homematic IP 计量实体的能耗计数器重置为 0。典型适用对象是插排式计量插座如HmIP-PSM等带电量统计的 Homematic IP 设备——它们在 Home Assistant 中会暴露为计量实体持续累加用电量。文档中声明了两条关键约束见 source/_actions/homematicip_cloud.reset_energy_counter.markdown仅限管理员使用该动作只能由 Home Assistant 管理员administrator调用不支持 targets不能通过 area/device/label 圈选目标必须通过Entity字段直接指定要重置的计量实体。从文档 frontmatter 的related_actions字段看该动作的关联动作是homematicip_cloud.set_active_climate_profile与homematicip_cloud.set_home_cooling_mode——它们同属 Homematic IP 云接入点的设备控制类动作但分属不同设备域能耗计量 vs. 气候模式切换说明reset_energy_counter是面向计量设备这一细分场景的专用动作而非通用的计数器操作。集成背景HomematicIP Cloud 是云推送型 Hub 集成理解该动作的前提需要知道 HomematicIP Cloud 集成的工作方式见 source/_integrations/homematicip_cloud.markdown集成类型为hubha_iot_class: Cloud Push——Home Assistant 不直连设备而是经由 Homematic IP 云服务器收发指令因此重置计数器这类命令实际上是下发给云端的远程操作支持的设备平台包括 Switch、Sensor、Binary sensor、Climate 等其中插排式开关与计量器HmIP-PS、HmIP-PSM系列会贡献 Switch 实体及其能耗计量能力——这正是reset_energy_counter的目标实体来源该集成自 HA 0.66 起提供支持配置流config flow添加也可在configuration.yaml中手动配置homematicip_cloud: - accesspoint: IDENTIFIER # 接入点 IDSGTIN authtoken: AUTHTOKEN # 用 hmip_generate_auth_token.py 生成的认证令牌文档特别注明所有作用于接入点的动作都接受可选的accesspoint_id参数即 SGTINSerialized Global Trade Item Number。单接入点安装可省略多接入点时可在集成页面顶部或接入点机身背面找到该 ID。reset_energy_counter同样遵循这一规则。从 UI 重置能耗计数器无需 YAML如果偏好可视化配置Home Assistant 会在自动化/脚本编辑器中逐步引导。完整操作步骤忠实继承自原文档进入SettingsAutomations scenes设置 自动化与场景打开一个已有自动化或脚本或选择Create automationCreate new automation若是新建自动化在When部分添加触发条件脚本不需要触发器它由其他机制调用在Then do部分选择Add action在搜索框中搜索并选择HomematicIP Cloud: Reset energy counter在Entity字段中输入要重置的计量实体点击Save保存。再次强调该动作不支持 targetsUI 中不会提示你选择区域、设备或标签唯一的目标定位手段就是Entity字段。UI 选项说明选项说明是否必填Entity要重置的计量实体。使用all关键字可一次性重置所有能耗计数器。是在 YAML 中使用 reset_energy_counter如果你直接编写 YAML或希望精确掌控调用参数在action步骤中以homematicip_cloud.reset_energy_counter引用该动作。原文档给出的基础示例如下action: | action: homematicip_cloud.reset_energy_counter data: entity_id: switch.livingroom这条动作将客厅计量实体的能耗计数器归零。在完整自动化中的典型用法例如每月 1 日零点批量清零所有计数器便于按自然月统计各回路用电量automation: - alias: 月初重置所有 Homematic IP 能耗计数器 triggers: - trigger: time at: 00:05:00 conditions: - condition: time weekday: - mon after: 00:00:00 actions: - action: homematicip_cloud.reset_energy_counter data: entity_id: all说明上面的完整自动化示例是在文档最小示例entity_id: switch.livingroom基础上结合文档明确支持的all关键字组合而成的编排示例最小示例本身可直接复制运行。YAML 参数参考参数类型必填说明entity_idstring是要重置的计量实体。传入all关键字时重置所有能耗计数器。文档未列出accesspoint_id作为该动作的必填参数结合集成文档的通用说明多接入点环境可参考其他接入点级动作的accesspoint_id约定SGTIN。使用前提、限制与验证方式权限限制动作仅限 Home Assistant 管理员调用。从文档表述看普通用户账户触发的自动化若包含此动作将不可用实体类型限制entity_id必须是 Homematic IP 的计量实体measuring entity例如带电量统计的计量插座对不支持能耗计量的实体调用该动作没有意义批量语义entity_id: all会重置全部能耗计数器而不仅仅是当前接入点的设备——在自动化中谨慎使用避免误清正在结算周期的计数云依赖由于集成走 Cloud Push 通道重置命令经由 Homematic IP 云端下发需保证接入点在线且云端连通正常接入点实体提供 cloud connection 状态可供排查自测方式不写 YAML 也能实测——打开SettingsToolsActions开发者工具 动作搜索homematicip_cloud.reset_energy_counter填入实体 ID 后点击Perform action即可在真实实体上观察计数归零效果。相关资源动作原文档source/_actions/homematicip_cloud.reset_energy_counter.markdownHomematicIP Cloud 集成总览含手动配置、设备支持清单、多接入点说明source/_integrations/homematicip_cloud.markdown同域接入点级动作可对照阅读activate_eco_mode_with_duration、set_active_climate_profile、set_home_cooling_mode动作页通用模板UI 引导、YAML 参考、Try it yourself、求助渠道等章节的渲染来源source/_includes/actions/ui_header.md、source/_includes/actions/yaml_header.md、source/_includes/actions/try_it.md遇到问题怎么办Home Assistant 社区提供快速答疑渠道Discord 实时聊天、社区论坛发帖时附上调用的动作和预期行为、以及 /r/homeassistant 版块。文档同时提示向 AI 助手描述你的需求也可以获得动作选择建议。【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Home Assistant HomematicIP Cloud：reset_energy_counter 动作完全指南——重置计量实体的能耗计数器
Home Assistant HomematicIP Cloudreset_energy_counter 动作完全指南——重置计量实体的能耗计数器【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io本文以 Home Assistant 官方文档中的homematicip_cloud.reset_energy_counter动作文档为主体详解如何将 Homematic IP 计量实体measuring entity的能耗计数器归零包括从 UI 可视化配置到 YAML 声明式写法、唯一必填参数entity_id支持all关键字批量重置、仅管理员可调用的权限限制以及该动作在 HomematicIP Cloud 集成中的定位与周边动作的关系。读完本文你可以按月结算周期自动归零电能计量、批量重置所有计数器并理解该动作与 Homematic IP 云接入点Access Point的交互前提。动作概览把能耗计数器清零Reset energy counter动作YAML 标识为homematicip_cloud.reset_energy_counter所属域为homematicip_cloud的作用非常明确将 Homematic IP 计量实体的能耗计数器重置为 0。典型适用对象是插排式计量插座如HmIP-PSM等带电量统计的 Homematic IP 设备——它们在 Home Assistant 中会暴露为计量实体持续累加用电量。文档中声明了两条关键约束见 source/_actions/homematicip_cloud.reset_energy_counter.markdown仅限管理员使用该动作只能由 Home Assistant 管理员administrator调用不支持 targets不能通过 area/device/label 圈选目标必须通过Entity字段直接指定要重置的计量实体。从文档 frontmatter 的related_actions字段看该动作的关联动作是homematicip_cloud.set_active_climate_profile与homematicip_cloud.set_home_cooling_mode——它们同属 Homematic IP 云接入点的设备控制类动作但分属不同设备域能耗计量 vs. 气候模式切换说明reset_energy_counter是面向计量设备这一细分场景的专用动作而非通用的计数器操作。集成背景HomematicIP Cloud 是云推送型 Hub 集成理解该动作的前提需要知道 HomematicIP Cloud 集成的工作方式见 source/_integrations/homematicip_cloud.markdown集成类型为hubha_iot_class: Cloud Push——Home Assistant 不直连设备而是经由 Homematic IP 云服务器收发指令因此重置计数器这类命令实际上是下发给云端的远程操作支持的设备平台包括 Switch、Sensor、Binary sensor、Climate 等其中插排式开关与计量器HmIP-PS、HmIP-PSM系列会贡献 Switch 实体及其能耗计量能力——这正是reset_energy_counter的目标实体来源该集成自 HA 0.66 起提供支持配置流config flow添加也可在configuration.yaml中手动配置homematicip_cloud: - accesspoint: IDENTIFIER # 接入点 IDSGTIN authtoken: AUTHTOKEN # 用 hmip_generate_auth_token.py 生成的认证令牌文档特别注明所有作用于接入点的动作都接受可选的accesspoint_id参数即 SGTINSerialized Global Trade Item Number。单接入点安装可省略多接入点时可在集成页面顶部或接入点机身背面找到该 ID。reset_energy_counter同样遵循这一规则。从 UI 重置能耗计数器无需 YAML如果偏好可视化配置Home Assistant 会在自动化/脚本编辑器中逐步引导。完整操作步骤忠实继承自原文档进入SettingsAutomations scenes设置 自动化与场景打开一个已有自动化或脚本或选择Create automationCreate new automation若是新建自动化在When部分添加触发条件脚本不需要触发器它由其他机制调用在Then do部分选择Add action在搜索框中搜索并选择HomematicIP Cloud: Reset energy counter在Entity字段中输入要重置的计量实体点击Save保存。再次强调该动作不支持 targetsUI 中不会提示你选择区域、设备或标签唯一的目标定位手段就是Entity字段。UI 选项说明选项说明是否必填Entity要重置的计量实体。使用all关键字可一次性重置所有能耗计数器。是在 YAML 中使用 reset_energy_counter如果你直接编写 YAML或希望精确掌控调用参数在action步骤中以homematicip_cloud.reset_energy_counter引用该动作。原文档给出的基础示例如下action: | action: homematicip_cloud.reset_energy_counter data: entity_id: switch.livingroom这条动作将客厅计量实体的能耗计数器归零。在完整自动化中的典型用法例如每月 1 日零点批量清零所有计数器便于按自然月统计各回路用电量automation: - alias: 月初重置所有 Homematic IP 能耗计数器 triggers: - trigger: time at: 00:05:00 conditions: - condition: time weekday: - mon after: 00:00:00 actions: - action: homematicip_cloud.reset_energy_counter data: entity_id: all说明上面的完整自动化示例是在文档最小示例entity_id: switch.livingroom基础上结合文档明确支持的all关键字组合而成的编排示例最小示例本身可直接复制运行。YAML 参数参考参数类型必填说明entity_idstring是要重置的计量实体。传入all关键字时重置所有能耗计数器。文档未列出accesspoint_id作为该动作的必填参数结合集成文档的通用说明多接入点环境可参考其他接入点级动作的accesspoint_id约定SGTIN。使用前提、限制与验证方式权限限制动作仅限 Home Assistant 管理员调用。从文档表述看普通用户账户触发的自动化若包含此动作将不可用实体类型限制entity_id必须是 Homematic IP 的计量实体measuring entity例如带电量统计的计量插座对不支持能耗计量的实体调用该动作没有意义批量语义entity_id: all会重置全部能耗计数器而不仅仅是当前接入点的设备——在自动化中谨慎使用避免误清正在结算周期的计数云依赖由于集成走 Cloud Push 通道重置命令经由 Homematic IP 云端下发需保证接入点在线且云端连通正常接入点实体提供 cloud connection 状态可供排查自测方式不写 YAML 也能实测——打开SettingsToolsActions开发者工具 动作搜索homematicip_cloud.reset_energy_counter填入实体 ID 后点击Perform action即可在真实实体上观察计数归零效果。相关资源动作原文档source/_actions/homematicip_cloud.reset_energy_counter.markdownHomematicIP Cloud 集成总览含手动配置、设备支持清单、多接入点说明source/_integrations/homematicip_cloud.markdown同域接入点级动作可对照阅读activate_eco_mode_with_duration、set_active_climate_profile、set_home_cooling_mode动作页通用模板UI 引导、YAML 参考、Try it yourself、求助渠道等章节的渲染来源source/_includes/actions/ui_header.md、source/_includes/actions/yaml_header.md、source/_includes/actions/try_it.md遇到问题怎么办Home Assistant 社区提供快速答疑渠道Discord 实时聊天、社区论坛发帖时附上调用的动作和预期行为、以及 /r/homeassistant 版块。文档同时提示向 AI 助手描述你的需求也可以获得动作选择建议。【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考