店铺照明设备控制：怎样把4 路远程照明开关接入到软件项目中_解决方案

CATALOG

芯步的智能照明控制器4路（UNI-KZQ-ZM-4）通过标准HTTP接口开放控制能力，可快速集成到各类软件项目中。以下方案涵盖硬件选型、接口对接、项目集成架构和代码示例，帮助你在10分钟内完成4路远程照明开关的接入。

一、硬件选型：智能照明控制器4路 (UNI-KZQ-ZM-4)

首先，我们需要明确控制对象。针对店铺照明改造，选用的是芯步“智能照明控制器4路”（型号：UNI-KZQ-ZM-4）。

核心功能：支持4路独立远程控制，每一路都可以单独控制开关，适用于店铺筒灯、灯带、射灯、招牌灯的分路控制。
电气参数：工作电压 AC 100-250V（宽电压适应），每路额定电流通常达10A，可直接驱动照明设备，无需外接继电器。
网络连接：支持2.4G WiFi，无需网关，直连路由器。
开放能力全面开放HTTP接口，只要你软件能发起HTTP请求，就能控制它。

二、接口对接核心：签名机制与指令下发

芯步的开放接口设计非常简洁，核心是HTTP请求 + 动态签名验证。以下是接口对接的详细步骤说明：

1. 准备凭证

在芯步物联网控制台注册设备后，你会获得以下关键信息：

AppId：你的应用唯一标识。
开发者密码 (Secret Key)：用于生成签名，请妥善保管。
设备ID (Device ID)：即你要控制的那台控制器的编号（例如：820720）。

2. 签名生成规则

为了安全，接口采用动态签名验证。规则如下（以示例中的逻辑为准）：

签名 (sign) = md5( md5(开发者密码) + “.” + 时间戳(ts) )

*例如：如果你的密钥是 “abc123”，时间戳是 “1678886400”，你需要计算 MD5(MD5(“abc123”) + “.” + “1678886400”)。*

3. 下发控制指令

请求地址http(s)://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}
请求方式：POST
Content-Type：application/json
请求体 (Body)
{ "device": 820720, // 替换为你的设备ID "order": { "power1": 1, // 1表示开启第1路 "power2": 0, // 0表示关闭第2路 "power3": 1, // 开启第3路 "power4": 0 // 关闭第4路 } }
*命令解读：上述JSON指令将控制设备ID为820720的控制器，打开第1、3路灯光，关闭第2、4路灯光。响应速度约为80-120ms。*

三、软件项目集成实战

无论你使用的是Java、Python、PHP、Go，还是前端JavaScript，只要遵循上述HTTP协议即可。这里提供一个 Node.js (JavaScript) 和 Python 的极简集成示例。

场景：批量控制与单独控制

在实际店铺场景中，可能有“一键打烊”（关闭所有灯）、“一键开店”（开所有灯）或“单独控制橱窗灯”的需求。

方案：封装一个控制函数

1. Node.js 示例 (使用 Axios)

const crypto = require('crypto');
const axios = require('axios');

// 配置参数
const config = {
    appId: 'YOUR_APP_ID',
    secret: 'YOUR_DEV_SECRET', // 开发者密码
    deviceId: 820720           // 你的设备ID
};

// 生成签名
function generateSign(secret) {
    const ts = Math.floor(Date.now() / 1000); // 秒级时间戳
    const md5Secret = crypto.createHash('md5').update(secret).digest('hex');
    const signRaw = md5Secret + '.' + ts;
    const sign = crypto.createHash('md5').update(signRaw).digest('hex');
    return { ts, sign };
}

// 控制灯光
async function controlLight(orderData) {
    const { ts, sign } = generateSign(config.secret);
    const url = `http://api.thingboot.com/${config.appId}/device/control/?sign=${sign}&ts=${ts}`;
    
    try {
        const response = await axios.post(url, {
            device: config.deviceId,
            order: orderData
        });
        console.log('控制成功:', response.data);
    } catch (error) {
        console.error('控制失败:', error.message);
    }
}

// --- 业务调用示例 ---

// 1. 开店:全部打开
controlLight({ power1: 1, power2: 1, power3: 1, power4: 1 });

// 2. 单独关闭一路（例如:关闭橱窗灯 power3）
controlLight({ power3: 0 });

// 3. 打烊:全部关闭
controlLight({ power1: 0, power2: 0, power3: 0, power4: 0 });

2. Python 示例 (使用 Requests)

四、高级应用：时序控制

除了简单的开关，芯步的接口还支持批量控制和延时通断，这在店铺节能和场景联动中非常实用。

例如，如果你需要实现 “先关闭第1路，延时3秒后关闭第2路” （比如某些特殊灯光需要散热顺序），可以利用 reset 命令：

配合传感器联动：当店铺中的人体传感器检测到无人时，通过你的后端服务调用此接口，即可实现智能关灯。

五、架构落地方案

对于一家拥有多家分店的品牌而言，采用以下系统架构来集成4路控制器：

设备层：各分店部署“智能照明控制器4路”，连接店内照明回路，通过店铺WiFi联网。
云平台层：芯步的API充当物联网连接器，负责消息转发和设备状态同步。
业务应用层（你的软件项目）：
- SaaS后台：在这里创建“开店模式”、“打烊模式”、“清洁模式”。点击按钮，调用API批量控制所有分店。
- 小程序/App：店长手机端通过微信小程序，直接调用API，实现远程巡检和关灯（例如：离开店铺后发现忘关灯，手机一键关闭）。
- 定时任务：你的服务器设置Cron Job，每天早8:00调用API开店灯，晚10:00调用API关灯，实现无人值守运行。

通过这套方案，你可以在不改造现有店铺强电线路的情况下（仅替换空开或加装模块），快速将传统照明升级为物联网智慧照明系统。