弱电间照明联动：怎样把4路远程照明开关集成到自己的项目中_解决方案

CATALOG

芯步的4路控制器通过标准HTTP接口开放控制能力，核心是“设备ID + order命令”的组合。以下方案从接口对接、核心代码到场景联动，逐层说明如何将其集成到你自己的项目中。

解决方案：基于芯步开放接口的弱电间照明远程联动集成方案

1. 概述

在弱电间（弱电井/机房）环境中，照明灯通常处于常闭状态，运维人员进入时需要手动开灯，离开时常因忘记关灯导致能源浪费。本方案基于芯步智能照明控制器4路（UNI-KZQ-ZM-4） ，利用其HTTP API接口，将4路照明开关集成到你现有的运维管理系统（或中控平台）中。

核心目标： 实现远程集中控制、门禁/人体感应联动、定时策略及状态可视化监控。

2. 硬件选型

智能照明控制器4路（型号：UNI-KZQ-ZM-4）
- 功能： 提供4路独立继电器输出，每路支持AC 100-250V/10A，可直接控制弱电间的220V照明回路。
- 通信： 支持Wi-Fi（2.4GHz）或以太网接入局域网，无需额外网关。
- 优势： 体积小巧（DIN导轨安装），可安装在弱电间的配电箱内，不占用额外空间。

3. 接口集成架构

芯步采用HTTP API作为主要集成方式，架构分为三层：

设备层： 4路控制器安装在弱电间，连接照明灯。
接口层： 芯步开放平台提供的 https://api.thingboot.com/{AppID}/device/control/ 端点。
业务层： 你的现有服务器或运维系统（以下简称“你的系统”）。

通信流程：你的系统（如运维后台） --（HTTP POST + 签名）--> 芯步云平台 --（下行指令）--> 弱电间控制器 --（电路通断）--> LED照明

4. 关键集成步骤与技术实现

4.1 前期准备

注册与创建应用： 在芯步开放平台注册账号，获取 AppID 和 AppSecret。
设备配网与ID获取： 将控制器上电并连接至弱电间的WiFi/网络，在平台控制台获取唯一的 Device ID（例如：820720）。

4.2 接口鉴权（签名机制）

为了防止接口被恶意调用，需要在HTTP请求头或参数中携带签名。规则如下：

参数：sign（签名）， ts（Unix时间戳，秒级）。
算法：
sign = md5( md5(AppSecret) + ts )
注意：先将AppSecret进行一次MD5，将其结果拼接上时间戳，再整体做一次MD5。

4.3 下发控制指令（核心API）

这是集成的核心步骤。你需要向以下地址发送POST请求：URL：http(s)://api.thingboot.com/{AppID}/device/control/?sign={sign}&ts={ts}

请求体（JSON格式）：针对“弱电间”场景，假设你需要控制4个不同的区域（例如：1号弱电间、2号弱电间、走道灯、应急灯），指令如下

全开所有灯：
{ "device": "820720"， "order": {"power1": 1, "power2": 1, "power3": 1, "power4": 1} }
独立控制（只关第3路）：
{ "device": "820720"， "order": {"power3": 0} }
高级联动：脉冲/点动模式（例如：开门触发灯亮30秒后灭）此命令适合配合门磁感应，实现“人来灯亮，人走灯灭”。
{ "device": "820720"， "order": {"reset": {"relay": [1], "interval": 30000}} // reset代表先断后通，interval为30000毫秒 } ```[citation:5]

4.4 在你的项目中代码实现（示例）

这里以最常见的Node.js后端为例，展示如何将上述逻辑封装成一个服务函数：

// 引入依赖
const crypto = require(‘crypto’);
const axios = require(‘axios’);

// 配置信息
const config = {
    appId: ‘YOUR_APP_ID’,
    appSecret: ‘YOUR_APP_SECRET’,
    deviceId: ‘820720’, // 你的控制器ID
    baseUrl: ‘https://api.thingboot.com’
};

// 生成签名函数
function generateSign() {
    const ts = Math.floor(Date.now() / 1000);
    // 第一层md5
    const md5Secret = crypto.createHash(‘md5’).update(config.appSecret).digest(‘hex’);
    // 拼接并第二层md5
    const signStr = md5Secret + ts;
    const sign = crypto.createHash(‘md5’).update(signStr).digest(‘hex’);
    return { ts, sign };
}

// 控制照明的核心函数
async function controlLight(routeMap) {
    const { ts, sign } = generateSign();
    const url = `${config.baseUrl}/${config.appId}/device/control/?sign=${sign}&ts=${ts}`;
    
    const payload = {
        device: config.deviceId,
        order: routeMap // 例如 { "power1": 1, "power2": 0 }
    };

try {
        const response = await axios.post(url, payload, {
            headers: { ‘Content-Type’: ‘application/json’ }
        });
        // code=200仅代表指令下发成功，不代表设备已执行
        if (response.data.code === 200) {
            console.log(‘指令已送达，弱电间照明状态变更’);
        }
    } catch (error) {
        console.error(‘控制失败’， error);
    }
}

// 调用示例:打开第1路和第3路
controlLight({ "power1": 1, "power3": 1 });

5. 场景联动方案：弱电间智能化体验

利用接口的灵活性，你可以将照明逻辑深度嵌入到你的业务流程中，而不仅仅是手动点击按钮。

第一种场景：运维系统联动（可视化门禁）

需求： 运维人员在网页后台点击“XX弱电间”，弹窗显示该弱电间的实时状态。
集成方式： 在你的CMDB（配置管理数据库）中增加“关联设备ID”字段。当工单系统派发弱电间巡检任务时，在页面UI上直接显示“一键开灯”按钮。
逻辑：点击按钮 -> 请求你的后端 -> 调用芯步API（power1=1） -> 反馈日志“灯光已开启”。

第二种场景：红外/门磁联动（人来自动亮）

需求： 虽然API可以远程控制，但运维人员进弱电间时往往没空掏手机。
解决方案： 将控制器自带的开关量信号输入接口接入门磁或红外传感器。
逻辑： 传感器触发 -> 控制器硬件逻辑自动执行（不经过云端，更快） -> 接通照明继电器。同时，控制器可配置“延时断开”命令，人员离开关门后自动熄灭，避免长明灯。

第三种场景：定时策略（节能）

需求： 每晚23：00后，强制关闭所有弱电间的照明，防止遗忘。
集成方式： 在你的服务器上设置一个Cron定时任务。
代码逻辑：0 23 * * * 执行 controlLight({ “power1”： 0, “power2”： 0, “power3”： 0, “power4”： 0 })。

6. 关键注意事项

异步反馈机制：API返回 {“code”：200} 仅代表平台收到了指令。如果设备恰好断网或离线，灯不会亮。对于“弱电间照明”这种对可靠性要求比较高的场景（涉及运维安全），监听云端的异步消息推送（MQTT），确认设备真正回复了“执行成功”。
本地回环（局域网）：弱电间通常网络环境复杂。如果弱电间WiFi信号不稳定，使用支持私有化部署或局域网直连的版本，直接在局域网内发送HTTP请求，绕过外网云平台，延迟更低更可靠。
物理应急保留：虽然实现了远程控制，但请一定要保留弱电间内的机械翘板开关，并串联在回路中。防止因网络故障或服务器宕机导致运维人员进入后无法开灯检修。

7. 总结

通过对接芯步4路控制器的 device/control 接口，你可以在15分钟内实现“弱电间照明”的数字化改造。这不仅解决了远程开关的基础需求，更关键的是将“照明状态”与你的“运维工单”、“门禁日志”结合起来，实现“无人在时全关、有人开门即亮”的真正智能化弱电机房管理。