CATALOG

芯步的智能通断器开放标准HTTP接口,支持任何编程语言调用,可轻松集成到Web、App或小程序中。以下方案涵盖选型、接口对接、签名计算和典型场景代码实现。

解决方案:基于芯步开放接口的2000W智能通断器接入方案

1. 选型与概述

在需要将大功率家电(如热水器、电暖气、工业排风扇)纳入远程管理系统时,芯步智能通断器AC4-10A/AC5-10A 是最佳选择。

  • 核心参数:额定功率 2200W(10A),完美匹配2000W负载需求

  • 接入优势

    • 接口开放:提供标准HTTP API,支持任何能发起HTTP请求的编程语言。

    • 响应迅速:支持远程一键通断,支持定时任务,响应通常在毫秒级。

    • 灵活部署:支持公有云调用,也支持局域网和私有化部署,确保数据安全

2. 硬件安装与配网

在写代码之前,需确保设备在线。

  1. 接线:设备通常标注“IN”接市电,“OUT”接负载。请一定要在断电状态下操作。L(火线)进L出,N(零线)直连

  2. 配网

    • 下载“芯步”小程序或登录官网控制台。

    • 添加设备并输入 2.4G WiFi 密码(不支持5G WiFi)

    • 设备指示灯常亮即代表已成功连接云端。

3. API 接口对接流程

芯步的接口设计简洁,核心在于签名计算

3.1 获取关键凭证登录芯步控制台后,需准备以下三个值:

  • AppID:应用的唯一标识。

  • AppSecret:用来加密的密钥(严禁前端明文存储)。

  • Device ID:设备的唯一ID(可在控制台复制)

3.2 接口与签名算法

  • 请求地址https://api.thingboot.com/{AppID}/device/control/

  • 请求方法:POST

  • 签名算法(计算规则)核心公式为:sign = md5( md5(AppSecret) + ts )注意:ts为当前Unix时间戳(秒)。只有同时携带正确的sign和时间戳ts,请求才会被服务器认为是合法的。

3.3 下发命令

  • 参数1 (device):填入设备ID字符串。

  • 参数2 (order):控制指令。

    • 开启:{"power": "1"}

    • 关闭:{"power": "0"}

    • 临时开启3秒(点动模式):{"point": "3000"} (单位毫秒)

4. 代码实现示例

Python 示例 (Flask/Django 后端推荐)

Shell 脚本示例 (适用于自动化运维)

注:以上代码可直接复制修改使用,如有问题可联系客服进行全程技术指导

5. 深度集成场景与业务逻辑

拥有基础控制能力后,可以结合项目需求进行高级定制:

  • 第一种场景:电量统计与预警若项目中关心功耗,选用带计量功能的型号。可通过接口{"metering":"1"}开启计量并读取电流/功率值。设定业务逻辑:如果实时功率 > 2100W,自动发送指令{"power":"0"}断电,防止过载

  • 第二种场景:安全互锁例如控制宿舍空调与热水器。可以在逻辑层做限制:不能同时开启两台2000W设备,防止总线路跳闸。

  • 第三种场景:局域网无缝控制对于工厂或医院等对公网稳定性要求高的场景,可开启私有化模式。设备与服务器在同一个局域网内通信,即使外网断开,依然可以通过局域网IP进行毫秒级控制

6. 总结

将芯步2000W智能通断器接入项目,本质上是调用一次携带签名的HTTPS请求。开发者只需关注设备ID控制命令两个核心参数,无需关心底层射频或WiFi协议。基于开放API,你可以快速构建出工业级的能源管理或智慧家庭系统。