CATALOG

共享设备柜的痛点是“多路独立控制”——每个格口需要单独供电、计费和断电。芯步的8路智能控制器正好解决这个问题,通过HTTP接口即可实现每路独立控制,无需网关、部署简单。以下是完整的集成方案。

1. 解决概述

在共享经济场景(如共享充电宝柜、共享雨伞机、快递柜、工具租赁柜)中,核心需求是:远程控制单个格口的通电与断电,并结合扫码支付实现自动化运营。

芯步提供的 8路智能远程电源控制器 专为此类场景设计。它拥有8个独立可控的线路,支持通过简单的 HTTP/HTTPS 接口远程控制每一路的通断。这意味着你可以将一个拥有8个格口的柜机物理上仅需一块控制器即可实现独立控制,极大降低硬件成本和布线复杂度

核心价值:

  • 高集成度:单设备控制8路输出,适合标准柜体布局。

  • 独立控制:8路分控互不干扰,可独立控制对应格口的电源或电磁锁。

  • 开发友好:开放标准 HTTP API,无论你的后台是 PHP、Java、Python 还是 Go,均可轻松集成。

  • 部署灵活:支持 公网远程控制局域网私有化部署,保障数据安全与响应速度

2. 硬件选型与准备

在集成前,请确认你的硬件设备为 UNI-KZQ-TY-8 系列(智能通用控制器 | 8路)。

关键参数说明:

  • 工作电压:DC 12V 1.5A(需配备稳定电源)。

  • 负载能力:单路最大支持 2200W(阻性负载),总功率不超过 4400W。

  • 通讯方式:WiFi 2.4GHz(不支持 5G WiFi,需注意现场路由器频段设置)。

  • 控制方式:继电器输出。对于共享设备柜,通常用于控制 220V 电源插座12V 电磁锁

接线示意(与柜体的物理集成):

  1. 输入:控制器接入 220V 市电或 12V 直流电源。

  2. 输出(8路)

    • L/N 输出端子:分别连接到 8 个独立格口的电源插座(例如 220V 充电插座)。

    • 或者连接到门锁驱动板。

  3. 网络:配置连接至现场的 2.4G WiFi。

3. 设备端配置(配网与激活)

在进行 API 开发之前,需要先将设备连上网络并与你的平台账号绑定。

操作步骤:

  1. 注册/登录:访问芯步官网或小程序,注册企业账号。

  2. 创建“工作台”:这是管理设备的数据核心。

  3. 配网

    • 使用 “小程序配网” 较为便捷。

    • 进入小程序后,选择对应的工作台,输入现场的 2.4G WiFi 名称和密码

    • 控制器接通电源,待指示灯从“快闪”变为“常亮/慢闪”,即表示上线成功。

  4. 获取关键凭证

    • 登录物联网控制台,找到已配网的设备,记录 设备ID(Device ID)。

    • 进入“开发设置”,获取 AppIDAppSecret(开发者密码)。这 3 个字符串是后续 API 调用的钥匙

4. API 接口集成指南

芯步的接口采用标准的 HTTP POST 请求,请求体为 JSON 格式,签名算法简单通用。

4.1 接口地址

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

注:支持 HTTP 和 HTTPS,若部署在局域网内可使用私有化 IP 地址。

4.2 签名生成规则(核心安全步骤)

为了防止接口被恶意调用,请求需要携带动态签名。

  • 公式sign = md5( md5(AppSecret) + ts )

  • 参数说明

    • AppSecret:你的开发者密码。

    • ts:当前 UNIX 时间戳(秒),用于防止重放攻击。

PHP 示例:

4.3 控制指令详解

该 API 支持非常精细的控制,以下是共享柜机场景最常用的指令。

操作场景指令格式 (JSON String)说明
开第2个格口{"power2":1}1代表接通/开锁,0代表断开/关锁。
关第2个格口{"power2":0}控制在对应设备下 ID 为2的线路。
全开/全关{"batch":{"power":1}}一次性打开或关闭所有8个格口。
选择性批量{"batch":{"relay":[1,3,5,7],"power":1}}只打开 1,3,5,7 号格口。

4.4 代码实战(以 PHP 为例)

假设用户刚刚扫码支付成功,需要为用户打开 3 号格口:

注:其他语言(Java, Python, Node.js)逻辑完全一致,仅需替换 HTTP 请求库即可。

5. 业务逻辑集成(共享流程)

如何将控制器无缝集成到你的共享项目中?典型的“扫码-通电-断电”闭环如下:

步骤 1:用户扫码

  • 用户扫描柜体上的二维码,前端获取设备编号(关联后台的柜机 ID 和格口号)。

步骤 2:支付与鉴权

  • 你的后端服务器收到请求,调用支付接口(微信/支付宝)。

  • 支付成功后,进入控制逻辑。

步骤 3:下发指令

  • 你的业务服务器调用芯步 API。

  • 请求示例:针对 device_001 发送 {"power3":1}

  • 硬件响应(通常在 100ms 以内),继电器吸合,3号格口通电/弹开电磁锁

步骤 4:状态监控与心跳

  • 被动上报:用户归还物品关闭柜门(或通过物理限位开关),你可以在业务上主动调用 {"power3":0} 切断电源,确保安全。

  • 联动控制:用户可以结合芯步的 传感器类产品(如门磁传感器)。当检测到柜门关闭时,自动触发 API 调用切断电源并结束计费

6. 私有化部署与局域网控制

对于网吧、企业内部、政府机构等高安全或低延迟要求的场景,芯步支持 私有化部署

  • 无需云端:指令完全在本地局域网路由内传输,不经过芯步公网服务器。

  • 更低延迟:局域网内响应速度可达毫秒级,网络抖动极小。

  • 独立生态:API 接口调用逻辑不变,只需将请求 URL 中的 api.thingboot.com 替换为你部署的本地服务器 IP 即可

7. 注意事项与调试

1. WiFi 稳定性是关键

  • 由于设备仅支持 2.4G,请确保现场路由器开启 2.4G 频段,并关闭“双频合一”功能,防止设备掉线

2. 负载类型注意

  • 如果控制的是电机(如自动门)、LED 节能灯或开关电源,属于感性/容性负载,降额使用,否则可能损坏继电器触点

3. 设备唯一ID

  • 如果管理 100 台柜机(每台一个控制器),你需要维护一个映射表:本地格口ID -> (Device_ID, Relay_Channel_ID)

4. 调试工具

  • 在正式编码前,先在芯步的“物联网控制台”网页端找到设备,尝试点击控制按钮。如果网页端能控,代码不能控,99% 是 签名算法错误(检查 AppSecret 是否多空格)或 ts 时间戳差值过大

通过以上步骤,你可以将芯步的 8 路控制器作为一个标准的“外设”快速集成到你的共享系统中,实现硬件的智能化管理。