CATALOG

芯步的4路灯光控制器(UNI-KZQ-ZM-4)通过标准HTTP接口实现云端/本地控制,核心对接流程包括设备上电配网、开放平台注册、接口调用三大步。以下是完整接入方案:

1. 硬件选型与准备

在项目初期,需要明确控制对象并准备相应的硬件设备。

核心设备:

  • 4路智能照明控制器(型号:UNI-KZQ-ZM-4): 这是执行终端。该设备支持4路独立控制,每路支持高达10A的电流,可直接控制教室内的LED灯管、护眼灯或黑板灯。它支持IEEE 802.11 B/G/N 2.4GHz WiFi,无需额外网关

  • 传感器套件(可选,用于自动化): 为了实现“按需照明”,搭配芯步的 “智能人体存在雷达传感器” 。该传感器不仅能探测移动,还能探测微动和存在,避免因学生静坐看书时灯光误灭

  • 环境光照传感器(可选): 用于采集靠窗与靠走道侧的自然光照度,实现恒照度调光。

网络环境要求: 教室需覆盖2.4GHz WiFi信号(因物联网协议大多使用2.4G频段,具有穿墙能力强的特点),且需开放外网访问权限(公网模式)或准备本地服务器(局域网私有化模式)。

2. 设计思路

本项目采用“端-云-用”三层架构,这是目前商业物联网项目最稳定、开发效率最高的架构:

  • 设备层: 由芯步的4路控制器和传感器组成。控制器直接替换教室原有的空气开关或墙壁开关,接收云端指令并执行开/关或查看回路状态。

  • 平台层(芯步开放平台): 芯步提供开放的API接口。您不需要自建物联网服务器(或可选择私有化部署),所有设备的在线/离线状态、数据上报都通过芯步平台中转。

  • 应用层(您的项目服务器/管理平台): 您的教室管理后台通过调用HTTP接口,向指定设备下发指令。

这种架构的优势在于解耦:您的开发团队只需关注业务逻辑(如排课表、定时策略),无需关心底层无线射频和通信协议。

3. 详细接入流程

第一步:设备上云配置

  1. 注册与创建应用: 在芯步开放平台注册开发者账号,创建应用获取 AppIdAppKey,这些凭证将用于后续接口调用的身份验证

  2. 设备配网: 通电后,通过芯步官方提供的配网工具或SDK,将控制器的WiFi模块连接到教室的无线网络。设备成功联网后,会在平台控制台中上线,并获取唯一的设备ID(Device ID)。

第二步:核心接口对接

芯步开放接口非常简洁,基于HTTP协议,采用 签名(Sign) + 时间戳(Ts) 的方式进行安全校验

1. 接口基础信息

  • 请求地址:http(s)://api.thingboot.com/{AppId}/device/control/

  • 请求方法: POST

  • 数据格式: JSON

2. 接口调用逻辑(以Java/Python伪代码为例)假设您需要在上课铃响时,打开教室的4路灯光(粉笔灯、学生灯、黑板灯、投影灯)。

请求参数构建:

签名与发送流程:

  • 拼接签名串:AppId, Device ID, TimestampAppSecret 按规则排序并MD5加密。

  • 发起请求: 将上述JSON数据作为Body,携带签名参数发送到API地址。

  • 返回结果: 平台会返回 {"code":0, "msg":"success"} 表示指令下发成功。控制器的响应时间通常在80-120毫秒内

3. 状态数据接收(消息推送)

  • 设备状态变化(如老师手动按了开关导致灯光关闭)或传感器数据变化,芯步平台会主动推送数据到您预先配置的服务器地址。

  • 处理逻辑: 您的服务器需接收POST数据包,解析 device_idpowerchannel 状态,并同步更新到您的数据库。

第三步:自动化与场景联动开发

控制器接入后,真正的价值在于场景化控制。在您的项目中,可以通过以下逻辑实现节能:

场景A:人走灯灭 / 无人节能

  • 流程: 部署在教室后方的“人体存在传感器”检测到无人状态(持续15分钟),传感器将“无人”状态推送到您的服务器。

  • 代码动作: 您的服务器触发回调函数,调用4路控制器的 关闭 接口,发送 {"device":"xxx", "order":{"power":0}},实现全关。

场景B:恒照度补光(分区控制)

  • 流程: 靠近窗户侧的光照传感器测得照度为800Lux(足够亮),而教室靠走廊侧测得200Lux(不够亮)。

  • 代码动作: 您的程序判断逻辑后,发送指令:关闭靠窗侧灯光(channel_1:0),开启走廊侧灯光(channel_2:1),既保证了桌面照度达标,又最大限度利用了自然光。

4. 项目实施与部署要点

  1. 私有化部署(数据安全):部分学校对数据出校有严格限制。芯步支持私有化部署方案。您可以将平台软件部署在学校的本地服务器上,控制器通过局域网IP直连。这样,即使外网断开,教室内的定时开关、本地联动依然不受影响。

  2. 负载计算与线路安全:在接入前,需计算教室总功率。UNI-KZQ-ZM-4每路最大支持2200W(阻性负载)。一间标准教室的LED照明总功率通常在300W-600W之间,4路控制器完全足够。但请一定要确保接线端子锁紧,并安装对应安数的空气开关作为总闸保护。

  3. 抗干扰与误触发解决:如果采用传感器联动,在程序中加入“延时确认”机制。例如,只有在5秒内连续收到2次“有人”信号时才开灯,避免空调风吹窗帘飘动等造成的误触发

5. 开发工作量评估

基于芯步的开放接口,您的团队主要工作量集中在:

  1. 接入层开发(0.5人日): 封装设备控制API,实现签名算法。

  2. 业务逻辑层(2人日): 实现课表定时任务(例如:8:00开启所有灯)、传感器联动逻辑。

  3. 前端适配(1人日): 在教室管理后台或APP中,增加4个灯控按钮的UI及状态同步机制。

6. 总结

通过芯步的开放接口接入4路灯光控制器,本质上是一次 “硬件标准化”“软件定制化” 的结合。利用其开放的HTTP API,开发者可以用熟悉的编程语言(任何支持HTTP请求的语言)仅需少量代码即可实现对硬件的闭环控制,从而快速构建出具备感知、决策、执行能力的智慧教室光环境系统。