CATALOG

60A计量版空开的对接其实不复杂——芯步的设备都走HTTP接口,拿到AppID、AppSecret和设备ID,按规则拼签名就能调通。下面从准备工作、指令下发、数据接收,到实际应用场景,把整个流程串起来。

一、 准备工作:先把“三要素”拿到手

你要跟这个空开说话,得先拿到三样东西,就像登录账号需要用户名密码一样。

  1. AppID(应用ID)AppSecret(应用密钥)

    • 登录芯步官网,进到你的“工作台” -> “物联网控制台” -> “开发设置”。

    • 这里系统会生成一对钥匙给你。注意: AppSecret 只会显示一次,如果不小心忘了,重置一下就行。

  2. Device ID(设备ID)

    • 把 60A 计量版空开接通电源,用配网小程序(芯步小程序)或者电脑控制台,让它连上你现场的 2.4G WiFi 。

    • 连上网之后,在控制台的“设备列表”里就能看到这个空开了,那一串数字就是 Device ID

二、 核心接口:下发指令与接收数据

芯步的接口设计得很简单,就是标准的 HTTP POST 请求,不管你用 Python、Java 还是 PHP,甚至是单片机的 AT 指令,只要能发 HTTP 请求就行

1. 控制空开(合闸/分闸)

你想远程把电闸推上去或者拉下来,就往这个地址发一条数据。

  • 请求地址:https://api.thingboot.com/{你的AppID}/device/control/?sign={签名}&ts={时间戳}

  • 请求体(JSON):

  • 签名生成(稍微留意一下):芯步的签名规则是 md5( md5(AppSecret) + ts )啥意思? 就是先把你的 AppSecret 做一次 MD5 加密,得到一串字符串,然后把这串字符跟当前的时间戳(秒)拼在一起,再对整个拼起来的字符串做一次 MD5。这个机制主要是为了防止接口被别人随便调用,保证安全性。

2. 接收计量数据(这才是重点)

既然是“计量版”,你肯定最关心电流、电压、功率怎么拿。这个空开不会等你来问,它是主动上报的。

你需要准备一台公网服务器(或者局域网服务器,如果你开了私有化部署的话),在芯步控制台里设置一个“消息推送 URL”(也叫 Webhook)。

只要空开的电流、电压有变化,或者每间隔一段时间(通常是几秒钟),它就会主动往你这个地址 POST 一段 JSON 数据。你只要解析这段数据就行,结构大概像这样

三、 实战逻辑:基于数据的保护机制

拿到数据了,怎么用?给你举个实实在在的例子:大功率保护

假设你接了一个 10kW 的设备,空开额定是 60A(约 13kW),为了防止线路过热起火,你想在功率超过 8kW 时就自动跳闸。

在你后端的代码里,只需要写几行简单的逻辑:

四、 高级玩法:私有化部署(局域网)

如果你所在的工厂或者机房对数据安全要求比较高,不希望数据经过外网(互联网),芯步的这个空开是支持私有化部署

  • 原理: 它允许你搭建一个“本地消息服务器”。空开连接 WiFi 时,配置的 API 域名指向你自己的服务器 IP 地址。

  • 好处:

    • 0延迟:数据在内网跑,响应飞快。

    • 断网无忧:即便外网断了,你的本地监控系统依然能拉闸和看数据。

五、 常见问题(排坑指南)

  1. 为什么我发的命令没反应?

    • 检查 ts(时间戳),你的服务器时间要和标准时间误差不能太大,否则签名会失效。

    • 检查 Device ID 是不是复制错了,别把别的传感器 ID 填进来了。

  2. 数据上报太慢了?

    • 默认是变化上报,如果电流很平稳,上报频率会降低。如果你需要高频监控,可以去控制台把“心跳间隔”调短一点(比如 5 秒上报一次),不过这样流量会大一些。

  3. WiFi 连接问题:

    • 只支持 2.4G WiFi ,5G 频段是搜不到的。路由器的名字(SSID)尽量不要用中文。

总结

对接这块空开,核心工作其实就两件事:

  1. 写一个接收数据的接口(Webhook),用来实时拿到电压、电流,存到数据库或者做实时判断。

  2. 写一个控制接口的调用(HTTP Client),用来根据数据结果执行“合闸”或“分闸”。

这中间的业务逻辑(比如:功率超限报警、过欠压保护、定时开关),完全可以按你的实际需求灵活发挥。