共享茶室照明控制：怎么把12路远程灯光控制模块对接到项目中_解决方案

CATALOG

共享茶室的痛点在于“空间流动、用电浪费”——包厢有人时灯未开，无人时灯忘关。芯步的开放接口正好能解决这个问题：通过HTTP/MQTT对接12路继电器模块，将灯光控制嵌入现有的预约系统，实现“订单开始自动通电、订单结束自动断电”。以下是具体对接方案：

一、背景与需求分析

在共享茶室/棋牌室/会议室场景中，照明控制直接关联用户体验和运营成本。传统的“人力巡检关灯”或“普通定时开关”无法适应共享空间碎片化、无人值守的特点。

痛点：

能耗浪费： 顾客离开后忘记关灯，导致电费流失。
体验不佳： 顾客预订后进入包厢，需要摸黑找开关，或者发现灯坏了无法远程处理。
管理低效： 运营方无法远程获知包厢灯具是否损坏或当前开关状态。

方案目标：利用芯步开放的API接口，将12路远程灯光控制模块无缝接入现有的“共享茶室SaaS系统/小程序”，实现“订单驱动照明”的全自动化管理。

二、整体系统架构

本方案采用标准的物联网三层架构，确保数据实时性与系统稳定性。

设备层： 部署12路智能照明控制模块（继电器），连接茶室内的筒灯、射灯、主灯、灯带等回路。该模块通过4G/Wi-Fi/以太网连接至芯步云平台。
平台层： 芯步开放平台。负责设备连接、指令转发、设备状态上报。它是业务系统与硬件之间的桥梁。
应用层： 共享茶室SaaS后台/小程序。通过调用芯步的OpenAPI，下发控制指令，获取设备状态。

flowchart LR
    subgraph A[设备层]
        Module[12路灯光控制模块
（继电器/驱动）]
        Light[灯具回路 1-12]
    end

    subgraph B[平台层]
        Yoyo[芯步开放平台]
        API[OpenAPI / MQTT]
    end

    subgraph C[应用层]
        SaaS[共享茶室SaaS系统]
        MiniApp[用户小程序 / 商家后台]
    end

    MiniApp <--> SaaS
    SaaS <-->|HTTP/MQTT| API
    API <-->|4G/以太网| Module
    Module <--> Light

三、硬件选型与连接

在共享茶室的配电箱中，需要部署支持芯步协议的标准12路远程控制模块。

硬件参数：
- 回路数： 12路（适配茶室多个分区，如：主照明、茶台射灯、洗茶区灯带、卫生间灯等）。
- 负载能力： 选用16A/路，足以覆盖LED灯和常规筒灯。
- 通信方式： 根据现场网络环境，优先选择 RJ45网口 或 2.4G Wi-Fi，若无网络则选4G Cat.1版本。
- 核心功能： 支持断电记忆、支持继电器状态回读（确保下发命令后确实闭合）。
接线逻辑：
- 将茶室的零火线接入模块输入端，灯具线接入对应输出端。
- 特别注意： 茶室若有大量LED灯具，启动电流较大，需确认模块的抗浪涌能力，防止继电器黏连。

四、对接开发核心流程

这是方案的技术核心，主要分为“设备配网”、“指令下发”和“状态同步”三步。

1. 设备接入与唯一标识

在芯步控制台创建项目，添加设备。

获取三个关键参数：AppID、设备唯一ID（Device ID）、ApiKey（用于生成签名）。
在茶室SaaS系统中，将包厢ID与芯步的Device ID进行绑定。例如：包厢A_Device = 12345678。

2. 核心接口调用：向设备下发指令

根据芯步的接口文档，控制12路灯光主要使用“向设备下发指令”接口。

请求地址：http(s)://api.thingboot.com/{AppID}/device/control/?sign={sign}&ts={ts}
请求方式： POST / GET
关键参数解析：
- device：传入上面获取的设备ID。
- order：这是命令体，用于控制具体哪一路灯。

情景A：开启/关闭某一路灯假设我们要控制12路模块中的“第3路”开关。在order字段中，我们需要根据硬件的协议传入参数。通常基于标准Modbus或私有协议，例如：

或者是直接通过属性设置：

(实际参数需查阅对应12路模块在芯步平台上的“物模型”定义，通常定义为 ch1 到 ch12)

情景B：一键执行场景（全部开启/关闭）当茶室订单开始或结束时，需要批量控制所有灯光。

全开场景：{"order": {"channels": [1,2,3,4,5,6,7,8,9,10,11,12], "status": 1}}
全关场景：{"order": {"all": 0}}

3. MQTT 推送与状态同步

机制： 顾客在面板上手动按键，或者红外遥控操作后，12路模块的状态会发生变化。如果 SaaS 系统仅靠轮询，实时性差且浪费资源。
对接： 芯步平台支持 MQTT 推流。茶室 SaaS 服务器需订阅设备状态变更主题。
应用： 当商家后台界面实时显示“某包厢灯光已开”，或者用于防盗监控（非营业时间检测到灯光开启，系统自动告警）。

五、共享茶室业务逻辑设计

将硬件接口与业务流结合，实现真正的无人值守。

业务节点	执行主体	控制逻辑	12路模块执行动作
顾客预订成功	小程序SaaS	提前5分钟下发预开灯指令（可选）	开启第1路（主灯），营造欢迎氛围
扫码进门	IoT触发器	门磁检测开门 + SaaS调用开电	全开或开启欢迎场景（主灯+茶台射灯）
消费中/暂停	小程序	顾客点击“暂离”或“关灯”	关闭部分非关键照明（如射灯），保留基础照明
订单结束/超时	定时任务	订单状态变为已结束	全关（强制切断12路所有继电器）
保洁/清扫	商家APP	保洁员登录工单系统	仅开启保洁模式（开启第12路保洁专用灯）

六、关键注意事项

在实施该项目时，结合硬件特性和共享场景，需关注以下三点：

设备离线处理机制
- 共享茶室不能因为网络波动导致无法关灯。
- 策略： 硬件层面需具备断电记忆和本地定时策略功能。即，在12路模块内置逻辑：若断网，到达预设的订单结束时间（如22:00），自动执行全关指令，防止“长明灯”。
接口调用频率与并发
- 芯步接口对单设备下发指令有限频（通常是1-2次/秒）。
- 在SaaS层设置请求队列。例如顾客点击“全开”，系统应只发一条包含所有通道状态的JSON指令，而非循环发送12条单通道指令，避免触发限流。
状态一致性维护
- 问题： 网络抖动可能导致SaaS显示“开”，但设备实际“关”。
- 解法： 除了接收芯步平台的异步消息推送外，SaaS后台应增加一个“同步”按钮，调用设备详情接口或查询设备属性接口，主动拉取12路模块的最新真实状态。