芯步的开放接口采用标准HTTP协议,核心控制指令极简——只需携带设备ID和通断参数即可完成远程开关操作。以下方案围绕“硬件选型-接口集成-业务落地”三条主线展开,涵盖单控、批量、定时、联动四种控制模式,可直接用于技术选型和开发规划。
1. 解决概述
在现代连锁门店的运营中,空调、照明、广告屏、热水器等电器常因人为疏忽导致长明灯、空转,造成巨大的能源浪费。本方案基于芯步(YoYoIo T) 智能硬件及开放 API,旨在为零售、餐饮、办公等门店场景构建一套 “云管端”一体化电源管理系统。
通过替换或加装智能硬件(智能插座/断路器/PDU),并调用其开放的 HTTP 接口,总部或店长可通过自建管理系统实现对门店前端所有用电设备的远程通断、定时策略、能耗监控与联动控制,彻底结束“人走电未断”的历史,实现精细化能源管理。
2. 硬件选型与部署
在门店电源管理场景中,根据被控设备功率(如服务器、收银机、灯箱、咖啡机)及布线环境的不同,推荐部署以下芯步硬件,它们均支持 HTTP 接口控制与 私有化部署。
| 硬件类型 | 推荐型号/系列 | 核心功能与控制参数 | 适用场景 |
|---|---|---|---|
| 智能断路器/控制器 | 智能控制器 4路 交流电压版 | 支持4路独立控制,每路 MAX 10A/2200W,总负载≤4400W | 控制店内总照明、总闸、新风系统,可嵌入强电箱 |
| 智能 PDU | 智能 PDU[分控] 8位 | 8路独立控制,支持远程分合闸,具备电量计量功能 | 机房服务器、网络机柜、收银台多设备集控 |
| 智能墙壁插座 | 智能墙壁插座 10A/16A | 单控,支持功率计量,支持“先断后通”自动化逻辑 | 替换传统 86 插座,控制独立咖啡机、热水器、冰箱 |
| 智能移动插座 | 智能插座 10A | 即插即用,无需布线,支持定时任务 | 改造已装修门店的广告牌、易拉宝冷柜 |
部署要点
关键负载接入:优先将 空调控制器、LED 主照明回路、饮水机/热水器 接入智能硬件。
网络保障:上述设备均支持 Wi-Fi 2.4G 直连或网线接入。对于 Wi-Fi 信号弱的角落,部署 Mesh 网络以确保指令送达率。
3. 开放接口对接架构
本方案的系统架构基于 “总部/门店 SaaS 系统 ↔ 芯步云/私有化服务器 ↔ 智能硬件” 的闭环逻辑。
3.1 接口基础信息
芯步开放平台提供标准的 HTTP API,支持任何后端语言(Java, Python, PHP, Node.js)调用。
请求地址
http(s)://api.thingboot.com/{AppID}/device/control/鉴权方式:URL 携带参数
sign(签名)和ts(时间戳),防止接口被恶意篡改。数据格式
Content-Type: application/json
3.2 核心控制逻辑
在电源控制场景下,核心是修改 order 参数中的 powerX 字段。
单路控制:若设备 ID 为
123456,需关闭第 1 路电源(power1设为 0)。全量控制:关闭设备所有插口。
3.3 分组与批量控制
针对连锁门店动辄上百台设备的场景,需优先利用 分组控制接口,而非逐个发送指令。
接口地址
http(s)://api.thingboot.com/{AppID}/group/control/场景应用:定义分组“一楼照明组”(ID=100),一键关闭。
指令示例
4. 详细实施步骤
4.1 环境准备与设备纳管
注册与创建应用:在芯步开放平台注册开发者账号,获取
AppID和App Key(用于生成签名)。设备配网:下载“芯步”商家版 App 或使用设备热点配网,将智能插座/控制器连接至门店 Wi-Fi,并在平台端绑定至对应门店的组织架构下。
获取凭证:通过平台获取每个设备的唯一
deviceID。
4.2 接口集成开发(代码逻辑示例)
以下以 Python 为例,展示封装一个关闭设备电源的函数。在实际业务系统中,您需在后端实现此逻辑。
4.3 高级电源管理策略
集成接口不仅是简单的开关,还需实现以下自动化逻辑,需在您的业务服务器端设置定时任务或触发器:
定时 + 循环策略:针对门店营业时间(如 8:00 - 22:00),利用服务器 Cron 任务,在 23:00 调用接口关闭非必要电源(广告牌、部分照明),在 7:50 预开收银系统。
“一键闭店”场景:设定分组
Group ID = Store_101_All,闭店时系统调用group/control/接口,传入{“power1”:0, “power2”:0 ... “power8”:0},下发一次指令即可关闭全店电源。先断后通(复位模式):针对路由器或网络设备重启场景,调用
{“reset”: “30000”},即先断开电源 30 秒后自动重新接通,避免远程重启后设备彻底离线。
5. 关键应用场景实战
5.1 “人来灯亮,人走灯灭”(联动控制)
配合芯步 “智能人体存在传感器” 实现节能。
逻辑:传感器探测到无人状态持续 30 分钟 -> 传感器上报数据至您的服务器 -> 服务器调用智能照明的
power=0接口关灯。价值:解决卫生间、仓库、试衣间长明灯问题。
5.2 大功率设备实时监测与熔断
利用智能插座/PDU 的 计量功能(电量实时上报)。
逻辑:服务器接收功率数据 -> 发现某设备实时功率超过 3000W -> 立即调用
{“power”: “0”}切断该插座电源,并触发告警推送至管理员。价值:防止咖啡机、微波炉等设备过载引发火灾。
5.3 私有化部署与断网执行
对于数据安全要求高的高端连锁品牌,利用芯步支持的 私有化部署 特性。
操作:将平台部署在企业本地服务器,所有指令通过局域网或 VPN 通道下发。
优势:即使门店外网断开,只要局域网内 Wi-Fi 正常,手机 App 或电脑仍可通过局域网对设备进行通断控制。
6. 预期收益与总结
实施本方案后,门店可实现:
能耗直降 15%-30%:彻底杜绝闭店后空调、灯箱、电脑的待机电耗。
运维效率提升:总部无需派人前往门店,即可远程排查设备电源状态,解决“空跑一趟”问题。
设备安全延长:通过定时通断和稳压逻辑,减少设备无效运行时间,延长 LED 屏、电机等寿命。
下一步行动:联系芯步技术支持获取 《开放平台 API 文档详解》 与 沙箱环境测试账号,优先选取标杆门店部署 智能插座 测试空调或灯光的远程通断延时与稳定性。