CATALOG

芯步这款带计量数显的40A断路器,核心价值在于它的开放性——全部通过HTTP API控制,这意味着不管你后端用Java、Python还是Node.js,前端做Web还是小程序,都能直接对接。下面我把整个集成思路串一遍,从硬件配网到核心接口调用,再到业务场景。

一、 我们到底拿到了一个什么硬件?

首先,咱们得搞清楚手里这个“智能大功率断路器[计量数显版]40A”是个什么段位的设备。简单来说,它就是一个能联网、能远程开关、还能告诉你用了多少电的空气开关。

  • 硬实力:支持40A电流,一般小区充电桩单路也就32A,用它绰绰有余。而且它自带“数显”,就是在设备屏幕上直接能看到电流电压,现场维修电工看了都说好

  • 通讯方式:它走的是WiFi 2.4G,不需要买额外的网关。这意味你家普通路由器只要信号覆盖到了,它就能自己连上去

  • 集成友好度:芯步的设备走的都是HTTP协议。这就太方便了,现在任何一个会写代码的,不用去学什么复杂的物联网协议(MQTT之类),直接用Postman或者代码库里的Request库就能调它

二、 集成第一步:让设备“上网”并找到它

要把这个铁疙瘩集成到软件里,第一步不是写代码,而是配网虽然设备没有物理键盘,但一般流程是这样的:

  1. 通电:给断路器上电,这时候它会发出一个热点信号。

  2. 配网:用他们的配网工具或者小程序,告诉它你场地的WiFi密码是多少。

  3. 获取ID:配网成功后,在你的芯步控制后台,你会看到一个叫 Device ID 的东西。这串字符就是设备的身份证,你接下来的所有代码都是对着这个ID发指令。

一个小:如果做充电桩项目,场地往往在地下车库,信号可能不太好。这个设备能设置5组WiFi,把附近能搜到的信号都配进去,它会自动选信号最强的连

三、 核心玩法:API调用实战(怎么用代码控制它)

这是最关键的一步。我们要通过软件来控制它的“合闸”与“分闸”。

芯步的接口设计得比较简洁,主要是Sign签名机制。只要搞清楚签名的算法,剩下的就跟普通接口请求一样了。

1. 搞清楚签名算法

官方文档给出的规则是:md5( md5(AppSecret) + ts )听起来有点绕?其实逻辑就是:

  • 第一步:把你后台的AppSecret(密钥)做一次MD5加密。

  • 第二步:拿第一步的结果,拼接上当前的时间戳ts,再做一次MD5。

这样做的好处是:防止别人抓包重放攻击。因为时间戳一直在变,签名也一直在变,非常安全。

2. 实战:远程合闸(用户扫码充电)

假设用户扫了码,付了钱,我们需要闭合电路开始充电。

请求地址https://api.thingboot.com/[你的AppID]/device/control/

请求参数

  • device:就是上面提到的设备ID(例如:UNI-40A-001)。

  • order:这是一个JSON字符串。

    • 让它合闸:{"power":1} (1代表开,0代表关)

  • sign:刚才算出来的签名。

  • ts:当前时间戳。

代码逻辑示意(伪代码)

3. 进阶:读取计量数据(计费核心)

作为充电桩系统,你不能按时间瞎收钱,得按实际用电量收。这个断路器牛逼的地方就在计量通过接口查询设备状态,返回的数据包里通常包含:

  • voltage:当前电压(V)

  • current:当前电流(A)

  • power:实时功率(W)

  • ele:累计用电量(kWh) —— 这是收钱的依据!

我们可以设定一个定时任务(比如每分钟轮询一次),读取设备的电量数据。当用户点击“结束充电”时,用最后的电量减去开始的电量,乘以电价,就是最终的扣费金额。

四、 场景:充电桩软件架构怎么