店铺照明设备管理：怎样把双路智能墙壁控制开关对接到软件项目中_解决方案

CATALOG

一、概述

店铺照明管理是门店日常运营的重要环节，直接影响顾客购物体验和店铺能耗成本。传统照明开关需要店员手动操作，不仅效率低，还容易出现店铺打烊后忘记关灯的情况。芯步双路智能墙壁开关通过开放HTTP接口，可无缝接入您的店铺管理系统，实现2路照明回路的远程独立控制和智能化管理。

核心能力

2路独立分控：可分别控制主照明、橱窗灯、招牌灯、货架照明等
开放HTTP API：适用于任何支持HTTP请求的编程语言
超低延迟：命令下发到设备响应80-120ms
状态保持：支持锁定开关状态，防止误操作后自动恢复
即装即用：标准86底盒直接替换原有开关，无需破墙布线

店铺照明典型应用场景

场景	控制对象	实现的方式是
开店自动开灯	主照明+招牌灯	定时任务触发API
橱窗展示模式	橱窗灯独立控制	远程单路开关
闭店一键关灯	全部照明回路	批量控制命令
下班防误触	锁定关灯状态	状态保持功能

二、产品核心特性

2.1 双路智能墙壁开关规格

芯步提供两款2路智能墙壁开关，可根据店铺装修风格和需求选择

特性	智能墙壁开关2路(按键版)	智能触摸墙壁开关2路
产品型号	UNI-KG-2	UNI-KG-CM-2
操控方式	物理按键	触摸面板
外壳材质	防火V0级PC	钢化玻璃
控制路数	2路独立分控	2路独立分控
工作电压	100-240V AC	100-240V AC
额定电流	MAX 10A / 路	MAX 10A / 路
负载功率	300-1200W / 路	300-1200W / 路
待机功耗	0.4 - 1.3W	0.4 - 1.3W
无线连接	WiFi 2.4GHz	WiFi 2.4GHz
控制接口	HTTP API	HTTP API
私有化部署	支持	支持

⚠️ LED灯负载限制：如果用于LED或节能灯泡，单路负载应小于300W。

2.2 支持的命令类型

该设备支持以下核心命令

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

三、整体架构

3.1 系统架构图

┌─────────────────────────────────────────────────────────────────┐
│                    店铺管理系统 / 收银系统                        │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐               │
│  │  控制台     │  │  定时任务   │  │  能耗看板   │               │
│  └─────────────┘  └─────────────┘  └─────────────┘               │
└─────────────────────────────────────────────────────────────────┘
                              │
                              │ HTTP API调用（携带签名）
                              ▼
┌─────────────────────────────────────────────────────────────────┐
│                     芯步云平台 / 私有化服务器                  │
└─────────────────────────────────────────────────────────────────┘
                              │
                              │ WiFi 2.4GHz
          ┌───────────────────┼───────────────────┐
          │                   │                   │
          ▼                   ▼                   ▼
    ┌──────────┐       ┌──────────┐       ┌──────────┐
    │ 门店A    │       │ 门店B    │       │ 门店C    │
    │ 2路开关  │       │ 2路开关  │       │ 2路开关  │
    │ 路1=主灯 │       │ 路1=主灯 │       │ 路1=主灯 │
    │ 路2=橱窗 │       │ 路2=橱窗 │       │ 路2=橱窗 │
    └──────────┘       └──────────┘       └──────────┘

3.2 集成工作流程

业务触发：定时任务到达、管理员点击控制、或传感器联动
签名计算：生成MD5签名，发起一个HTTP请求
指令下发：向API发送POST请求
设备执行：智能开关执行通断控制（80-120ms响应）

四、API接口接入详解

4.1 接口地址与签名计算

芯步智能墙壁开关开放HTTP接口，适用于任何支持HTTP请求的编程语言。

请求地址

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

参数说明

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

签名计算公式

sign = md5( md5(AppSecret) + ts )

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

签名计算示例

4.2 核心命令详解

4.2.1 单路独立控制

4.2.2 双路同时控制

4.2.3 状态保持（锁定模式）

在闭店时锁定关灯状态，可防止店员或顾客误操作恢复照明，从而避免不必要的能耗。

示例：保持关闭，用户开灯5秒后自动恢复关闭

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_showcase_light(self, device_id):
        """开启橱窗灯（第2路）"""
        return self._send_command(device_id, {"power2": "1"})
    
    def turn_off_showcase_light(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_closed(self, device_id, light_num=1, revert_seconds=5):
        """锁定关闭状态（防止误开灯）"""
        cmd = f"power{light_num}"
        return self._send_command(device_id, {
            cmd: {"keep": "0", "revert": str(revert_seconds)}
        })
    
    def batch_all_off(self, device_ids):
        """批量关闭多个门店的照明"""
        devices_str = ",".join(device_ids)
        return self._send_command(devices_str, {"power1": "0", "power2": "0"})

# 使用示例
controller = StoreLightController("your_app_id", "your_app_secret")
device_id = "store_light_001"

# 开店:开启全部照明
controller.all_on(device_id)

# 闭店:关闭全部照明
controller.all_off(device_id)

# 下班后锁定关灯状态，防止误操作
controller.lock_closed(device_id, 1, 5)

JavaScript/Node.js

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 payload = { device: deviceId, order };
        const response = await axios.post(url, payload);
        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 lockClosed(deviceId, lightNum) {
        const cmd = `power${lightNum}`;
        return this.sendCommand(deviceId, { [cmd]: { keep: "0", revert: "5" } });
    }
}

// 使用示例
const controller = new StoreLightController("your_app_id", "your_app_secret");
await controller.allOn("store_light_001");

Shell（curl）- 快速测试

微信小程序代码

五、店铺场景实战

5.1 第一种场景：自动开店/闭店

需求：根据店铺营业时间自动开关照明。

实现的方式是：使用芯步平台内置的远程定时任务功能

任务名称	执行时间	命令	说明
开店开灯	每天 08:00	`{"power1":"1","power2":"1"}`	开启全部照明
闭店关灯	每天 22:00	`{"power1":"0","power2":"0"}`	关闭全部照明
橱窗延时	每天 23:00	`{"power2":"0"}`	单独关闭橱窗灯

代码实现

5.2 第二种场景：收银台集中控制

需求：店员通过收银系统触摸屏一键控制店内照明。

集成方式：收银系统添加控制按钮，调用HTTP API

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

需求：闭店后，如果有人误按开关，灯光会在几秒后自动恢复关闭状态。

实现的方式是：使用状态保持命令

5.4 场景四：橱窗灯独立展示模式

需求：夜间或非营业时段，单独点亮橱窗灯展示商品。

集成到手机APP/小程序

5.5 场景五：连锁品牌集中管理

需求：总部远程监控和管理所有门店的照明系统。

六、设备安装部署指南

6.1 安装要求

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

6.2 店铺安装注意事项

必须接入零线：智能开关需要零线供电，这是最常见的安装问题。如原开关只有火线，需请电工增加零线
LED负载限制：LED灯启动电流较大，单路总功率不超过300W
WiFi信号：金属底盒可能屏蔽信号，安装前测试信号强度
随附电容：LED灯闪烁时需并联产品附带的补偿电容

6.3 店铺部署

店铺类型	数量	控制对象
便利店/小超市	1-2台	主照明+招牌灯
服装店/专卖店	2-3台	主照明、橱窗、射灯
餐厅/咖啡厅	2-4台	就餐区、吧台、装饰灯

6.4 接线示意图

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

七、私有化部署方案

对于连锁品牌数据安全要求较高的场景，设备支持私有化局域网运行。

部署模式对比

特性	公有云模式	私有化模式
设备联网	WiFi连接互联网	连接企业内网WiFi
API地址	`api.thingboot.com`	自建服务器IP
数据流向	经过芯步云端	内网直连，数据不出企业
网络依赖	需要互联网	仅需内网
适用场景	快速接入、单店	连锁品牌、安全要求高

配置要点

设备支持配置5组WiFi网络，自动连接信号最强的网络
需自建HTTP服务，所有API调用在内网完成
支持自建消息服务器，接收设备状态回调

八、常见问题与排障

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

*响应速度说明：从命令下发到设备执行，响应时间约为80-120ms，响应非常快。*

九、总结

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

能力	实现的方式是
2路独立分控	`power1`/`power2`命令分别控制主照明和橱窗灯
远程开关管理	HTTP API随时随地控制
营业时间自动化	定时任务自动开关灯
收银系统集成	收银台一键控制
状态锁定	防误触状态保持功能
连锁店集中管理	批量控制命令

集成核心步骤

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

方案优势

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

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