店铺招牌控制：怎么把24 路智能远程集中控制模块对接到软件项目中_解决方案

CATALOG

24路智能远程集中控制模块通过标准HTTP接口实现对接，核心是构造签名、调用控制指令即可独立控制24路中的任意一路或多路。以下从接口规范、对接流程、代码示例到店铺招牌应用场景，给出完整方案。

解决方案：基于芯步24路智能远程集中控制模块的店铺招牌控制系统对接

一、背景与需求

在现代店铺运营中，招牌灯光控制不仅是日常开关需求，更涉及到根据不同时间段（如营业/打烊）、不同场景（如节假日、促销）进行多模式切换。传统的24路强电控制柜体积大、布线复杂，且无法实现远程集中管理。

芯步的 智能通用控制器24路（型号：UNI-KZQ-TY-24） 凭借其 无线Wi-Fi连接、24路独立分控 及 开放HTTP接口 的特性，可以完美替代传统控制柜。本方案的目标是阐述如何将该硬件无缝对接到现有的软件系统（如SaaS店铺管理系统、小程序或PC管理后台）中。

二、核心技术原理

该控制器采用直连Wi-Fi 2.4G网络的方式，无需网关中转。其核心开放策略是 “HTTP API”。

对接协议：HTTP/HTTPS
请求方法：POST
数据格式：JSON
核心优势：支持局域网和公网直连，支持私有化部署，响应速度极快（约80-120ms）。

三、详细对接实施步骤

要将24路模块集成到您的软件项目中，需按以下流程进行开发：

1. 设备初始化与网络配置

在软件代码编写前，需要确保硬件在线。

配网：通过设备配网功能将控制器连接到店铺的2.4G Wi-Fi网络。
获取唯一标识：在芯步开发者后台或设备标签上获取该设备的 Device ID （设备编号） 和 AppId/AppKey，这是软件寻址和控制该设备的唯一凭证。

2. 接口鉴权机制

项目后端需要实现签名算法（Sign），以防止接口被恶意调用。在每次请求中通常需要携带 sign（签名）和 ts（时间戳）。

签名算法示例（伪代码逻辑）
1. 将请求参数（如 Device ID, AppKey, Timestamp）按字母顺序排序。
2. 拼接成字符串并进行MD5或哈希加密。
3. 将生成的Sign放在请求URL中。

3. 核心控制指令开发（重点）

针对店铺招牌控制，主要调用 单路控制 和 批量控制 接口。

根据芯步的API规范，24路分别对应参数 power1 至 power24。

1. 单路控制（例如：只打开“招牌主灯”）
- URL： http（s）：//api.thingboot.com/{AppId}/device/control/
- Body （JSON）
  { "device": "这里的设备ID"， "order": { "power1": "on" } // 控制第1路线路开启 }
2. 多路组合控制（例如：开启所有招牌灯箱，对应1-10路）
- 为了提高效率，可以利用 batch（批量）指令。
- Body （JSON）
  { "device": "设备ID"， "order": { "batch": "1，2，3，4，5，6，7，8，9，10" } // 开启指定回路 }
3. 定时/延时任务（例如：灯箱开启2小时后自动关闭）
- 利用 reset （先断后通/定时断）功能，无需在软件侧写定时任务。
- Body （JSON）
  { "device": "设备ID"， "order": { "reset1": 7200000 } // 开启第1路，并在2小时（7200000毫秒）后自动关闭 }

4. 状态同步机制

为了在软件界面实时显示招牌的“亮/灭”状态，有两种方案：

主动查询：调用设备状态查询接口，获取当前各回路 power1~power24 的状态。
被动接收（推荐）：配置消息服务器。设备状态改变时，会主动推送数据到指定的URL，方便软件实时更新UI。

四、软件项目集成代码示例（逻辑示意）

假设您使用 Python （Django/Flask） 或 JavaScript （Node.js/前端） 作为开发语言，对接流程如下：

前端触发按钮（例如：点击“开门店招牌灯”）：

后端处理逻辑（Python 示意）：

五、店铺招牌控制的典型场景应用

第一种场景：按日/周计划表自动控制软件后台设置策略：

18：00 （营业前1小时） -> 调用接口开启 1-5路（主招牌+侧招）。
20：00 （客流高峰） -> 调用接口开启 6-8路（装饰氛围灯带）。
02：00 （打烊） -> 调用接口开启 power1-24 全部关闭（off），仅保留一路安防监控电源（如需要）。

第二种场景：一键联动（ECDH）在软件中设置“一键开店/打烊”按钮：

点击“开店”：顺序发送指令或批量指令，延迟500ms依次启动，减少电流冲击。
点击“打烊”：立即发送全部关闭指令。

第三种场景：应急与监控当传感器检测到店铺内温度异常或烟雾报警时，软件系统可立即通过接口切断除应急照明外的所有招牌电源，保障安全。

六、实施注意事项（Tips）

负载匹配：虽然控制器单路可支持较高功率，但如果店铺招牌是大功率霓虹灯或室外大型LED屏，通过控制器的“干接点”模式外加交流接触器，以免烧毁板载继电器。
网络稳定性：该设备依赖2.4G Wi-Fi。店铺路由器避免设置双频合一，且需保证设备在弱电箱或金属电箱内的信号强度（必要时外接天线）。
私有化部署：如果对数据安全要求比较高（如连锁总店不希望经过云端），可要求芯步提供私有化部署包，将API服务部署在本地服务器，实现纯局域网控制，外网断开也能控制招牌。

七、总结

通过对接芯步24路智能远程集中控制模块，您的软件项目将立即获得物理世界控制能力。开发者无需深入硬件底层，只需关注 HTTP请求构造 与 业务逻辑结合。这种对接方式可将原本需要布线和PLC编程的复杂工程，简化为几行代码，极大缩短了“店铺智能化”改造的交付周期。