商场展柜电源控制：如何将24 路智能远程集中控制模块对接到软件项目中_解决方案

CATALOG

芯步的24路控制器通过HTTP接口开放控制能力，非常适合商场展柜的集中电源管理。下面从对接原理、接口调用方法到代码示例，完整梳理一遍落地思路。

解决方案：商场展柜电源集中控制

基于芯步24路智能远程控制模块的软件对接实践

一、场景痛点与需求

在商场或展览馆中，往往有几十甚至上百个展柜。传统的管理方式是需要人工下班挨个关电源、上班挨个开，不仅费人力，还容易遗漏。

如果能把这 24 路（相当于 24 个插座）集成到我们现有的商场管理系统或小程序里，就能实现：

一键全开/全关：比如晚上 10 点打烊，系统自动切段所有电源。
分区精细化管理：比如珠宝区的灯要 24 小时亮，但服装区的灯要定时关。
远程故障排查：运营人员不用跑到配电间，手机上点一下就能重启某台死机的设备。

下面我们要解决的，就是如何打通“软件”和这个“硬件盒子”的任督二脉。

二、硬件核心信息解读

首先得了解一下这个“大家伙”。根据资料，芯步的这款 UNI-KZQ-TY-24 控制器是专为这种场景设计的。

核心能力：它提供了 24 路 继电器输出。简单理解就是，它可以独立控制 24 个展柜的电源通断。
接口协议：它走的是 HTTP 协议，不是那种复杂的私有协议。这意味着不管你后端是 Java、Python 还是 PHP，用 http 库就能直接调。
网络要求：支持 局域网 和 私有化部署。这对商场很重要，毕竟商场网络环境往往比较复杂，有时候没外网也得能控制。
命令规则：控制第 1 路是 power1，第 2 路是 power2……以此类推，非常直观。

三、软件对接设计

我们采用最标准的 HTTP 请求模式，不需要复杂的 MQTT broker。

设备层： 24路控制器通电商场 WiFi 或有线网络，拿到一个内网 IP。
云平台/本地服务器：芯步提供了一个统一的接口网关（可以是公有云 API，也可以是私有化部署的本地 API）。
业务系统（你的软件）：你的商城小程序或后台系统，直接通过 HTTP 调用接口。

四、实战：如何用代码控制它（核心部分）

这部分比较干，但也很简单。控制这个盒子主要分三步：搞到凭证、算出签名、发送命令。

1. 准备动作：拿到钥匙（AppID 和 Secret）芯步的接口很安全，不是谁随便发个请求都能控制你商场的电。你需要先登录芯步的控制台，拿到 AppID 和 AppSecret。

2. 最难的一步：签名计算稍微有一点点绕的就是签名，这是为了防止别人伪造请求。官方的规则是：sign = md5( md5(AppSecret) + ts )。

ts 是当前的时间戳。
其实说白了就是把你的 AppSecret 加密一次，再加上时间戳，再整体加密一次。

3. 发送命令：控制 24 路开关假设我们想控制 1 号展柜（第一路）开启，以及 3 号展柜（第三路）关闭。

请求地址： https://api.thingboot.com/{你的AppId}/device/control/?sign={计算出的签名}&ts={当前时间戳}
请求方式： POST
请求 Body (JSON)
{ "device": "这里填设备的ID编号", "order": { "power1": 1, // 打开第1路 "power3": 0 // 关闭第3路 } }

4. 代码示意（如果后端是Node.js）为了让更直观，这里写个伪代码逻辑：

// 1. 引入加密库
const crypto = require('crypto');

// 2. 配置参数（从后台抄过来）
const config = {
    appId: 'YOUR_APP_ID',
    appSecret: 'YOUR_APP_SECRET',
    deviceId: '1234567' // 硬件盒子的ID
};

// 3. 封装一个控制函数
function controlSwitch(routeNumber, action) {
    let ts = Math.floor(Date.now() / 1000); // 当前秒级时间戳
    
    // 第一步加密:md5(secret)
    let step1 = crypto.createHash('md5').update(config.appSecret).digest("hex");
    // 第二步加密:md5(step1 + ts)
    let sign = crypto.createHash('md5').update(step1 + ts).digest("hex");

// 构建命令对象，例如 { "power1": 1 }
    let command = {};
    command[`power${routeNumber}`] = action;

// 发起请求
    let url = `https://api.thingboot.com/${config.appId}/device/control/?sign=${sign}&ts=${ts}`;
    
    // 使用 axios 或 fetch 发送请求
    axios.post(url, {
        device: config.deviceId,
        order: command
    }).then(res => {
        console.log(`展柜 ${routeNumber} 控制成功`);
    });
}

// 调用示例:关掉所有展柜（循环调用1-24路）
for(let i = 1; i <= 24; i++) {
    controlSwitch(i, 0); // 0=关闭，1=开启
}

五、高级玩法与优化

批量控制，别再写 24 行代码虽然接口每次传参可以只写变化的字段，但如果要全开，你可以构造一个巨大的 JSON 对象，把 power1 到 power24 全塞进去，一次 HTTP 请求搞定所有展柜。
定时任务不需要在硬件里设置。商场系统里肯定有定时任务（如 Cron Job）。直接在服务器设置：
- 0 21 * * * ：调用关闭所有电源接口（晚上9点断电）。
- 0 9 * * * ：调用开启所有电源接口（早上9点送电）。
局域网优先资料提到设备“支持私有化、局域网” 。如果你的软件系统是部署在商场本地的服务器上，直接通过内网 IP 调用 API。这样延时极低（实测 80-120ms），而且即便外网断了，也不影响展柜的定时开关。
负载注意看参数，这个盒子虽然能带很大功率（总阻性负载最大 4400W），但如果展柜里都是 LED 灯问题不大，如果接的是电机或大功率射灯，注意单路不要超过 350W 感性负载，否则容易烧触点。

六、总结

把这套方案落地下来，最直观的感受就是：“解放人力”。芯步的这个 24 路控制器由于开放了标准的 HTTP 接口，实际上把它当成一个“网络版 24 插排”就行了。

开发人员只需要关心业务逻辑（比如：是双击小程序卡片开灯？还是传感器感应到人开灯？），完全不需要关心底层的无线协议，直接 发 HTTP 请求 就完事了。