智慧教室灯光设备集中控制：如何把12路分体远程控制箱集成到自己的项目中_解决方案

CATALOG

芯步的智能分体控制箱支持12-24路独立控制，通过开放的HTTP接口可轻松集成到教室管理系统中。以下方案涵盖接口调用、签名算法、前后端代码示例及场景配置。

解决方案：智慧教室灯光设备集中控制

基于芯步12路智能分体控制箱的集成实战

1. 项目概述与准备

在现代智慧校园建设中，对教室灯光进行分区、定时及远程集中控制是节能降耗和提升管理效率的关键。芯步的智能分体控制箱（型号：UNI-KZQ-FT）支持12路甚至24路的独立回路控制，非常适合标准教室或小型会议室的灯光、风扇等设备的集中管理。

核心挑战： 如何将这款硬件无缝对接到您现有的教务管理平台或自研的物联网控制中心中？解决方案核心： 利用芯步开放的 HTTP API。该协议无需特定的网关中转（设备直连WiFi 2.4G），任何支持HTTP请求的编程语言（Java, Python, Go, PHP, Node.js等）均可快速集成。

准备工作：

硬件就绪：确保12路分体远程控制箱已通电并完成配网（通过“芯步”官方App配置WiFi）。
平台凭证：登录芯步控制台，获取 AppID 和 AppSecret（开发者密码）。这是后续所有API调用的“身份证”。

2. 接口集成核心：签名机制与命令格式

所有控制指令都通过向 api.thingboot.com 发送POST请求实现。为了安全，芯步采用了 “双重MD5加盐” 的签名机制。

2.1 动态签名生成算法（以12路控制箱为例）

这是集成中最容易出错的地方，请严格按照以下逻辑生成 sign 和 ts（时间戳）：

准备：获取 AppSecret（例如 abc123）和当前Unix时间戳 ts（例如 1714528000，单位秒）。
第一次加密：计算 Secret_MD5 = md5(AppSecret)。
拼接：计算 Str = Secret_MD5 + ts。
第二次加密：计算 sign = md5(Str)。

注：这是一种标准的防重放攻击机制，确保每次请求的数据唯一性。

2.2 关键API地址

请求地址https://api.thingboot.com/{AppID}/device/control/?sign={sign}&ts={ts}
请求方式POST
HeaderContent-Type: application/json

2.3 12路设备的核心指令集（Order）

针对您提到的12路控制箱，其主要控制对象是power1到power12。若设备为20路版本，则支持至power20。

功能描述	指令示例 (Order JSON)	说明
开启第1路灯光	`{"power1": 1}`	1代表开启，0代表关闭
关闭第5路灯光	`{"power5": 0}`	针对黑板灯或投影区灯
批量全开/全关	`{"batch": 1}` 或 `{"batch": 0}`	1全开，0全关，快速响应
顺序启动	`{"point": 1}`	用于避免瞬间电流过大，按顺序依次闭合各路
状态查询	(需查看设备具体手册)	可通过特定命令获取各回路当前状态

3. 系统集成实战：代码与逻辑流程

为了将12路控制箱集成到您的项目中，我们需要编写一个“设备控制服务模块”。以下以一个Web后端（伪代码/逻辑示例）为例，展示如何处理来自前端的“上课模式”请求。

3.1 后端控制逻辑示例（Python/Node.js 思路）

场景：当老师点击“上课模式”时，系统自动开启教室的第1-8路主照明灯，并关闭靠窗的第9路（节能）。

步骤

接收前端请求。
根据当前时间戳计算Sign。
构造Payload，关键点：设备ID（Device ID）需提前在控制台绑定或通过扫码获取。
发送指令。

# -*- coding: utf-8 -*-
import hashlib
import time
import requests
import json

# 1. 配置参数
APP_ID = "YOUR_APP_ID"          # 控制台获取
APP_SECRET = "YOUR_APP_SECRET"  # 控制台获取
DEVICE_ID = "12_LIGHT_BOX_001"  # 12路分体箱的实际设备ID

def control_12_channel_light(light_dict):
    """
    light_dict: 字典参数，例如 {"power1":1, "power2":1, "power9":0}
    """
    # 2. 生成签名
    ts = int(time.time())
    # 第一次md5
    md5_app_secret = hashlib.md5(APP_SECRET.encode()).hexdigest()
    # 拼接并第二次md5
    sign_str = md5_app_secret + str(ts)
    sign = hashlib.md5(sign_str.encode()).hexdigest()
    
    # 3. 拼接URL
    url = f"https://api.thingboot.com/{APP_ID}/device/control/?sign={sign}&ts={ts}"
    
    # 4. 构建请求体
    # 注意:order 必须是一个 json 字符串格式的字典
    payload = {
        "device": DEVICE_ID,
        "order": json.dumps(light_dict)  # 核心:将控制指令转为JSON字符串
    }
    
    # 5. 发送请求
    response = requests.post(url, json=payload, timeout=5)
    return response.json()

# 场景调用示例:上课模式
if __name__ == "__main__":
    # 开启1-8路，关闭第9路（注意:此处命令格式为字符串化的JSON）
    commands = {
        "power1": 1, "power2": 1, "power3": 1, "power4": 1,
        "power5": 1, "power6": 1, "power7": 1, "power8": 1,
        "power9": 0
    }
    result = control_12_channel_light(commands)
    print(result)

3.2 前端可视化的对接（UI）

在您的项目后台（Vue/React等），设计如下视图以匹配12路物理回路：

回路分组：将物理的power1-power4绑定为“左侧照明”，power5-power8绑定为“右侧照明”，power9-power10绑定为“讲台射灯”。
状态反馈：由于控制是单向下发，为了获取真实状态，结合消息推送机制：配置芯步将设备状态变化实时推送到您的服务器接口，从而实现界面开关状态的同步刷新。

4. 高级应用：打造真正的“智慧”教室

单纯的远程开关只是第一步，将传感数据与控制逻辑结合才是“智慧”核心。芯步生态中包含人体传感器、光照传感器等。

场景联动方案（典型的自动化逻辑）：

定时任务：每天晚上22:00，您的服务器自动向控制箱发送 {"batch":0}，强制关闭所有教室灯光，杜绝长明灯。
人感联动
- 传感器检测到“无人”状态，上报数据。
- 您的服务器接收传感器数据后，调用控制箱接口：{"power1": 0, "power2": 0 ...}。
- 技术点：支持局域网IP直连（私有化部署），即使在校园网断开外网的情况下，传感器与控制箱也能通过内网联动，保证稳定性。
光照度补偿
- 光照传感器检测到教室照度低于400Lux。
- 系统自动开启靠窗侧的灯光（例如 {"power3":1}），保持桌面照度恒定。

5. 总结

通过集成芯步12路分体远程控制箱，您不需要从头开发嵌入式硬件，只需关注上层业务逻辑

连接：处理好AppID/Secret的动态签名。
控制：精准操作power1至power12字段。
融合：利用传感器数据触发灯光指令。

此方案适用于Windows桌面软件、Linux服务器、安卓/iOS APP及各类小程序，能快速提升项目的智能化专业度。