店铺照明设备管理：如何把智能触摸墙壁开关3路接入到自己的项目中_解决方案

CATALOG

芯步的智能触摸墙壁开关3路通过标准HTTP接口开放控制能力，可在公网或纯局域网环境下使用。以下方案涵盖接口协议、签名算法、多语言代码示例，以及状态保持、延时通断等高级功能的调用方式。

一、背景与选型分析

在店铺照明智能化管理中，传统的布线改造工程量大、成本高。采用 “智能触摸墙壁开关3路” 可以完美解决存量店铺的智能化改造需求。

核心优势：该设备支持 “零火线” 供电（部分型号支持单火，需确认），可直接替换现有的86型墙壁开关，无需砸墙重新布线。
网络 connectivity：设备内置WiFi 2.4G模块，直连路由器，不需要额外购买网关，降低了项目成本和故障点。
开放性：芯步全系控制器均开放标准的HTTP API接口，无论是开发Web管理后台、微信小程序还是手机APP，都可以通过简单的POST请求控制设备。

二、准备工作：设备配网与凭证获取

在编写代码之前，需要确保设备联网并获取凭证。

注册与创建应用：在芯步官网注册开发者账号，登录控制台后创建一个项目。系统会生成唯一的 AppId 和 AppSecret（开发者密码）。
设备配网
- 使用官方提供的“物联网控制台”或“芯步小程序”。
- 将手机连接到店铺的2.4G WiFi网络。
- 长按开关3路的任意按键，直到指示灯进入快闪状态（配网模式）。
- 通过小程序将WiFi账号密码推送给设备。
获取设备ID：配网成功后，在控制台的后台可以看到在线的设备，记录下 Device ID（例如：820720）。

三、接口对接方案

该设备采用极简的HTTP指令设计，命令格式为 JSON。

1. 请求地址与鉴权

请求URL： http(s)://api.thingboot.com/{AppId}/device/control/
鉴权方式：动态签名（Sign）
参数说明
- ts：当前Unix时间戳（秒）。
- sign：签名值。计算公式为 MD5( MD5(AppSecret) . ts )。

签名生成伪代码：

2. 核心控制命令表

针对 UNI-KG-CM-3 型号，order 字段支持以下指令。该设备支持独立控制3路电路（可接三组灯或同时接照明与排风扇）。

功能描述	指令JSON (order)	适用场景
第一路开启	`{"power1": 1}`	打开店铺主照明
第二路关闭	`{"power2": 0}`	关闭橱窗射灯
第三路点动	`{"point3":"1000"}`	控制排风扇/门禁（1秒后自动断电）
全开/全关	`{"power1":1,"power2":1,"power3":1}`	营业开始/结束

3. 高级功能：状态保持（防误触）

在展厅或包间场景，为防止用户手动误关灯，可以启用 “保持开” 模式：即使用户在墙上手动关闭了开关，1秒后系统会自动强制打开。

指令示例：让第二路保持开启状态，用户手动关闭后的5秒自动恢复开。
{ "device": "820720", "order": { "power2": { "keep": "1", // 1=保持开，0=保持关 "revert": "5" // 秒数，如果keep为1，用户关掉后x秒自动开 } } } ```[citation:3][citation:10]

4. 高级功能：环境模式（延时通断）

如果店铺需要“渐亮”效果或“定时关灯”，可以使用 point 和 reset 指令：

先通后断 (point)：像门铃或排气扇那样，打开2秒后自动关闭。
{"order": {"point3": "2000"}} // 这里的单位是毫秒
先断后通 (reset)：重置设备或用于电机散热。
{"order": {"reset1": "3000"}} // 关闭3秒后再开启 ```[citation:9][citation:10]

四、代码实现示例

以下示例展示如何用代码控制店铺的设备。

示例：Python 脚本（适用于后端服务器）

import hashlib
import time
import requests
import json

# 配置信息 (从控制台获取)
APP_ID = "你的AppId"
APP_SECRET = "你的AppSecret"
DEVICE_ID = "设备ID(数字)"

# 1. 生成签名
def generate_sign(secret):
    ts = str(int(time.time()))
    # 第一步: md5(secret)
    md5_a = hashlib.md5(secret.encode()).hexdigest()
    # 第二步: md5(md5(secret) + ts)
    sign_str = md5_a + ts
    sign = hashlib.md5(sign_str.encode()).hexdigest()
    return ts, sign

# 2. 控制设备
def control_device(power1, power2, power3):
    ts, sign = generate_sign(APP_SECRET)
    url = f"http://api.thingboot.com/{APP_ID}/device/control/?sign={sign}&ts={ts}"
    
    payload = {
        "device": DEVICE_ID,
        "order": {
            "power1": power1,
            "power2": power2,
            "power3": power3
        }
    }
    
    response = requests.post(url, json=payload)
    print(f"响应状态: {response.status_code}")
    print(f"设备响应: {response.text}")

# 3. 业务逻辑:营业时间开启，非营业时间关闭
if __name__ == "__main__":
    current_hour = time.localtime().tm_hour
    if 9 <= current_hour < 22:  # 早上9点到晚上10点
        print("营业中，开启灯光...")
        control_device(1, 1, 1)
    else:
        print("打烊，关闭灯光...")
        control_device(0, 0, 0)

示例：微信小程序端控制（前端直连）

为了避免后端中转，也可以在小程序端直接调用接口，但 Signature 在后端生成以防止密钥泄露。