这是一份关于将芯步24路智能控制器集成到景观灯光远程控制系统中的解决方案。该方案面向拥有自主软件平台（Web/小程序/APP）的开发者或集成商，重点利用其开放的HTTP API接口实现无缝对接。
1. 概述与适用场景
在景观照明工程中，楼宇亮化、园林景观、桥梁装饰等场景往往需要控制大量的灯光回路。传统的控制方式依赖定时钟或 RS485 总线布线，不仅施工复杂，且后期维护成本高，无法满足节假日临时变动的需求。
本方案基于 芯步 24路远程多通道智能控制器，利用其标准 HTTP API 接口，将硬件设备快速集成到您的现有系统中。无论是智慧园区综合管理平台，还是定制开发的景观灯光小程序，通过本方案均可实现设备的远程启停、批量控制和智能场景联动。
该方案的核心优势在于：
快速集成：设备支持 WiFi 2.4G 直连，无需网关，通过 HTTP 协议即可通信。
接口通用：支持任何能发起 HTTP 请求的编程语言（如 Java, Python, PHP, Node.js, Go 等）。
部署灵活：支持公有云接入，也支持局域网（LAN）和私有化部署，满足内网安全要求。
2. 硬件设备参数概览
在开始集成前，请确认您手中的设备型号及规格：
| 项目 | 规格参数 |
|---|---|
| 产品型号 | UNI-KZQ-TY-24 |
| 控制路数 | 24 路（单路独立控制） |
| 工作电压 | DC 12V 2A |
| 负载能力 | 阻性负载总功率 Max 4400W；感性负载总功率 Max 700W |
| 通信方式 | 无线连接 (WiFi 802.11 b/g/n 2.4GHz) |
| 接口协议 | HTTP API (支持签名认证) ，MQTT (可选) |
| 特色功能 | 支持局域网通信、远程定时、批量控制、先通后断/先断后通逻辑 |
适用负载：可直接控制 LED 模组、灯带，外接交流接触器可控制大功率投光灯、洗墙灯。
3. 核心技术对接流程
集成工作的核心是调用芯步开放平台 API。架构流程如下：【您的应用端】 <--> 【芯步云/LAN】 <--> 【WiFi网络】 <--> 【24路控制器】 <--> 【灯具】
3.1 前期准备与设备激活
获取凭证：在芯步开放平台注册开发者账号，在“控制台-开发设置”中获取
AppID和AppSecret。设备配网：为控制器通电，通过简易配置模式将其连接至现场 2.4G WiFi 网络。
获取设备 ID：设备联网成功后，在平台控制台获取该控制器的唯一标识
device（通常是一串数字），后续 API 调用均需此 ID 。
3.2 核心 API 调用机制
为了防止接口被恶意篡改，所有 API 请求均需携带动态签名（Sign）。
3.2.1 鉴权签名算法
签名生成规则（伪代码逻辑）：
将
AppSecret进行 MD5 加密得到Secret_MD5。拼接字符串：
temp = Secret_MD5 + ts（其中ts为当前 Unix 时间戳，单位秒）。最终签名：
sign = MD5(temp)。
3.2.2 API 请求地址
POST https://api.thingboot.com/{AppID}/device/control/?sign={sign}&ts={ts}注：在局域网纯内网环境中，您也可以将 api.thingboot.com 替换为设备在局域网内的 IP 地址进行直连（私有化部署）。
3.2.3 请求体参数说明
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
| device | String | 是 | 您想控制的 24 路控制器的设备 ID |
| order | JSON String | 是 | 具体的控制指令，详见下方指令表 |
4. 景观灯光常用控制指令详解
针对 24 路控制器，您可以利用 order 参数实现精细化控制。以下为 JSON 格式的 order 内容示例：
4.1 单路独立控制
景观灯光调试或维护时，通常需要单独开关某一路。
4.2 批量一键控制
在大型活动或整点表演时，需要快速开启或关闭所有灯光。
进阶批量：只开启指定的几路（例如只开 1、3、5 路），关闭其他路可通过组合命令实现，或使用 batch 命令：
4.3 动态场景模式（先通后断 / 先断后通）
景观灯带常涉及电机或特殊驱动电源，突然断电可能损坏电源。使用“先通后断”功能可在切换场景时保持负载安全。
5. 项目集成进阶
5.1 状态同步与反馈机制
API 下发命令后，平台返回 code:200 仅代表指令下达成功，不代表继电器实际吸合。为了在您的界面上显示“真实开关状态”，：
利用芯步平台的消息推送功能，设备状态变化时会主动推送到您的服务器地址。
若设备支持 MQTT，订阅设备状态主题获取实时回传。
5.2 定时任务与无人值守
景观灯光通常具有“平日模式”和“节日模式”。
您无需在设备端编写定时逻辑，完全可以在您的服务端建立定时任务调度器（如 Linux Crontab）。
在指定时间点（如 18:00）调用 API 发送全开指令，22:00 发送全关指令。这样更容易管理和修改时间表，且所有设备时间统一（使用服务器时间）。
5.3 联动传感器实现节能
如果在景观区域部署了人体感应或环境光传感器（芯步生态产品），可以利用它们的联动功能：当环境光变暗（照度传感器触发）且检测到行人（雷达传感器触发）时，自动调用本 API 将 24 路灯光调至 50% 亮度或开启特定引导灯光，实现“人来灯亮、人走灯暗”的智慧节能效果。
6. 总结
通过将 芯步 24路远程多通道智能控制器 的开放 HTTP 接口集成至您的项目，可以快速构建一个低成本的云端景观照明系统。该方案不仅解决了传统 DMX512 或 485 布线难的问题，还赋予开发者比较高的灵活性——您既可以进行简单的单灯调试，也可以搭建复杂的城市级灯光秀集群控制。
实施关键点回顾：
注册平台获取 AppID/Secret。
设备配网获取 Device ID。
代码实现标准的 MD5 签名算法。
功能开发根据 UI 界面调用相应的单控（power1~24）或群控（power）指令。