芯步的智能开关和控制器均支持通过HTTP接口直接下发延时指令，无需在云端额外维护定时任务队列。针对景观照明的常见场景——如“人来渐亮、人走后延时关闭”或“分组灯带依次亮起”——可以通过设备内置的point（先通后断）和reset（先断后通）命令直接实现。以下是基于其开放接口的完整解决方案：
解决方案：基于芯步开放接口的景观照明延时通断控制系统
1. 解决概述
本方案的目标是利用芯步提供的智能照明控制器（如4路/8路控制器）或智能墙壁开关，通过其标准的HTTP API接口，将传统的景观照明系统升级为可编程的智能照明系统。
核心目标是实现“延时通断控制”，包括但不限于：
通电延时：触发后，照明设备延时一段时间再启动。
断电延时：触发后，照明设备延时一段时间再关闭。
联动延时：某一路照明开启后，延时触发另一路照明的开启或关闭。
2. 硬件选型
根据景观照明通常涉及的电压和功率需求，选用以下芯步产品
| 特性 | 推荐型号/系列 | 适用场景 |
|---|---|---|
| 高功率照明控制 | 智能照明控制器 (如UNI-KZQ-ZM-4) | 控制大型景观灯带、投光灯、草坪灯，单路支持10A甚至16A大负载。 |
| 墙体/小回路控制 | 智能墙壁开关 (1/2/3路) | 控制楼宇亮化局部回路或小功率装饰灯，支持标准86型面板无缝替换。 |
| 环境感知联动 (进阶) | 智能人体存在雷达传感器 | 实现人来灯亮、人走灯灭的节能联动控制。 |
3. 接口对接架构
芯步的开放接口基于HTTP/HTTPS协议，采用简单的POST请求即可完成控制，对接架构如下：
基础设施层：安装芯步智能控制器，替换原有传统断路器/开关，设备通电并连接2.4GHz Wi-Fi。
接口调用层：您的景观照明管理平台（云服务器或本地服务器）通过调用芯步提供的统一API，向指定设备下发指令。
通信链路
管理平台 <---> 芯步云/私有化API <---> (Wi-Fi) <---> 智能控制器。实测命令下发到设备执行响应约为80-120ms。
4. 实现“延时通断”的三种编程方法
芯步的接口在 order 参数中提供了丰富的指令集，实现延时不需要在服务器端写循环等待代码，而是直接由设备硬件执行。
方法一：硬件级延时指令（推荐，最稳定）
直接向设备发送带有时间参数的JSON指令，利用设备内置逻辑实现延时。
场景 A：延时断开（先通后断）
需求：景观喷泉旁的灯光打开，5分钟后自动关闭。
指令：使用
point1参数，单位为毫秒。效果：线路1立即接通（灯亮），5分钟后（300,000毫秒）自动断开（灯灭）。
场景 B：延时接通（先断后通）
需求：关闭某一区域的景观灯柱，2分钟后自动重新点亮（用于散热或特定节律）。
指令：使用
reset1参数。效果：线路1立即断开（灯灭），2分钟后自动接通（灯亮）。
场景 C：状态保持（防止用户误触）
需求：在景观核心区域，强制保持照明开启状态，任何人通过物理按键关闭后，3秒内自动恢复。
指令：使用
power1配合keep和revert对象。效果：强制开灯，如果有人手动关灯，3秒后设备会自动强制开灯。
方法二：云端/服务器端逻辑控制（适合复杂编排）
对于复杂的景观照明秀（如“渐变流水灯”效果），需要通过您自己的服务器设置定时任务或延迟队列。
定义多步动作：假设控制一组“蒲公英灯阵”。
代码逻辑
Step 1: 下发
{"device":"ID_1", "order":{"power1":1}}(第0秒，第一组亮)。Step 2: 服务器线程
sleep(2)或设置定时任务，2秒后执行。Step 3: 下发
{"device":"ID_1", "order":{"power2":1}}(第2秒，第二组亮)。Step 4: 服务器线程
sleep(2)...Step 5: 下发
{"device":"ID_1", "order":{"power1":0, "power2":0}}(全部熄灭)。
方法三：传感器联动（自动化场景）
结合芯步的人体存在传感器实现“人来灯亮，人走延时灭”。
配置接收地址：在芯步控制台中，配置传感器的消息推送URL为您自己的服务器地址。
业务逻辑
传感器上报：
{"device":"sensor_01", "status":"someone"}。您的服务器接收数据后，调用控制器接口：
{"device":"light_01", "order":{"power1":1}}(亮灯)。传感器上报：
{"device":"sensor_01", "status":"none"}。您的服务器接收数据后，调用控制器接口：
{"device":"light_01", "order":{"point1": "60000"}}(无人的情况下，延时60秒关灯)。
5. 关键参数配置说明
| 参数关键字 | 数据类型 | 说明 | 示例值 |
|---|---|---|---|
powerX | Int / Object | 基础开关(0/1)或状态保持对象 | {"power1":1} 或 {"power1":{"keep":"1","revert":"5"}} |
pointX | String | 先通后断：立即开启，延时后关闭。单位毫秒 | "point1":"5000" (开5秒后关) |
resetX | String | 先断后通：立即关闭，延时后开启。单位毫秒 | "reset1":"10000" (关10秒后开) |
| 签名 | sign | MD5(MD5(开发者密码) + “.” + 时间戳) | 用于接口鉴权，防止非法控制 |
6. 实施步骤简述
设备安装：在景观照明配电箱内安装芯步智能控制器（如4路控制器），连接零火线，并接入Wi-Fi网络。
获取凭证：在芯步开发者后台获取
AppId和开发者密码，计算签名方法参考文档md5(md5(密码) + “.” + ts)。接口调试：使用 Postman 或 curl 命令向
http(s)://api.thingboot.com/{AppId}/device/control/发送 POST 请求进行测试。系统集成：将上述API集成到现有的景观照明管理系统中。
7. 方案优势
接口友好：无需关心底层复杂的通讯协议，HTTP接口可在10分钟内完成对接测试。
低延迟高可靠：命令响应极快（约100ms），且设备支持时序保护，避免瞬时大电流冲击损坏设备。
强大的边缘计算能力
point和reset等指令属于设备端执行，即使断网（局域网模式下），已下发的延时指令依然生效。
通过上述方案，您可以快速利用芯步的硬件能力，为景观照明系统增加灵活、精准的延时控制功能。