CATALOG

这是一个针对“共享茶室”场景,将芯步5位分控PDU集成到现有管理系统中的技术解决方案。

1. 行业背景与痛点

在共享茶室、无人棋牌室、自助自习室等无人值守场景中,机柜(包括交换机、路由器、背景音乐主机、茶艺煮水设备) 的电源管理是运维的难点。

传统的解决方案存在以下痛点:

  • 死机无法自愈:路由器或服务器死机,需人工跑现场拔插电源。

  • 能耗浪费:顾客离开现场时后,机柜附属设备(如广告屏、功放)仍在通电。

  • 权限模糊:无法通过远程或自动化手段按需分配电源。

解决方案:引入芯步5位分控智能PDU。该设备支持5路独立分控(即可单独控制5个插孔的通断电),并开放标准HTTP API接口,可完美嵌入您的“共享茶室SaaS系统”。

2. 硬件选型:芯步 5位分控PDU

根据芯步官方硬件库,我们选用 “智能PDU[分控]|5位” 作为核心执行单元

  • 核心优势:支持线路1至线路5独立控制(Power1 - Power5),支持批量控制(Batch)。

  • 网络连接:采用WiFi 2.4G直连接入,无需额外网关,降低部署成本

  • 接口协议:全系支持HTTP请求,兼容任何后端语言(Java, Python, PHP, Node.js)及前端(小程序、Web)

3. 系统设计

集成逻辑

  1. 设备层:PDU接入茶室机柜电源(路由、光猫、主控盒、音响等)。

  2. 云平台层(芯步) :PDU保持长连接,监听云端指令。

  3. 应用层(您的服务器/小程序) :您的业务系统通过调用芯步的开放API,发出“闭合/断开”指令。

通信流程顾客小程序下单 -> 茶室SaaS系统(您的后端) -> 计算Sign签名 -> 调用ThingBootApi -> 云端下发给PDU -> PDU执行通断

4. 详细集成步骤

4.1 环境准备与凭证获取

  1. 注册:登录芯步官网,进入控制台

  2. 获取密钥:在“开发设置”中,获取 AppIDAppSecret。这是您系统调用接口的“身份证”

  3. 设备添加:将PDU通网通电,在控制台中绑定设备,获取唯一的 DeviceID(例如:12345678)。

4.2 接口签名算法 (Sign)

这是集成过程中唯一需要注意的技术细节。为防止接口被恶意篡改,芯步采用双重MD5签名机制

签名公式Sign = md5( md5(AppSecret) + ts )

步骤拆解

  1. AppSecret 进行一次MD5加密,得到字符串 S1

  2. 获取当前Unix时间戳(秒级),记为 ts

  3. 拼接字符串:S1 + ts

  4. 对拼接后的字符串再次进行MD5加密,得到最终的 Sign

注:时间戳ts需作为参数一并传递,用于服务端时效性校验。

4.3 分控命令下发 API 详解

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

请求方式POSTContent-Typeapplication/json

核心参数

  • device:设备ID(字符串类型)。

  • order:指令对象(JSON字符串)。

特别注意:文档指出,order 参数需传入 JSON字符串(如 '{"power1":1}'),而非直接嵌入JSON对象。

4.4 实际场景命令示例

假设我们要控制“茶室A”机柜中的路由器插在“线路1”,音响插在“线路2”。

业务场景指令JSON (order)说明
顾客扫码开始使用{"power1":1, "power2":1}闭合线路1和2,路由器与音响通电
顾客临时暂停{"power2":0}仅关闭音响,保留路由器网络
顾客结束订单{"power1":0, "power2":0}全关,节能且安全
远程重启路由器{"power1":0} (等待5秒) -> {"power1":1}先断后开,实现网络设备重启

4.5 代码实现脚手架 (Python示例)

以下是根据芯步官方示例整理的集成片段

5. 高级功能集成:事件驱动与联动

为了提升共享茶室的智能化程度,利用芯步平台的消息推送功能

5.1 异常实时告警

  • 配置:在控制台配置“消息推送URL”(您的后端接口)。

  • 场景:当PDU检测到电流过载或电压不稳时,平台会主动推送数据到您的服务器。

  • 动作:您的系统收到告警后,自动触发短信/公众号通知给正在使用的顾客,或通知运维人员。

5.2 传感器联动

  • 设备:搭配“芯步智能人体存在传感器”

  • 逻辑:顾客离开茶室超过15分钟,传感器上报“无人”状态 -> 您的服务器接收消息 -> 自动调用PDU断电API(执行节能策略)。

  • 逻辑:顾客推门进入 -> 传感器上报“有人” -> 自动调用PDU通电API(恢复供电,点亮设备)。

6. 私有化部署选项

对于一些注重数据安全或处于弱网环境(无外网)的高端茶室:

  • 芯步支持私有化部署局域网自建消息服务器

  • 您的后端可以不经过公网,直接在局域网内下发MQTT或HTTP指令给PDU,保证断网环境下系统依然可控。

7. 总结

通过集成芯步5位分控PDU,共享茶室的机柜管理将实现:

  1. 无人化:彻底告别人工拔插电源。

  2. 精细化:可按设备(光猫/路由/主控)精准控制,而非一把抓断总闸。

  3. 自动化:与订单系统、传感器联动,实现“订单开始即供电,订单结束即断电”。

实施:首先购买一台PDU设备在办公室进行API对接测试,利用其提供的batch(批量控制)接口可以一次性设置所有线路状态,简化开发复杂度