芯步的智能插座开放了标准HTTP API,签名验证简洁,通常10-15分钟就能完成对接调试。以下方案以 1位5孔智能墙壁插座10A(计量版) 为例,涵盖硬件安装、接口调试到业务集成的全过程。
1. 背景与选型
本方案选用的 芯步智能墙壁插座10A(1位5孔) 具备以下特点,适合办公、家居或无人值守站点的改造:
硬件规格:标准86型,平行替换原有插座;2200W额定功率,适用于绝大多数电器;V0级防火PC外壳 。
核心功能:远程控制通断、功率/电压/电流实时计量、定时/倒空任务、延时通断 。
接口优势:基于HTTP协议,签名机制简单,支持公网或局域网直连,响应速度约80-120ms 。
适用场景:服务器机房远程重启、工位节能断电控制、宿舍电器限电管理、家中鱼缸/热水器定时开关。
2. API 接入准备
在开始编码前,需要准备以下三要素,均可在 芯步控制台 获取
AppId:应用的唯一标识。
AppSecret:用于签名加密的密钥。
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 双重加密:
将
AppSecret进行一次 MD5 加密,得到encrypted_secret。将
encrypted_secret与当前时间戳ts(秒级) 拼接。对拼接后的字符串再进行一次 MD5 加密,得到
sign。
公式Sign = md5( md5(AppSecret) + ts )
示例假设 AppSecret = “abc123”,ts = “1715011200”。
step1 = md5(“abc123”) = “e99a18c428cb38d5f22e03”step2 = step1 + ts = “e99a18c428cb38d5f22e03” + “1715011200”Sign = md5(step2)
4. 下发控制命令详解
通过向接口 POST 不同的 JSON 体,实现开关、延时等功能 。
4.1 基础开关控制
场景:员工下班后远程关闭工位插座电源。
开/关指令
多设备批量控制
4.2 高级功能:延时任务
利用 reset 和 point 参数,可以在不依赖本地定时任务的情况下实现“只开一会儿”或“暂时关闭”。
任务一:临时开启(先通后断) -
point(单位:毫秒)需求:给服务器临时供电3分钟进行故障诊断,防止忘记关闭。
指令
{"point": 180000}(接通电源,3分钟后自动断开)。
任务二:定时重启(先断后通) -
reset(单位:毫秒)需求:重启路由器(断开后需等待10秒再通电)。
指令
{"reset": 10000}(断开电源,10秒后重新接通)。
4.3 定时任务与循环
如果需要每天固定时间执行(如早上9点开灯,下午6点关灯),采用 “云定时”策略:
在自己的服务器中设置 Cronjob 或 Scheduler。
定时任务触发时,调用上述 HTTP 接口即可。
5. 进阶应用:数据监测与告警
计量版 插座支持实时读取电压、电流和功率。这一般通过设备状态查询接口(需查阅设备文档中的 device/status 接口)获取。
应用案例:电器离线/故障监测
逻辑:轮询获取设备功率值。如果功率值突然变为
0(小于待机阈值) 且当前状态为“开启”,则判定设备故障或插头脱落。动作:触发短信或钉钉机器人告警:“机房空调已断电,请及时处理”。
6. 硬件安装指南
芯步的插座采用标准 86型 底盒设计,替换非常简单:
断电:请一定要关闭总闸,用电笔测试确认无电。
接线:遵循“火线进L,零线进N,地线进 ”的原则。10A版本需接 2.5平方 及以上铜线 。
配网:通电后,长按插座侧面按键5秒,进入配网模式(指示灯闪烁)。通过“芯步云”配网工具或微信小程序,将插座连接到 2.4GHz 频段的 WiFi 网络 。
7. 总结
芯步的这套解决方案通过 “统一云平台 + 标准化HTTP接口 + 传统硬件改造” 的模式,大幅降低了物联网接入的门槛。
技术门槛低:无论是 PHP、Python、Java 还是 Node.js,仅需具备发送 HTTP 请求的能力即可接入 。
业务价值高:不仅解决了远程开关问题,通过功率计量功能,还能实现能耗统计和设备健康度监控。
开发者先通过 Postman 测试签名和下发的流程,成功后再编写业务代码,可以事半功倍。