怎样在共享场所灯光管理中接入智能硬件以实现设备分组控制_解决方案

CATALOG

——基于芯步智能控制器的设备分组管理与实践

一、背景分析

1.1 业务场景

共享自习室、共享棋牌室、共享茶室、共享舞蹈室等共享服务场所中，灯光管理是运营的核心环节：

共享自习室：需要独立控制每个座位的照明灯，支持用户扫码开灯、按时计费
共享棋牌室：包间内有多路照明（主灯、氛围灯、卫生间灯），需按需控制
共享舞蹈室：不同舞蹈类型需切换不同灯光模式，预约时段自动开/关灯
共享会议室：按预订时间自动开启/关闭照明，同时控制投影幕、空调等设备

1.2 当前痛点

痛点	具体表现
布线成本高	每个座位/包间独立布线、独立开关，改造成本大
管理效率低	管理员需逐个开关灯，退场后常遗漏关灯造成能耗浪费
缺乏联动	灯光与预约系统、计费系统割裂，无法实现自动启停
扩展困难	新增座位时布线改造复杂，难以快速部署

1.3 核心需求

多路独立控制：单台设备可控制多个独立回路，每路照明可单独开关
分组管理：支持将同区域/同类型的设备归入同一分组，批量控制
预约自动联动：与预约/计费系统对接，订单生效时开灯，结束时自动关灯
灵活集成：通过标准化HTTP API接入现有管理平台
扩展性强：新增座位只需增加控制器路数或新增设备，软件配置即可

二、产品选型

2.1 核心产品：智能控制器[交流电压版]

芯步提供多路智能控制器，适用于共享场所灯光管理场景：

产品型号	控制路数	额定电流	适用场景
智能控制器4路	4路	10A/路	小型包间、4个以下独立座位区
智能控制器8路	8路	10A/路	中型自习室、8个独立座位、复杂包间
智能照明控制器12路	12路	-	大型场所、多区域控制

2.2 产品规格（以8路为例）

参数项	规格
产品型号	UNI-KZQ-AC-8
产品尺寸	125×90×40mm
控制路数	8路独立控制
工作电压	AC 85-265V（市电）
额定电流	MAX 10A/路
负载功率	单路MAX 2200W[阻性负载] / 350W[感性负载]
待机功耗	0.4（全断）-1（全通/无负载）W
无线连接	WiFi IEEE 802.11 b/g/n 2.4GHz
外壳材质	防火V0级PC

数据来源：

2.3 核心特性

特性	说明
8路独立控制	每路均可通过HTTP接口独立控制通断
开关量输入	8路开关量信号输入，可外接轻触开关实现本地控制
远程定时任务	支持设置定时开关灯，无需人工干预
自定义联动	可配置设备之间的联动逻辑
开放HTTP API	适用于Web、APP/小程序、SaaS/低代码平台

三、分组管理方案

3.1 为什么要分组

在共享场所中，往往需要批量控制多个设备：

自习室：关闭整个A区的所有座位灯
棋牌室：切换包间的“营业模式”（主灯+氛围灯全开）、“清洁模式”（仅开卫生灯）
舞蹈室：街舞模式下打开所有彩灯，瑜伽模式下调暗主灯

分组管理可以将多个设备/多个回路归为逻辑组，实现一键批量控制。

3.2 分组层次设计

┌─────────────────────────────────────────────────────────────┐
│                      共享场所管理平台                          │
├─────────────────────────────────────────────────────────────┤
│  场地分组（按物理区域）        功能分组（按业务场景）           │
│  ├── A区（8个座位）           ├── 营业模式（所有照明开）       │
│  ├── B区（6个座位）           ├── 清洁模式（仅基础照明）       │
│  └── 休息区                   └── 节能模式（间隔开灯）         │
├─────────────────────────────────────────────────────────────┤
│                     智能控制器群                              │
│  ┌──────────────┐  ┌──────────────┐  ┌──────────────┐       │
│  │ 控制器1（8路）│  │ 控制器2（8路）│  │ 控制器3（4路）│       │
│  │ 座位1-8照明  │  │ 座位9-16照明 │  │ 公共区域照明 │       │
│  └──────────────┘  └──────────────┘  └──────────────┘       │
└─────────────────────────────────────────────────────────────┘

3.3 分组API接口

芯步提供完整的设备分组管理接口。

3.3.1 创建设备分组

将设备加入到指定分组：

接口地址

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

请求参数

名称	类型	说明
device	string	设备ID，支持多个用逗号分隔，如`1001,1002`
group	string	分组ID（整数），为0时表示取消分组

请求示例

数据来源：

3.3.2 执行分组命令

控制分组执行动作（如批量关灯）：

接口地址

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

请求参数

名称	类型	说明
group	int	分组ID
order	json	命令内容，如`{"power1":0,"power2":0}`

请求示例（关闭分组内所有设备的第1路和第2路）：

返回结果

数据来源：

3.4 签名算法

所有API接口均需携带签名：

sign = md5(md5(AppSecret) + ts)

AppId：开发者应用ID，由芯步平台生成
AppSecret：开发者密钥
ts：当前Unix时间戳（秒）

签名计算流程

将AppSecret进行MD5加密
将加密结果与时间戳拼接
对拼接字符串再次进行MD5加密

四、集成代码示例

4.1 Python Flask完整示例

from flask import Flask, request, jsonify
import requests
import hashlib
import time
import json

app = Flask(__name__)

# ========== 配置参数 ==========
APP_ID = "your_app_id"           # 芯步平台分配
APP_SECRET = "your_app_secret"   # 平台分配密钥

# 设备配置:每个控制器管理多个座位
DEVICES = {
    "controller_1": "820720",     # 座位1-8
    "controller_2": "820721",     # 座位9-16
    "public_light": "820722"      # 公共区域照明
}

# 分组配置
GROUPS = {
    "zone_a": {"group_id": 101, "name": "A区", "devices": ["820720"]},
    "zone_b": {"group_id": 102, "name": "B区", "devices": ["820721"]},
    "all_seats": {"group_id": 103, "name": "全部座位", "devices": ["820720", "820721"]}
}

# 座位到控制器路数的映射
SEAT_MAPPING = {
    1: {"device": "controller_1", "channel": "power1"},
    2: {"device": "controller_1", "channel": "power2"},
    3: {"device": "controller_1", "channel": "power3"},
    4: {"device": "controller_1", "channel": "power4"},
    5: {"device": "controller_1", "channel": "power5"},
    6: {"device": "controller_1", "channel": "power6"},
    7: {"device": "controller_1", "channel": "power7"},
    8: {"device": "controller_1", "channel": "power8"},
    9: {"device": "controller_2", "channel": "power1"},
    # ... 更多座位
}

# ========== 签名生成 ==========
def generate_sign(ts):
    """生成API签名:md5(md5(AppSecret) + ts)"""
    first_md5 = hashlib.md5(APP_SECRET.encode()).hexdigest()
    combined = first_md5 + str(ts)
    return hashlib.md5(combined.encode()).hexdigest()

# ========== 设备控制函数 ==========
def control_device(device_id, commands):
    """控制单个设备的多路输出"""
    ts = int(time.time())
    sign = generate_sign(ts)
    
    control_url = f"https://api.thingboot.com/{APP_ID}/device/control/"
    payload = {
        "device": device_id,
        "order": commands
    }
    
    try:
        response = requests.post(
            control_url,
            params={"sign": sign, "ts": ts},
            json=payload,
            timeout=5
        )
        return {"success": response.status_code == 200, "data": response.json()}
    except Exception as e:
        return {"success": False, "error": str(e)}

def control_group(group_id, commands):
    """控制分组下的所有设备"""
    ts = int(time.time())
    sign = generate_sign(ts)
    
    control_url = f"https://api.thingboot.com/{APP_ID}/group/control/"
    payload = {
        "group": group_id,
        "order": commands
    }
    
    try:
        response = requests.post(
            control_url,
            params={"sign": sign, "ts": ts},
            json=payload,
            timeout=5
        )
        return {"success": response.status_code == 200, "data": response.json()}
    except Exception as e:
        return {"success": False, "error": str(e)}

# ========== 业务接口 ==========

@app.route('/api/seat/light', methods=['POST'])
def control_seat_light():
    """
    控制单个座位的照明灯
    请求体: {"seat_id": 1, "status": 1}  # 1开0关
    """
    data = request.json
    seat_id = data.get('seat_id')
    status = data.get('status')
    
    if seat_id not in SEAT_MAPPING:
        return jsonify({"error": f"Seat {seat_id} not found"}), 404
    
    mapping = SEAT_MAPPING[seat_id]
    device_id = DEVICES.get(mapping["device"])
    channel = mapping["channel"]
    
    commands = {channel: status}
    result = control_device(device_id, commands)
    
    # 记录操作日志
    log_action(seat_id, status)
    
    return jsonify(result)

@app.route('/api/zone/light', methods=['POST'])
def control_zone_light():
    """
    控制区域照明（批量关灯）
    请求体: {"zone": "zone_a", "status": 0}
    """
    data = request.json
    zone = data.get('zone')
    status = data.get('status')
    
    if zone not in GROUPS:
        return jsonify({"error": f"Zone {zone} not found"}), 404
    
    group_info = GROUPS[zone]
    
    # 方式1:使用分组API（推荐）
    # 假设分组已创建，group_id=group_info["group_id"]
    # 批量控制该分组下所有设备的第1-8路
    commands = {f"power{i}": status for i in range(1, 9)}
    result = control_group(group_info["group_id"], commands)
    
    return jsonify(result)

@app.route('/api/batch/off', methods=['POST'])
def batch_off_all():
    """一键关闭所有座位照明（打烊/清场）"""
    data = request.json
    zone = data.get('zone', 'all_seats')
    
    if zone not in GROUPS:
        return jsonify({"error": f"Zone {zone} not found"}), 404
    
    group_info = GROUPS[zone]
    commands = {f"power{i}": 0 for i in range(1, 9)}
    result = control_group(group_info["group_id"], commands)
    
    return jsonify(result)

def log_action(seat_id, status):
    """记录操作日志（用于计费/审计）"""
    print(f"[{time.strftime('%Y-%m-%d %H:%M:%S')}] 座位{seat_id} 灯光{'开启' if status else '关闭'}")

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

4.2 Node.js分组控制

4.3 小程序集成示例

// 微信小程序端
Page({
  data: {
    seatId: null,
    lightStatus: false
  },
  
  onLoad(options) {
    this.setData({ seatId: options.seatId });
    // 页面加载时获取灯光状态
    this.getLightStatus();
  },
  
  // 获取灯光状态
  getLightStatus() {
    wx.request({
      url: 'https://your-api.com/api/seat/status',
      method: 'GET',
      data: { seat_id: this.data.seatId },
      success: (res) => {
        this.setData({ lightStatus: res.data.status === 1 });
      }
    });
  },
  
  // 开灯（用户扫码/下单后触发）
  turnOnLight() {
    wx.request({
      url: 'https://your-api.com/api/seat/light',
      method: 'POST',
      data: {
        seat_id: this.data.seatId,
        status: 1
      },
      success: (res) => {
        if (res.data.success) {
          this.setData({ lightStatus: true });
          wx.showToast({ title: '开灯成功', icon: 'success' });
        }
      }
    });
  },
  
  // 关灯（用户结束时触发）
  turnOffLight() {
    wx.request({
      url: 'https://your-api.com/api/seat/light',
      method: 'POST',
      data: {
        seat_id: this.data.seatId,
        status: 0
      },
      success: (res) => {
        if (res.data.success) {
          this.setData({ lightStatus: false });
        }
      }
    });
  }
});

五、智能联动场景

5.1 第一种场景：用户扫码开灯 + 按时计费

业务需求：用户扫码下单，自动开灯并开始计费；订单结束自动关灯。

关键指标

从下单到开灯：< 2秒
订单超时自动关灯：可设置保底时间自动执行

5.2 第二种场景：区域批量控制

业务需求：管理员在后台一键关闭A区所有灯光。

实现的方式是

5.3 第三种场景：预约自动开灯

业务需求：用户预约座位后，系统在预约时间前5分钟自动开灯准备。

实现的方式是

5.4 场景四：人体感应联动（节能模式）

业务需求：公共区域检测到无人时自动关灯，有人时自动开灯。

搭配芯步智能人体存在传感器，可实现：

感应状态	联动动作	适用场景
检测到人进入	自动开灯	走廊、卫生间、公共休息区
长时间无人（≥15分钟）	自动关灯	非营业时段节能
检测到人静止	保持开灯	自习室（避免误关）

数据来源：

六、部署要点

6.1 硬件部署规划

场地规模	座位数	推荐设备	数量
小型自习室	≤8座	智能控制器8路	1台
中型自习室	9-24座	智能控制器8路	2-3台
大型自习室	25-48座	智能控制器8路	4-6台
棋牌室包间	每包间	智能包间控制器Max	1台/包间

6.2 布线要求

项目	要求
供电	控制器需接入AC 220V市电（火线+零线）
负载接线	每路输出接对应座位的照明灯零火线
本地开关（可选）	可外接轻触开关至开关量输入端

6.3 网络要求

项目	要求
WiFi信号	2.4GHz，信号强度≥-65dBm
带宽	单控制器带宽<1Mbps，多设备可共用AP
部署位置	控制器安装在配电箱或座位区附近

6.4 注意事项

负载限制：单路不得超过2200W[阻性负载]/350W[感性负载]，LED/节能灯为感性负载
总负载限制：全接通时总负载≤4400W[阻性负载]/700W[感性负载]
定时任务：设置保底关灯时间（如订单结束+5分钟自动关灯）
本地控制：如需保留物理开关，可外接轻触开关接入开关量输入端口

七、方案总结

基于芯步智能控制器的共享场所灯光分组控制方案，具有以下核心价值：

价值维度	实现效果
多路独立控制	4路/8路/12路可选，每路可独立控制座位照明
分组批量管理	通过分组API，一键控制整区/全场的灯光
开放集成	标准化HTTP API支持任何编程语言，10分钟完成对接
灵活部署	支持单设备配电箱安装，新增座位只需扩展路数
智能联动	与预约系统、计费系统、人体传感器深度联动
降本增效	减少人工巡检关灯工作量，降低30%以上能耗

技术要点回顾

硬件选型：4路/8路智能控制器覆盖不同规模需求
分组管理：通过/device/group维护分组，通过/group/control批量控制
开放API：标准化HTTP接口，兼容任何编程语言和平台
签名机制：MD5嵌套签名保障接口安全

技术支持：芯步免费提供全程技术指导——从选型、对接，到布线、安装、调试，可随时联系工程师获取支持。