CATALOG

芯步的智能插座开放了标准HTTP API,签名验证简洁,通常10-15分钟就能完成对接调试。以下方案以 1位5孔智能墙壁插座10A(计量版) 为例,涵盖硬件安装、接口调试到业务集成的全过程。

1. 背景与选型

本方案选用的 芯步智能墙壁插座10A(1位5孔) 具备以下特点,适合办公、家居或无人值守站点的改造:

  • 硬件规格:标准86型,平行替换原有插座;2200W额定功率,适用于绝大多数电器;V0级防火PC外壳

  • 核心功能:远程控制通断、功率/电压/电流实时计量、定时/倒空任务、延时通断

  • 接口优势:基于HTTP协议,签名机制简单,支持公网或局域网直连,响应速度约80-120ms

适用场景:服务器机房远程重启、工位节能断电控制、宿舍电器限电管理、家中鱼缸/热水器定时开关。

2. API 接入准备

在开始编码前,需要准备以下三要素,均可在 芯步控制台 获取

  1. AppId:应用的唯一标识。

  2. AppSecret:用于签名加密的密钥。

  3. Device ID:具体某个插座的设备编号。

3. 核心接口与签名算法

芯步的接口通过 URL 传递签名进行身份验证,无需复杂的 OAuth 流程。

3.1 请求地址

https://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}
  • Method:POST

  • Content-Type:application/json

3.2 签名生成规则

为了防止接口被篡改,需要对请求进行 MD5 双重加密:

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

  2. encrypted_secret 与当前时间戳 ts (秒级) 拼接。

  3. 对拼接后的字符串再进行一次 MD5 加密,得到 sign

公式Sign = md5( md5(AppSecret) + ts )

示例假设 AppSecret = “abc123”ts = “1715011200”

  1. step1 = md5(“abc123”) = “e99a18c428cb38d5f22e03”

  2. step2 = step1 + ts = “e99a18c428cb38d5f22e03” + “1715011200”

  3. Sign = md5(step2)

4. 下发控制命令详解

通过向接口 POST 不同的 JSON 体,实现开关、延时等功能

4.1 基础开关控制

场景:员工下班后远程关闭工位插座电源。

  • 开/关指令

  • 多设备批量控制

4.2 高级功能:延时任务

利用 resetpoint 参数,可以在不依赖本地定时任务的情况下实现“只开一会儿”或“暂时关闭”。

  • 任务一:临时开启(先通后断) - point (单位:毫秒)

    • 需求:给服务器临时供电3分钟进行故障诊断,防止忘记关闭。

    • 指令{"point": 180000} (接通电源,3分钟后自动断开)。

  • 任务二:定时重启(先断后通) - reset (单位:毫秒)

    • 需求:重启路由器(断开后需等待10秒再通电)。

    • 指令{"reset": 10000} (断开电源,10秒后重新接通)。

4.3 定时任务与循环

如果需要每天固定时间执行(如早上9点开灯,下午6点关灯),采用 “云定时”策略:

  1. 在自己的服务器中设置 Cronjob 或 Scheduler。

  2. 定时任务触发时,调用上述 HTTP 接口即可。

5. 进阶应用:数据监测与告警

计量版 插座支持实时读取电压、电流和功率。这一般通过设备状态查询接口(需查阅设备文档中的 device/status 接口)获取。

应用案例:电器离线/故障监测

  • 逻辑:轮询获取设备功率值。如果功率值突然变为 0 (小于待机阈值) 且当前状态为“开启”,则判定设备故障或插头脱落。

  • 动作:触发短信或钉钉机器人告警:“机房空调已断电,请及时处理”。

6. 硬件安装指南

芯步的插座采用标准 86型 底盒设计,替换非常简单:

  1. 断电:请一定要关闭总闸,用电笔测试确认无电。

  2. 接线:遵循“火线进L,零线进N,地线进 ”的原则。10A版本需接 2.5平方 及以上铜线

  3. 配网:通电后,长按插座侧面按键5秒,进入配网模式(指示灯闪烁)。通过“芯步云”配网工具或微信小程序,将插座连接到 2.4GHz 频段的 WiFi 网络

7. 总结

芯步的这套解决方案通过 “统一云平台 + 标准化HTTP接口 + 传统硬件改造” 的模式,大幅降低了物联网接入的门槛。

  • 技术门槛低:无论是 PHP、Python、Java 还是 Node.js,仅需具备发送 HTTP 请求的能力即可接入

  • 业务价值高:不仅解决了远程开关问题,通过功率计量功能,还能实现能耗统计和设备健康度监控。

开发者先通过 Postman 测试签名和下发的流程,成功后再编写业务代码,可以事半功倍。

插座产品方案:
写字楼设备电源管理:怎么把16A86型定时智能插座接入到软件项目中
查看 >>
办公室设备电源控制:怎么把1位5孔单路智能插座对接到软件项目中
查看 >>
怎样在智能办公设备电源控制中接入智能硬件来实现空调电源控制
查看 >>
共享麻将馆灯光插座管理:怎么将DC-10A 电器开关集成到自己的项目中
查看 >>
怎么在广告灯箱设备电源管理中集成智能硬件来实现远程定时任务设置
查看 >>
电器场景方案:
如何在智能家居多路电器控制中集成智能设备来实现分组控制模式设置
查看 >>
怎么在社区公共设备电源管理中中集成智能设备以实现远程控制大功率电器电源
查看 >>
怎么在共享场所电器电源管理中接入智能硬件以实现远程参数配置管理
查看 >>
怎样对接16A远程电源控制插座来实现远程控制电器电源
查看 >>
怎样在出租屋用电安全管理中集成智能硬件以实现远程控制大功率电器电源
查看 >>
远程控制用途方案:
怎样在仓储设备机柜电源管理中接入智能硬件以实现远程控制8路电源
查看 >>
怎样接入8路防水防尘控制箱来实现远程控制8路线路
查看 >>
如何在共享台球室灯光空调控制中接入智能设备以实现远程控制16路线路
查看 >>
怎么二次开发壁挂式雷达存在感应器以实现HTTP接口远程控制
查看 >>
怎么在快递柜设备控制中集成智能硬件来实现远程控制16路线路
查看 >>