CATALOG

芯步的智能PDU(就是那种5位总控/分控插排)本身就开放了HTTP接口,对接起来其实就像在代码里发几个请求那么简单。下面我整理了从硬件配网到代码接入的完整流程,你可以直接拿去参考。

一、 硬件的“入网”准备(让插排连上Wi-Fi)

在写代码之前,首先得让插排连上网。芯步的设备支持“小程序配网”,操作非常“白菜化”,不需要什么技术基础:

  1. 上电:把5位总控插排插上电,确保指示灯处于快闪状态(通常是红绿交替或急促闪烁),这代表它正在寻找网络。

  2. 小程序操作:拿出手机,打开微信搜索“芯步”小程序。

  3. 账户登录:用手机号注册并登录(这一步也顺便帮你开通了云端后台的账号)。

  4. 添加设备:点击小程序右上角的“加号”或“添加设备”。

    • 输入你现场的Wi-Fi名称和密码。注意: 大部分物联网设备只支持 2.4G频段 的Wi-Fi,如果你的Wi-Fi是双频合一的,在路由器后台关掉5G频段或分开设置,否则插排可能连不上

  5. 配网成功:按照提示,让手机靠近插排,通常几秒钟后指示灯变成常亮慢闪,就说明设备已经连上云端了。

二、 核心对接姿势:HTTP接口调用

配网成功后,先登录芯步的官网控制台,拿到属于你的“钥匙”:

  • AppID:你的应用ID。

  • AppSecret:你的应用密钥。

  • Device ID:刚才配网的那个插排的ID(在设备列表里能看到)。

1. 接口与地址

芯步的接口风格非常 Restful 和简洁,不需要复杂的SDK,无论是Java、Python、PHP还是Node.js,只要支持HTTP请求就能调

请求地址:

  • Method:POST

  • Body类型:JSON

2. 签名计算(稍微注意一下)

为了安全,接口有一个签名校验,逻辑大概是这样的:sign = md5( md5(AppSecret) + ts )

  • ts 是当前时间的秒数戳。

  • 先把你的密钥 AppSecret 做一次MD5,得到的结果再拼接上时间戳,整体再做一次MD5

举个例子(伪代码):如果你的密码是 abc123,当前时间是 1714550400Step1: Md5_Secret = md5(“abc123”) = “e99a18c...”Step2: 待签名字符串 = “e99a18c...” + “1714550400”Step3: 最终sign = md5(待签名字符串)

3. 下发控制指令(最关键的一步)

针对 5位总控插排,控制指令的格式非常直观。它通常支持“总控”和“分控”两种模式。

如果你买的是 5位分控(可以单独控制每个孔位的通断):

  • 打开第1个插孔

  • 关闭第3个插孔

  • 全部打开(如果是总控):

如果你买的是 5位总控(只有一个继电器控制全部):通常使用 power 字段,不带数字。

  • 全部开启{“power”: 1}

  • 全部关闭{“power”: 0}

三、 实战场景:如何写到项目代码里?

假设你现在正在开发园区的 中控管理系统,有一个需求:“当园区下班时,一键关闭所有机柜的电源以节能”。

你只需要在后端写一个函数,请求插排的关闭接口。整个过程(从后端发起请求到插排断电)通常在 80-120毫秒 左右,体感上几乎是瞬发的

代码逻辑示意图(伪代码):

四、 进阶技巧:局域网私有化(如果园区内网要求高)

很多园区对数据安全比较看重,不希望设备指令经过外网流转。芯步的设备其实支持 局域网API 控制

  • 原理:只要你的后端服务器和插排连接的是同一个局域网(插排连了Wi-Fi,你的服务器也连了同一个路由器),你可以通过广播或者直接访问设备的本地IP进行控制,不经过云端。

  • 优势:延迟更低(局域网一般在10-20ms)、完全不依赖互联网带宽。

五、 总结一下方案落地的步骤

  1. 买硬件:采购芯步 5位PDU(记得确认型号是否支持分控,总控便宜,分控灵活)。

  2. 配网:通过“芯步”小程序,把插排连上园区的 2.4G Wi-Fi

  3. 拿钥匙:去官网控制台拿到 AppIDAppSecret

  4. 调接口:在项目中封装一个 DeviceControl 服务,按照上述的签名规则,通过 HTTP POST 请求加上 power1/power2 等参数,实现对每个机柜电源的开关。

这套方案最实用的地方在于,它不需要复杂的嵌入式开发,一个普通的后端工程师看半小时文档就能搞定,而且以后要加温度传感器、烟感,也是用同一套接口逻辑