CATALOG

一、概述

在无人售货机的运营场景中,电源控制是设备管理的核心环节。无论是远程重启死机的主控系统、定时切断非核心负载以节能,还是对异常设备进行紧急断电保护,都需要一套可靠、可编程的电源控制系统。本方案基于芯步1位5孔WiFi智能插座(10A/16A可选)及其开放HTTP接口,阐述如何将智能插座快速集成到现有无人售货机管理系统中

方案核心价值:无需改造售货机内部电路,即插即用;通过标准HTTP接口实现远程控制,开发工作量小;支持局域网和公网两种模式,可私有化部署。

二、技术架构

2.1 整体架构图

flowchart TB
    subgraph 管理层
        A[售货机管理后台]
        B[运维APP/小程序]
    end
    
    subgraph 通信层
        C[芯步API网关
api.thingboot.com] D[局域网API
私有化部署] end subgraph 设备层 E[WiFi智能插座] F[售货机电源] end subgraph 业务场景 G[主控系统] H[制冷压缩机] I[支付模块] J[照明灯箱] end A --> C A --> D B --> C C --> E D --> E E --> F F --> G F --> H F --> I F --> J

2.2 核心组件说明

组件说明
智能插座芯步1位5孔WiFi插座(10A/16A),支持远程通断控制、电量计量(计量版)
API网关公网接口 api.thingboot.com,支持HTTP/HTTPS
管理后台开发者自行集成的售货机管理系统
设备ID每个插座在平台上的唯一标识

三、硬件选型与部署

3.1 插座规格选型

根据售货机负载情况选择合适的型号:

规格额定功率适用场景
10A计量版MAX 2200W小型售货机、单货道控制
16A计量版MAX 3500W带制冷压缩机的售货机

计量版额外支持电压、电流、功率、用电量的实时上报,可用于能耗监控和异常预警

3.2 部署方式

方式一:整机供电控制

  • 将智能插座串联在售货机总电源输入前端

  • 优点:一个插座控制整台设备,成本最低

  • 适用场景:需要远程重启整机、定时开关机

方式二:分区独立控制

  • 多台插座分别接入不同负载(主控板、压缩机、照明、支付模块)

  • 优点:精细化控制,故障隔离

  • 适用场景:大型售货机、需要能耗分项统计

3.3 网络环境要求

  • WiFi 2.4GHz频段(不支持5G)

  • 确保售货机安装位置WiFi信号强度≥-70dBm

  • 支持配置5组WiFi网络,自动切换最强信号

四、接口集成开发

4.1 准备工作

在芯步开发者平台完成以下步骤:

  1. 注册开发者账号,创建应用,获取 AppIdAppSecret

  2. 添加智能插座设备,获取 设备ID(如:820720

  3. 确认设备在线状态

4.2 接口认证机制

芯步采用双重MD5签名机制,每个请求需携带:

  • sign:动态签名

  • ts:Unix时间戳(秒)

签名生成算法

Step 1: md5_1 = MD5(AppSecret)
Step 2: sign_str = md5_1 + ts
Step 3: sign = MD5(sign_str)

代码示例(Python)

代码示例(Node.js)

4.3 核心API接口

4.3.1 设备控制(开/关)

请求地址

POST https://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}

请求头

Content-Type: application/json

请求体

  • power: 1 开启插座,power: 0 关闭插座

响应示例

cURL调用示例

4.3.2 延时控制(点动模式)

适用于“通电N秒后自动断电”的场景(如重启操作):

  • point: 5000 表示先通电,5000毫秒后自动断电

4.3.3 断电恢复(先断后通)

适用于需要“彻底断电再重启”的场景:

  • reset: 3000 表示先断电,3000毫秒后自动恢复通电

4.3.4 批量控制

一次请求控制多台设备:

  • 多个设备ID用英文逗号分隔

4.4 状态查询与数据获取

计量版插座支持实时电参数据获取,可通过以下方式:

方式一:设备主动上报

  • 设备按配置间隔(通常30-60秒)向开发者配置的消息服务器推送数据

  • 需在控制台配置回调URL

方式二:主动查询

  • 调用设备状态查询接口获取最新数据

上报数据示例:

五、业务场景集成

5.1 第一种场景:远程故障恢复

问题:售货机触摸屏死机,需要现场断电重启。

解决方案

集成到管理后台后,运维人员可远程一键重启。

5.2 第二种场景:定时节能策略

问题:夜间无人购买,制冷压缩机持续运行造成浪费。

解决方案

  • 在管理系统中设置定时任务

  • 23:00 关闭压缩机对应插座

  • 06:00 开启压缩机预冷

5.3 第三种场景:支付联动控制

问题:用户扫码支付后,对应货道需要临时供电。

解决方案

5.4 场景四:异常预警

问题:设备功率异常(如压缩机故障、门锁短路)。

解决方案

  • 消费设备上报的功率数据

  • 设置阈值告警规则

  • 功率异常时自动切断电源并通知运维

六、高级功能

6.1 局域网私有化部署

对于对公网依赖敏感的场景,芯步支持私有化部署:

  • API服务可部署在客户自己的服务器上

  • 设备与API服务在同一局域网内通信

  • 完全脱离互联网运行

6.2 自建消息服务器

设备上报数据可推送到开发者自建的消息服务器:

  1. 在控制台配置回调URL

  2. 设备状态变化时,平台POST数据到指定URL

  3. 开发者自行处理数据(入库、分析、告警等)

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

7.1 网络问题

问题解决方案
设备离线检查WiFi信号强度,智能插座仅支持2.4G
命令响应超时正常响应80-120ms,超时可重试,设置3次重试
局域网控制失败确认设备与服务器在同一网段,检查防火墙策略

7.2 安全

  • 签名密钥保护:AppSecret不能暴露在前端代码中,必须由后端持有

  • 操作日志:记录所有控制操作,便于审计和追溯

  • 权限控制:管理后台应区分查看权限和操作权限

  • 频率限制:避免短时间内频繁下发命令,最小间隔≥2秒

7.3 负载注意事项

  • 10A插座适用于2000W以内负载

  • 16A插座适用于3500W以内负载

  • 电机类负载(压缩机)启动电流为额定3-7倍,需预留足够余量

  • LED/节能灯负载不超过500W

八、总结

芯步1位5孔WiFi智能插座通过开放的HTTP接口,为无人售货机项目提供了一个低成本、高可靠性、易集成的电源控制解决方案。开发者只需掌握基础的HTTP请求和MD5签名计算,即可在数小时内完成从设备配网到接口调用的全流程集成。

无论是远程故障恢复、定时节能控制,还是与支付系统联动的精细化电源管理,该方案都能有效支撑。对于对网络安全或公网依赖有特殊要求的场景,私有化部署和局域网控制功能也提供了充足的选择空间。