芯步16A智能插座基于HTTP接口开放，二次开发的核心是调用API完成签名认证和指令下发——签名按“MD5(MD5(AppSecret)+ts)”拼接待签名字符串即可。以下按“准备-配网-调用-场景扩展”四个阶段展开。

一、 背景与选型分析

在二次开发之前，首先需要明确硬件载体的技术参数。针对大功率电器（如空调、热水器、工业设备），芯步的 16A 智能墙壁插座是最佳选择。

• 关键参数：额定电流 16A，最大负载功率 3500W，支持 100-250V 宽电压输入。

• 无线连接：WiFi 802.11 b/g/n 2.4GHz（无需网关，直连路由器）。

• 核心优势：提供标准 HTTP API 接口，响应速度 80-120ms，支持远程通断、定时、电量计量（计量版）。

注意：请确保您持有的设备是 16A 规格（区别于常见的 10A 插座），以防止接入空调等大功率设备时发生过载风险。

二、 获取凭证与设备配网

调用 API 前，必须完成账号注册和设备联网。

1. 获取 AppID 和 AppSecret

   • 登录芯步官网，进入“工作台” -> “物联网控制台”。

   • 在“开发设置”中，您可以找到系统生成的 AppID 和 AppSecret。其中 AppSecret 用于生成签名，请勿泄露。

2. 设备配网（关键步骤）

   • 由于 16A 插座通常用于空调等固定线路设备，使用“AP 配网”或“扫码配网”。

   • 操作流程：长按插座按键 5 秒直至指示灯快闪 -> 打开“芯步”小程序 -> 选择“配置网络” -> 输入家中 2.4G Wi-Fi 密码 -> 生成二维码让插座扫描。

   • 记录 Device ID：配网成功后，在控制台的“设备列表”中查看该插座的唯一标识符 Device ID（例如 820720），后续 API 调用需要用到此 ID。

三、 接口调用

芯步的接口采用标准的 HTTP POST 请求，数据格式为 JSON。签名算法是接入的核心安全机制。

1. 请求地址

https://api.thingboot.com/{AppID}/device/control/?sign={sign}&ts={ts}

• AppID：您的应用ID

• sign：接口签名（用于身份验证）

• ts：Unix 时间戳（秒）

2. 签名生成规则

为了防止接口被恶意篡改，系统使用 MD5 双重加密：

1. 将 AppSecret 进行一次 MD5 加密 -> 得到 secret_md5
2. 拼接字符串:待签名字符串 = secret_md5 + ts
3. 对待签名字符串再次进行 MD5 加密 -> 得到最终的 sign

Python 示例代码：

3. 下发控制命令

通过 order 参数控制插座状态。

第一种场景：远程开启/关闭电器假设需要对连接在16A插座上的空调进行开关机。

Java 调用示例（使用 OkHttp）：

第二种场景：定时任务（先通后断）利用接口内置的 point 参数，可以实现“开启一段时间后自动关闭”，非常适合给电动车充电或控制热水器，无需在服务器端维护定时任务队列。

第三种场景：状态查询与电量计量如果您购买的是 16A 计量版，你还可以通过接口读取电压、电流和功率数据，用于能耗分析。

四、 实战案例：集成到 HomeAssistant 或企业内部系统

假设你希望将这款16A插座接入公司的内部工单系统或开源的 HomeAssistant。

逻辑流程图：

1. 触发：用户在企业微信点击“开启服务器散热风扇”。

2. 处理：后端服务生成签名 -> 调用 https://api.thingboot.com/.../control/。

3. 执行：芯步云平台下发指令到插座（80-120ms）。

4. 反馈：插座继电器吸合，3500W 负载通电。

Python Flask 微服务示例：

五、 常见问题与解决

1. 签名错误（401 Unauthorized）

   • 检查时间戳 ts 是否为秒级（长度为10位），不是毫秒级。

   • 检查 MD5 结果是否为 32 位小写十六进制字符串。

2. 控制失败（设备离线）

   • 16A 插座仅支持 2.4G Wi-Fi。若路由器开启了“双频合一”，关闭此功能，让插座单独连接 2.4G 频段。

   • LED 指示灯状态：快闪为待配网，慢闪为网络故障，常亮/熄灭为正常。

3. 大功率负载安全

   • 虽然额定 3500W，但如果是感性负载（如电机、老式空调），启动瞬时电流较大，预留余量，控制在 2500W 以内使用。