Home Assistant Renault 空调定时调度指南用 renault.ac_set_schedules 一键设置车辆空调计划【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io导读本指南围绕 Home Assistant 官方文档中 Renault 集成提供的renault.ac_set_schedules动作展开讲解如何通过可视化界面或 YAML 为雷诺Renault车辆批量设置空调调度A/C schedules让座舱在你指定的时间准时达到适宜温度。读完本文你将掌握该动作的完整参数结构、readyAtTime的 UTC 时间格式约定、多组调度同时写入的写法以及与之配套的renault.ac_start、renault.ac_cancel动作的用法与底层限制。动作概述一次调用设置多组空调调度renault.ac_set_schedules用于更新一辆雷诺车辆的空调调度使得座舱在你选择的时刻提前完成预热或预冷。与一次只能启动一次的空调动作不同这个动作的核心能力是在单次调用中同时更新一组或多组调度例如工作日早上 7 点、周末下午 2 点等多套计划可以一次性写入。该动作属于 Renault 集成ha_domain: renault的一部分。根据集成文档该集成通过MyRenault 云服务与雷诺服务器通信并提供传感器电池电量、外部温度、里程表、续航、充电速率、胎压等、二进制传感器、按钮、设备跟踪器、数字与选择器等多种平台。需要特别注意的是空调控制可能要求有效的订阅服务例如Pack EV Remote Control并且并非所有车辆都支持。此外集成文档中的已知限制也适用于本动作部分较新车型使用新的接口端点而底层库尚未支持对应动作可能返回错误码err.func.wired.forbidden。从用户界面调用该动作如果你更习惯用可视化方式搭建自动化和脚本Home Assistant 会引导你逐步完成该动作的配置无需编写 YAML。官方文档给出的操作步骤如下进入设置Settings自动化与场景Automations scenes。打开一个已有的自动化或脚本或者选择创建自动化Create automation创建新自动化Create new automation。如果是新建自动化需要在When何时区域添加一个触发器。脚本Script不需要触发器——它们由其他自动化或调用方触发执行。在Then do然后执行区域选择添加动作Add action。搜索动作Renault: Update A/C schedule雷诺更新空调调度并选中。在Vehicle车辆字段中选择目标车辆并在Schedules调度字段中填写调度内容。选择保存Save。UI 中的选项选项说明Vehicle要发送命令的雷诺车辆。Schedules一组或多组要设置的调度其结构见下文调度结构详解。值得注意的是该动作不支持 targets目标实体选择器必须通过Vehicle字段明确选择车辆。这是因为它属于面向单辆车的远程控制命令而不是面向多个实体广播的动作。在 YAML 中使用该动作如果你直接编写 YAML或者想确切了解 Home Assistant 底层做了什么可以参考下面的技术参考。YAML 中该动作的调用名为renault.ac_set_schedules官方给出的基础示例如下action: renault.ac_set_schedules data: vehicle: abcde1234567890abcde1234567890ab schedules: - id: 1 activated: true monday: readyAtTime: T12:00ZYAML 参数说明参数必填类型说明vehicle是string接收命令的雷诺车辆 ID。schedules是list一组或多组要设置的调度具体结构见下文。完整调用示例自动化中在自动化中通常将动作写进action列表里。下面是一个更完整的形态alias: Precondition car on weekday mornings triggers: - trigger: time at: 06:00:00 actions: - action: renault.ac_set_schedules data: vehicle: abcde1234567890abcde1234567890ab schedules: - id: 1 activated: true monday: readyAtTime: T07:30Z tuesday: readyAtTime: T07:30Z wednesday: readyAtTime: T07:30Z thursday: readyAtTime: T07:30Z friday: readyAtTime: T07:30Z如果你需要在设置完调度后立即验证效果也可以配合相关动作见下文在同一个自动化里执行。调度结构详解Good to knowrenault.ac_set_schedules的精髓在于schedules参数。它接受一组或多组调度所有调度在同一次调用中全部写入。每一组调度都是一个映射mapping包含以下键id必填调度编号范围为 1 到 5具体可用数量取决于车辆型号。activated可选该调度是否激活。如果不填写此项则保持当前的启用状态不变。monday到sunday可选每天的调度内容。规则如下如果省略某一天该天的当前设置保持不变如果将某一天设置为空值则该天的设置被清除如果设置某一天则必须包含readyAtTime键格式为UTC 时间写法是THH:MMZ例如T12:00Z。官方文档给出的多组调度示例- id: 1 activated: true monday: readyAtTime: T12:00Z - id: 2 activated: false monday: readyAtTime: T12:00Z tuesday: readyAtTime: T12:00Z分析该示例可以看出两种典型用法启用调度 1id: 1被激活并在周一 12:00 UTC 准备就绪由于只写了monday其他日期沿用当前设置。停用调度 2id: 2的activated: false直接关闭该调度但保留了周一周二的时刻信息方便日后重新启用此外它同时设置了monday与tuesday两个日期展示了多日期单组调度的写法。时间格式的注意事项readyAtTime的格式是THH:MMZ其中T是 ISO 8601 时间前缀HH:MM是 24 小时制的小时和分钟Z表示 UTC协调世界时零时区。使用时要根据你的本地时区换算。例如中国标准时间UTC8下的 20:00对应的 UTC 值即为T12:00Z。如果你的自动化在同一时区运行也可以直接用模板或变量构造该字符串但务必确保最终传给动作的值是 UTC 格式否则车辆端可能按错误的时间执行调度。立即试运行动作调试入口如果你想在不写任何 YAML 的情况下验证该动作对真实车辆实体的效果可以在 Home Assistant 中打开设置Settings工具Tools动作Actions搜索renault.ac_set_schedules填写字段后点击执行动作Perform action。通过实际执行可以看到动作是否被车辆端接受以及返回的状态信息。与空调相关的配套动作renault.ac_set_schedules与另外两个空调动作相互配合官方文档将其标记为 related actionsrenault.ac_start启动雷诺车辆的空调例如出发前预热或预冷座舱。可以立即启动也可以通过when参数datetime 类型默认现在设定启动时间temperature为必填 float单位为摄氏度范围15–25。renault.ac_cancel取消雷诺车辆的空调例如停止座舱预处理。典型的组合思路是用ac_set_schedules定义日常的固定调度如工作日早晨再用ac_start在临时需要时立即启动或指定时刻启动最后用ac_cancel取消一次性的启动请求。这三个动作同样不支持 targets都需要通过vehicle字段指定车辆并且都可能受Pack EV Remote Control订阅与车型支持范围的限制。底层原理与限制基于仓库证据从 Renault 集成文档可以确认以下几点与本动作相关的实现事实连接方式该集成是Cloud Polling类型ha_iot_class: Cloud Polling通过MyRenault 云服务通信配置流中需要提供 Locale国家代码如fr_FR、en_GB、用户名、密码以及Kamereon account id车辆所属的 Kamereon 账户 ID仅有一个账户时自动选择。数据更新频率由于雷诺服务器存在速率限制集成将轮询限制为每小时 60 次数据请求对于拥有全部 7 个端点的单辆车大约每 7 分钟拉取一次数据。这意味着调度写入后的状态反馈例如实体值的刷新可能不是即时的。订阅与车型限制部分功能可能要求Pack EV Remote Control和/或Pack Smart Navigation订阅较新车型使用的新端点尚未被底层库支持对应动作可能以err.func.wired.forbidden失败。集成质量等级ha_quality_scale: silver自 2021.8 版本引入ha_release: 2021.8代码维护者为epenet。此外该动作面向的调度能力依赖车辆本身的远程空调调度功能。从文档结构与字段定义可以推断调度编号上限1–5、每天的readyAtTime、activated开关等字段直接对应车辆端通过 Kamereon 云接口的调度模型Home Assistant 侧只是将这些字段原样封装为动作参数因此实际可用的调度数量与时间精度以你的车辆与订阅为准。常见问题与排障建议动作执行失败并提示err.func.wired.forbidden大概率是车型过新、底层库尚未支持对应端点或者缺少Pack EV Remote Control订阅。可先检查车辆是否支持远程空调功能如通过官方 App 验证。调度没有按预期时间执行优先检查readyAtTime是否为UTC 格式THH:MMZ并按本地时区正确换算同时确认activated: true已设置且车辆端没有其他调度与之冲突。状态刷新缓慢受每小时 60 次请求的轮询上限影响实体状态如调度确认信息的更新不是实时的请耐心等待下一轮数据拉取。想确认服务端是否正常根据集成文档的排障指引可以打开雷诺官方 Android/iOS App 快速验证服务可用性若需提交问题可启用调试日志并附带诊断数据。小结renault.ac_set_schedules是 Renault 集成中面向空调远程调度的核心动作一次调用即可写入 1–5 组调度支持按id管理、按天monday–sunday配置readyAtTime并允许保留或清除指定日期的设置。它适合与renault.ac_start临时启动和renault.ac_cancel取消启动组合构成完整的远程空调控制链路。使用时务必牢记三条约束通过vehicle选择车辆不支持 targets、时间为 UTC 格式、功能受订阅与车型支持范围限制。【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
Home Assistant Renault 空调定时调度指南：用 renault.ac_set_schedules 一键设置车辆空调计划
Home Assistant Renault 空调定时调度指南用 renault.ac_set_schedules 一键设置车辆空调计划【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io导读本指南围绕 Home Assistant 官方文档中 Renault 集成提供的renault.ac_set_schedules动作展开讲解如何通过可视化界面或 YAML 为雷诺Renault车辆批量设置空调调度A/C schedules让座舱在你指定的时间准时达到适宜温度。读完本文你将掌握该动作的完整参数结构、readyAtTime的 UTC 时间格式约定、多组调度同时写入的写法以及与之配套的renault.ac_start、renault.ac_cancel动作的用法与底层限制。动作概述一次调用设置多组空调调度renault.ac_set_schedules用于更新一辆雷诺车辆的空调调度使得座舱在你选择的时刻提前完成预热或预冷。与一次只能启动一次的空调动作不同这个动作的核心能力是在单次调用中同时更新一组或多组调度例如工作日早上 7 点、周末下午 2 点等多套计划可以一次性写入。该动作属于 Renault 集成ha_domain: renault的一部分。根据集成文档该集成通过MyRenault 云服务与雷诺服务器通信并提供传感器电池电量、外部温度、里程表、续航、充电速率、胎压等、二进制传感器、按钮、设备跟踪器、数字与选择器等多种平台。需要特别注意的是空调控制可能要求有效的订阅服务例如Pack EV Remote Control并且并非所有车辆都支持。此外集成文档中的已知限制也适用于本动作部分较新车型使用新的接口端点而底层库尚未支持对应动作可能返回错误码err.func.wired.forbidden。从用户界面调用该动作如果你更习惯用可视化方式搭建自动化和脚本Home Assistant 会引导你逐步完成该动作的配置无需编写 YAML。官方文档给出的操作步骤如下进入设置Settings自动化与场景Automations scenes。打开一个已有的自动化或脚本或者选择创建自动化Create automation创建新自动化Create new automation。如果是新建自动化需要在When何时区域添加一个触发器。脚本Script不需要触发器——它们由其他自动化或调用方触发执行。在Then do然后执行区域选择添加动作Add action。搜索动作Renault: Update A/C schedule雷诺更新空调调度并选中。在Vehicle车辆字段中选择目标车辆并在Schedules调度字段中填写调度内容。选择保存Save。UI 中的选项选项说明Vehicle要发送命令的雷诺车辆。Schedules一组或多组要设置的调度其结构见下文调度结构详解。值得注意的是该动作不支持 targets目标实体选择器必须通过Vehicle字段明确选择车辆。这是因为它属于面向单辆车的远程控制命令而不是面向多个实体广播的动作。在 YAML 中使用该动作如果你直接编写 YAML或者想确切了解 Home Assistant 底层做了什么可以参考下面的技术参考。YAML 中该动作的调用名为renault.ac_set_schedules官方给出的基础示例如下action: renault.ac_set_schedules data: vehicle: abcde1234567890abcde1234567890ab schedules: - id: 1 activated: true monday: readyAtTime: T12:00ZYAML 参数说明参数必填类型说明vehicle是string接收命令的雷诺车辆 ID。schedules是list一组或多组要设置的调度具体结构见下文。完整调用示例自动化中在自动化中通常将动作写进action列表里。下面是一个更完整的形态alias: Precondition car on weekday mornings triggers: - trigger: time at: 06:00:00 actions: - action: renault.ac_set_schedules data: vehicle: abcde1234567890abcde1234567890ab schedules: - id: 1 activated: true monday: readyAtTime: T07:30Z tuesday: readyAtTime: T07:30Z wednesday: readyAtTime: T07:30Z thursday: readyAtTime: T07:30Z friday: readyAtTime: T07:30Z如果你需要在设置完调度后立即验证效果也可以配合相关动作见下文在同一个自动化里执行。调度结构详解Good to knowrenault.ac_set_schedules的精髓在于schedules参数。它接受一组或多组调度所有调度在同一次调用中全部写入。每一组调度都是一个映射mapping包含以下键id必填调度编号范围为 1 到 5具体可用数量取决于车辆型号。activated可选该调度是否激活。如果不填写此项则保持当前的启用状态不变。monday到sunday可选每天的调度内容。规则如下如果省略某一天该天的当前设置保持不变如果将某一天设置为空值则该天的设置被清除如果设置某一天则必须包含readyAtTime键格式为UTC 时间写法是THH:MMZ例如T12:00Z。官方文档给出的多组调度示例- id: 1 activated: true monday: readyAtTime: T12:00Z - id: 2 activated: false monday: readyAtTime: T12:00Z tuesday: readyAtTime: T12:00Z分析该示例可以看出两种典型用法启用调度 1id: 1被激活并在周一 12:00 UTC 准备就绪由于只写了monday其他日期沿用当前设置。停用调度 2id: 2的activated: false直接关闭该调度但保留了周一周二的时刻信息方便日后重新启用此外它同时设置了monday与tuesday两个日期展示了多日期单组调度的写法。时间格式的注意事项readyAtTime的格式是THH:MMZ其中T是 ISO 8601 时间前缀HH:MM是 24 小时制的小时和分钟Z表示 UTC协调世界时零时区。使用时要根据你的本地时区换算。例如中国标准时间UTC8下的 20:00对应的 UTC 值即为T12:00Z。如果你的自动化在同一时区运行也可以直接用模板或变量构造该字符串但务必确保最终传给动作的值是 UTC 格式否则车辆端可能按错误的时间执行调度。立即试运行动作调试入口如果你想在不写任何 YAML 的情况下验证该动作对真实车辆实体的效果可以在 Home Assistant 中打开设置Settings工具Tools动作Actions搜索renault.ac_set_schedules填写字段后点击执行动作Perform action。通过实际执行可以看到动作是否被车辆端接受以及返回的状态信息。与空调相关的配套动作renault.ac_set_schedules与另外两个空调动作相互配合官方文档将其标记为 related actionsrenault.ac_start启动雷诺车辆的空调例如出发前预热或预冷座舱。可以立即启动也可以通过when参数datetime 类型默认现在设定启动时间temperature为必填 float单位为摄氏度范围15–25。renault.ac_cancel取消雷诺车辆的空调例如停止座舱预处理。典型的组合思路是用ac_set_schedules定义日常的固定调度如工作日早晨再用ac_start在临时需要时立即启动或指定时刻启动最后用ac_cancel取消一次性的启动请求。这三个动作同样不支持 targets都需要通过vehicle字段指定车辆并且都可能受Pack EV Remote Control订阅与车型支持范围的限制。底层原理与限制基于仓库证据从 Renault 集成文档可以确认以下几点与本动作相关的实现事实连接方式该集成是Cloud Polling类型ha_iot_class: Cloud Polling通过MyRenault 云服务通信配置流中需要提供 Locale国家代码如fr_FR、en_GB、用户名、密码以及Kamereon account id车辆所属的 Kamereon 账户 ID仅有一个账户时自动选择。数据更新频率由于雷诺服务器存在速率限制集成将轮询限制为每小时 60 次数据请求对于拥有全部 7 个端点的单辆车大约每 7 分钟拉取一次数据。这意味着调度写入后的状态反馈例如实体值的刷新可能不是即时的。订阅与车型限制部分功能可能要求Pack EV Remote Control和/或Pack Smart Navigation订阅较新车型使用的新端点尚未被底层库支持对应动作可能以err.func.wired.forbidden失败。集成质量等级ha_quality_scale: silver自 2021.8 版本引入ha_release: 2021.8代码维护者为epenet。此外该动作面向的调度能力依赖车辆本身的远程空调调度功能。从文档结构与字段定义可以推断调度编号上限1–5、每天的readyAtTime、activated开关等字段直接对应车辆端通过 Kamereon 云接口的调度模型Home Assistant 侧只是将这些字段原样封装为动作参数因此实际可用的调度数量与时间精度以你的车辆与订阅为准。常见问题与排障建议动作执行失败并提示err.func.wired.forbidden大概率是车型过新、底层库尚未支持对应端点或者缺少Pack EV Remote Control订阅。可先检查车辆是否支持远程空调功能如通过官方 App 验证。调度没有按预期时间执行优先检查readyAtTime是否为UTC 格式THH:MMZ并按本地时区正确换算同时确认activated: true已设置且车辆端没有其他调度与之冲突。状态刷新缓慢受每小时 60 次请求的轮询上限影响实体状态如调度确认信息的更新不是实时的请耐心等待下一轮数据拉取。想确认服务端是否正常根据集成文档的排障指引可以打开雷诺官方 Android/iOS App 快速验证服务可用性若需提交问题可启用调试日志并附带诊断数据。小结renault.ac_set_schedules是 Renault 集成中面向空调远程调度的核心动作一次调用即可写入 1–5 组调度支持按id管理、按天monday–sunday配置readyAtTime并允许保留或清除指定日期的设置。它适合与renault.ac_start临时启动和renault.ac_cancel取消启动组合构成完整的远程空调控制链路。使用时务必牢记三条约束通过vehicle选择车辆不支持 targets、时间为 UTC 格式、功能受订阅与车型支持范围限制。【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
