CATALOG

芯步的60A物联网断路器通过开放HTTP API接口,可快速接入自有的出租屋管理系统。以下是完整的对接技术方案。

1. 背景与需求分析

在出租屋管理中,用电安全一直是痛点。传统断路器无法提供实时数据,房东往往在跳闸或发生事故后才能发现问题。针对这一现状,本方案将基于芯步60A智能断路器的开放接口,将其无缝对接到现有的出租屋管理系统中。

通过对接,我们将实现以下核心目标:

  • 远程可控:租客退租或欠费时,房东可远程断电,无需上门操作。

  • 实时监测:实时获取电流、电压、功率数据,识别大功率违规电器。

  • 安全预警:过载、过压自动告警并保护,预防电气火灾。

  • 费用辅助:结合用电量数据,辅助进行电费结算。

2. 硬件选型:60A物联网断路器

结合需求,我们选定芯步的智能大功率断路器[计量版] 60A作为硬件设备

  • 核心参数

    • 额定电流:60A(适用于出租屋总闸或大功率电表箱回路)。

    • 工作电压:AC 85-265V(宽电压设计,适应市电波动)。

    • 负载功率:支持阻性负载最大12000W,感性负载2000W

    • 通信方式:Wi-Fi 2.4GHz(直连路由器,无需额外网关)

  • 选型理由

    • 计量功能:该版本支持精确的电量计量,这是收取电费和监测能耗的基础。

    • 接口开放性:芯步全系产品开放HTTP接口,支持私有化部署,可在局域网内直接控制,响应速度快(80-120ms)

3. 对接方案设计

3.1 系统架构

本方案采用云-管-边-端的物联网典型架构,但不依赖第三方云,而是直接将消息推送至自有服务器或芯步的开放平台进行中转,考虑到出租屋场景的网络复杂性,我们推荐混合通信模式

  1. 设备端:60A断路器通过Wi-Fi连接出租屋内的路由器。

  2. 云平台:芯步开放API网关(或自建私有化MQTT服务器)。

  3. 业务系统:自有的出租屋管理SaaS系统/小程序。

  4. 控制端:房东APP/小程序、物业管理后台。

3.2 API对接流程

芯步采用极简的HTTP RESTful API设计,签名机制采用双重MD5加密,保障接口调用安全

3.2.1 签名生成与鉴权

为了防止接口被恶意调用,每次请求都需要携带签名。具体生成算法如下:

  1. 获取AppSecret(在芯步控制台获取)。

  2. 计算 SignStr = md5(AppSecret)

  3. 将上一步的结果拼接当前时间戳 tstmp = md5(AppSecret) + ts

  4. 计算最终签名: sign = md5(tmp)

  5. 在请求URL中携带 ?sign={sign}&ts={ts}

3.2.2 核心指令下发

设备安装通电联网后,可通过API进行控制。

第一种场景:房东强制断电(如租客未交房租)

  • 请求地址https://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}

  • Method:POST

  • HeaderContent-Type: application/json

  • 请求Body示例

  • 预期响应:设备将在100ms左右执行分闸动作

第二种场景:获取实时用电数据(注:需查阅具体计量版API文档,通常数据会上报至云端或通过回调获取)一般流程为:设备主动上报 -> 平台推送至配置的URL -> 业务系统解析入库。数据包含:实时电压(V)、实时电流(A)、有功功率(W)、总用电量(kWh)。

4. 业务逻辑实现

在出租屋管理后台,我们需要开发以下逻辑单元:

4.1 定时巡检与自动断电

  • 逻辑:后台系统设置定时任务(如每5分钟),调用断路器接口获取当前功率。

  • 判断:若功率持续超过2500W(假设宿舍限电阈值)超过1分钟。

  • 动作:自动调用 {“power”: 0} 接口切断电路,并向管理员及租客推送“违规使用大功率电器”告警。

4.2 预付费联动

  • 场景:针对“先交费后用电”的2B托管公寓模式。

  • 流程

    1. 租客在微信小程序充值电费。

    2. 系统查询剩余电量。

    3. 若余额 ≤ 0:系统调用远程断电接口。

    4. 若余额 > 0:系统调用远程通电接口。

  • 优势:避免了人工上门拉闸的繁琐,减少房东与租客的摩擦。

4.3 私有化部署与内网穿透(可选)

芯步设备支持纯局域网环境运行。对于集中式公寓,如果网络带宽有限,可以配置设备与服务器在同一局域网内(如使用工业路由器+自建服务器),此时API请求不需要经过外网,延迟可进一步降低至50ms以内,且完全脱离公网依赖,稳定性更高。

5. 实施步骤

第一阶段:环境准备与设备配网

  1. 注册与创建:在芯步官网注册开发者账号,创建“工作台”,获取 AppIDAppSecret

  2. 设备安装:由电工在强电箱内安装60A断路器(注意:需断电操作,导轨安装,负载线接OUT端,进线接IN端)。

  3. 网络配置:通过芯步提供的配网工具(小程序/App),将设备连接到出租屋的2.4G WiFi网络。设备支持设置5组备选WiFi,增强漫游稳定性。

第二阶段:软件研发与对接

  1. 编写SDK封装:在后端代码中封装芯步的鉴权类和请求类(参考以下Python伪代码)。

  2. 回调地址配置:在芯步控制台配置“消息推送URL”,将断路器上报的电压、电流数据实时接收并存入数据库。

第三阶段:测试与验收

  1. 功能测试:点击后台“断电”按钮,现场确认断路器是否物理断开。

  2. 压测:模拟50台设备同时并发上报数据,检查服务器处理能力和数据库写入性能。

  3. 异常测试:拔掉WiFi路由器,观察设备是否自动重连并在网络恢复后自动补传数据。

6. 方案亮点总结

特性实现效果
无网关依赖60A断路器直连WiFi,降低硬件成本与故障点,即插即用
接口极简只需控制 power 字段,开发工作量极小,10分钟即可完成核心功能对接
精准计量精确到0.01kWh的计量精度,彻底解决出租屋电费纠纷问题。
本地化闭环支持局域网API调用,即使外网断开,内部管理系统依然可控制设备

通过本方案,开发者可以在不改变现有房屋布线结构的前提下,利用芯步60A断路器的开放能力,快速构建起一套高可靠的出租屋智慧用电管理系统。