如何在自助储物柜控制中集成智能设备来实现16路多通道独立控制_解决方案

CATALOG

芯步的智能通用控制器|16路（型号：UNI-KZQ-TY-16）是一款专为多通道独立控制场景设计的硬件产品。它提供16路输出，可通过HTTP接口远程独立控制每一路的通断，体积小巧、集成度高，非常适合自助储物柜场景。

一、解决概述

自助储物柜的痛点在于：柜门数量多（通常12-24格），需要独立控制每个格子的电磁锁，同时还要兼顾照明、语音提示等辅助设备。传统方案采用多个继电器模块分散控制，布线复杂、维护困难。

本方案利用芯步16路智能通用控制器的高集成度特性，将储物柜的所有控制线路集中到一台设备中，通过HTTP开放接口与软件项目无缝对接，实现：

16路独立控制：每路可单独控制电磁锁的通断时间、顺序
批量操作：一键全开/全关，或选择性开启指定柜门
定时控制：支持“先通后断”命令，电磁锁通电后自动断电，防止线圈烧毁
灵活扩展：单台设备不足时可并联多台，支持最多100台设备同时控制

二、核心技术能力分析

2.1 16路智能通用控制器特性

类别	特性说明
控制路数	16路独立输出，每路均可通过HTTP接口远程控制
工作电压	DC 12V2A（直流），适配电磁锁供电需求
单路负载	MAX 2200W[阻性] / 350W[感性]，电磁锁属于感性负载，每路可接多个电磁锁
总负载	全接通时不超过4400W[阻性] / 700W[感性]
产品尺寸	宽：119.4mm；长：95.0mm；厚：65.2mm，便于集成到柜体内部
无线连接	WiFi 2.4GHz IEEE 802.11 b/g/n，直连路由器无需网关
控制协议	开放标准HTTP接口，任何编程语言均可对接
部署模式	支持私有化部署，可运行在纯局域网环境

2.2 核心命令表

根据产品手册，16路控制器支持以下核心命令

命令类型	JSON格式	功能说明
单路控制	`{"power1":1}`	第1路接通（1=通，0=断）
多路独立控制	`{"power1":1,"power3":1,"power5":0}`	同时控制多个不同状态的线路
全开全关	`{"batch":{"power":1}}`	所有线路同时接通/断开
选择性批量控制	`{"batch":{"relay":[1,3,5,7],"power":1}}`	指定线路批量接通/断开
先通后断	`{"point":{"relay":[1],"interval":500}}`	接通500ms后自动断开（电磁锁专用）
先断后通	`{"reset":{"relay":[1],"interval":3000}}`	断开3秒后自动接通

2.3 电磁锁控制的关键注意点

储物柜的电磁锁属于感性负载，且通常只需通电0.5-1秒即可开锁，长时间通电会导致线圈发热烧毁。该控制器提供先通后断（point）命令，可精准控制通电时间，完美解决这一问题。

三、硬件选型与接线方案

3.1 设备选型

储物柜规模	推荐方案	说明
12格以内	1台16路控制器	12路控制电磁锁，剩余4路备用或控制照明
24格	2台16路控制器	并联使用，通过HTTP接口统一控制
36格以上	3台或以上	支持同时向最多100台设备下发指令

3.2 接线示意图

┌─────────────────────────────────────────────────────────────┐
│                   16路智能通用控制器                         │
│  ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐        ┌──────┐       │
│  │OUT1  │ │OUT2  │ │OUT3  │ │OUT4  │ ...    │OUT16 │       │
│  └──┬───┘ └──┬───┘ └──┬───┘ └──┬───┘        └──┬───┘       │
│     │        │        │        │               │           │
│     ▼        ▼        ▼        ▼               ▼           │
│  电磁锁1   电磁锁2   电磁锁3   电磁锁4    ...   电磁锁16     │
│  (12V DC)  (12V DC)  (12V DC)  (12V DC)       (12V DC)     │
│                                                             │
│  电源输入:DC 12V2A                                         │
│  WiFi连接:2.4GHz                                           │
└─────────────────────────────────────────────────────────────┘
                                         │
                                         │ HTTP API
                                         ▼
                              ┌─────────────────────┐
                              │   开发者服务器       │
                              │   (小程序后端)       │
                              └─────────────────────┘

3.3 电磁锁接线注意事项

电源匹配：确保DC电源适配器（12V2A）功率足够，20路电磁锁同时工作时瞬时电流较大，预留余量
极性确认：电磁锁分正负极，接线时注意区分（通常红线为正极，黑线为负极）
并联限制：每路可并联2-3个电磁锁（视单个电磁锁电流而定），总电流不超过单路额定值

四、技术对接实施方案

4.1 整体架构

用户小程序 → 开发者服务器 → 芯步云端API → 16路控制器 → 电磁锁
                    ↑
                    │ 状态回调（可选）

4.2 获取API凭证

登录
进入「开发设置」获取AppId和AppSecret
在控制台添加设备，记录每个储物柜控制器的设备ID

4.3 签名算法

芯步API采用动态签名验证，计算公式为

sign = md5( md5(AppSecret) + ts )

其中ts为当前Unix时间戳（秒）。

4.4 代码集成示例

以下提供Python、Java、微信小程序三种语言的完整对接示例。

Python 实现

import hashlib
import time
import requests
import json
from typing import List, Dict, Optional

class LockerController:
    """自助储物柜16路控制器类"""
    
    def __init__(self, app_id: str, app_secret: str):
        self.app_id = app_id
        self.app_secret = app_secret
        self.api_base = "https://api.thingboot.com"
    
    def _generate_sign(self, ts: int) -> str:
        """生成API签名"""
        md5_secret = hashlib.md5(self.app_secret.encode()).hexdigest()
        return hashlib.md5((md5_secret + str(ts)).encode()).hexdigest()
    
    def _send_command(self, device_id: str, order: Dict) -> Optional[Dict]:
        """发送控制命令"""
        ts = int(time.time())
        sign = self._generate_sign(ts)
        url = f"{self.api_base}/{self.app_id}/device/control/?sign={sign}&ts={ts}"
        
        payload = {"device": device_id, "order": order}
        try:
            response = requests.post(url, json=payload, timeout=5)
            return response.json()
        except Exception as e:
            print(f"命令发送失败: {e}")
            return None
    
    # ========== 单门控制 ==========
    def open_door(self, device_id: str, door_number: int, hold_ms: int = 500):
        """
        开启指定柜门
        :param device_id: 控制器设备ID
        :param door_number: 门编号 (1-16)
        :param hold_ms: 电磁锁通电时间(毫秒)，默认500ms
        """
        command = {"point": {"relay": [door_number], "interval": hold_ms}}
        return self._send_command(device_id, command)
    
    # ========== 多门批量控制 ==========
    def open_doors(self, device_id: str, door_numbers: List[int], hold_ms: int = 500):
        """
        批量开启多个柜门
        :param device_id: 控制器设备ID
        :param door_numbers: 门编号列表
        :param hold_ms: 电磁锁通电时间(毫秒)
        """
        command = {"point": {"relay": door_numbers, "interval": hold_ms}}
        return self._send_command(device_id, command)
    
    # ========== 开关控制（非电磁锁场景） ==========
    def turn_on(self, device_id: str, relay_number: int):
        """接通指定线路（用于照明等持续供电设备）"""
        return self._send_command(device_id, {f"power{relay_number}": 1})
    
    def turn_off(self, device_id: str, relay_number: int):
        """断开指定线路"""
        return self._send_command(device_id, {f"power{relay_number}": 0})
    
    def turn_all_on(self, device_id: str):
        """全开所有线路"""
        return self._send_command(device_id, {"batch": {"power": 1}})
    
    def turn_all_off(self, device_id: str):
        """全关所有线路"""
        return self._send_command(device_id, {"batch": {"power": 0}})
    
    # ========== 综合控制（不同线路不同状态） ==========
    def multi_control(self, device_id: str, actions: Dict[int, int]):
        """
        同时控制多个线路的不同状态
        :param device_id: 控制器设备ID
        :param actions: 字典，key为线路号，value为状态(1=通/0=断)
        """
        order = {f"power{k}": v for k, v in actions.items()}
        return self._send_command(device_id, order)

# ========== 使用示例 ==========
if __name__ == "__main__":
    # 初始化（请替换为实际的AppId和AppSecret）
    locker = LockerController("YOUR_APP_ID", "YOUR_APP_SECRET")
    
    # 场景1:用户扫码开柜门（1号柜，通电500ms自动断开）
    locker.open_door("device_001", door_number=1, hold_ms=500)
    
    # 场景2:批量开门（用户租用多个柜子）
    locker.open_doors("device_001", door_numbers=[3, 5, 7], hold_ms=500)
    
    # 场景3:开启柜体照明灯（常亮）
    locker.turn_on("device_001", relay_number=16)
    
    # 场景4:取件完成后关闭所有设备
    locker.turn_all_off("device_001")

Java 实现

import okhttp3.*;
import java.security.MessageDigest;
import java.security.NoSuchAlgorithmException;

public class LockerController {
    private final String appId;
    private final String appSecret;
    private final OkHttpClient client;
    private static final String API_BASE = "https://api.thingboot.com";
    
    public LockerController(String appId, String appSecret) {
        this.appId = appId;
        this.appSecret = appSecret;
        this.client = new OkHttpClient();
    }
    
    private String md5(String input) {
        try {
            MessageDigest md = MessageDigest.getInstance("MD5");
            byte[] digest = md.digest(input.getBytes());
            StringBuilder sb = new StringBuilder();
            for (byte b : digest) {
                sb.append(String.format("x", b));
            }
            return sb.toString();
        } catch (NoSuchAlgorithmException e) {
            throw new RuntimeException(e);
        }
    }
    
    private String generateSign(long ts) {
        String md5Secret = md5(appSecret);
        return md5(md5Secret + ts);
    }
    
    private String sendCommand(String deviceId, String orderJson) throws IOException {
        long ts = System.currentTimeMillis() / 1000;
        String sign = generateSign(ts);
        String url = API_BASE + "/" + appId + "/device/control/?sign=" + sign + "&ts=" + ts;
        
        String bodyJson = "{\"device\":\"" + deviceId + "\",\"order\":" + orderJson + "}";
        RequestBody body = RequestBody.create(bodyJson, MediaType.parse("application/json"));
        
        Request request = new Request.Builder()
                .url(url)
                .post(body)
                .build();
        
        try (Response response = client.newCall(request).execute()) {
            return response.body() != null ? response.body().string() : null;
        }
    }
    
    // 开启单个柜门（通电500ms自动断开）
    public void openDoor(String deviceId, int doorNumber) throws IOException {
        String order = "{\"point\":{\"relay\":[" + doorNumber + "],\"interval\":500}}";
        sendCommand(deviceId, order);
    }
    
    // 开启照明
    public void turnOnLight(String deviceId, int relayNumber) throws IOException {
        sendCommand(deviceId, "{\"power" + relayNumber + "\":1}");
    }
    
    // 关闭照明
    public void turnOffLight(String deviceId, int relayNumber) throws IOException {
        sendCommand(deviceId, "{\"power" + relayNumber + "\":0}");
    }
}

微信小程序实现

4.5 后端服务（Flask示例，安全中转）

from flask import Flask, request, jsonify

app = Flask(__name__)

# 初始化控制器
locker = LockerController("YOUR_APP_ID", "YOUR_APP_SECRET")

@app.route('/api/locker/open', methods=['POST'])
def api_open_door():
    """小程序调用的开锁接口"""
    data = request.get_json()
    device_id = data.get('deviceId')
    door_number = data.get('doorNumber')
    
    if not device_id or not door_number:
        return jsonify({"code": 400, "message": "参数缺失"})
    
    # 调用16路控制器开锁
    result = locker.open_door(device_id, door_number, hold_ms=500)
    
    if result and result.get('code') == 200:
        return jsonify({"code": 200, "message": "开门成功"})
    else:
        return jsonify({"code": 500, "message": "开门失败"})

@app.route('/api/locker/batch-open', methods=['POST'])
def api_batch_open():
    """批量开门接口"""
    data = request.get_json()
    device_id = data.get('deviceId')
    door_numbers = data.get('doorNumbers', [])  # 列表，如 [1,3,5]
    
    if not device_id or not door_numbers:
        return jsonify({"code": 400, "message": "参数缺失"})
    
    result = locker.open_doors(device_id, door_numbers, hold_ms=500)
    
    if result and result.get('code') == 200:
        return jsonify({"code": 200, "message": "批量开门成功"})
    else:
        return jsonify({"code": 500, "message": "批量开门失败"})

if __name__ == '__main__':
    app.run(host='0.0.0.0', port=5000)

五、典型场景联动实现

5.1 用户扫码存包流程

用户扫码 → 小程序请求后端分配空柜 → 后端调用16路控制器开锁 → 电磁锁通电500ms → 柜门弹开 → 用户放入物品关门 → 系统记录柜号并返回取件码

5.2 照明与语音联动（扩展）

如果储物柜配有照明和语音提示设备，可利用控制器的剩余通道实现联动：

5.3 管理员批量操作

六、多设备扩展方案

当储物柜需求超过16路时，可以通过并联多台控制器实现扩展。芯步API支持一次向最多100台设备下发相同指令

设备ID格式：传入多个设备时，使用逗号分隔，如 "1878,1879,1880"

七、总结

优势	说明
16路高集成	单台设备即可控制标准12-16格储物柜，减少设备数量，简化布线
独立控制	每路均可通过HTTP接口远程独立控制，支持多路同时操作
电磁锁专用指令	`point`命令（先通后断）可精确控制通电时间，防止线圈烧毁
HTTP开放接口	任何编程语言均可对接，10分钟即可完成基础集成
私有化部署	支持纯局域网环境运行，数据安全可控
多设备扩展	单次API调用可控制最多100台设备，满足大规模储物柜需求
低成本高集成	体积小巧(119×95×65mm)，可直接嵌入柜体内部

八、注意事项

电磁锁通电时间：使用point命令设置通电时长，300-500ms，避免长时间通电导致线圈损坏
电源功率：多路电磁锁同时工作时峰值电流较大，电源适配器预留50%以上余量
WiFi信号：确保控制器安装位置WiFi信号良好（仅支持2.4G频段）
API签名：生产环境请一定要关闭调试模式，正确计算sign签名

通过以上方案，你可以快速将芯步16路智能通用控制器集成到自助储物柜软件项目中，实现稳定、高效的多通道独立控制。如有疑问，可联系芯步技术支持获取详细产品手册。

一、解决概述

二、核心技术能力分析

2.1 16路智能通用控制器特性

2.2 核心命令表

2.3 电磁锁控制的关键注意点

三、硬件选型与接线方案

3.1 设备选型

3.2 接线示意图

3.3 电磁锁接线注意事项

四、技术对接实施方案

4.1 整体架构

4.2 获取API凭证

4.3 签名算法

4.4 代码集成示例

Python 实现

Java 实现

微信小程序实现

4.5 后端服务（Flask示例，安全中转）

五、典型场景联动实现

5.1 用户扫码存包流程

5.2 照明与语音联动（扩展）

5.3 管理员批量操作

六、多设备扩展方案

七、总结

八、注意事项

控制器产品方案：

怎么在轰趴馆多功能包间控制中对接智能硬件来实现空调电源控制

怎样接入4路智能直流开关以实现多设备联动控制

怎么二次开发24 路智能分体远程控制设备联动模块以实现多达24路独立线路控制

怎么二次开发智能 24 路分体远程信号控制器来实现设备运行状态监控

怎么在店铺设备电源控制中集成智能硬件以实现8 路多通道独立控制

自助储物柜场景方案：

自助储物柜控制：如何把智能 24 路分体远程信号控制器集成到自己的项目中

如何在自助储物柜控制中接入智能设备来实现控制 8 路交直流输出

如何在自助储物柜控制中接入智能设备来实现远程控制8条线路通断

怎么在自助储物柜控制中对接智能硬件来实现设备回路状态查询

如何在自助储物柜控制中集成智能硬件以实现设备用电定时管控

16路用途方案：

如何二次开发智能 16 路远程通用控制器来实现远程控制16路线路

如何对接智能 16 路远程开关控制模块来实现16路设备集中控制

怎样在店铺招牌控制中接入智能设备来实现多达16路独立线路控制

怎样在自助洗车设备线路控制中集成智能设备以实现16路多通道独立控制

怎样在仓储照明控制中对接智能设备来实现16路多通道独立控制