CATALOG

展柜场景下,16路控制器主要解决多回路独立控制问题——每层展柜的灯光、每个玻璃罩的升降电机、恒温系统都需要单独控制,同时还要在管理后台看到每路状态。芯步这款设备的开放接口基于HTTP,接入方式比较直接,以下是具体方案。

解决方案:展柜设备控制 —— 将16路远程多回路智能控制器集成至项目系统

1. 解决概述

在展柜控制场景中,常常需要对多组灯光、升降机构、旋转展台或恒温模块进行独立且精细的控制。芯步的 16路远程多回路智能控制器 专为此类场景设计。

本方案的目标是指导开发者如何利用该设备提供的标准 HTTP API接口,在无需网关中转(直连WiFi)且兼顾局域网/公网环境的前提下,快速将其接入现有的软件系统中(如中控台、小程序或网页后台)。

2. 硬件核心特性

在开始开发前,需确认目标硬件的核心参数,以便在代码中正确适配。

  • 产品型号:UNI-KZQ-TY-16

  • 网络连接:支持 2.4G WiFi(直连路由器,无需额外网关)

  • 控制路数:16路继电器输出(干触点/电压输出取决于采购型号,通常用于控制照明、电机或电磁锁)

  • 开放能力:支持 HTTP 请求与 MQTT 协议,支持私有化部署及局域网通信

3. API 集成方案

3.1 接入流程
  1. 设备配网:通过“芯步”官方App或配网接口,让控制器连接到现场路由器(WiFi)。

  2. 获取凭证:在芯步开放平台创建应用,获取 AppIDAppSecret 用于生成签名 sign;在控制台获取目标 device ID

  3. 接口调试:调用Open API进行单路开关测试。

3.2 核心接口:指令下发

该设备的核心逻辑是通过向指定的API端点发送POST请求来控制16路继电器中的任意一路或多路。

  • 请求地址http(s)://api.thingboot.com/{AppID}/device/control/?sign={sign}&ts={ts}

  • 请求方法POST (推荐,参数较长时使用)

  • 请求头 (Headers)Content-Type: application/json

3.3 指令定义(关键部分)

根据16路控制器的特性,order 参数是控制的核心。参考芯步4路/8路设备的通用规范,16路设备的命令格式遵循以下逻辑:

为了集成到项目中,后端需封装一个“控制服务”,生成如下JSON载荷:

第一种场景:独立控制单一路控制第1路开启,第3路关闭。

第二种场景:批量控制同时关闭第1、5、9、13路。

第三种场景:点动/脉冲控制(用于展柜升降或临时照明)让第2路接通1秒后自动断开(例如控制电插锁或短暂触发电机)。

3.4 代码实现示例(伪代码/后端集成)

以下逻辑需在您的项目后端实现,前端严禁直接暴露API密钥。

4. 关键场景集成细节

在展柜项目中,为了提高开发效率和用户体验,关注以下两个高阶配置:

A. 异步状态同步(消息推送)HTTP接口返回的 200 仅代表指令下达成功,不代表设备真实执行(如设备可能离线)。

  • 解决方案:配置 消息推送 机制。在芯步控制台设置您的服务器回调URL。当设备真实执行指令(如继电器真的吸合了)或状态变化时,平台会主动推送状态到您的服务器 。您需要开发一个接收端接口,用于实时更新数据库中“展柜灯光/电机”的状态,解决“界面显示开了但实际没开”的问题。

B. 私有化部署(局域网控制)针对博物馆、保密展馆等对网络安全要求比较高的环境。

  • 方案:该设备支持 私有化部署

    • 做法:在展馆本地服务器部署芯步的边缘网关软件或自建MQTT Broker。

    • 好处:控制指令完全在局域网内传输,不经过外网,延迟更低(<50ms),且断外网不影响展柜操作。

5. 总结

将芯步16路控制器接入展柜项目,核心在于 API的指令封装异步状态同步

  • 对于开发者:只需关注 HTTP POST 请求的构造,无需关心底层射频或电路驱动。

  • 对于展柜功能:可利用“批量控制”实现“一键开馆/闭馆”,利用“点动控制”实现电动展柜的缓慢开启,利用“独立回路”实现单个展品的重点照明。