CATALOG

小型商铺的照明控制看似简单,但主次灯分区、营业模式切换、远程管理等需求,用传统开关很难优雅满足。以下方案基于芯步开放接口,以两路照明独立控制为目标,从设备选型到接口对接给出完整路径。

解决方案:基于芯步开放接口的小型商铺两路照明智能控制方案

一、 背景与需求

在小型商铺(如便利店、奶茶店、服装店)环境中,通常将照明分为“基础照明”(如天花灯,负责整体亮度)和“重点/氛围照明”(如轨道灯、灯带,负责货架或橱窗展示)。传统机械开关方案不仅无法实现远程控制和定时管理,还容易因店员忘记关灯造成能源浪费。

本方案的目标是利用芯步开放的API接口,将商铺内的两路照明设备接入统一的智能管理系统,实现:

  1. 独立控制:可单独控制两路灯具的开关状态。

  2. 定时策略:如早8点开基础灯,晚6点开氛围灯,闭店自动全关。

  3. 远程运维:店主不在店内时,可通过APP或Web后台远程查看灯光状态并控制。

二、 硬件选型与连接拓扑

为了实现上述目标,需要选用支持芯步协议且具备多路独立输出能力的硬件。

1. 方案A:双路智能断路器/模块(推荐用于新装或配电箱改造)

  • 选型:选用芯步生态内的 2路智能照明控制模块

  • 接线方式

    • 输入端:接入220V市电。

    • 输出端继电器输出 1 串联至“基础照明”回路;继电器输出 2 串联至“氛围照明”回路

    • 优点:直接替换原配电箱内的空气开关或交流接触器,支持大功率负载,稳定性高。

2. 方案B:智能双路面板/墙壁开关(适用于改造,无需动线路)

  • 选型:选用支持芯步协议的双路(2 Gang)智能墙壁开关

  • 接线方式

    • L孔:接火线进线。

    • L1孔:接第一路照明灯的控制线。

    • L2孔:接第二路照明灯的控制线。

    • 优点:安装简单,零火线供电更稳定,直接替换原有开关即可。

3. 网络层

  • 网关:由于Zigbee或Wi-Fi设备需联网,需配置芯步智能网关(或支持该协议的通用网关),确保设备在线且能与云端API通信。

三、 核心功能实现:API对接与指令下发

芯步开放平台提供了标准的HTTP API接口,这是实现自动化控制的核心。开发者或系统集成商可以通过调用以下关键接口来实现控制逻辑

1. 关键接口说明

  • 接口地址http(s)://api.thingboot.com/{AppID}/device/control/

  • 请求方式:POST (推荐,特别是同时控制两路状态时)

  • 核心参数

    • device:目标设备的唯一ID(需提前通过设备列表接口获取)。

    • order:控制指令。

2. “两路独立控制” 指令构造实战假设我们有一个双路设备,其属性定义通常为 channel_1(回路1)和 channel_2(回路2)。

  • 第一种场景:只想打开第一路(例如:开启基础照明)

    说明:此时第二路状态保持不变。

  • 第二种场景:同时控制两路(例如:闭店全关)

  • 第三种场景:带特征信息的控制(例如:店员交接班时操作,用于记录审计)芯步接口支持在指令中携带 extra 字段,这非常适合商铺管理。

    接口返回:若返回 {"code":200} 仅代表指令下达成功,实际执行结果需通过异步消息推送获取

3. 自动化逻辑开发示例(伪代码逻辑)在芯步的SaaS后台或自建服务器中,可以设置如下定时任务:

  • 08:00 触发调用 control API,构造 {"channel_1": 1} 指令。目的:天亮开门,仅开启基础照明,节约能源。

  • 18:00 触发调用 control API,构造 {"channel_2": 1} 指令。目的:傍晚开启橱窗射灯或氛围灯带,吸引客流。

  • 23:00 触发调用 control API,构造 {"channel_1": 0, "channel_2": 0} 指令。目的:闭店全切,防止通宵亮灯。

四、 本地与场景联动(进阶体验)

除了API层面的开发,还可以利用芯步平台内部的“场景联动”功能,减少代码开发量:

  1. 人体感应联动

    • 条件:红外传感器检测到无人移动持续 30 分钟。

    • 动作:执行全关指令(两路皆闭)。

  2. 光照度调节(若选用调光模块)

    • 如果是带调光功能的两路模块(Dimmer),可以利用接口发送 "brightness": 80 指令,在傍晚时将氛围灯调至 60% 亮度,深夜调至 20% 亮度,营造舒适视觉。

五、 故障排查与维护

  1. 设备离线处理:利用芯步API中的 设备状态查询 接口,若检测到设备连续掉线,系统可自动发送告警给管理员,提醒检查网关电源或Wi-Fi信号

  2. 指令反馈确认:由于 code 200 仅代表平台接收成功,不代表设备执行成功。在关键业务(如闭店断电)中,订阅芯步的 消息推送 服务,获取设备的实际执行回执(如 report 属性),确保万无一失

  3. 负载合规性:特别注意,直接控制照明设备的继电器有容量限制(如单路电流不超过 5A-16A)。对于商铺内的大功率射灯阵列,通过模块控制交流接触器,再由接触器控制灯具,防止烧毁模块触点。

通过以上方案,芯步的开放接口将底层硬件与上层业务逻辑解耦,使得即使是缺乏深厚嵌入式开发背景的集成商,也能通过简单的HTTP请求,为小型商铺构建出专业、稳定、可审计的两路照明智能控制系统。