芯步的60A物联网断路器通过开放HTTP API接口,可快速接入自有的出租屋管理系统。以下是完整的对接技术方案。
1. 背景与需求分析
在出租屋管理中,用电安全一直是痛点。传统断路器无法提供实时数据,房东往往在跳闸或发生事故后才能发现问题。针对这一现状,本方案将基于芯步60A智能断路器的开放接口,将其无缝对接到现有的出租屋管理系统中。
通过对接,我们将实现以下核心目标:
远程可控:租客退租或欠费时,房东可远程断电,无需上门操作。
实时监测:实时获取电流、电压、功率数据,识别大功率违规电器。
安全预警:过载、过压自动告警并保护,预防电气火灾。
费用辅助:结合用电量数据,辅助进行电费结算。
2. 硬件选型:60A物联网断路器
结合需求,我们选定芯步的智能大功率断路器[计量版] 60A作为硬件设备。
核心参数
额定电流:60A(适用于出租屋总闸或大功率电表箱回路)。
工作电压:AC 85-265V(宽电压设计,适应市电波动)。
负载功率:支持阻性负载最大12000W,感性负载2000W。
通信方式:Wi-Fi 2.4GHz(直连路由器,无需额外网关)。
选型理由
计量功能:该版本支持精确的电量计量,这是收取电费和监测能耗的基础。
接口开放性:芯步全系产品开放HTTP接口,支持私有化部署,可在局域网内直接控制,响应速度快(80-120ms)。
3. 对接方案设计
3.1 系统架构
本方案采用云-管-边-端的物联网典型架构,但不依赖第三方云,而是直接将消息推送至自有服务器或芯步的开放平台进行中转,考虑到出租屋场景的网络复杂性,我们推荐混合通信模式
设备端:60A断路器通过Wi-Fi连接出租屋内的路由器。
云平台:芯步开放API网关(或自建私有化MQTT服务器)。
业务系统:自有的出租屋管理SaaS系统/小程序。
控制端:房东APP/小程序、物业管理后台。
3.2 API对接流程
芯步采用极简的HTTP RESTful API设计,签名机制采用双重MD5加密,保障接口调用安全。
3.2.1 签名生成与鉴权
为了防止接口被恶意调用,每次请求都需要携带签名。具体生成算法如下:
获取AppSecret(在芯步控制台获取)。
计算
SignStr = md5(AppSecret)。将上一步的结果拼接当前时间戳
ts:tmp = md5(AppSecret) + ts。计算最终签名:
sign = md5(tmp)。在请求URL中携带
?sign={sign}&ts={ts}。
3.2.2 核心指令下发
设备安装通电联网后,可通过API进行控制。
第一种场景:房东强制断电(如租客未交房租)
请求地址
https://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}Method:POST
Header
Content-Type: application/json请求Body示例
预期响应:设备将在100ms左右执行分闸动作。
第二种场景:获取实时用电数据(注:需查阅具体计量版API文档,通常数据会上报至云端或通过回调获取)一般流程为:设备主动上报 -> 平台推送至配置的URL -> 业务系统解析入库。数据包含:实时电压(V)、实时电流(A)、有功功率(W)、总用电量(kWh)。
4. 业务逻辑实现
在出租屋管理后台,我们需要开发以下逻辑单元:
4.1 定时巡检与自动断电
逻辑:后台系统设置定时任务(如每5分钟),调用断路器接口获取当前功率。
判断:若功率持续超过2500W(假设宿舍限电阈值)超过1分钟。
动作:自动调用
{“power”: 0}接口切断电路,并向管理员及租客推送“违规使用大功率电器”告警。
4.2 预付费联动
场景:针对“先交费后用电”的2B托管公寓模式。
流程
租客在微信小程序充值电费。
系统查询剩余电量。
若余额 ≤ 0:系统调用远程断电接口。
若余额 > 0:系统调用远程通电接口。
优势:避免了人工上门拉闸的繁琐,减少房东与租客的摩擦。
4.3 私有化部署与内网穿透(可选)
芯步设备支持纯局域网环境运行。对于集中式公寓,如果网络带宽有限,可以配置设备与服务器在同一局域网内(如使用工业路由器+自建服务器),此时API请求不需要经过外网,延迟可进一步降低至50ms以内,且完全脱离公网依赖,稳定性更高。
5. 实施步骤
第一阶段:环境准备与设备配网
注册与创建:在芯步官网注册开发者账号,创建“工作台”,获取
AppID和AppSecret。设备安装:由电工在强电箱内安装60A断路器(注意:需断电操作,导轨安装,负载线接OUT端,进线接IN端)。
网络配置:通过芯步提供的配网工具(小程序/App),将设备连接到出租屋的2.4G WiFi网络。设备支持设置5组备选WiFi,增强漫游稳定性。
第二阶段:软件研发与对接
编写SDK封装:在后端代码中封装芯步的鉴权类和请求类(参考以下Python伪代码)。
回调地址配置:在芯步控制台配置“消息推送URL”,将断路器上报的电压、电流数据实时接收并存入数据库。
第三阶段:测试与验收
功能测试:点击后台“断电”按钮,现场确认断路器是否物理断开。
压测:模拟50台设备同时并发上报数据,检查服务器处理能力和数据库写入性能。
异常测试:拔掉WiFi路由器,观察设备是否自动重连并在网络恢复后自动补传数据。
6. 方案亮点总结
| 特性 | 实现效果 |
|---|---|
| 无网关依赖 | 60A断路器直连WiFi,降低硬件成本与故障点,即插即用。 |
| 接口极简 | 只需控制 power 字段,开发工作量极小,10分钟即可完成核心功能对接。 |
| 精准计量 | 精确到0.01kWh的计量精度,彻底解决出租屋电费纠纷问题。 |
| 本地化闭环 | 支持局域网API调用,即使外网断开,内部管理系统依然可控制设备。 |
通过本方案,开发者可以在不改变现有房屋布线结构的前提下,利用芯步60A断路器的开放能力,快速构建起一套高可靠的出租屋智慧用电管理系统。