CATALOG

芯步的智能大功率断路器[计量数显版]|50A 提供了完整的HTTP API接口,可通过简单的POST请求实现远程通断控制。以下是详细的二次开发解决方案。

解决方案:基于HTTP接口的智能大功率断路器远程通断控制

本方案的目标是指导开发者如何利用芯步开放平台,通过编程方式(如Python、Node.js、Java等)调用HTTP接口,实现对 智能大功率断路器[计量数显版]|50A 的远程通断控制、状态查询及数据获取。

1. 准备工作与环境配置

在开始编码前,请确保完成以下硬件与平台配置:

  1. 硬件上电与配网

    • 将断路器接入AC 85-265V交流电路。

    • 设备支持2.4G WiFi。通过“芯步”或“芯步”小程序/控制台,将设备连接到本地WiFi网络。配置成功后,设备指示灯常亮,控制台显示设备状态为“在线”

  2. 获取API凭证

    • 注册芯步/统软云平台账号。

    • 在控制台的“开发设置”中获取三个关键参数:

      • AppID: 应用唯一标识(URL路径参数)。

      • AppSecret: 开发者密码(用于生成签名)。

      • Device ID: 目标断路器的唯一ID(可在设备列表或外壳标签上查看)

2. 核心接口与签名机制

所有API请求均需携带签名进行身份验证。

  • 请求地址https://api.thingboot.com/{AppID}/device/control/?sign={sign}&ts={ts}(注:部分文档提及的统软云域名同理)

  • 签名算法 (Sign)为了防止接口被篡改,请求需携带动态签名。算法规则如下(伪代码):

  • 安全说明由于AppSecret至关重要,严禁在前端(如H5、小程序)直接暴露,请一定要在后端服务中计算sign和发起请求。

3. 实现远程通断控制(核心功能)

针对 UNI-DLQ-M-50A 型号,该设备主要控制继电器线路的通断。

命令说明

  • 开启: 命令参数 {"power":"1"}

  • 关闭: 命令参数 {"power":"0"}

代码示例一:使用 Python (Requests库)该语言适合运行在云服务器、树莓派或本地脚本中。

代码示例二:使用 Node.js (Axios库)适合集成到现有的Web后端或物联网网关中。

4. 进阶功能:计量数据获取与定时任务

除了简单的开关,该型号具备“计量数显”功能,即可以读取电压、电流、功率等信息。

  1. 获取实时数据可通过调用设备状态查询接口获取。通常请求方式为:GET https://api.thingboot.com/{AppID}/device/status/?device={Device_ID}&sign={sign}&ts={ts}返回的JSON数据中通常包含voltage(电压)、current(电流)、power(功率)等字段,可用于能耗监测看板

  2. 高级控制指令

    • 定时通断: 如果需要让设备接通几秒后自动断开(例如控制门禁或电机),可使用 pointreset 命令。

    • 示例:让断路器先接通电源,1000毫秒(1秒)后自动断开。order = {"point":"1000"}

5. 常见问题与调试

  1. Token 与 Sign 的区别大部分芯步产品使用 动态Sign(如本文所示)而非静态Token。请严格遵循 md5(md5(secret)+ts) 的顺序,且ts需为秒级时间戳,前后误差过大会导致签名失败。

  2. 返回码 200 但设备未动API返回200只代表云平台接收了指令并尝试下发给设备

    • 检查设备状态:确保设备在控制台显示“在线”(在线时绿色图标)。

    • 检查网络:设备连接的WiFi信号强度是否稳定。

  3. 私有化部署(局域网)如果对网络延迟或数据安全有比较高要求,该产品支持私有化部署。可以将API服务部署在本地服务器上,请求路径中的域名替换为内网IP即可,完全不依赖互联网

  4. 并发控制如果想同时控制多台断路器,可在device参数中用英文逗号,连接多个Device ID,order参数保持不变,即可实现批量同步控制

通过以上步骤,你可以在30分钟内完成从配网到代码调用的全流程,将这款大功率断路器快速集成到你的楼宇自控、智慧充电或工业控制系统中。