怎么在4路包间智能开关控制器MINI中对接智能设备来实现包间灯光亮度远程调节_解决方案

CATALOG

芯步的4路智能包间控制器Mini本身只支持开关控制（通/断），不具备直接输出PWM或0-10V调光信号的能力。要实现亮度远程调节，需要将控制器与可调光驱动电源（LED调光驱动器）配合使用——控制器负责供电通断，调光驱动负责亮度调节，两者通过HTTP接口统一控制。以下是完整方案：

1. 背景与需求分析

在棋牌室、茶室、影音房等共享包间场景中，用户对灯光氛围的需求日益提升——不仅仅是简单的开/关，更希望在观影、用餐、休息等不同时段调节灯光亮度。芯步4路智能包间控制器Mini（型号：UNI-KZQ-BJ-MINI）是一款成熟的包间电器控制设备，但其原生功能仅支持继电器通断控制，不具备直接输出PWM或0-10V调光信号的能力。

因此，本方案的核心思路是：将Mini控制器的开关控制能力与可调光驱动电源（LED调光驱动器）相结合，控制器负责供给/切断灯具电源，调光驱动负责执行亮度调节指令，两者在逻辑上联动，实现“开关+调光”一体化控制。

2. 系统架构与选型

2.1 整体架构图（文字描述）

┌─────────────────────────────────────────────────────────────┐
│                      控制端（用户侧）                         │
│  微信小程序 / 商户管理后台 / 平板中控 / 第三方SaaS平台          │
└───────────────────────────┬─────────────────────────────────┘
                            │ HTTPS / HTTP API
                            ▼
┌─────────────────────────────────────────────────────────────┐
│                   芯步云平台 / 私有化服务器                │
│              （提供开放HTTP API，设备管理、签名鉴权）           │
└───────────────────────────┬─────────────────────────────────┘
                            │ 局域网 WiFi / 云端下发
                            ▼
┌─────────────────────────────────────────────────────────────┐
│              4路智能包间控制器Mini（装在电箱内）               │
│  第1路（16A）─┬─► 控制 可调光驱动电源（LED调光器）──► LED灯具   │
│               │    （亮度调节通过调光器的独立协议/接口完成）      │
│  第2路（16A）─┴─► 控制 非调光设备（麻将机/换气扇/饮水机等）      │
│  第3路（10A）───► 电磁门锁                                     │
│  第4路（30A）───► 空调                                        │
└─────────────────────────────────────────────────────────────┘

2.2 调光方案对比与选型

由于Mini控制器无法直接输出调光信号，需要为LED灯具配备独立的可调光驱动电源，该驱动电源应具备远程控制接口（WiFi/蓝牙/Zigbee/RS485/0-10V等）。根据包间场景的普适性和成本考量，推荐以下两种方案：

方案	原理	优点	缺点	适用场景
方案A：WiFi智能调光模块串联	Mini控制器第1路常开，后端串联一个WiFi智能调光通断器，由调光模块直接控制亮度	改造简单，Mini开关保留总闸功能；支持无极调光、缓亮缓灭	电箱内需额外空间安装调光模块	新建项目，有预留安装空间
方案B：0-10V/PWM调光驱动+中控桥接	选用支持0-10V/PWM调光的LED驱动电源，通过有人值守的网关或中控（如树莓派/工业网关）发送调光指令	调光线性度最佳，无频闪，专业工程级	成本较高，需额外部署中控设备	高端影音包间、专业会议室

本方案以方案A（WiFi智能调光通断器）为核心展开，因其对接简单、成本可控、无需额外布线。

2.3 设备清单

设备名称	型号/规格	数量	备注
4路智能包间控制器Mini	UNI-KZQ-BJ-MINI（WiFi版）	1台/包间	主控，提供4路继电器输出
WiFi智能调光通断器	支持可控硅调光或PWM调光，WiFi+BLE双模	1个/可调光回路	串联在Mini第1路后端，执行亮度调节
LED可调光灯带/筒灯	支持可控硅调光或PWM调光	若干	灯具需与调光驱动匹配
非调光设备	麻将机、换气扇、饮水机、空调等	若干	分别接入Mini的第2/4路等
（可选）私有化服务器	本地PC/工控机	1台	对网络延迟敏感时可部署本地HTTP服务

3. 接口对接与实现步骤

3.1 前置准备：获取API凭证

登录芯步开发者控制台，获取AppID和AppSecret。
将Mini控制器通电并连接WiFi（仅支持2.4GHz网络），在控制台获取device（设备唯一ID）。
将WiFi智能调光通断器配网，记录其设备ID和调光API格式（厂商提供）。

3.2 签名算法（HTTP API鉴权）

芯步的开放接口采用双层MD5签名机制

ts = 当前Unix时间戳（秒）
step1 = md5(AppSecret)
step2 = md5(step1 + ts)
sign = step2

请求完整URL格式：

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

请求体（JSON）：

3.3 场景1：单独开灯（某包间用户进入）

目标：用户扫码后，系统自动打开照明，并恢复到上次调用的亮度。

步骤

业务系统（小程序/后台）调用芯步API，发送：
{"device":"包间Mini_ID", "order":{"power1":1}}
power1对应Mini第1路，开启后，后端串联的智能调光模块得电。
智能调光模块默认具备亮度记忆功能，通电后自动恢复断电前的亮度。
（进阶） 如果调光模块支持API，业务系统可单独向调光模块发送调光指令：
```
POST http://调光模块IP/set_brightness
{"brightness": 80}   // 0-100
```

3.4 场景2：远程调节亮度（用户/服务员操作）

目标：用户在手机端拖动亮度滑块，灯光实时响应。

方案实现

Mini控制器保持power1为开启状态（不切断前端供电）。
业务系统直接调用调光模块厂商的API（通常也是HTTP/本地UDP/MQTT），发送目标亮度值。例如涂鸦方案的调光通断器支持通过云云对接或局域网HTTP下发{"brightness":60}。
如果调光模块不支持云端API，可架设一台本地网关（树莓派），由业务系统通过网关转发指令。

3.5 场景3：关灯（同时断电，节能安全）

目标：用户离开现场时或定时结束，完全切断灯具电源（避免调光模块待机耗电）。

步骤：业务系统调用芯步API关闭第1路：

注意：调光模块失去电源后，下次开灯时会执行上电自检，可能会出现瞬间全亮再回到记忆亮度的情况，此为正常现象。若需“软开/软关”（无闪烁），则保持Mini第1路常开，仅通过调光模块的API进行开关和调光。

4. 接口调用代码示例（后端/Python）

以下示例展示如何通过芯步API控制Mini控制器第1路通断，从而间接控制照明回路。

import hashlib
import time
import requests
import json

# ========== 配置参数 ==========
APP_ID = "你的AppID"
APP_SECRET = "你的AppSecret"
DEVICE_ID = "包间Mini的设备ID"   # 从控制台获取

# ========== 生成签名 ==========
def generate_sign(secret, ts):
    step1 = hashlib.md5(secret.encode()).hexdigest()
    step2 = hashlib.md5((step1 + str(ts)).encode()).hexdigest()
    return step2

# ========== 控制Mini控制器 ==========
def control_mini(power1_state):   # power1_state: 1 开启, 0 关闭
    ts = int(time.time())
    sign = generate_sign(APP_SECRET, ts)
    url = f"https://api.thingboot.com/{APP_ID}/device/control/?sign={sign}&ts={ts}"
    
    payload = {
        "device": DEVICE_ID,
        "order": {"power1": power1_state}   # 第1路开关
    }
    
    response = requests.post(url, json=payload)
    return response.json()

# ========== 调用示例 ==========
if __name__ == "__main__":
    # 开灯:Mini第1路通电 -> 调光模块得电 -> 恢复上次亮度
    result_on = control_mini(1)
    print("开灯结果:", result_on)
    
    # 关灯:Mini第1路断电 -> 调光模块及灯具断电
    result_off = control_mini(0)
    print("关灯结果:", result_off)

调光指令示例（需根据实际调光模块厂商API调整）：

5. 局限性说明与优化

5.1 已知局限性

Mini控制器本身不支持亮度直接调节：其继电器输出仅为“通”或“断”，无法像专业的灯光调光模块（如泰思物联4路调光模块）那样输出0-10V或PWM信号。这是本方案采用“串联调光模块”的根本原因。
调光模块的API需要额外对接：芯步平台不控制调光模块，业务系统需要调用两套API（Mini API + 调光模块API）。
联动延迟：云云对接模式下，用户滑动亮度滑块可能产生100-300ms延迟，对延迟敏感的场景部署局域网本地网关。

5.2 优化

优化点	具体做法
统一控制入口	在业务系统后端封装“照明控制服务”，屏蔽底层Mini和调光模块的差异，前端只调用一个接口
降低延迟	在包间内布置一台本地网关（树莓派/工控机），通过局域网直接控制Mini设备和调光模块（芯步支持局域网API）
场景化联动	利用Mini自带的“自定义联动”功能，将空调、门锁、照明组合为一个场景码，用户扫码一键执行
语音控制	若调光模块支持主流IoT平台（如涂鸦、天猫精灵、小度），可对接语音音箱直接调光

6. 总结

基于芯步4路智能包间控制器Mini实现灯光亮度远程调节的核心是“控制权拆分”

功能	执行设备	控制方式
总闸供电/断电	Mini控制器第1路	芯步HTTP API（`power1`）
亮度调节（0-100%）	WiFi智能调光通断器	调光模块厂商API（`brightness`）
非调光设备开关	Mini控制器第2/3/4路	芯步HTTP API（`power2/3/4`）

该方案适用于已采购或计划采购芯步Mini控制器的商户，以最小的硬件改动（仅增加一个串联调光模块）实现包间灯光的“无级调光+远程控制”，大幅提升用户体验。如果预算充足且对调光品质有更高要求（如无频闪、色温可调），可选用0-10V/PWM专业调光驱动并配合本地中控网关。