怎么在便利店照明管理中对接智能硬件来实现触摸按键控制门禁/照明_解决方案

CATALOG

便利店夜间无人值守时，照明常亮浪费电、店员离店后无法远程关门是常见痛点。基于芯步的开放接口，可以用一套HTTP API将触控开关、门禁和照明联动起来——店员下班时一键“打烊”，自动关灯、锁门；夜间有人触发门铃，远程开灯并授权开门。以下是具体实现方案。

1. 背景与需求分析

在24小时便利店或无人值守场景中，照明和门禁是核心管理项。传统方案存在布线复杂、无法远程控制、缺少联动逻辑等问题。

基于芯步的开放硬件与HTTP接口，本方案的目标是解决以下 4个痛点

远程关门与状态确认：店员离店后忘记锁门，或需要远程为配送员开门。
人來灯亮，人走灯灭/低功耗：夜间降低能耗，仅在客户靠近或触发传感器时亮灯。
联动控制：开门瞬间自动打开照明，关门（且无人时）延迟关闭照明。
低成本改造：利用现有WiFi网络，避免复杂的强弱电布线与协议开发。

2. 系统设计

本方案采用云边协同的极简架构，以便利店现有的WiFi网络为传输基础，芯步云平台为中枢。

2.1 架构层级

感知/执行层（硬件） ：
- 智能触摸墙壁开关：控制便利店天花灯、货架射灯。
- 智能门禁控制器/出门开关：控制电磁锁（电插锁或磁力锁）的断电开锁。
- 智能人体传感器（可选）：检测店内是否有人，作为“离店关灯”的冗余逻辑。
网络传输层
- 2.4G WiFi：所有设备连接店内WiFi。
- HTTP/HTTPS协议：设备与芯步云通信。
平台控制层
- 芯步云：处理设备状态上报与指令下发。
- 本地局域网控制：芯步硬件支持局域网通信，即使外网断连，内网控制依然有效。
应用管理层
- 门店管理后台/手机小程序：管理员视角，查看门锁状态、控制照明。
- 触摸面板：店内物理交互。

2.2 硬件选型（基于芯步产品线）

设备类型	推荐产品	核心功能	接口支持
照明控制	智能触摸墙壁开关 (2路/3路)	控制2路照明电路通断，支持回弹保持（触摸感）。	HTTP API (控制power状态)
门禁控制	智能WiFi控制器 / 出门开关	输出常开/常闭信号，控制12V电磁锁。	HTTP API (reset指令，断开门锁通电)
感应辅助	智能WiFi人体感应传感器	检测空间内人员移动。	状态上报API

3. 场景联动逻辑与实现

3.1 第一种场景：照明与门禁的“闭店联动”

场景描述：店员整理完货架，准备离店。执行动作：店员点击手机APP中的“离店模式” -> 门锁上锁 -> 所有照明关闭 -> 传感器布防。

技术实现方案

接口调用：店员手机端向芯步云发起POST请求。
API示例
// 请求地址:POST https://api.thingboot.com/{AppId}/device/control/ { "device": ["门锁设备ID", "照明开关设备ID"], "order": { "power": 0 // 关闭照明 // 或者对于门锁，如果是常开型门锁控制继电器断电 } }
针对门禁的特殊控制（点动开门），使用 reset 命令
// 针对门锁:触发断电开门，维持3秒后自动恢复上电锁门 { "device": "door_lock_01", "order": { "reset": 3000 } }

3.2 第二种场景：触摸按键控制门禁（“内部一键开门”）

场景描述：店员在店内补货后需要出门扔垃圾，或者夜间顾客在门外，店员在收银台直接开门。痛点解决：无需走到门口按物理开关，利用现有的智能墙壁开关或单独的智能按键，通过逻辑映射控制门禁。

实现逻辑

硬件：在收银台处安装一个“智能触摸墙壁开关”（通常用于灯控，这里复用）。
配置：在芯步控制台中设置 “联动规则” 。
- 触发条件：开关按键被按下（设备上报 power 状态变化）。
- 执行动作：调用门禁控制器的 reset 接口（断电3秒）。
效果：店员拍一下收银台的开关，门锁断开3秒，推门即可出去。

API逻辑映射当系统收到开关面板的指令时，后端需要转发指令给门禁：

3.3 第三种场景：智能照明策略（人感+定时）

场景描述：深夜23：00至凌晨06：00，主照明关闭，仅保留收银台灯光。当人体传感器检测到顾客进店，自动开启货架照明，顾客离店2分钟后自动关闭。

技术实现路径

设备：智能WiFi墙壁开关 + WiFi人体传感器。
逻辑
- 平台检测到人体传感器状态变为“有人” -> 发送指令给墙壁开关（power：1）-> 灯亮。
- 平台检测到人体传感器状态变为“无人” -> 启动延迟定时器（120秒）-> 无再次触发 -> 发送指令关灯。

4. 技术细节：HTTP API对接指南

芯步的核心优势在于其开放且标准化的HTTP接口。所有硬件（无论是开关、门禁还是传感器）都通过统一的API进行控制。

4.1 鉴权与签名机制

为了保证安全性，每次API调用需携带签名。签名算法为sign = md5( md5(AppSecret) + ts )

AppSecret：开发者密钥。
ts：Unix时间戳（秒）。
开发者需在请求URL中带上 sign 和 ts。

4.2 核心指令集

功能场景	设备类型	指令 (order JSON)	说明
开灯/关灯	智能墙壁开关	`{"power1": 1}` (开) `{"power1": 0}` (关)	控制第一路照明
点动开门	门禁控制器	`{"reset": 3000}`	断开继电器3000毫秒，用于门禁电磁铁断电开门
保持开灯	墙壁开关	`{"power1":{"keep":"1","revert":"60"}}`	强制开灯，且60秒后自动恢复原状态（防止忘记关灯）
状态查询	所有设备	`GET /device/status/`	获取当前门锁开关状态、灯的开闭状态

4.3 代码示例：python实现关门+关灯

以下是一个简单的Python函数，供后台调用，实现“闭店”操作：

import requests
import hashlib
import time

class YoYoControl:
    def __init__(self, app_id, app_secret):
        self.app_id = app_id
        self.app_secret = app_secret
        self.base_url = f"https://api.thingboot.com/{app_id}/device/control/"
    
    def generate_sign(self):
        # 1. md5(AppSecret)
        step1 = hashlib.md5(self.app_secret.encode()).hexdigest()
        # 2. 拼接时间戳
        ts = str(int(time.time()))
        step2 = step1 + ts
        # 3. 再次md5
        sign = hashlib.md5(step2.encode()).hexdigest()
        return sign, ts

def close_store(self, light_device_id, door_device_id):
        """闭店:关灯 + 锁门"""
        sign, ts = self.generate_sign()
        url = f"{self.base_url}?sign={sign}&ts={ts}"
        
        # 注意:芯步支持一次请求控制多个设备
        # 但如果在同一个order里，通常针对同一类型。分批调用或使用device数组配合相同order。
        # 这里演示调用两次接口或发送复合指令（如果两个设备order不同）
        # 场景1:关灯
        payload_light = {
            "device": light_device_id,
            "order": {"power": 0}
        }
        # 场景2:关门（确保门锁闭合，即给继电器断电，如果门是开的，这里发0保持关闭）
        payload_door = {
            "device": door_device_id,
            "order": {"power": 0} 
        }
        requests.post(url, json=payload_light)
        requests.post(url, json=payload_door)
        return True

5. 实施部署指南

5.1 硬件安装要点

照明开关：芯步的智能触摸墙壁开关采用标准86底盒，可直接替换店内原有开关，无需重新凿墙。接线时请一定要确保零线接入（传统开关可能没零线，需确认）。
门禁布线
- 门禁控制器（智能WiFi控制器）安装在门框上方。
- 输出端接常开或常闭触点。对于电磁锁，通常断电开锁，因此使用继电器的常闭端。
- 电源适配器需足够功率（12V/2A以上）同时带动控制器和电磁锁。
配网：使用“芯步小程序”进行2.4G WiFi配网。请一定要确保便利店WiFi信号覆盖门口区域。

5.2 软件配置要点

注册开发者：在芯步官网注册账号，获取 AppID 和 AppSecret。
设备ID获取：配网成功后，在控制台“设备列表”中获取唯一的 device 编号。
场景联动
- 若不写代码，可使用芯步控制台自带的 “自动化场景” 功能（如有提供），或自行搭建简易的后端服务接收webhook。

6. 总结

改造成本低：相比于传统的KNX或RS485有线总线方案，本方案基于WiFi和HTTP，不需要网关转换协议，设备即插即用（只要接零火线）。
开发门槛低：即使是非嵌入式工程师，只要懂HTTP请求（如上述Python代码），10分钟内即可完成接口对接，实现远程控制和触摸联动。
维护方便：店员可通过手机小程序实时查看“门是否关好”、“灯是否还亮着”，解决了远程管理中的焦虑问题。
场景灵活：通过API的组合，可以将收银台的照明开关复用为门禁开关，也可以将人体传感器作为照明的触发器，实现门店的智能化、节能化管理。