芯步这款带计量数显的40A断路器,核心价值在于它的开放性——全部通过HTTP API控制,这意味着不管你后端用Java、Python还是Node.js,前端做Web还是小程序,都能直接对接。下面我把整个集成思路串一遍,从硬件配网到核心接口调用,再到业务场景。
一、 我们到底拿到了一个什么硬件?
首先,咱们得搞清楚手里这个“智能大功率断路器[计量数显版]40A”是个什么段位的设备。简单来说,它就是一个能联网、能远程开关、还能告诉你用了多少电的空气开关。
硬实力:支持40A电流,一般小区充电桩单路也就32A,用它绰绰有余。而且它自带“数显”,就是在设备屏幕上直接能看到电流电压,现场维修电工看了都说好。
通讯方式:它走的是WiFi 2.4G,不需要买额外的网关。这意味你家普通路由器只要信号覆盖到了,它就能自己连上去。
集成友好度:芯步的设备走的都是HTTP协议。这就太方便了,现在任何一个会写代码的,不用去学什么复杂的物联网协议(MQTT之类),直接用Postman或者代码库里的Request库就能调它。
二、 集成第一步:让设备“上网”并找到它
要把这个铁疙瘩集成到软件里,第一步不是写代码,而是配网。虽然设备没有物理键盘,但一般流程是这样的:
通电:给断路器上电,这时候它会发出一个热点信号。
配网:用他们的配网工具或者小程序,告诉它你场地的WiFi密码是多少。
获取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) —— 这是收钱的依据!
我们可以设定一个定时任务(比如每分钟轮询一次),读取设备的电量数据。当用户点击“结束充电”时,用最后的电量减去开始的电量,乘以电价,就是最终的扣费金额。