共享茶室门禁灯光控制：怎样将2路墙壁智能电源开关对接到项目中_解决方案

CATALOG

共享茶室的核心挑战在于“无人化”场景下的自动控制——用户下单后自动通电、计时结束前预警、超时自动断电。芯步2路智能墙壁开关的开放HTTP接口，恰好能解决这些痛点。以下方案涵盖硬件选型、API对接逻辑、业务时序和关键代码实现。

解决方案：共享茶室门禁与灯光联动控制

基于芯步2路智能墙壁开关的无人化改造

1. 背景与选型分析

在共享茶室/棋牌室场景中，最核心的需求是：用户下单后自动通电（灯亮、门锁开），用户离开或超时后自动断电。

选用芯步智能墙壁开关（2路）的核心优势在于：

直接替换：标准86型设计，无需重新布线，直接替换原有机械开关，最大程度降低施工改造成本。
强电直控：单路支持最高1200W负载，可直接控制灯光、茶桌插座，甚至可以通过控制门禁电源的通断来管理磁力锁/电插锁。
开放API：提供标准的HTTP接口，支持任何后端语言调用，便于无缝集成到现有的预约小程序或SaaS管理后台。

2. 硬件接线方案

在开始对接开发前，需确保物理接线满足业务逻辑。该开关共有2个独立通道，规划如下：

通道	连接设备	业务逻辑
L1 (第1路)	门禁专用电源 + 磁力锁/电插锁	总电闸控制：通过通断控制整扇门的开门与闭门。如需保持开门状态，可配合“状态保持”命令；
L2 (第2路)	室内主照明/氛围灯带	灯光控制：控制包间内的主要照明设备。
L (火线进)	总火线	开关供电及控制回路输入。
N (零线)	总零线	开关工作供电（智能开关需要零线支持，或者单火线供电，需核对具体型号）。

安全提示：若直接控制电插锁，将“出门开关”串联在L2线路中，以实现物理出门按钮功能，避免因服务器故障导致人员被困。

3. 接口对接核心逻辑

芯步的API采用 HTTP POST + MD5 双重签名机制。对接工作主要在后端完成。

3.1 签名与鉴权准备每次请求必须携带动态生成的签名。

AppId：开发者ID
AppSecret：开发者密码
Signmd5( md5(AppSecret) + ts )

3.2 关键命令表针对“2路开关”，接口 order 字段支持多种模式

业务场景	命令格式 (order)	适用场景
开门/开灯	`{"power1":1}` 或 `{"power2":1}`	用户下单成功，接通电路；
关门/关灯	`{"power1":0}` 或 `{"power2":0}`	订单结束，断开电路；
点动/复位	`{"point1":5000}`	高级功能：门禁常用。接通5秒后自动断开（适用于门禁电源触发开门，但需保护电机）；
状态保持	`{"reset1":0}`	强制断电复位；

4. 业务时序流程（从下单到离店）

为了实现极致的无人化体验，后台系统需要按以下逻辑进行调用：

Step 1: 用户下单成功

后台动作：调用控制接口。
API指令{"power1":1} (门禁通电，门吸合/门锁吸合)，{"power2":1} (照明开启)。
状态：茶室进入“已使用”状态。

Step 2: 用户自助进门

用户到达现场，按下/触摸墙壁开关的物理按键（或者通过小程序一键开门）。
注意：如果使用电插锁，通常默认通电上锁，断电开门。逻辑需根据实际锁类型调整（磁力锁通电吸合，电插锁通电锁死）。

Step 3: 计时结束提醒

后台动作：在订单结束前10分钟。
可选操作：通过语音播报设备（如有）发送提醒，或不做灯光操作（避免惊扰用户），仅发送提醒。

Step 4: 订单超时/离店

场景A（自动结算）：时间到，系统调用 {"power1":0} 和 {"power2":0}，全屋断电，门锁闭。
场景B（续费成功）：用户续费，系统重置计时器，保持 power 状态不变。

5. 核心代码实现示例 (Python/Node.js)

以下是基于芯步开放接口[ citation:3]调用 power1 控制门禁的核心逻辑。

Python (Flask/Django) 实现

import hashlib
import time
import requests

class ThingBootController:
    def __init__(self, app_id, app_secret):
        self.app_id = app_id
        self.app_secret = app_secret
        self.api_url = f"https://api.thingboot.com/{app_id}/device/control/"

def _generate_sign(self, ts):
        # 1. MD5加密AppSecret
        md5_first = hashlib.md5(self.app_secret.encode()).hexdigest()
        # 2. 拼接时间戳
        sign_str = md5_first + str(ts)
        # 3. 再次MD5
        final_sign = hashlib.md5(sign_str.encode()).hexdigest()
        return final_sign

def control_device(self, device_id, power_cmd):
        ts = int(time.time())
        sign = self._generate_sign(ts)
        
        # 请求参数
        params = {
            "sign": sign,
            "ts": ts
        }
        payload = {
            "device": device_id,   # 设备ID
            "order": power_cmd     # 例如 {"power1": 1}
        }
        
        response = requests.post(self.api_url, params=params, json=payload)
        return response.json()

# 使用实例
iot = ThingBootController("Your_AppID_123", "Your_AppSecret_456")

# 1. 用户下单成功，开门(路1) + 开灯(路2)
iot.control_device("设备序列号", {"power1": 1, "power2": 1})

# 2. 用户续费成功，不需要动作，只需延长本地计时

# 3. 用户离店/超时，开门(路1) + 关灯(路2)
iot.control_device("设备序列号", {"power1": 0, "power2": 0})

关键代码解析

签名算法严格遵循两次MD5：这是保证接口安全的关键，防止设备被恶意控制。
批量控制：芯步接口支持在一次请求中传递多个device，但在控制2路开关时，在order里同时写入power1和power2更高效。

6. 异常处理与优化

6.1 断网与本地保活

物理按键优先：确保用户即使断网也能通过物理按键开灯。智能开关支持断电记忆或状态保持功能。
局域网私有化：芯步支持私有化部署。如果茶室对稳定性要求比较高（如专线网络），可将API请求指向局域网内的本地服务器，即使外网断开，控制依然有效。

6.2 负载与安全

灯光控制：如果使用LED节能灯，单路负载控制在300W以内，否则容易出现鬼火或损坏继电器。
门禁联动：严禁直接将220V电锁接在开关上！请使用 “门禁专用电源” 作为中介。智能开关控制门禁电源的PUSH端或220V输入端，通过门禁电源转换为12V给锁供电。

6.3 用户体验优化

状态同步：因为墙壁开关可以被用户物理按下，后台需要轮询设备状态或订阅设备消息，以便实时同步“灯是否被用户手动关了”，避免用户关灯睡觉后系统误判为设备离线。

7. 总结

通过将芯步2路智能墙壁开关无缝对接到共享茶室SaaS系统中，可以低成本解决“远程开门、自动断电、照明控制”三大痛点。该方案利用标准的HTTP接口，开发者仅需几行代码即可完成硬件层与业务层的闭环。