Home Assistant 中通过 renault.charge_set_schedules 配置雷诺电动汽车充电时段【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io本篇技术指南讲解如何在 Home Assistant 中使用renault.charge_set_schedules动作action更新雷诺电动汽车的充电计划例如将充电集中在电网谷电时段进行。读完本文你将掌握该动作在自动化与脚本中的完整调用方式包括 UI 操作步骤、YAML 参数结构、多日程的写入与清除规则以及与之配套的 Renault 集成配置与订阅前提。动作概览与适用场景renault.charge_set_schedules是 Home Assistant 中 Renault 集成 提供的动作之一作用是把一组充电日程一次性下发到雷诺云端MyRenault / Kamereon 服务让车辆在指定时间窗口内充电。典型应用场景包括将充电安排在夜间谷电时段降低用电成本配合电量上限target charge level控制兼顾电池健康与用车需求在一次调用中同时更新多个日程最多 5 个无需逐个修改。需要注意的边界条件充电控制需要有效的订阅服务例如Pack EV Remote Control并且并非所有车型都支持该功能与整个 Renault 集成 一样该动作依赖稳定网络与雷诺服务器可用性接口调用受云侧限速约束部分新款车型使用新端点底层库尚未支持时相关动作会以err.func.wired.forbidden错误码失败详见集成文档的 Known limitations 一节。从用户界面配置充电日程通过 UI 创建自动化或脚本时可按下述步骤操作打开设置 自动化与场景Settings Automations scenes打开现有的自动化或脚本或选择创建自动化创建新自动化如果是新建自动化先在When部分添加触发器脚本无需触发器由其他自动化或场景显式调用在Then do部分选择添加动作Add action搜索并选择Renault: Update charge schedule更新充电日程在Vehicle字段选择车辆并在Schedules字段填写日程点击保存。UI 中的选项选项说明Vehicle要下发命令的雷诺车辆Schedules要设置的一个或多个日程其结构见下文 Good to know在 YAML 中使用该动作在 YAML 中该动作的服务名为renault.charge_set_schedules。基础示例action: renault.charge_set_schedules data: vehicle: abcde1234567890abcde1234567890ab schedules: - id: 1 activated: true monday: startTime: T12:00Z duration: 15YAML 选项参考字段说明必填类型vehicle接收命令的雷诺车辆 ID是stringschedules要设置的一个或多个日程结构见下文是list关于 targets 的说明该动作不支持目标targets无法像light.turn_on那样通过target:选择实体必须在vehicle字段中显式指定车辆 ID。完整配置示例将下面的片段放入configuration.yaml的自动化或脚本中即可实现多日程批量下发alias: Set EV charging schedule description: 配置雷诺车辆充电日程 trigger: [] condition: [] action: - action: renault.charge_set_schedules data: vehicle: abcde1234567890abcde1234567890ab schedules: - id: 1 activated: true monday: startTime: T00:30Z duration: 360 tuesday: startTime: T00:30Z duration: 360 wednesday: startTime: T00:30Z duration: 360 thursday: startTime: T00:30Z duration: 360 friday: startTime: T00:30Z duration: 360 - id: 2 activated: false monday: startTime: T12:00Z duration: 15 mode: singleGood to know日程结构详解schedules选项接收一个或多个日程所有日程会在同一次调用中一起下发。每个日程是一个映射mapping包含以下键id必填日程编号取值范围为 1 到 5具体数量取决于车型activated可选该日程是否激活。省略时保持当前设置不变monday至sunday可选每天对应的时段设置规则如下省略某天保持该天的当前设置将某天设为空值如monday:后不加内容清除该天的设置设置某天时必须包含两个键startTimeUTC 时间格式为THH:MMZ如T12:00Z表示 UTC 12:00duration充电持续分钟数。官方文档中的多日程示例- id: 1 activated: true monday: startTime: T12:00Z duration: 15 - id: 2 activated: false monday: startTime: T12:00Z duration: 15时间格式与语义要点startTime使用ISO 8601 风格的时间字符串前缀T表示时间字段后缀Z表示 UTC 时区。由于是 UTC国内使用时需换算为本地时区例如北京时间 UTC8T12:00Z对应本地 20:00duration的单位是分钟不是小时。设置 6 小时充电窗口应写duration: 360activated: false的日程仍然可以保留每天的时段配置只是整体不生效便于日后一键启用同一次调用中id必须唯一重复的日程编号会覆盖前一个同名日程的配置。从 UI 与 YAML 的对应关系看动作设计Home Assistant 文档体系中将该动作的 UI 与 YAML 两种使用方式分开描述见 actions/ui_header.md 与 actions/yaml_header.mdUI 方式面向可视化配置YAML 方式则暴露底层字段名、类型与必填性。两者最终都会生成相同的服务调用——action: renault.charge_set_schedules加上data中的vehicle与schedules。与同域其他动作的配合Renault 集成的动作集中还有几个相关动作可与充电日程协同使用见 source/_actions 目录renault.charge_start立即开始充电或通过可选的when字段datetime 类型指定开始时间。文档中将它与renault.charge_set_schedules列为互相关联的动作renault.ac_set_schedules更新空调预约日程结构与充电日程类似但每天使用readyAtTime键到点准备好语义且不包含duration字段此外集成还提供renault.ac_start、renault.ac_cancel等空调控制动作。典型的组合用法通过renault.charge_set_schedules设定工作日夜间充电窗口同时用renault.charge_start在临时需要时立即补电若空调需要在上车前预热可另行配置renault.ac_set_schedules。前提条件与限制回顾在把该动作投入使用前请确认以下前提依据 Renault 集成文档集成已正确配置通过配置流Config Flow填入 Locale如fr_FR、en_GB需与 MyRenault 账号的区域设置一致、用户名、密码以及 Kamereon 账户 ID单账户时自动选择车型支持部分功能含远程充电控制需要Pack EV Remote Control和/或Pack Smart Navigation订阅且并非所有车型开放服务可用性雷诺服务器停机或维护、网络不稳定都会导致动作失败可先用官方手机 App 快速验证服务状态限速与轮询间隔集成将轮询限制为 60 次数据请求/小时单个车辆每约 7 分钟同步一次数据因此日程下发生效与状态回读存在一定延迟。若动作执行异常可参考集成文档的 Troubleshooting 章节开启 debug 日志并结合 diagnostics 数据上报问题。【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考