CATALOG

芯步的16路智能控制箱(如UNI-KZQ-TY-16型号)提供标准HTTP接口,支持通过简单的API调用实现远程参数配置。以下方案涵盖接口鉴权、16路独立控制以及批量配置的实现方式,可直接用于二次开发。

1. 解决概述

本方案基于芯步开放的 HTTP API 接口。对接方(您的服务器/软件)通过携带动态签名的 POST 请求,向目标设备下发 JSON 格式的命令。设备接收指令后实时响应(约80-120ms),从而实现无需现场操作的远程配置与管理

核心优势:

  • 独立性: 16 路继电器完全独立控制,互不干扰。

  • 灵活性: 支持单控、批量控制、定时任务及场景联动

  • 简易性: 标准 HTTP 协议,适用于任何主流开发语言(如 Python, Java, PHP, Node.js 等)

2. 对接准备工作

在开始编码前,请完成以下步骤以获得必要凭证:

  1. 注册与登录: 访问芯步官网注册企业/个人账号

  2. 获取凭证: 登录后进入“控制台” -> “开发设置”,获取唯一的 AppIDAppSecret(开发者密码)

  3. 绑定设备: 确保 16 路分体智能控制箱已上电并连接 WiFi,在控制台设备列表中获取该设备的唯一标识码 Device ID

3. 核心鉴权机制(签名计算)

所有 API 请求均需携带动态签名以确保安全。规则如下:

  • Sign 算法:Sign = md5( md5(AppSecret) + ts )

    • Step 1: 将 AppSecret 进行 MD5 加密得到字符串 S1

    • Step 2: 获取当前 Unix 时间戳(秒) ts

    • Step 3: 拼接 S1ts,再次进行 MD5 加密得到最终的 Sign

鉴权参数示例:

  • URL结构:https://api.thingboot.com/{AppID}/device/control/?sign={Sign}&ts={ts}

  • Header:Content-Type: application/json

4. 详细配置方案:如何实现远程参数配置

针对“16路分体智能控制箱”,所谓的“参数配置”主要指控制各线路的通断状态(Power On/Off)、延时通断或复位。

4.1 单路独立配置(精细化控制)

若需修改其中某一路(如第 8 路)的参数,通过指定 power8 字段即可。

请求示例(JSON):

场景说明: 该指令仅影响第 8 路继电器,其余 15 路保持原有状态不变。

4.2 批量配置(全量或分组控制)

为提升效率,系统提供 batch 命令,可通过字符串一次性定义 16 路的状态。

请求示例(JSON):

  • 参数解析: 该字符串共 16 位。

    • 前 8 位 11111111:代表 1-8 路闭合/开启。

    • 后 8 位 00000000:代表 9-16 路断开/关闭。

  • 适用场景: 系统初始化、场景模式切换(如“全部开启”或“节能模式”)

4.3 高级执行参数(时序控制)

针对需要防浪涌或顺序启动的场景,使用 pointreset 指令:

  • 先通后断 (point): 闭合某一路,延时后自动断开。适用于声光报警或脉冲控制。

    • 指令:{"point1": 2000} (第1路接通,2秒后自动断开)

  • 先断后通 (reset): 断开某一路,延时后自动恢复。适用于网络设备重启(如远程重启路由器)。

    • 指令:{"reset1": 3000} (第1路断开,3秒后自动重新接通)

5. 开发集成示例(以Python与Node.js为例)

以下代码演示如何计算签名并下发“开启第1路”与“批量配置”的命令。

5.1 Python 实现

5.2 Node.js 实现

6. 对接和需要注意的点

  1. 私有化部署(可选): 如果您的服务器与设备处于同一局域网,或担心数据公网传输安全,芯步支持私有化部署。您可以将 API 请求地址指向本地服务器,实现纯内网环境下的远程配置

  2. 双重确认机制: 控制箱通常会在状态变化后主动推送当前状态至您的服务器。您不仅发送“配置指令”,还需监听设备回传的“状态报文”,以形成闭环确认(例如:指令下发后,收到返回的 power1:1 确认日志),确保操作成功。

  3. 超时重试: 网络环境可能存在波动,在代码中设置合理的超时时间(如 3-5 秒)并配置重试机制(Retry)。

7. 总结

通过芯步提供的开放接口,对接“16路分体智能控制箱”实现远程参数配置技术门槛较低。主要工作集中在签名鉴权机制的集成上,完成后即可利用标准的 JSON 指令(如 powerbatchpoint)灵活管理现场设备。若在对接过程中遇到具体技术问题,可参考官方提供的《智能通用控制器16路产品手册》或联系其技术支持团队获取协助