CATALOG

芯步的WiFi通断器采用标准HTTP接口,核心就是通过签名认证调用API下发命令。以下方案涵盖从硬件准备、接口鉴权到业务系统集成的完整路径,代码示例直接用C libcurl实现,可快速接入现有系统。

解决方案:基于芯步开放接口的 Type-C WiFi 通断器二次开发

1. 概述与准备

本方案的目标是指导开发者如何利用芯步平台提供的开放 API 接口,对 Type-C 供电的 WiFi 通断器 模组进行二次开发,从而实现通过自有云平台或应用对该设备的远程控制和状态管理。

适用场景:智能插座、DIY 物联网项目、工业设备远程重启、智能灯具控制等。

准备工作

  1. 硬件:芯步 Type-C 供电 WiFi 通断器模组(基于 ESP32 或类似方案)。

  2. 平台账号:注册并登录 [芯步开放平台],在控制台获取 AppIDAppSecret

  3. 开发环境:支持 HTTP 请求的开发环境(如 C, Python, Java, Node.js 等),本文将以 C 语言结合 libcurl 为例。

2. 硬件与通信机制分析

该 Type-C 接口不仅是供电输入(5V),通常也连接内部的继电器控制电路和 WiFi 模组。

  • 供电特性:Type-C 接口提供 5V 输入,模组内部通过 LDO 降压至 3.3V 为 ESP 芯片供电

  • 控制逻辑:通断器的核心是控制继电器的开合。二次开发并非修改模组固件,而是利用模组已固化的固件,通过 芯步云平台 API 下发指令。

  • 通信路径自有云平台 -> 芯步云 API -> WiFi 模组 -> 继电器动作

3. 核心开发:API 接口调用

芯步采用标准的 HTTP 协议,下行控制指令通过向指定 URL 发送 POST 请求实现

3.1 接口鉴权与签名计算

所有 API 请求均需携带签名。鉴权参数包含在 URL 中,核心算法是双重 MD5 加密签名公式sign = md5( md5(AppSecret) + ts )

一个通用的 C 语言时间戳与签名生成逻辑如下:

3.2 下发控制指令

无论是单路还是多路控制器,核心在于 order 参数的构造。对于基础的 Type-C 通断器,控制指令通常涉及 power 字段

CURL 请求示例

常用 order 指令集

  • 开启{"power":1}{"power1":1} (多路场景)

  • 关闭{"power":0}

  • 多路批量{"batch":{"relay":[1,3],"power":1}} (开启第1和第3路)

4. 高级功能集成:设备状态实时同步

单纯的“发命令”是不够的,完整的解决方案需要获取设备当前状态。

配置回调接收(推荐)

在芯步控制台中配置 “API 回调 URL” 。当设备状态变化(如手动按下模组上的按键、或设备上下线)时,平台会主动推送数据到你的服务器

  • 接收格式:JSON。

  • 处理逻辑:开发一个 Web 接口(例如 http://yourdomain.com/device/callback),接收 device_idstatus,并更新本地数据库。

主动查询(备选)

如果无法配置公网回调,可通过调用查询接口获取设备最新状态。

5. 实战应用场景:智能插座改造/远程重启器

假设你有一个工控主机需要定时重启或远程维护,利用该 Type-C 通断器作为控制媒介。

后端 C 语言控制函数封装示例我们可以将控制逻辑封装成一个简单的函数,方便集成到自动化任务中。

6. 总结

基于芯步 Type-C WiFi 通断器进行二次开发的门槛较低,其核心是 HTTP 接口调用签名生成算法

开发者不需要编写设备端固件,只需专注于业务逻辑:

  1. 连接:确保设备通过 Type-C 上电并连入 2.4G WiFi。

  2. 开发:调用 api.thingboot.com 接口,传入 device_idorder 指令。

  3. 应用:将控制逻辑集成到运维脚本、自动化任务或 App 后台中,实现远程开关、定时重启等高阶功能。