芯步的8路智能控制箱提供完整的HTTP API接口，支持单路、批量、定时等多种控制模式。以下方案涵盖设备选型、接口对接、指令示例及典型场景应用，帮助快速实现集中控制。

1. 概述

本方案基于芯步8路智能控制器，利用其开放的 HTTP API接口，实现第三方服务平台对8路工业设备的远程集中控制。

该方案适用于智能仓储、农业大棚、共享设备（如自习室/售卖柜）、自动化产线及楼宇照明等场景。开发者无需复杂的嵌入式开发，仅需通过标准的HTTP协议即可实现对设备电源、电机、电磁锁等终端的独立开关、状态查询及定时任务设置。

2. 硬件：8路智能控制箱

针对不同的负载类型（交/直流），芯步提供不同型号的8路控制器，请根据现场设备选型：

选型

• 控制220V照明、插座、大功率电机：请选用 交流电压版 或 分体控制箱，接线最方便。

• 控制12V/24V电磁锁、直流电机、指示灯：请选用 直流电压版 (UNI-KZQ-TY-8)，注意需接入12V直流电源。

3. 开放接口详解

芯步提供了全平台的API支持，开发者可以通过任意支持HTTP请求的语言（Java, Python, PHP, Node.js, Go等）或工具进行集成。接口地址为：http(s)://api.thingboot.com/{AppID}/device/control/?sign={sign}&ts={ts}

3.1 单路独立控制指令

你可以独立控制第1路至第8路的“通”或“断”，互不干扰。命令存放在 order 字段的JSON对象中。

请求示例 (控制第1路开启)

路径与参数说明

• URLhttps://api.thingboot.com/{AppID}/device/control/?sign={sign}&ts={ts}

• Method：POST

• HeadersContent-Type: application/json

• Body

注：将 power1 改为 power2...power8 可分别控制对应线路；将值改为 0 即为关闭 。

3.2 批量控制指令

为了提高效率，避免频繁请求，支持一次性对多条线路或全部线路进行操作。

1. 全部开启/关闭

2. 指定奇数/偶数或特定线路控制例如，仅关闭第1、3、5、7路（常用于控制楼层间隔照明）：

-- 数据来源：

3.3 高级控制指令

在一些自动化场景中，可能需要设备执行“点动”或“信号触发”。例如控制电动卷帘门（按一下开，再按一下停，或者按一下开，几秒后自动停），可以使用以下命令。

1. 先通后断 (点动/脉冲信号)该命令会立即开启线路，保持 interval 毫秒后自动关闭。常用于控制电磁锁开门（通电1秒后自动断电）。

2. 先断后通 (复位信号)该命令会立即断开线路，保持 interval 毫秒后自动恢复通电。

-- 数据来源：

4. 实施步骤

步骤一：硬件接线与通电

1. 交流版：将220V火线（L）接入控制器的输入端（IN），将第1-8路输出端（OUT）引线至负载（如灯泡、接触器线圈），零线（N）并接。

2. 直流版：接好12V电源适配器，输出端接直流负载（注意正负极）。

3. 上电：通电后，设备指示灯应亮起（蓝灯闪烁表示未连网，常亮或熄灭表示已连网）。

步骤二：设备配网与注册

1. 登录控制台：访问芯步官网，进入“物联网控制台”。

2. 2.4G WiFi：确保现场WiFi是2.4GHz频段（不支持5G）。

3. 配网

   • 方法A（推荐-小程序）：微信搜索“芯步”小程序，登录后选择“添加设备”，根据提示输入WiFi密码即可。

   • 方法B（热点模式）：在控制台录入WiFi账号密码，生成二维码，让设备扫码连接。

步骤三：获取凭证与开发

1. 获取凭证：在控制台的“工作台” -> “应用管理”中，找到 AppID（应用ID）和 API Key（用于生成签名Sign）。

2. 生成签名：接口要求携带 sign（签名）和 ts（时间戳）以防篡改。签名算法一般为 md5(AppID + Secret + ts) 的组合，具体请参考官方《签名算法文档》。

3. 代码调用 (Python示例) ：

   import requests import time import hashlib # 配置参数 app_id = "YOUR_APP_ID" api_key = "YOUR_API_KEY" device_id = "YOUR_DEVICE_ID" ts = str(int(time.time())) # 计算签名 (具体算法请参考官方文档，以下为逻辑示意) sign_str = app_id + api_key + ts sign = hashlib.md5(sign_str.encode()).hexdigest() # 接口地址 url = f"https://api.thingboot.com/{app_id}/device/control/?sign={sign}&ts={ts}" # 控制第1路开启 payload = { "device": device_id, "order": {"power1": 1} } response = requests.post(url, json=payload) print(response.json()) # 返回 {"code": 200} 表示指令下达成功

步骤四：状态同步与联动

• 被动接收：配置“消息推送”地址（Webhook），当设备状态变化或外接传感器触发时，芯步平台会主动将数据POST到你的服务器。

• 主动查询：调用 /device/status 接口查询8路线路当前的通断状态。

5. 典型应用场景

第一种场景：共享自习室/健身房插座控制

• 需求：用户下单后自动开启对应座位的电源。

• 实现：后台管理系统收到支付回调 -> 调用API向控制箱发送 {"power3": 1} -> 座位3插座通电 -> 计时结束发送 {"power3": 0}。

第二种场景：农业智能灌溉/温室大棚

• 需求：根据温湿度传感器自动控制8路电磁阀或水泵。

• 实现：传感器上报湿度数据（如低于阈值）-> 服务器逻辑判断 -> 调用API发送 {"power5": 1} 开启水泵 -> 达到阈值发送 {"power5": 0} 关闭。

第三种场景：沙盘模型/展览灯光控制

• 需求：点击触摸屏，控制沙盘不同区域的灯光轮流亮起讲解。

• 实现

  1. 发送 {"batch": {"power": 0}} 关闭所有。

  2. 发送 {"point": {"relay": [1], "interval": 5000}} (区域1亮5秒后自动灭)。

  3. 利用定时器依次发送此命令控制区域2、3...实现流水效果。

场景四：无人货柜/快递柜锁控

• 需求：打开指定的柜门。

• 选型：必须使用直流电压版配合 12V电插锁。

• 实现：扫码开柜 -> 服务器发送 {"point": {"relay": [4], "interval": 3000}} -> 第4路通电3秒（锁弹开）后自动断电，防止锁体长时间通电发热烧毁。

6. 常见问题与排错

1. Q：调用接口返回 code:200，但设备没反应？

   • A：code:200 仅仅代表服务器收到了指令。可能设备已离线（检查WiFi信号），或者设备ID填写错误。开启控制台的“消息推送”功能，查看设备实际回执。

2. Q：直流控制器带电机/电磁锁，为什么一通电设备就重启？

   • A：感性负载启动瞬间电流极大，超过了电源适配器（DC 12V 1.5A）的供电能力。换用更大功率的12V电源（如5A或10A），或者将负载接到外置接触器上。

3. Q：总功率有限制吗？

   • A：有。单路最大通常为2200W（阻性），8路总功率极限为4400W。如果控制8个2000W的取暖器，即使只开4路也会超载，请严格遵守产品参数。

通过上述方案，你可以快速将芯步的8路控制器集成到现有的业务系统中，实现对多路设备的远程智能化管理。