Home Assistant 中 Indevolt 电池充电动作indevolt.charge完整使用指南从 UI 配置到 YAML 自动化实战【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io导读indevolt.charge是 Home Assistant Indevolt 集成提供的核心能量管理动作用于以设定功率上限为一块或多块 Indevolt 储能电池启动充电直到达到目标荷电状态SOCState of Charge。本指南围绕 indevolt.charge 动作文档 展开覆盖 UI 可视化配置、YAML 字段完整参考、与indevolt.discharge的协同用法并结合仓库中的 Indevolt 集成文档 与官方 blueprint讲解如何在太阳能预测、峰谷电价等真实场景中落地自动化。读完本文你将能独立完成按时间/按电量条件触发充电、限功率充电至目标 SOC等实战配置。动作概述一次限功率、按目标 SOC 终止的充电控制indevolt.charge用于启动一个或多个 Indevolt 电池的充电流程关键特性有三点设定最大功率通过power参数限制充电功率上限单位瓦特避免瞬时大电流冲击或超出家庭供电能力目标 SOC 终止通过target_soc指定目标荷电状态百分比充电到达该值后自动停止实时控制模式自动切换每个涉及的设备在需要时会自动切换到实时控制模式real-time control mode确保 Home Assistant 下发的功率与 SOC 目标能够即时生效。从集成架构上看该动作属于 Indevolt 集成 面向设备device级控制的动作与之对应的放电动作是indevolt.discharge见相关动作文档两者互为充满/放空的一对操作配合使用即可实现完整的充放电策略编排。从用户界面创建充电自动化如果你的自动化或脚本通过 UI 构建Home Assistant 会逐步引导完成整个动作配置无需编写 YAML。参考 actions/ui_header.md 中的说明操作步骤如下进入设置 自动化与场景Settings Automations scenes打开现有自动化或脚本或选择创建自动化 创建新自动化Create automation Create new automation若是新建自动化先在When区域添加触发器脚本Script不需要触发器由其他流程调用时才执行在Then do区域选择添加动作Add action搜索并选择Indevolt: Charge在Device(s)字段中选择 Indevolt 设备然后设置Target SOC与Max. power点击保存Save。需要注意一个重要限制该动作不支持 targets目标选择器。在 UI 中你必须通过Device(s)字段直接勾选 Indevolt 设备而不能像其他动作那样按区域area、设备device、实体entity或标签label来选择目标。这一点同时适用于 YAML 中的device_id参数详见下文。UI 选项参考选项说明必填Device(s)要开始充电的 Indevolt 设备是Target SOC目标荷电状态百分比达到后停止充电是Max. power最大充电功率瓦特是YAML 字段完整参考如果直接编写 YAML或者想确切知道 Home Assistant 在底层做了什么可参考 actions/yaml_header.md 中所述的技术参考章节。动作在 YAML 中的名称为indevolt.charge基础示例来自 官方动作文档action: indevolt.charge data: device_id: a1b2c3d4e5f6 target_soc: 100 power: 1000以上配置的含义是以不超过 1000 瓦的功率为指定设备充电直到电量达到 100% 为止。字段参数表字段类型必填说明device_idstring / list是要开始充电的 Indevolt 设备可传单个字符串或字符串列表对应 UI 中的 Device(s) 字段target_socinteger是目标荷电状态取值 0100百分比充电达到该值后停止powerinteger是最大充电功率取值 02400瓦特从字段的取值范围可以看到两个硬性边界target_soc上限为 100充满即止power上限为 2400 W与 Indevolt 设备的额定功率能力一致。device_id同时支持列表类型意味着你可以通过一次动作调用同时为多块电池下发充电指令。这些参数在页面渲染时由 plugins/options_yaml.rb 等 Jekyll 插件解析最终以config-vars布局呈现为带 Required/Optional 徽标的参数表格与集成配置块复用同一套渲染逻辑。典型自动化示例清晨低谷时段为电池充满官方文档给出了一个非常实用的场景——每天早晨在家庭起床之前充电该自动化在 06:00 启动充电使电池在早晨用电高峰到来前储备充足电量用存储能量覆盖早晨的家庭用电而不是从电网取电。触发器时间 06:00动作Indevolt: Charge对应 YAMLautomation: alias: Charge battery every morning triggers: - trigger: time at: 06:00:00 actions: - action: indevolt.charge data: device_id: your_device_id power: 1000 target_soc: 80这里target_soc: 80表示不追求充满而是充到 80% 即停——在峰谷电价或夜间太阳能富余的场景中这是典型的按需充电策略既覆盖早晨需求又避免过度充电造成电池损耗。与放电动作配合完整能量管理闭环indevolt.charge与indevolt.discharge是一对互补动作见相关动作。放电动作的 YAML 形态几乎一致只是目标变为放空到指定 SOCaction: indevolt.discharge data: device_id: a1b2c3d4e5f6 target_soc: 10 power: 800官方放电示例的完整自动化如下——在傍晚高峰电价窗口放电避免从电网取电同时用条件保护电池不亏电automation: alias: Discharge battery during evening peak tariff triggers: - trigger: time at: 17:00:00 conditions: - condition: numeric_state entity_id: sensor.indevolt_battery_soc above: 30 actions: - action: indevolt.discharge data: device_id: your_device_id power: 800 target_soc: 20触发器时间 17:00条件电池 SOC 高于 30%动作Indevolt: Discharge以 800 W 放电至 20% SOC将两个示例串联即可构成早晨充到 80%、傍晚放至 20%的日常循环实现全天的削峰填谷。尝试执行与排障直接试运行如果只是想验证动作是否生效可参考 actions/try_it.md 的方式打开设置 工具 动作Settings Tools Actions搜索该动作填写字段后点击执行动作Perform action无需编写任何 YAML 即可在真实实体上观察效果。卡住时的排查建议按照 actions/stuck.md 的指引若动作未按预期工作可到 Home Assistant 社区论坛发帖附上正在调用的动作及预期结果也可以让 AI 助手根据你的自然语言描述推荐或解释正确的动作用法。进阶用官方 Blueprint 实现智能充放电仓库中的 blueprints/integrations/indevolt_smart_discharge.yml 展示了一个更复杂的生产级用法它不直接调用indevolt.discharge而是通过number.set_value动态调整电池的 AC 输出功率上限ac_output_limit实体实现按需放电。该 blueprint 的核心逻辑监听电表净功率net_power实体当净进口功率超过阈值默认 500 W持续 1 分钟时触发import分支在今日剩余光伏产量低于阈值默认 0.25 kWh夜间模式或日间且电池 SOC 高于 75%的条件下将 AC 输出上限调至放电功率默认 800 W当净出口功率低于阈值默认 0 W即开始向电网馈电时触发export分支将 AC 输出上限归零阻止向电网馈电。可见indevolt.charge/indevolt.discharge是一次性目标驱动的动作而number实体的功率上限控制则更适合持续、动态跟随电网状态的策略两者可组合使用。另一个官方 blueprint indevolt_manage_auto_emergency_soc.yml 则根据未来最低气温动态调整备用 SOC 目标温度低于 0°C 时把 SOC 目标设为 50%低于 5°C 设为 30%否则 10%——这是根据天气预报保护电池低温性能的典型自动化可通过number.set_value作用于 SOC 目标实体。相关动作与indevolt.charge配合效果最佳的相关动作如下Discharge启动 Indevolt 电池放电直到达到目标荷电状态。两者共享相同的参数模型device_id、target_soc、power只是目标方向相反建议成对阅读、组合使用。【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Home Assistant 中 Indevolt 电池充电动作（indevolt.charge）完整使用指南：从 UI 配置到 YAML 自动化实战
Home Assistant 中 Indevolt 电池充电动作indevolt.charge完整使用指南从 UI 配置到 YAML 自动化实战【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io导读indevolt.charge是 Home Assistant Indevolt 集成提供的核心能量管理动作用于以设定功率上限为一块或多块 Indevolt 储能电池启动充电直到达到目标荷电状态SOCState of Charge。本指南围绕 indevolt.charge 动作文档 展开覆盖 UI 可视化配置、YAML 字段完整参考、与indevolt.discharge的协同用法并结合仓库中的 Indevolt 集成文档 与官方 blueprint讲解如何在太阳能预测、峰谷电价等真实场景中落地自动化。读完本文你将能独立完成按时间/按电量条件触发充电、限功率充电至目标 SOC等实战配置。动作概述一次限功率、按目标 SOC 终止的充电控制indevolt.charge用于启动一个或多个 Indevolt 电池的充电流程关键特性有三点设定最大功率通过power参数限制充电功率上限单位瓦特避免瞬时大电流冲击或超出家庭供电能力目标 SOC 终止通过target_soc指定目标荷电状态百分比充电到达该值后自动停止实时控制模式自动切换每个涉及的设备在需要时会自动切换到实时控制模式real-time control mode确保 Home Assistant 下发的功率与 SOC 目标能够即时生效。从集成架构上看该动作属于 Indevolt 集成 面向设备device级控制的动作与之对应的放电动作是indevolt.discharge见相关动作文档两者互为充满/放空的一对操作配合使用即可实现完整的充放电策略编排。从用户界面创建充电自动化如果你的自动化或脚本通过 UI 构建Home Assistant 会逐步引导完成整个动作配置无需编写 YAML。参考 actions/ui_header.md 中的说明操作步骤如下进入设置 自动化与场景Settings Automations scenes打开现有自动化或脚本或选择创建自动化 创建新自动化Create automation Create new automation若是新建自动化先在When区域添加触发器脚本Script不需要触发器由其他流程调用时才执行在Then do区域选择添加动作Add action搜索并选择Indevolt: Charge在Device(s)字段中选择 Indevolt 设备然后设置Target SOC与Max. power点击保存Save。需要注意一个重要限制该动作不支持 targets目标选择器。在 UI 中你必须通过Device(s)字段直接勾选 Indevolt 设备而不能像其他动作那样按区域area、设备device、实体entity或标签label来选择目标。这一点同时适用于 YAML 中的device_id参数详见下文。UI 选项参考选项说明必填Device(s)要开始充电的 Indevolt 设备是Target SOC目标荷电状态百分比达到后停止充电是Max. power最大充电功率瓦特是YAML 字段完整参考如果直接编写 YAML或者想确切知道 Home Assistant 在底层做了什么可参考 actions/yaml_header.md 中所述的技术参考章节。动作在 YAML 中的名称为indevolt.charge基础示例来自 官方动作文档action: indevolt.charge data: device_id: a1b2c3d4e5f6 target_soc: 100 power: 1000以上配置的含义是以不超过 1000 瓦的功率为指定设备充电直到电量达到 100% 为止。字段参数表字段类型必填说明device_idstring / list是要开始充电的 Indevolt 设备可传单个字符串或字符串列表对应 UI 中的 Device(s) 字段target_socinteger是目标荷电状态取值 0100百分比充电达到该值后停止powerinteger是最大充电功率取值 02400瓦特从字段的取值范围可以看到两个硬性边界target_soc上限为 100充满即止power上限为 2400 W与 Indevolt 设备的额定功率能力一致。device_id同时支持列表类型意味着你可以通过一次动作调用同时为多块电池下发充电指令。这些参数在页面渲染时由 plugins/options_yaml.rb 等 Jekyll 插件解析最终以config-vars布局呈现为带 Required/Optional 徽标的参数表格与集成配置块复用同一套渲染逻辑。典型自动化示例清晨低谷时段为电池充满官方文档给出了一个非常实用的场景——每天早晨在家庭起床之前充电该自动化在 06:00 启动充电使电池在早晨用电高峰到来前储备充足电量用存储能量覆盖早晨的家庭用电而不是从电网取电。触发器时间 06:00动作Indevolt: Charge对应 YAMLautomation: alias: Charge battery every morning triggers: - trigger: time at: 06:00:00 actions: - action: indevolt.charge data: device_id: your_device_id power: 1000 target_soc: 80这里target_soc: 80表示不追求充满而是充到 80% 即停——在峰谷电价或夜间太阳能富余的场景中这是典型的按需充电策略既覆盖早晨需求又避免过度充电造成电池损耗。与放电动作配合完整能量管理闭环indevolt.charge与indevolt.discharge是一对互补动作见相关动作。放电动作的 YAML 形态几乎一致只是目标变为放空到指定 SOCaction: indevolt.discharge data: device_id: a1b2c3d4e5f6 target_soc: 10 power: 800官方放电示例的完整自动化如下——在傍晚高峰电价窗口放电避免从电网取电同时用条件保护电池不亏电automation: alias: Discharge battery during evening peak tariff triggers: - trigger: time at: 17:00:00 conditions: - condition: numeric_state entity_id: sensor.indevolt_battery_soc above: 30 actions: - action: indevolt.discharge data: device_id: your_device_id power: 800 target_soc: 20触发器时间 17:00条件电池 SOC 高于 30%动作Indevolt: Discharge以 800 W 放电至 20% SOC将两个示例串联即可构成早晨充到 80%、傍晚放至 20%的日常循环实现全天的削峰填谷。尝试执行与排障直接试运行如果只是想验证动作是否生效可参考 actions/try_it.md 的方式打开设置 工具 动作Settings Tools Actions搜索该动作填写字段后点击执行动作Perform action无需编写任何 YAML 即可在真实实体上观察效果。卡住时的排查建议按照 actions/stuck.md 的指引若动作未按预期工作可到 Home Assistant 社区论坛发帖附上正在调用的动作及预期结果也可以让 AI 助手根据你的自然语言描述推荐或解释正确的动作用法。进阶用官方 Blueprint 实现智能充放电仓库中的 blueprints/integrations/indevolt_smart_discharge.yml 展示了一个更复杂的生产级用法它不直接调用indevolt.discharge而是通过number.set_value动态调整电池的 AC 输出功率上限ac_output_limit实体实现按需放电。该 blueprint 的核心逻辑监听电表净功率net_power实体当净进口功率超过阈值默认 500 W持续 1 分钟时触发import分支在今日剩余光伏产量低于阈值默认 0.25 kWh夜间模式或日间且电池 SOC 高于 75%的条件下将 AC 输出上限调至放电功率默认 800 W当净出口功率低于阈值默认 0 W即开始向电网馈电时触发export分支将 AC 输出上限归零阻止向电网馈电。可见indevolt.charge/indevolt.discharge是一次性目标驱动的动作而number实体的功率上限控制则更适合持续、动态跟随电网状态的策略两者可组合使用。另一个官方 blueprint indevolt_manage_auto_emergency_soc.yml 则根据未来最低气温动态调整备用 SOC 目标温度低于 0°C 时把 SOC 目标设为 50%低于 5°C 设为 30%否则 10%——这是根据天气预报保护电池低温性能的典型自动化可通过number.set_value作用于 SOC 目标实体。相关动作与indevolt.charge配合效果最佳的相关动作如下Discharge启动 Indevolt 电池放电直到达到目标荷电状态。两者共享相同的参数模型device_id、target_soc、power只是目标方向相反建议成对阅读、组合使用。【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考