CATALOG

无人值守场景下,照明控制的关键在于“有人自动开、无人延时关”,同时要保证断网时本地仍可操作。以下方案基于芯步3路智能墙壁开关的HTTP接口,说明如何将其快速接入自有系统。

1. 背景与选型

在无人值守门店(如共享自习室、24小时健身房、自动售货店铺等)的运营中,照明控制是实现节能和智能化体验的关键环节。传统的照明方案无法根据人员状态远程控制或联动控制,往往造成长明灯,浪费电力。

本方案基于芯步智能墙壁触摸开关(3路) 的开放API接口,将其快速对接到您现有的项目中(如小程序管理后台、Web控制台或自动化运维脚本)。

产品核心优势

  • 无需网关:设备直连WiFi 2.4G网络,减少硬件成本和故障点

  • 接口开放:提供标准HTTP API,支持任何编程语言调用(Python, Java, PHP, Go等)

  • 控制精度:支持3路独立控制(适用于门店主照明、橱窗射灯、灯箱招牌的分路管理)。

  • 灵活部署:标准86盒设计,可直接替换现有墙壁开关,零改造接入

2. 对接设计

整个集成方案采用云端API下发的模式。架构图逻辑如下:

  • 设备层:3路智能墙壁开关(执行端) + 可选配的传感器(如人体存在传感器,用于有人/无人检测)。

  • 网络层:设备通过WiFi连接至芯步云平台。

  • 业务层:您的自有服务器(云端或局域网私有化服务器)。

  • 控制端:门店管理后台、员工APP/小程序或自动化脚本。

交互流程

  1. 状态上报:设备状态实时同步至芯步云。

  2. 指令下发:您的业务系统调用芯步的HTTP接口,向指定设备ID发送开/关指令。

  3. 本地执行:开关接收指令,物理控制电路通断。

3. 对接详细步骤:从配网到第一行代码

3.1 准备工作:获取设备凭证

在开始编码前,需要获取两个关键凭证:

  1. AppID:在[芯步控制台]注册并创建工作台后生成

  2. 设备ID (Device ID):贴在设备外壳上,或在控制台的设备列表中查看。例如:1234567

  3. API密钥 (AccessKey/SecretKey):用于生成接口签名(Sign)。

3.2 设备配网

由于是无人值守门店,在部署前通过手机小程序完成配网:

  1. 手机小程序配网:登录“芯步小程序” -> 选择工作台 -> 添加现场WiFi(必须是2.4G频段)。

  2. 设备激活:长按开关配网键,指示灯闪烁后,手机热点将配置消息的推送给设备

  3. 验证:在控制台设备列表中确认设备状态显示为“在线”。

3.3 接口调试:控制3路灯光的核心逻辑

芯步的接口设计非常直观:向指定设备发送JSON命令

  • 请求地址https://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={timestamp}

  • 请求方式:POST (Content-Type: application/json)

针对3路智能墙壁开关,其order参数映射如下(截面基于1路和2路文档逻辑推导,3路通常扩展为power3):

功能描述JSON 命令示例说明
开启第1路 (主灯){"device":"设备ID","order":{"power1":1}}power1对应开关背后的第一根负载线
关闭第2路 (射灯){"device":"设备ID","order":{"power2":0}}power2对应第二路
开启第3路 (灯箱){"device":"设备ID","order":{"power3":1}}power3对应第三路
一键全开{"device":"设备ID","order":{"power1":1,"power2":1,"power3":1}}同时控制多路
延时关闭 (先通后断){"device":"设备ID","order":{"point1":"3000"}}第1路开启3秒后自动关闭,适用于门禁联动照明

3.4 代码实现示例

以下伪代码演示了如何在您的项目中封装控制函数(基于HTTP协议):

4. 无人值守场景的自动化策略

仅仅实现远程控制还不够,无人值守的核心是自动化。您可以结合传感器或计时器逻辑:

4.1 人体存在联动(节能方案)

在门店内安装“芯步智能人体存在传感器”。

  • 逻辑:传感器探测到“有人” -> 您的服务器接收传感器上报 -> 调用接口 power1=1 (亮灯)。

  • 逻辑:传感器持续上报“无人”超过10分钟 -> 您的服务器调用接口 power1=0,2,3=0 (全关)。

  • 依据:传感器具备实时状态上报功能,适合服务端联动

4.2 营业时间定时任务(基础方案)

如果您的项目不包含传感器,可以通过您的服务器设置Cron定时任务:

  • 20:00 (夜间):调用接口开启招牌灯(第3路)。

  • 23:00 (打烊):调用接口关闭所有灯光。

4.3 门磁/收银联动

  • 进门开灯:用户扫码开门成功 -> 您的业务系统 -> 调用接口开灯。

  • 离开现场时关灯:最后一位会员离开现场时 -> 调用接口关灯。

5. 高级特性:防止误操作与状态保持

在无人场景中,如果顾客手动按下了开关,可能会打乱自动计划。芯步接口提供了状态保持(锁定) 功能:

  • 应用场景:设备维护模式,或防止顾客随手关闭必要的安全照明。

  • 指令示例{"order":{"power1":{"keep":"1","revert":"5"}}}

    • 参数解析:强制锁定第1路为开启状态(keep:1),即使用户手动关闭开关,系统也会在5秒后自动将其重新打开

    • 这一特性在实际部署中非常实用,比如在自习室的“无人区”需要强制保持通风或基础照明。

6. 私有化部署与网络稳定性

无人值守门店对网络稳定性要求比较高,一旦断网,远程控制失效将严重影响体验。

  • 局域网控制:芯步支持私有化部署。如果您的服务器部署在门店本地,设备与服务器都连接在同一路由器下,即使外网断开,依然可以通过局域网IP进行控制

  • 断网本地执行:即便完全无网络,用户依然可以通过物理触摸按键正常开关灯,确保基础功能不受损

7. 总结

通过对接芯步3路智能墙壁开关,您可以以极低的开发成本(仅需调用HTTP API)实现专业级的门店照明物联网改造。这种方案不仅能快速响应您的业务需求——从简单的定时开关到复杂的人来灯亮、人走灯灭,还能通过其灵活的私有化部署选项,确保数据安全与系统的自主可控。