Home Assistant Keba 充电桩授权动作keba.authorize完整指南配置、调用与自动化实战【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io导读keba.authorize是 Home Assistant 中 Keba 充电桩集成 提供的一个核心动作action用于向 Keba P30/P20 充电桩含 BMW Wallbox发送授权指令等效于在充电桩上刷一次 RFID 卡。本文以 source/_actions/keba.authorize.markdown 为主体结合集成配置文档与全部相关动作文档系统讲解该动作的底层原理、前置配置、UI 与 YAML 两种调用方式、相关动作体系以及自动化实战示例。读完本文你将能独立完成 Keba 充电桩的授权/取消授权自动化并将其与限流、限电、fail-safe 等能力组合成完整的智能充电策略。动作概览keba.authorize做了什么根据官方动作文档的定义keba.authorize用于authorize授权Keba 充电桩上的充电过程Use this action to authorize a charging process on a Keba charging station. It uses the RFID tag defined in your configuration.其核心机制是调用该动作时Home Assistant 会使用你在configuration.yaml中为keba集成配置的rfid标签值向充电桩发送授权命令。也就是说授权所用的身份不是由动作参数指定的而是由集成配置中的rfid字段决定的这也是为什么该动作在 UI 中没有额外选项。两个必须牢记的要点动作会改变充电桩的物理状态。官方文档在动作说明处专门以 caution 警示块强调Using this action changes the state of your charging station. Use it with care.使用该动作会改变充电桩状态请谨慎使用。因此在自动化中接入此动作前务必确认触发条件不会造成意外充电。授权 ≠ 启动充电。keba.authorize只完成授权这一步解除充电锁 / 模拟刷卡真正开始充电由 keba.enable 完成停止充电由 keba.disable 完成。理解这一动作边界是正确编排自动化流程的前提。前置条件Keba 集成与 RFID 配置keba.authorize依赖keba集成正常工作因此第一步是完成集成配置。1. 硬件侧启用 UDP Smart Home InterfaceKeba 充电桩通过UDP Smart Home Interface与 Home Assistant 通信。要启用该接口需要按照充电桩安装手册调整充电桩内的DIP 拨码开关。同时注意兼容性边界支持Keba P30 / P20 充电桩以及 BMW WallboxKeba P40 暂不支持因其使用不同的通信协议集成默认每5 秒轮询一次充电桩数据与官方手机 App 的刷新频率一致可通过refresh_interval调整。2. 软件侧在configuration.yaml中启用集成在configuration.yaml中添加如下最小配置修改后需重启 Home Assistant 使配置生效# Example configuration.yaml entry keba: host: KEBA_HOST3. 配置rfid字段keba.authorize的关键依赖由于keba.authorize使用配置中定义的 RFID 标签执行授权请务必正确配置rfid字段否则授权将使用默认值。完整的keba集成配置项如下配置项必填类型默认值说明host是string—Keba 充电桩的主机地址IP 或主机名rfid否string00845500用于授权authorize的 RFID 标签failsafe否booleanfalse是否在 Home Assistant 启动时启用 fail-safe 模式failsafe_timeout否integer30fail-safe 超时时间秒允许范围 10–600 秒仅在启用 fail-safe 时生效。必须保证在该超时时间内定期调用keba.set_current等设置电流的动作failsafe_fallback否integer6fail-safe 回退电流A允许范围 6–63 A0会完全停止正在进行的充电仅在启用 fail-safe 时生效failsafe_persist否integer0是否将 fail-safe 配置写入充电桩内部 EEPROM1表示保存0表示仅在充电桩下次重启前有效仅在启用 fail-safe 时生效refresh_interval否integer5从充电桩拉取新数据的刷新间隔秒官方 App 同为 5 秒建议保持默认一个带 RFID 授权的完整配置示例keba: host: 192.168.1.50 rfid: 00845500 # 替换为你实际的 RFID 标签 refresh_interval: 5从源码文档结构看见 source/_integrations/keba.markdown 的{% configuration %}块rfid属于集成级配置而非动作级参数这解释了为什么keba.authorize动作本身没有任何参数选项——它读取的正是这个全局配置。4. 集成提供的实体平台配置完成后集成会为充电桩创建以下平台的实体理解这些实体有助于为keba.authorize设计合理的触发条件Binary sensor在线状态online、插枪状态plug、充电状态charging、fail-safe 模式状态Lock授权锁用法与 RFID 卡一致keba.authorize/keba.deauthorize即操作该锁的核心通道Sensor用户设定的电流、用户设定的目标能量、当前充电功率、本次充电累计电量、总充电电量Notify在带 LED 显示屏的充电桩上显示文本可选平台Actionsauthorize、deauthorize、设置能量目标、设置最大允许电流、手动刷新状态。在 UI 中调用keba.authorize官方动作文档给出了完整的 UI 操作路径适用于从自动化automation或脚本script中调用进入设置Settings自动化与场景Automations scenes打开一个已有的自动化或脚本或选择创建自动化Create automation创建新自动化Create new automation如果是在创建新自动化需要在When当……时部分添加一个触发器脚本则不需要触发器它们在被其他东西调用时才运行在Then do然后执行部分选择Add action添加动作在搜索框中搜索并选择Keba Charging Station: Authorize点击保存Save。需要注意的两个 UI 行为特征不支持目标targets官方文档明确指出 This action does not support targets. In the UI, you are not prompted to choose an area, device, entity, or label. 即调用该动作时UI不会提示你选择区域、设备、实体或标签。这是因为授权动作面向的是集成级配置的单一充电桩。无额外 UI 选项该动作在 UI 中没有额外的参数输入项因为授权所用的 RFID 来自配置文件。在 YAML 中调用keba.authorize在 YAML 中自动化、脚本或homeassistant.turn_on之外的任何动作上下文动作名写作keba.authorize。官方文档给出的基础示例如下action: keba.authorize放在一个完整自动化中的示例automation: - alias: Authorize Keba charging station triggers: - trigger: time at: 21:00:00 actions: - action: keba.authorizeYAML 参数说明keba.authorize在 YAML 中同样没有额外参数——这是它与keba.set_current需要current、keba.set_energy需要energy等带参动作的本质区别。对比可参考 keba.set_current.markdown 与 keba.set_energy.markdown 中{% options_yaml %}块的参数定义。授权相关动作体系一张图看懂 Keba 动作组合keba.authorize并非孤立存在它与同域的其他动作构成一套完整的充电控制体系。官方在动作文档的related_actions中明确了关联关系动作作用关联关系keba.authorize授权充电过程模拟 RFID 刷卡本文主题keba.deauthorize取消正在运行的充电过程的授权与keba.authorize互为反操作keba.enable启动充电过程充电桩需已授权依赖先完成授权keba.disable停止充电过程充电桩需已授权与keba.enable互为反操作keba.request_data请求充电桩立即发送最新数据刷新相关实体手动强制刷新keba.set_current设置最大充电电流6–63 A0停止充电限流、fail-safe 配合keba.set_energy设置本次充电目标电量0–100 kWh0取消限制限电keba.set_failsafe配置 fail-safe 模式超时、回退电流、是否持久化安全兜底典型的一次授权并充电完整链路是keba.authorize—— 授权解除锁定模拟刷卡keba.set_current——可选限制最大充电电流如匹配光伏余电keba.enable—— 启动充电过程充电完成后keba.disable停止充电keba.deauthorize取消授权。需要特别提醒的是 keba.set_failsafe 中的要求启用 fail-safe 模式后必须在配置的超时时间内定期调用keba.set_current否则充电桩将按 fail-safe 配置的回退电流运行。这与集成配置中failsafe_timeout10–600 秒的设计目的完全一致——当 Home Assistant 与充电桩失去联系时充电不会失控。自动化实战授权 限流 目标电量组合场景下面将keba.authorize与其他动作组合成两个可直接落地的自动化场景。场景一插枪后授权并限流充电当插枪传感器变为已插入plug sensor 为on时先授权再将电流限制到安全值并启动充电automation: - alias: Authorize and start gentle charging when plugged in triggers: - trigger: state entity_id: binary_sensor.keba_charging_station_plug to: on actions: - action: keba.authorize - action: keba.set_current data: current: 16 - action: keba.enable说明传感器实体名以实际设备为准上述binary_sensor.keba_charging_station_plug为文档示例命名。keba.set_current的current参数为必填 float允许范围 6–63 A0会停止正在进行的充电。场景二按需充入固定电量当希望只补固定度数、不充满时可参照 keba.set_energy.markdown 中官方给出的自动化模式将keba.set_energy与授权动作组合automation: - alias: Authorize and add fixed energy when plugged in triggers: - trigger: state entity_id: binary_sensor.keba_charging_station_plug to: on actions: - action: keba.authorize - action: keba.set_energy data: energy: 15 # kWh达到后充电桩自动停止energy参数为必填 float允许范围 0–100 kWh0表示取消能量限制。常见问题与注意事项授权后没有任何反应先检查keba集成是否已正常连接观察 online 二进制传感器状态再确认rfid字段是否配置正确。默认值00845500是文档给出的出厂默认示例实际设备可能不同。另外授权 ≠ 启动充电若未调用keba.enable充电不会开始。为什么 UI 中没有可选的设备/实体因为keba.authorize不支持 targets动作直接作用于集成配置中的充电桩这属于设计行为而非缺陷。调用频率与刷新延迟集成默认 5 秒刷新一次数据。如果刚完成授权想立即看到实体状态变化可以先调用 keba.request_data 强制充电桩发送最新数据。动作会改变充电桩状态务必谨慎设计触发条件官方在集成文档与所有动作文档中都反复使用 caution 警示Using these actions changes the state of your charging station. Use them with care. 建议为自动化添加额外保护条件例如仅在车辆确实插枪、且电价处于低谷时段才授权避免误触发导致意外充电或计费。fail-safe 模式的交互若启用了 fail-safe启动时或通过keba.set_failsafe配置任何依赖周期性设置电流的自动化都必须确保在failsafe_timeout内持续执行keba.set_current超时后充电桩会切换到failsafe_fallback指定的回退电流0则会直接停充。这是安全兜底机制设计自动化时应将其视为预期行为而非故障。参考文档本文主体source/_actions/keba.authorize.markdown集成配置与实体说明source/_integrations/keba.markdown关联动作keba.deauthorize keba.enable keba.disable keba.request_data keba.set_current keba.set_energy keba.set_failsafe【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Home Assistant Keba 充电桩授权动作 `keba.authorize` 完整指南：配置、调用与自动化实战
Home Assistant Keba 充电桩授权动作keba.authorize完整指南配置、调用与自动化实战【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io导读keba.authorize是 Home Assistant 中 Keba 充电桩集成 提供的一个核心动作action用于向 Keba P30/P20 充电桩含 BMW Wallbox发送授权指令等效于在充电桩上刷一次 RFID 卡。本文以 source/_actions/keba.authorize.markdown 为主体结合集成配置文档与全部相关动作文档系统讲解该动作的底层原理、前置配置、UI 与 YAML 两种调用方式、相关动作体系以及自动化实战示例。读完本文你将能独立完成 Keba 充电桩的授权/取消授权自动化并将其与限流、限电、fail-safe 等能力组合成完整的智能充电策略。动作概览keba.authorize做了什么根据官方动作文档的定义keba.authorize用于authorize授权Keba 充电桩上的充电过程Use this action to authorize a charging process on a Keba charging station. It uses the RFID tag defined in your configuration.其核心机制是调用该动作时Home Assistant 会使用你在configuration.yaml中为keba集成配置的rfid标签值向充电桩发送授权命令。也就是说授权所用的身份不是由动作参数指定的而是由集成配置中的rfid字段决定的这也是为什么该动作在 UI 中没有额外选项。两个必须牢记的要点动作会改变充电桩的物理状态。官方文档在动作说明处专门以 caution 警示块强调Using this action changes the state of your charging station. Use it with care.使用该动作会改变充电桩状态请谨慎使用。因此在自动化中接入此动作前务必确认触发条件不会造成意外充电。授权 ≠ 启动充电。keba.authorize只完成授权这一步解除充电锁 / 模拟刷卡真正开始充电由 keba.enable 完成停止充电由 keba.disable 完成。理解这一动作边界是正确编排自动化流程的前提。前置条件Keba 集成与 RFID 配置keba.authorize依赖keba集成正常工作因此第一步是完成集成配置。1. 硬件侧启用 UDP Smart Home InterfaceKeba 充电桩通过UDP Smart Home Interface与 Home Assistant 通信。要启用该接口需要按照充电桩安装手册调整充电桩内的DIP 拨码开关。同时注意兼容性边界支持Keba P30 / P20 充电桩以及 BMW WallboxKeba P40 暂不支持因其使用不同的通信协议集成默认每5 秒轮询一次充电桩数据与官方手机 App 的刷新频率一致可通过refresh_interval调整。2. 软件侧在configuration.yaml中启用集成在configuration.yaml中添加如下最小配置修改后需重启 Home Assistant 使配置生效# Example configuration.yaml entry keba: host: KEBA_HOST3. 配置rfid字段keba.authorize的关键依赖由于keba.authorize使用配置中定义的 RFID 标签执行授权请务必正确配置rfid字段否则授权将使用默认值。完整的keba集成配置项如下配置项必填类型默认值说明host是string—Keba 充电桩的主机地址IP 或主机名rfid否string00845500用于授权authorize的 RFID 标签failsafe否booleanfalse是否在 Home Assistant 启动时启用 fail-safe 模式failsafe_timeout否integer30fail-safe 超时时间秒允许范围 10–600 秒仅在启用 fail-safe 时生效。必须保证在该超时时间内定期调用keba.set_current等设置电流的动作failsafe_fallback否integer6fail-safe 回退电流A允许范围 6–63 A0会完全停止正在进行的充电仅在启用 fail-safe 时生效failsafe_persist否integer0是否将 fail-safe 配置写入充电桩内部 EEPROM1表示保存0表示仅在充电桩下次重启前有效仅在启用 fail-safe 时生效refresh_interval否integer5从充电桩拉取新数据的刷新间隔秒官方 App 同为 5 秒建议保持默认一个带 RFID 授权的完整配置示例keba: host: 192.168.1.50 rfid: 00845500 # 替换为你实际的 RFID 标签 refresh_interval: 5从源码文档结构看见 source/_integrations/keba.markdown 的{% configuration %}块rfid属于集成级配置而非动作级参数这解释了为什么keba.authorize动作本身没有任何参数选项——它读取的正是这个全局配置。4. 集成提供的实体平台配置完成后集成会为充电桩创建以下平台的实体理解这些实体有助于为keba.authorize设计合理的触发条件Binary sensor在线状态online、插枪状态plug、充电状态charging、fail-safe 模式状态Lock授权锁用法与 RFID 卡一致keba.authorize/keba.deauthorize即操作该锁的核心通道Sensor用户设定的电流、用户设定的目标能量、当前充电功率、本次充电累计电量、总充电电量Notify在带 LED 显示屏的充电桩上显示文本可选平台Actionsauthorize、deauthorize、设置能量目标、设置最大允许电流、手动刷新状态。在 UI 中调用keba.authorize官方动作文档给出了完整的 UI 操作路径适用于从自动化automation或脚本script中调用进入设置Settings自动化与场景Automations scenes打开一个已有的自动化或脚本或选择创建自动化Create automation创建新自动化Create new automation如果是在创建新自动化需要在When当……时部分添加一个触发器脚本则不需要触发器它们在被其他东西调用时才运行在Then do然后执行部分选择Add action添加动作在搜索框中搜索并选择Keba Charging Station: Authorize点击保存Save。需要注意的两个 UI 行为特征不支持目标targets官方文档明确指出 This action does not support targets. In the UI, you are not prompted to choose an area, device, entity, or label. 即调用该动作时UI不会提示你选择区域、设备、实体或标签。这是因为授权动作面向的是集成级配置的单一充电桩。无额外 UI 选项该动作在 UI 中没有额外的参数输入项因为授权所用的 RFID 来自配置文件。在 YAML 中调用keba.authorize在 YAML 中自动化、脚本或homeassistant.turn_on之外的任何动作上下文动作名写作keba.authorize。官方文档给出的基础示例如下action: keba.authorize放在一个完整自动化中的示例automation: - alias: Authorize Keba charging station triggers: - trigger: time at: 21:00:00 actions: - action: keba.authorizeYAML 参数说明keba.authorize在 YAML 中同样没有额外参数——这是它与keba.set_current需要current、keba.set_energy需要energy等带参动作的本质区别。对比可参考 keba.set_current.markdown 与 keba.set_energy.markdown 中{% options_yaml %}块的参数定义。授权相关动作体系一张图看懂 Keba 动作组合keba.authorize并非孤立存在它与同域的其他动作构成一套完整的充电控制体系。官方在动作文档的related_actions中明确了关联关系动作作用关联关系keba.authorize授权充电过程模拟 RFID 刷卡本文主题keba.deauthorize取消正在运行的充电过程的授权与keba.authorize互为反操作keba.enable启动充电过程充电桩需已授权依赖先完成授权keba.disable停止充电过程充电桩需已授权与keba.enable互为反操作keba.request_data请求充电桩立即发送最新数据刷新相关实体手动强制刷新keba.set_current设置最大充电电流6–63 A0停止充电限流、fail-safe 配合keba.set_energy设置本次充电目标电量0–100 kWh0取消限制限电keba.set_failsafe配置 fail-safe 模式超时、回退电流、是否持久化安全兜底典型的一次授权并充电完整链路是keba.authorize—— 授权解除锁定模拟刷卡keba.set_current——可选限制最大充电电流如匹配光伏余电keba.enable—— 启动充电过程充电完成后keba.disable停止充电keba.deauthorize取消授权。需要特别提醒的是 keba.set_failsafe 中的要求启用 fail-safe 模式后必须在配置的超时时间内定期调用keba.set_current否则充电桩将按 fail-safe 配置的回退电流运行。这与集成配置中failsafe_timeout10–600 秒的设计目的完全一致——当 Home Assistant 与充电桩失去联系时充电不会失控。自动化实战授权 限流 目标电量组合场景下面将keba.authorize与其他动作组合成两个可直接落地的自动化场景。场景一插枪后授权并限流充电当插枪传感器变为已插入plug sensor 为on时先授权再将电流限制到安全值并启动充电automation: - alias: Authorize and start gentle charging when plugged in triggers: - trigger: state entity_id: binary_sensor.keba_charging_station_plug to: on actions: - action: keba.authorize - action: keba.set_current data: current: 16 - action: keba.enable说明传感器实体名以实际设备为准上述binary_sensor.keba_charging_station_plug为文档示例命名。keba.set_current的current参数为必填 float允许范围 6–63 A0会停止正在进行的充电。场景二按需充入固定电量当希望只补固定度数、不充满时可参照 keba.set_energy.markdown 中官方给出的自动化模式将keba.set_energy与授权动作组合automation: - alias: Authorize and add fixed energy when plugged in triggers: - trigger: state entity_id: binary_sensor.keba_charging_station_plug to: on actions: - action: keba.authorize - action: keba.set_energy data: energy: 15 # kWh达到后充电桩自动停止energy参数为必填 float允许范围 0–100 kWh0表示取消能量限制。常见问题与注意事项授权后没有任何反应先检查keba集成是否已正常连接观察 online 二进制传感器状态再确认rfid字段是否配置正确。默认值00845500是文档给出的出厂默认示例实际设备可能不同。另外授权 ≠ 启动充电若未调用keba.enable充电不会开始。为什么 UI 中没有可选的设备/实体因为keba.authorize不支持 targets动作直接作用于集成配置中的充电桩这属于设计行为而非缺陷。调用频率与刷新延迟集成默认 5 秒刷新一次数据。如果刚完成授权想立即看到实体状态变化可以先调用 keba.request_data 强制充电桩发送最新数据。动作会改变充电桩状态务必谨慎设计触发条件官方在集成文档与所有动作文档中都反复使用 caution 警示Using these actions changes the state of your charging station. Use them with care. 建议为自动化添加额外保护条件例如仅在车辆确实插枪、且电价处于低谷时段才授权避免误触发导致意外充电或计费。fail-safe 模式的交互若启用了 fail-safe启动时或通过keba.set_failsafe配置任何依赖周期性设置电流的自动化都必须确保在failsafe_timeout内持续执行keba.set_current超时后充电桩会切换到failsafe_fallback指定的回退电流0则会直接停充。这是安全兜底机制设计自动化时应将其视为预期行为而非故障。参考文档本文主体source/_actions/keba.authorize.markdown集成配置与实体说明source/_integrations/keba.markdown关联动作keba.deauthorize keba.enable keba.disable keba.request_data keba.set_current keba.set_energy keba.set_failsafe【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考