便利店通常营业至深夜，灯光是营造氛围、吸引顾客和引导动线的关键。如何在不频繁改动现有线路的前提下，实现对店内各路灯光（如招牌灯、货架层板灯、收银台灯、鲜食区照明等）的灵活控制，是许多便利店面临的现实问题。基于芯步24路智能分体控制器的开放接口，以下是完整的接入方案。
1. 背景与需求分析
在连锁便利店运营中，电力成本是重要的支出项。尤其是罗森、美宜佳等品牌门店，面积虽小但灯具众多（如货架层板灯、鲜食区照明、招牌灯、冷柜灯等），常存在“人走灯未灭”或非高峰期无效照明的情况 。同时，传统的灯光控制依赖墙壁开关，无法实现远程调度或与传感器联动。
痛点：
能耗浪费： 夜间客流低谷期，全店照明满负荷运行导致不必要的电费支出。
管理不便： 店员手动开关灯繁琐，且容易忘记操作。
缺乏联动： 灯光无法与“有人/无人”状态或特定时间（如日出日落）自动关联。
布线改造成本高： 传统KNX或总线型智能照明系统需要重新铺设信号线，施工周期长，影响便利店正常营业。
建设目标：利用芯步 UNI-KZQ-TY-24 24路智能分体远程交直流输出控制器，通过其开放API接口，在不改变原有强电线路的基础上，将现有灯具回路接入控制器，实现对全店24路灯光的分组、定时、远程及联动控制 。
2. 产品选型与核心优势
本方案硬件选型为 24路智能分体远程交直流输出控制器，其型号参数基于 UNI-KZQ-TY-24 标准。
为何选择该设备？
路数充足，分区精细： 提供24路继电器输出，足以覆盖便利店常见的照明分区（如：1-招牌灯、2-门头灯箱、3-收银台背景、4-中央货架层板、5-冷藏柜照明等）。
交直流兼容，负载适配性强： 直接支持直流12V LED灯带，同时通过内置继电器控制交流220V回路，无需额外转换器 。
无线部署，无需网关： 设备直接通过板载Wi-Fi (2.4GHz) 连接路由器，无需购买额外的网关或主机，降低设备投入成本，减少故障节点 。
接口开放，私有化部署： 支持纯局域网（LAN）运行和标准HTTP API调用，数据安全可控，响应速度快（毫秒级）。
| 项目 | 参数/规格 | 项目 | 参数/规格 |
|---|---|---|---|
| 产品型号 | UNI-KZQ-TY-24 | 无线连接 | Wi-Fi 2.4GHz 802.11 b/g/n |
| 控制路数 | 24 路（独立控制） | 工作电压 | DC 12V 2A |
| 负载功率 | 单路最大 2200W（阻性） | 接口协议 | HTTP/HTTPS Web API |
| 通信方式 | WiFi 2.4GHz | 特色功能 | 定时任务、群组控制 |
3. 系统设计
系统采用去中心化的直连架构，避免单点故障。核心是“云端/本地服务器 — 控制器 — 灯具”三层模型。
基础设施层：
执行单元： 24路控制器安装在便利店配电箱旁，将原有的24个照明回路空气开关下方线路，依次接入控制器的24路输入端。保留原有机械开关作为备用（串联）。
传感器（可选）： 部署人体红外传感器（亦可通过芯步开放接口接入），用于检测货架区域是否有人流 。
网络传输层：
控制器通过店铺现有的商用路由器接入互联网或本地局域网。芯步设备支持“心跳”机制，确保连接稳定性。
应用管理层：
本地服务器/PC： 便利店后台系统或总部服务器。
SaaS平台： 若使用芯步官方控制台，或自行开发的私有化部署平台。
移动端： 店长手机（微信小程序/APP）作为远程遥控器。
4. 接入实施步骤（API对接详解）
本部分重点描述如何将设备物理接入系统并利用API进行控制。
4.1 设备配网与激活
步骤一：设备上电将控制器接上12V电源，指示灯亮起。长按配网键，设备进入配网模式。
步骤二：网络配置使用芯步官方App或通过其提供的 SoftAP配网接口，将门店的WiFi SSID和密码写入设备。注意： 为确保响应速度，便利店使用独立的2.4GHz IoT信号频道。
步骤三：获取设备唯一标识配网成功后，在芯步物联网控制台或通过设备配网接口，获取该控制器的唯一 Device ID。这是后续所有API调用中的核心参数 。
4.2 API接口集成开发与签名机制
芯步的开放接口采用标准的HTTP协议，开发者可利用任何后端语言（Python, Java, Go, Node.js）或前端（Ajax）进行调用。对于便利店系统，在总部服务器后台做二次封装。
签名算法（Sign）：为了安全，所有请求需携带签名。请求格式一般为：https://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}
AppId：平台分配的应用标识。
ts：Unix时间戳，防重放攻击。
sign：通常为
md5(AppId + AppSecret + ts)的哈希值 。
4.3 下发单路与批量控制指令（核心逻辑）
控制器接入项目后，最频繁的操作是开关灯。以“关闭第1路”和“夜间模式”为例：
第一种场景：关闭收银台上方的射灯（例如设备ID为：123456，线路为3路）
URL：
https://api.thingboot.com/YoYoApp/device/control/Method： POST
Body (JSON)：
*命令解析：powerX 是标准指令集，X代表1-24路。*
第二种场景：晚间23点后进入节能模式（仅保留1路招牌灯和2路安防灯）在实际代码逻辑中，需要连续发送指令或使用批量指令。
批量关闭其他20路指令
此命令利用了batch批量操作功能，可一次性控制多个指定继电器状态，极大减少HTTP请求的网络开销。
4.4 配置定时与联动任务
不需要每次都通过代码发指令，可以在项目集成时利用控制器的云端功能预设逻辑：
定时任务： 调用
定时任务设置接口，配置 Cron 表达式。示例：
0 30 23 * * ?-> 每晚23:30执行全关（除夜灯外的所有路）。示例：
0 30 8 * * ?-> 早上8:30打开所有货架照明。
传感器联动： 如果项目中同时接入了“芯步人体传感器”，可通过Webhook配置联动规则。当传感器30分钟无人触发时，自动调用控制器的关灯接口，动态节能 。
4.5 项目中的特殊场景处理：感性负载与接触器
便利店中存在大量LED灯管和灯带，属于容性/感性负载。控制器继电器虽然支持一定功率，但在大范围启动时瞬间电流较大。
方案： 在API逻辑中加入 “分批启动” 策略。即在“全开”指令发出时，后端代码应生成间隔200毫秒的延迟指令（如先开1-8路，延时0.2秒后开9-16路），避免瞬间电流冲击损坏继电器触点。该控制器支持
point（先通后断）指令集，可设置interval参数实现软启动 。
5. 项目落地实施流程
回路梳理与标记： 在现场配电箱处，使用标签机逐个标记24路空气开关对应的灯具位置（如：关一路看哪排灯灭）。制作对照表映射到控制器的物理端口。
旁路接线： 将原空开下端出线剪断，串联接入控制器的继电器输入端和输出端。保留原空开作为总闸，保留一路紧急旁路开关，防止网络故障时无法照明。
软件部署：
部署本地微服务（Docker容器）。
导入芯步SDK，封装
LightService类，包含turnOn(relayId)和nightMode()等方法。开发简易的H5管理后台，嵌入便利店原有的POS系统或独立App，生成可视化界面（平面图上点击控制）。
测试与验收：
响应延时测试： 局域网内压测，API响应时间应 < 100ms。
稳定性测试： 模拟网络断开重连，设备应具备断网自动重连机制。
能耗对比： 接入后一周内，对比历史同时段电费数据。
6. 总结
通过将芯步24路智能分体控制器接入便利店项目，利用其完备的 HTTP API接口 和 私有化部署能力，不仅实现了对照明系统的精细化、远程化管理，还为未来引入更多传感器（光照度、人流）提供了可扩展的物联网基础架构。这套方案施工简单（仅需电工接线），开发量适中（只需处理HTTP请求和业务逻辑），能有效解决便利店行业“降本增效”的核心诉求。