CATALOG

芯步10A智能插座的核心优势在于接口极其简单——实际上只需一次POST请求、携带正确的签名和设备ID,就能完成控制。这意味着定时管控功能的实现,主要是对“单次控制”逻辑的编排封装:你可以利用设备自带的硬件定时能力做简单延迟,也可以在云端用定时任务驱动接口调用。以下是两种方案的详细实现路径。

芯步10A智能插座对接方案:实现设备用电定时管控

1. 概述

本方案的目标是指导开发者如何通过芯步开放的HTTP API接口,对 10A智能墙壁插座(或智能插座10A) 进行二次开发,实现设备的远程定时管控。

芯步的智能硬件接口采用标准的HTTP协议,支持JSON数据格式,无需复杂的SDK,适用于任意支持HTTP请求的编程语言(如Java、Python、PHP、Node.js及Shell等),能够轻松集成到现有的Web系统、APP或小程序后台中

2. 对接准备工作

在开始编码前,需完成以下准备工作:

  1. 安装设备:将10A智能插座通电并配置好WiFi网络(仅支持2.4GHz),确保设备在芯步控制台处于“在线”状态

  2. 获取凭证:登录芯步开放平台,在“开发设置”中获取以下三个关键参数:

    • AppId :应用的唯一标识。

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

    • Device ID:需要管控的目标10A插座的设备ID

3.核心技术原理:签名生成

芯步的接口通过动态签名(Sign)来保证安全性。调用任何控制接口前,必须按照如下规则生成Sign

签名算法步骤

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

  2. 获取当前的Unix时间戳(秒级)ts

  3. Secret_MD5ts 字符串拼接,形成新字符串 str

  4. str 再次进行一次MD5加密,得到最终的 Sign

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

4. 定时管控的接口实现方案

针对10A智能插座的定时管控,根据实际业务场景的复杂度和实时性要求,主要有以下两种对接实现方式。

方案一:利用设备自带“硬件定时”能力(极简模式)

适用场景:简单的倒计时断电需求,如“1小时后关闭热水器”。

芯步10A插座支持内置定时指令,开发者只需单次下发命令,设备便会自动执行倒计时,无需开发者维护复杂的定时任务队列[citation:11]

接口实现示例

  • 接口地址http(s)://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}

  • 请求方式:POST

  • 请求Body

参数类型说明示例值
deviceString设备ID"820720"
orderObject控制命令,reset字段单位毫秒{"reset":3600000}

场景应用

  • 倒计时断电:发送 {"reset":3600000},插座会立即接通,并在 1小时(3600000毫秒) 后自动断开。

  • 倒计时通电:发送 {"point":1800000},插座会立即断开,并在 30分钟 后自动通电

方案二:云端/业务层定时任务(计划任务模式)

适用场景:复杂的周期性管控,如“每天8:00开启,18:00关闭”;需要结合传感器数据执行逻辑(如“温度过高则断电”)。

在此方案中,10A智能插座仅作为执行终端,由对接方的业务服务器通过定时任务(如Linux Crontab、Quartz、Node-schedule等)在预设时间点触发API调用。

1. 基础开关指令定义

  • 接通电源{"power": 1}{"power":"1"}

  • 断开电源{"power": 0}{"power":"0"}

2. 各语言对接代码示例

示例一:使用 Shell + Curl适用场景:部署在服务器上的简单脚本,配合 Crontab 使用。

citation:

示例二:使用 Node.js适用场景:基于 JavaScript 的服务端项目。

citation:

3. 实现高级联动逻辑基于功率统计(需购买计量版本),可以在定时管控的基础上增加“执行检查”逻辑:

  1. 业务系统下发“断开”指令。

  2. 等待2秒后调用 “查询设备状态”接口

  3. 逻辑判断:如果返回的power字段仍为1或实时功率load_power大于某个阈值,判定为执行异常,触发告警并重试

5. 关键注意事项

  • 功率限制:10A版本的额定功率为2200W,对接的电器功率请勿超过此限制,否则存在安全隐患

  • 响应速度:从命令下发到设备执行,官方典型响应时间为 80-120ms,在编写代码时,请合理设置超时时间

  • 签名时间戳ts 参数使用的是 秒级 时间戳,而非毫秒级。若使用毫秒级时间戳,签名验证将失败

  • 私有化部署:若需内网访问,芯步接口同样支持局域网IP直连或私有化部署,请求方式不变

通过以上方案,您可以快速实现10A智能插座的远程定时管控,无论是简单的倒计时断电,还是复杂的多时段自动化控制,均可通过芯步的开放接口轻松落地。