便利店照明管理：如何把智能触摸墙壁开关2路接入到软件项目中_解决方案

CATALOG

一、概述

便利店照明管理是门店能耗控制的重要环节。传统照明开关需要人工到店操作，无法与营业时间、客流量、节能策略形成联动。芯步智能触摸墙壁开关2路通过开放HTTP接口，实现2路独立照明回路的远程控制与智能化管理，帮助便利店降低能耗、提升管理效率。

核心能力

2路独立分控：分别控制店内主照明、招牌灯、货架灯、冷藏柜照明等
开放HTTP API：任意编程语言均可接入
超低延迟：命令下发到设备响应80-120ms
多场景集成：Web后台、APP、小程序、SaaS平台均可对接
私有化部署：支持局域网直连，数据安全可控

便利店典型应用场景

场景	控制对象	自动化逻辑
营业时间照明	主照明+招牌灯	开店自动开灯，闭店自动关灯
分区节能	货架区/收银台	无人时段降低亮度或关闭
远程巡检	全部照明	管理员远程检查并控制照明状态
应急控制	全部照明	异常情况远程一键关灯

参考数据来源：

二、产品核心特性

2.1 技术规格

芯步智能触摸墙壁开关2路具备以下技术特性

特性	参数
产品型号	UNI-KG-CM-2
控制路数	2路独立分控
操控方式	触摸面板（钢化玻璃）
工作电压	100-240V AC（交流市电）
额定电流	MAX 10A / 路
负载功率	300-1200W / 路
待机功耗	0.4（全断）- 1.3（全通/无负载）W
安装方式	标准86型底盒直接替换原有开关
无线连接	WiFi 2.4GHz IEEE 802.11 b/g/n
外壳材质	钢化玻璃面板 + 防火V0级PC
控制接口	HTTP API
私有化部署	支持局域网直连

2.2 支持的命令类型

该设备支持以下核心命令，用于实现各种照明控制场景

命令类型	命令格式	说明	应用场景
单路开/关	`{"power1":"1"}` / `{"power1":"0"}`	控制第1路通断	日常开关灯
双路独立控制	`{"power1":"1","power2":"0"}`	同时控制2路	分区照明
状态保持	`{"power1":{"keep":"0","revert":"3"}}`	锁定状态，防止误操作	闭店后锁定关灯
先通后断	`{"point1":"3000"}`	接通后自动断开	临时照明/清场模式
先断后通	`{"reset1":"3000"}`	断开后自动接通	设备重启

三、软件集成架构

3.1 整体架构图

┌─────────────────────────────────────────────────────────────────┐
│                    便利店管理系统 / 总部SaaS平台                  │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐               │
│  │  管理后台   │  │  手机APP    │  │  小程序     │               │
│  └─────────────┘  └─────────────┘  └─────────────┘               │
└─────────────────────────────────────────────────────────────────┘
                              ▲
                              │ HTTP API调用（凭签名认证）
                              ▼
┌─────────────────────────────────────────────────────────────────┐
│                     芯步云平台 / 私有化服务器                  │
│                （接收命令，转发至对应设备）                        │
└─────────────────────────────────────────────────────────────────┘
                              ▲
                              │ WiFi 2.4GHz
          ┌───────────────────┼───────────────────┐
          │                   │                   │
          ▼                   ▼                   ▼
    ┌──────────┐       ┌──────────┐       ┌──────────┐
    │ 门店A    │       │ 门店B    │       │ 门店C    │
    │ 触摸开关 │       │ 触摸开关 │       │ 触摸开关 │
    │ 路1=主灯 │       │ 路1=主灯 │       │ 路1=主灯 │
    │ 路2=招牌 │       │ 路2=招牌 │       │ 路2=招牌 │
    └──────────┘       └──────────┘       └──────────┘

3.2 集成工作原理

设备开放HTTP接口，适用于任何支持HTTP请求的编程语言。接口简单、清晰、友好，仅需在接口携带签名以及设备ID，即可向设备下发命令。支持接入任何形式的软件项目：Web、APP/小程序、窗体软件以及SaaS/低代码等平台。

工作流程

管理后台触发照明控制指令
系统生成MD5签名，封装HTTP请求
请求发送至芯步云端或私有化服务器
平台将命令路由至对应门店的设备
智能开关执行通断控制（80-120ms响应）

四、API接口接入详解

4.1 接口地址与签名计算

请求地址

https://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}

参数说明

参数	说明	示例
{AppId}	应用ID（控制台获取）	`qtyVWcgeMq`
{ts}	当前Unix时间戳（秒）	`1747212640`
{sign}	签名（见下方计算公式）	`c484eb97...`

签名计算公式（两次MD5加密）

sign = md5( md5(AppSecret) + ts )

将开发者密码（AppSecret）进行一次MD5
将这个结果拼接上时间戳ts
对整个拼接后的字符串再做一次MD5

签名计算示例

4.2 核心命令示例

4.2.1 单路独立控制

参考数据来源：

4.2.2 双路同时控制

4.2.3 状态保持（锁定照明）

适用于闭店后锁定关灯状态，防止店员或顾客误操作：

参考数据来源：

4.2.4 先通后断（临时照明）

适用于清场、巡检等临时需要照明的场景：

*支持时间：1000/2000/3000/5000毫秒*

4.2.5 批量控制多设备（连锁店场景）

单次请求可同时控制多个门店的开关设备：

4.3 多语言代码示例

Python

import requests
import time
import hashlib

class StoreLightController:
    """便利店照明控制器"""
    
    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, ts):
        """生成签名:md5(md5(AppSecret) + ts)"""
        md5_secret = hashlib.md5(self.app_secret.encode()).hexdigest()
        sign_str = md5_secret + str(ts)
        return hashlib.md5(sign_str.encode()).hexdigest()
    
    def _send_command(self, device_id, order):
        """发送命令到设备"""
        ts = int(time.time())
        sign = self._generate_sign(ts)
        
        url = f"{self.base_url}?sign={sign}&ts={ts}"
        payload = {"device": device_id, "order": order}
        
        response = requests.post(url, json=payload)
        return response.json()
    
    def turn_on_main_light(self, device_id):
        """开启主照明（第1路）"""
        return self._send_command(device_id, {"power1": "1"})
    
    def turn_off_main_light(self, device_id):
        """关闭主照明"""
        return self._send_command(device_id, {"power1": "0"})
    
    def turn_on_signage(self, device_id):
        """开启招牌灯（第2路）"""
        return self._send_command(device_id, {"power2": "1"})
    
    def turn_off_signage(self, device_id):
        """关闭招牌灯"""
        return self._send_command(device_id, {"power2": "0"})
    
    def all_on(self, device_id):
        """开启全部照明"""
        return self._send_command(device_id, {"power1": "1", "power2": "1"})
    
    def all_off(self, device_id):
        """关闭全部照明"""
        return self._send_command(device_id, {"power1": "0", "power2": "0"})
    
    def temporary_light(self, device_id, light_num=1, duration_ms=3000):
        """临时照明（先通后断）"""
        cmd = f"point{light_num}"
        return self._send_command(device_id, {cmd: str(duration_ms)})
    
    def lock_state(self, device_id, light_num, keep_state, revert_seconds=5):
        """状态保持锁定"""
        cmd = f"power{light_num}"
        return self._send_command(device_id, {
            cmd: {"keep": keep_state, "revert": str(revert_seconds)}
        })

# 使用示例
if __name__ == "__main__":
    controller = StoreLightController("your_app_id", "your_app_secret")
    device_id = "store_light_001"
    
    # 开店:开启全部照明
    controller.all_on(device_id)
    
    # 闭店:关闭全部照明
    controller.all_off(device_id)
    
    # 清场模式:主灯临时亮3秒
    controller.temporary_light(device_id, 1, 3000)

Java

import okhttp3.*;
import java.security.MessageDigest;
import java.time.Instant;
import java.util.HashMap;
import java.util.Map;

public class StoreLightController {
    private final String appId;
    private final String appSecret;
    private final OkHttpClient client;
    private static final MediaType JSON = MediaType.parse("application/json; charset=utf-8");
    
    public StoreLightController(String appId, String appSecret) {
        this.appId = appId;
        this.appSecret = appSecret;
        this.client = new OkHttpClient();
    }
    
    private String md5(String input) {
        try {
            MessageDigest md = MessageDigest.getInstance("MD5");
            byte[] digest = md.digest(input.getBytes());
            StringBuilder sb = new StringBuilder();
            for (byte b : digest) {
                sb.append(String.format("x", b));
            }
            return sb.toString();
        } catch (Exception e) {
            throw new RuntimeException(e);
        }
    }
    
    private String generateSign(long ts) {
        String md5Secret = md5(appSecret);
        return md5(md5Secret + ts);
    }
    
    public String allOff(String deviceId) throws Exception {
        long ts = Instant.now().getEpochSecond();
        String sign = generateSign(ts);
        String url = String.format("https://api.thingboot.com/%s/device/control/?sign=%s&ts=%d", 
            appId, sign, ts);
        
        Map<String, String> order = new HashMap<>();
        order.put("power1", "0");
        order.put("power2", "0");
        
        Map<String, Object> payload = new HashMap<>();
        payload.put("device", deviceId);
        payload.put("order", order);
        
        String jsonPayload = new Gson().toJson(payload);
        RequestBody body = RequestBody.create(jsonPayload, JSON);
        Request request = new Request.Builder().url(url).post(body).build();
        
        Response response = client.newCall(request).execute();
        return response.body().string();
    }
}

JavaScript/Node.js（小程序/APP集成）

const crypto = require('crypto');
const axios = require('axios');

class StoreLightController {
    constructor(appId, appSecret) {
        this.appId = appId;
        this.appSecret = appSecret;
        this.baseUrl = `https://api.thingboot.com/${appId}/device/control/`;
    }
    
    _generateSign(ts) {
        const md5Secret = crypto.createHash('md5').update(this.appSecret).digest('hex');
        const signStr = md5Secret + ts;
        return crypto.createHash('md5').update(signStr).digest('hex');
    }
    
    async sendCommand(deviceId, order) {
        const ts = Math.floor(Date.now() / 1000);
        const sign = this._generateSign(ts);
        const url = `${this.baseUrl}?sign=${sign}&ts=${ts}`;
        
        const response = await axios.post(url, { device: deviceId, order });
        return response.data;
    }
    
    async allOn(deviceId) {
        return this.sendCommand(deviceId, { power1: "1", power2: "1" });
    }
    
    async allOff(deviceId) {
        return this.sendCommand(deviceId, { power1: "0", power2: "0" });
    }
    
    async turnOnLight1(deviceId) {
        return this.sendCommand(deviceId, { power1: "1" });
    }
    
    async turnOffLight1(deviceId) {
        return this.sendCommand(deviceId, { power1: "0" });
    }
}

Shell（curl）- 快速测试

五、便利店场景实战

5.1 第一种场景：营业时间远程管理

需求：连锁便利店总部需要对各门店的照明进行集中管理，根据营业时间统一控制。

设备配置：每门店1台2路触摸开关（主照明+招牌灯各接一路）

联动逻辑

5.2 第二种场景：分区独立控制

需求：货架区与收银区需要分路控制，收银台可根据客流情况独立开关照明。

设备配置：1台2路触摸开关（路1=货架区照明，路2=收银台照明）

5.3 第三种场景：闭店后的防误触锁定

需求：闭店后，如果有人误按开关，灯光将自动恢复关闭状态，确保节能。

设备配置：1台2路触摸开关

5.4 场景四：清场/巡检临时照明

需求：闭店后需要清场或临时巡检时，只点亮局部照明一段时间后自动关闭。

设备配置：1台2路触摸开关

5.5 场景五：小程序集成（店长远程控制）

需求：店长通过手机小程序远程控制门店照明状态。

小程序端代码示例

六、设备安装部署指南

6.1 安装要求

项目	要求
安装方式	标准86型底盒直接替换原有开关
接线要求	需接入零火线（智能开关需要零线供电）
负载要求	LED灯单路总功率 < 300W；白炽灯 < 1200W
网络要求	WiFi 2.4GHz信号覆盖良好
安装空间	底盒深度 ≥ 35mm

6.2 接线示意图

原开关接线（需电工确认）:
- 火线 L → 智能开关 L
- 零线 N → 智能开关 N（必须！）
- 主照明控制线 → 智能开关 L1
- 招牌灯控制线 → 智能开关 L2
- 地线 → 智能开关 E（保护地）

注意:如原开关只有火线和控制线（无零线），需请电工增加零线。

6.3 注意事项

必须接入零线：智能开关需要零线供电，这是最常见的安装问题
LED负载限制：LED灯启动电流较大，单路总功率不超过300W
WiFi信号：金属底盒可能屏蔽信号，测试后再固定
随附电容：LED灯闪烁时需并联产品附带的补偿电容
设备支持5组WiFi：可配置多个WiFi网络，优先连接信号最强的

七、常见问题与排障

问题	可能原因	解决方案
设备不在线	WiFi信号弱	检查2.4GHz WiFi覆盖，设备支持5组WiFi自动切换
开关无法控制灯	LED负载过低	并联产品附带的补偿电容
灯闪烁	负载功率不足	增加负载或并联电容
远程控制失败	签名错误/设备离线	检查AppSecret和时间戳，确认签名算法
手动触摸无反应	静电/硬件问题	断电重启开关
面板松动	底盒变形	更换标准86底盒

八、总结

本方案基于芯步智能触摸墙壁开关2路，实现了便利店照明的软件集成与智能管理

能力	实现的方式是
2路独立分控	`power1`/`power2`命令分别控制主照明和招牌灯
远程开关	HTTP API随时随地控制，延迟80-120ms
营业时间自动化	定时任务自动开关灯
管理系统集成	Web/APP/小程序均可对接
状态锁定	防误触状态保持功能
连锁店集中管理	批量控制命令，总部统一调度

集成核心步骤

获取AppID/AppSecret，实现MD5签名算法
开发HTTP调用模块，封装开关灯命令
根据营业需求，配置定时任务或集成到管理系统
物理安装设备，注意零线接入和负载配置

方案优势

✅ 接口统一：标准HTTP API，任意编程语言10分钟对接
✅ 安装简单：标准86底盒直接替换原有开关
✅ 部署灵活：支持公有云和私有化部署
✅ 功能丰富：支持状态保持、定时任务、批量控制
✅ 安全可靠：钢化玻璃面板+防火V0级PC外壳
✅ 响应迅速：80-120ms超低延迟

如需详细的产品手册和API文档，请访问查阅或联系技术支持团队获取。

一、概述

二、产品核心特性

2.1 技术规格

2.2 支持的命令类型

三、软件集成架构

3.1 整体架构图

3.2 集成工作原理

四、API接口接入详解

4.1 接口地址与签名计算

4.2 核心命令示例

4.2.1 单路独立控制

4.2.2 双路同时控制

4.2.3 状态保持（锁定照明）

4.2.4 先通后断（临时照明）

4.2.5 批量控制多设备（连锁店场景）

4.3 多语言代码示例

Python

Java

JavaScript/Node.js（小程序/APP集成）

Shell（curl）- 快速测试

五、便利店场景实战

5.1 第一种场景：营业时间远程管理

5.2 第二种场景：分区独立控制

5.3 第三种场景：闭店后的防误触锁定

5.4 场景四：清场/巡检临时照明

5.5 场景五：小程序集成（店长远程控制）

六、设备安装部署指南

6.1 安装要求

6.2 接线示意图

6.3 注意事项

七、常见问题与排障

八、总结

便利店场景方案：

便利店照明管理：如何将4路共享设备控制模块集成到软件项目中

便利店门禁管理：怎样把单路墙壁智能开关接入到自己的项目中

便利店照明管理：如何将1路智能墙壁开关集成到项目中

便利店收银台语音提示场景：如何把60W 远程 TTS 语音音柱对接到自己的项目中

便利店收银机电源管理：怎么将40A带计量数显智能空开集成到软件项目中

开关用途方案：

出租屋照明控制：如何把3路远程独立控制开关集成到自己的项目中

舞蹈室门禁照明管理：怎么把门禁照明一体开关集成到自己的项目中

怎么在办公室门禁系统控制中集成智能硬件以实现开门状态反馈控制

共享棋牌室设备控制：怎么将3路墙壁智能多回路控制开关集成到项目中

怎么在网咖电竞包间管理中对接智能设备以实现多包间批量开关控制