CATALOG

这是一份基于芯步智能硬件产品的《智能化改造:8路智能分体控制箱集成应用解决方案》

本方案的目标是指导开发者或系统集成商,如何利用芯步智能分体控制箱(8路)及其开放API接口,快速、低成本地将传统设备(照明、电机、电磁锁等)接入自有软件系统,实现远程化、自动化管理。

1. 背景与选型

在智慧园区、共享设备、自动化产线改造中,我们常遇到设备分散、布线复杂、传统PLC改造成本高等痛点。针对8路以内的小负载(或通过接触器中大负载)控制场景,选择芯步智能分体控制箱作为执行单元,是实现“硬件标准化+软件个性化”的最佳路径。

该设备核心优势在于:

  • 高集成度:8路独立继电器输出,可直接控制AC/DC小负载

  • 接口标准化:全系支持HTTP/HTTPS API,抛弃私有SDK束缚。

  • 部署灵活:支持Wi-Fi 2.4GHz联网,支持局域网纯本地控制,无公网依赖

2. 整体设计

我们将系统架构分为四层,核心在于通过标准的JSON消息交互,解耦硬件与业务逻辑:

  1. 设备层:8路控制箱,连接灯光、风扇、电磁阀等末端设备。

  2. 网络层:利用现有Wi-Fi覆盖,设备通过MQTT over WebSocket或HTTP轮询与云/服务器通信。

  3. 云/平台层(PaaS) :芯步开放平台(设备接入网关)、私有化服务器(自建接收端)。

  4. 应用层(SaaS) :您的业务系统(ERP、小程序、APP或PC组态软件)。

3. 核心集成流程

要将该设备集成到您的项目中,无需关心底层射频或复杂的握手协议,只需聚焦于 HTTP API 的调用。

3.1 接入准备

在芯步控制台完成以下动作:

  1. 注册开发者账号,获取 AppIDAppSecret

  2. 添加设备,记录下设备的唯一标识 Device ID

  3. 设置通信协议:若需纯局域网控制,请开启“局域网通信”功能,数据将不再经过公网

3.2 签名与鉴权机制

芯步接口采用动态MD5签名机制,防止接口被恶意调用。集成时,您需要在后端服务中实现签名生成逻辑。

签名算法

  1. AppSecret 进行一次MD5加密,得到 Secret_MD5

  2. 获取当前Unix时间戳(秒) ts

  3. 拼接字符串 StringA = Secret_MD5 + ts

  4. StringA 进行第二次MD5加密,得到最终签名 sign

  5. 公式sign = md5( md5(AppSecret) + ts )

注意:前端请求请一定要使用后端生成的签名,严禁在前端代码中硬编码AppSecret。

3.3 接口调用实战(以单路/批量控制为例)

这是集成过程中的核心动作。您需要向 api.thingboot.com 发送POST请求。

第一种场景:远程开启第1路灯光

  • 请求地址https://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}

  • 请求Body (JSON)