CATALOG

60A数显智能空开主要用于大功率用电场景(如充电桩、中央空调、大型设备),其远程控制的核心是通过芯步统一的HTTP API接口下发指令。下面从前期准备、接口对接、命令构建到项目集成,给出完整的接入方案。

1. 解决概述

本方案基于芯步开放的HTTP API接口,通过标准的POST请求向云端发送控制指令,云端再将指令下发给设备,从而实现远程通断控制。整个方案不依赖特定编程语言,适用于任何支持HTTP协议的环境(如Python、Java、PHP、Node.js及各种SaaS平台)

核心流程:业务系统 -> HTTP POST请求 -> 芯步云端API -> MQTT/CoAP协议 -> 60A智能空开(执行动作)

2. 准备工作

在开始开发前,需要先完成账号注册与设备配网等准备工作。

  1. 注册与登录:访问芯步官网,注册一个企业/开发者账号

  2. 获取凭证:登录后,进入“工作台” -> “物联网控制台” -> “开发设置”,获取以下三个关键参数:

    • AppID:应用的唯一标识。

    • AppSecret:用于签名加密的密钥(请勿泄露)。

    • 设备ID (Device ID):在控制台“设备列表”中查看已配网的60A空开对应的ID

    • *注:60A数显智能空开通常属于“智能控制器”或“通断器”类产品线,接口调用方式与4路/8路控制器一致。*

  3. 设备配网:确保60A智能空开已上电,并通过“芯步”小程序或控制台配置好Wi-Fi(仅支持2.4G频段)。设备指示灯常亮即代表在线

3. 接口鉴权与签名机制

芯步的API采用动态签名的方式进行身份验证。每次请求都需要在URL参数中携带 signts

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

  • 请求方法:POST

  • Content-Typeapplication/json

签名算法步骤如下:

  1. 取当前的Unix时间戳(秒)作为 ts

  2. AppSecret 进行MD5加密,得到 sec_md5

  3. sec_md5ts 进行字符串拼接,得到 sign_str

  4. sign_str 再次进行MD5加密,得到最终的 sign

公式:Sign = MD5( MD5(AppSecret) + ts )

注:具体的代码实现可参考下文第6节的示例。

4. 控制指令(Order)详解

由于60A数显智能空开通常为大功率单路控制设备,其控制指令相对简单。根据芯步的API规范,控制单路设备的命令字段如下

功能描述指令字段 (order)参数值JSON示例
开启输出power1{"power": 1}
关闭输出power0{"power": 0}
临时通电 (先通后断)point毫秒数(如5000){"point": 5000}
临时断电 (先断后通)reset毫秒数(如10000){"reset": 10000}
  • 基础控制:直接发送 power:1power:0 控制继电器吸合或断开。

  • 脉冲控制:针对电机、门锁等设备,可使用 point(设备立即通电,延时后自动断电)或 reset(设备立即断电,延时后自动恢复通电)。

  • 注意:若空开支持数显数据上报,需通过“设备详情查询”或“消息推送”接口获取,该接口仅负责控制通断。

5. 请求完整示例

假设你的 AppIDabc123设备ID10086AppSecrettest123,当前时间戳 ts1700000000

5.1 构造URL

加密计算后得到 Sign,URL构造如下:https://api.thingboot.com/abc123/device/control/?sign=xxxxxxx&ts=1700000000

5.2 构造POST Body

5.3 服务器响应

  • 成功{"code":0, "msg":"success", "data":{...}}

  • 失败{"code":500, "msg":"device offline", ...}(设备离线时常见报错)

6. 代码接入示例

以下为使用Python和Shell实现的简易控制脚本,展示了签名生成与请求发送的全过程

Python 3 实现

Bash + cURL 实现

7. 注意事项

  1. 60A大功率安全事项:在进行远程控制测试前,请确保后端负载在额定范围内(60A通常对应220V*60A=13.2kW)。频繁远程通断大功率设备可能产生电弧,搭配接触器使用或确保空开具备灭弧能力。

  2. 局域网与私有化部署:如果你的业务系统与设备在同一局域网内(如工厂内部),芯步支持局域网IP直连控制,延迟更低,不依赖外网。需在控制台开启“局域网API”功能并绑定设备

  3. 状态同步:通过HTTP接口下发命令后,若需确认空开是否真的执行了物理动作(尤其是60A空开可能因过载保护而跳闸),定时调用 设备状态查询接口 或接收云端 Webhook推送 来获取实时的“开关状态”和“电流/功率读数”。

  4. 频率限制:请勿在无延迟循环中高频调用接口(如每秒数十次),这可能会触发云端限流策略,通常间隔大于500ms。

通过以上步骤,你可以快速将60A数显智能空开集成到现有的Web后台或手机管理应用中。