CATALOG

芯步的60A计量空开支持WiFi直连和HTTP API控制,无需额外网关即可接入。下面从硬件选型、API对接、数据获取到项目落地的完整链路展开说明。

一、 解决概述与硬件选型

在家庭配电箱改造项目中,核心设备是芯步“智能大功率断路器[计量版]|60A”。该设备不仅是空气开关(具备过流、短路保护功能),还集成了电能计量模块和WiFi通信模块

核心优势:

  • 直接接入: 支持WiFi(2.4GHz)直连,不需要购买额外的网关

  • 接口开放: 提供标准的HTTP API接口,支持JSON格式指令,适用于任何能发起HTTP请求的编程语言或平台(如Python、PHP、Node-RED、HomeAssistant等)

  • 双控模式: 支持远程(接口)控制和本地手柄控制,且支持断电记忆功能。

硬件安装注意:该设备采用导轨式安装,直接替换原有配电箱中的总闸或大功率回路空开。由于电流高达60A,请请一定要确认入户线缆线径(≥10mm²),并在断电施工。

二、 技术对接准备:获取密钥与网络配置

要将空开接入你自己的项目,需先在芯步平台完成以下准备工作:

  1. 注册与创建:在芯步官网注册账号,并创建一个“工作台”(相当于一个项目空间)

  2. 获取凭证:进入“物联网控制台” -> “开发设置”,获取以下两个关键字符串:

    • AppID: 应用唯一标识。

    • AppSecret: 应用密钥(用于加密签名,请勿泄露)

  3. 配网:因为60A空开是WiFi设备,需要给它配置家庭网络。

    • 打开设备电源。

    • 使用“芯步”小程序或控制台中的“网络配置”功能。

    • 输入家中的2.4G WiFi名称和密码(不支持5G WiFi),让设备联网

三、 核心对接逻辑:API签名与指令下发

这是实现“接入自己项目”最核心的步骤。芯步的API采用了动态签名机制来确保安全。假设你想通过自己的服务器或智能家居中枢(如树莓派)来控制这个空开。

1. 签名算法你需要生成一个动态的sign参数,计算方式为:YourSign = md5( md5(AppSecret) + ts )

  • ts: 当前Unix时间戳(秒)。

  • 逻辑: 先将AppSecret做一次MD5加密,得到的字符串拼接上时间戳,再将这个新字符串做一次MD5

2. 接口地址与请求示例

  • 请求URLhttps://api.thingboot.com/{AppID}/device/control/

  • 参数?sign=你的签名&&ts=当前时间戳

以下是一个Python代码示例,演示如何将60A空开“合闸”(通电):

关键分析

  • 设备ID获取:设备配网成功后,在控制台设备列表可以看到一串数字ID,必须替换到代码中。

  • 命令格式:对于60A大功率断路器,通常power1控制主回路。1为接通,0为断开

四、 数据读取:获取电压、电流与功率

除了控制通断,你的项目最关心的应该是计量数据(实时功率、今日用电量等)。芯步提供了两种数据获取方式:

方式一:主动查询(拉取模式)通过调用设备状态接口,轮询获取实时数据。你需要查阅接口文档,发送类似上述结构的请求,只是order字段改为查询指令。

方式二:被动接收(推送模式 / 高级应用)对于实时性要求较高的项目(如实时监控功率波动),可以采用消息推送机制。

  • 在控制台配置你的服务器接收地址(Webhook)。

  • 设备会上报电压、电流、功率因数、累计电能等数据到你指定的服务器端口,通过解析JSON即可存入数据库进行分析

典型字段解析(推测)当获取设备状态时,可能会收到如下数据,可提取作为能耗分析依据:

  • voltage: 电压 (V)

  • current: 电流 (A)

  • power: 有功功率 (W)

  • energy: 累计电能 (kWh)

五、 集成到自己的项目架构(以家庭能耗中枢为例)

假设你想做一个“家庭智能能耗看板”,集成的架构如下:

1. 物理层配电箱内安装 60A智能计量空开(总进线) + 若干 20A智能通断器(分支回路)。

2. 数据中台层

  • 在你的本地服务器(如群晖、树莓派)上运行一个定时脚本(Cron Job),每隔5分钟调用上述API接口

  • 优势:该设备支持局域网通信。只要你的服务器和空开在同一个WiFi下,甚至可以走局域网IP请求,不消耗外网流量且延迟极低

3. 应用展示层

  • 将获取到的电流、功率数据存入InfluxDB或MySQL。

  • 使用Grafana或自建Vue前端,绘制功率曲线图。

  • 设定逻辑:当功率连续10分钟低于50W时,自动调用API下发{"power1":0}命令切断待机电源,实现节能。

六、 常见问题和需要注意的点

  1. 关于60A电流的负载限制:该型号设计用于家庭总入户或大功率电器。API控制逻辑中应考虑“远程锁定”,防止因误操作导致大功率设备突然断电(如服务器、冰箱)造成损失。在代码中增加操作确认弹窗或延时断电逻辑。

  2. 断网处理:如果家庭WiFi中断,智能空开会失去远程控制能力,但它仍会保持最后的通断状态,且基本的过载短路保护功能(物理功能)永远生效,不受网络影响

  3. 安全性:不要将AppSecret硬编码在前端网页中。必须由你的后端服务器保存密钥并计算签名,前端通过你的后端接口控制设备,防止密钥泄露导致他人恶意拉闸

通过以上步骤,你就能将一个工业级的60A智能空开无缝对接到你自己开发的智能家居系统中,实现精准的电力监测与远程控制。