Home Assistant 中通过 keba.set_current 控制 Keba 充电桩最大充电电流【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io本文围绕 Home Assistant 官方文档仓库中 keba.set_current 行动文档 展开系统讲解如何通过该行动为 Keba 充电桩设置最大充电电流单位安培实现光伏余电跟随充电、夜间慢充、限流保护等场景。读完本文你将掌握keba.set_current在 UI 与 YAML 中的完整用法、参数取值范围与含义以及它与 Keba 集成的 failsafe故障保护模式、keba.set_energy、keba.set_failsafe等相关行动的配合方式。行动概述什么是 keba.set_currentkeba.set_current是 Home Assistant 中Keba Charging Station集成提供的一项行动action用于设置 Keba 充电桩的最大充电电流单位安培。通过限制电流你可以控制电动汽车的充电速度例如匹配光伏余电当太阳能发电充足时将电流调高余电不足时调低匹配家庭电网容量让充电电流保持在入户电表和线路的承载能力之内避免过载跳闸夜间慢充在谷电时段以较低电流温和充电保护电池并降低对电网的冲击。注意该行动会改变充电桩的运行状态使用前请务必确认操作后果谨慎调用。关于该集成的背景可参考 Keba Charging Station 集成文档该集成通过 UDP Smart Home 接口与 Keba P30/P20 充电桩含 BMW Wallbox通信数据轮询间隔默认 5 秒与官方 App 一致Keba P40 因采用不同协议暂不支持。使用前需按充电桩安装手册通过 DIP 拨码开关启用 UDP Smart Home 接口。通过 UI 界面设置最大充电电流若从自动化或脚本的界面流程中调用该行动操作步骤如下进入设置 自动化与场景Settings Automations scenes。打开现有的自动化或脚本或点击创建自动化创建新自动化。若是新建自动化需在When何时区域添加触发条件脚本无需触发器它们在被其他流程调用时运行。在Then do然后执行区域选择添加动作Add action。在搜索框中搜索并选择Keba Charging Station: Set currentKeba 充电桩设置电流。输入Current电流单位为安培。点击保存。需要注意该行动不支持 targets目标选择。在 UI 中不会提示你选择区域、设备、实体或标签行动直接作用于集成配置的那台充电桩。UI 中的选项选项说明Current电流最大充电电流单位安培。允许值范围6 A ~ 63 A设为0会停止正在进行的充电流程。必填。在 YAML 中使用 keba.set_current在 YAML 配置自动化、脚本、蓝图中行动名为keba.set_current。最基本的调用示例如下action: keba.set_current data: current: 16即把最大充电电流设置为 16 A。YAML 选项参数必填类型说明current是float浮点数最大充电电流单位安培。允许值范围6 A ~ 63 A设为0会停止正在进行的充电流程。current支持浮点数这意味着你可以在允许范围内做细粒度调节如 7.4 A、11.5 A 等对应不同功率等级的单相/三相充电。实战示例夜间自动限流充电原文档给出了一个典型场景——夜间降低充电电流在谷电时段23:00把最大电流调低让车辆整晚温和充电。触发条件时间23:00执行动作Keba Charging Station: Set current设置电流对应的完整自动化 YAML 如下automation: alias: Limit charging current at night triggers: - trigger: time at: 23:00:00 actions: - action: keba.set_current data: current: 10这段自动化在每天晚上 23:00 将最大充电电流降为 10 A适合配合峰谷电价策略使用。你可以把current: 10替换为你的电网容量、线路规格和充电需求允许范围内的任意值6~63或 0 停止充电。与 Keba 集成的其他行动配合使用keba.set_current并非孤立存在它常与 Keba 集成的其他行动协同工作形成完整的充电控制方案。以下行动文档均与本行动有相互引用关系设置目标电量keba.set_energykeba.set_energy用于设置当前充电会话的目标电量单位千瓦时kWh。当会话充到该电量后充电桩自动停止充电适合只补充固定电量而非充满的场景。参数energy目标电量类型 float允许0 ~ 100 kWh设为0表示禁用该电量上限。示例插入充电枪时自动补电 15 kWhautomation: alias: Add fixed energy when plugged in triggers: - trigger: state entity_id: binary_sensor.keba_charging_station_plug to: on actions: - action: keba.set_energy data: energy: 15配置故障保护模式keba.set_failsafekeba.set_failsafe用于配置充电桩的failsafe故障保护模式当 Home Assistant 停止向充电桩发送更新时充电桩会在超时后自动回退到设定的后备电流保证充电在无人监管的情况下安全继续。该行动包含三个参数参数类型说明failsafe_timeoutinteger超时秒数超过该时间未收到新的电流设置即应用后备电流。允许1 ~ 3600 秒0表示禁用 failsafe 模式。failsafe_fallbackfloat后备电流安培。允许6 A ~ 63 A0会停止正在进行的充电。failsafe_persistinteger是否把 failsafe 配置写入充电桩 EEPROM 永久保存1永久保存0仅保留到充电桩下次重启。关键提示来自原文档启用 failsafe 模式后必须在配置的超时时间内定期调用keba.set_current即本行动否则充电桩会应用后备电流。这正是keba.set_current与 failsafe 模式深度耦合的核心用法——set_current既是日常限流手段也是维持 failsafe 心跳的必要动作。手动请求数据keba.request_datakeba.request_data用于主动向充电桩请求一次数据更新让相关实体立即反映最新状态。该行动在 UI 与 YAML 中均无额外参数action: keba.request_dataKeba 行动家族全貌从 source/_actions 目录 可看到 Keba 集成的完整行动集除上述外还包括keba.authorize/keba.deauthorize授权/取消授权类似 RFID 卡刷卡keba.enable/keba.disable启用/禁用充电keba.request_data请求数据刷新集成层面的配置基础要让keba.set_current生效首先需在 configuration.yaml 中配置好 Keba 集成。最小配置# Example configuration.yaml entry keba: host: KEBA_HOST集成提供的可选配置项还包括配置项默认值说明host—Keba 充电桩主机地址必填rfid00845500用于授权的 RFID 标签failsafefalse是否在 Home Assistant 启动时启用 failsafe 模式failsafe_timeout30failsafe 超时秒数允许 10~600 秒仅在启用 failsafe 时生效failsafe_fallback6failsafe 后备电流A允许 6~630 表示完全停止充电仅在启用 failsafe 时生效failsafe_persist0是否将 failsafe 配置存入充电桩 EEPROM仅在启用 failsafe 时生效refresh_interval5从充电桩拉取数据的刷新间隔秒官方 App 同样为 5 秒值得注意的是集成配置文档中关于 failsafe_timeout 的说明也强调请确保在该超时周期内定期调用keba.set_curr行动——再次印证了keba.set_current在 failsafe 心跳机制中的核心地位注意集成文档中该处历史写法为keba.set_curr而当前行动规范命名为keba.set_current。版本与维护信息在 Home Assistant 2025.8 更新日志 中有一条与本行动直接相关的记录Fix description ofcurrentfield ofkeba.set_currentaction修复keba.set_current行动current字段的描述这说明该行动的参数描述仍在持续修订使用时建议以当前文档仓库的最新内容为准即本行动文档中current允许 6~63 A、0 停止充电的描述。使用注意事项总结谨慎调用keba.set_current会真实改变充电桩状态自动化触发条件应设计得足够明确避免意外限流或停止充电。合法取值范围current必须在 6~63 A 之间0 用于停止正在进行的充电流程不要把它当成最小电流来用。不支持 targets该行动直接作用于集成的充电桩无法通过 target 选择指定设备。与 failsafe 联动启用 failsafe 后必须在failsafe_timeout内定期调用keba.set_current否则充电桩会回退到后备电流。适用于 P30/P20 系列该集成面向 Keba P30/P20 及 BMW Wallbox基于 UDP Smart Home 接口P40 系列暂不支持。【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考