怎样接入两路触摸控制开关以实现远程指令开关控制_解决方案

CATALOG

芯步的两路触摸开关通过标准化HTTP接口开放控制能力，开发者只需掌握签名计算和指令格式，即可在10-20分钟内完成远程控制功能的集成。以下方案涵盖核心接口、签名算法及典型场景代码实现。

1. 解决概述

芯步的智能触摸墙壁开关等产品，核心优势在于其全面开放的 HTTP API 接口。你可以绕过复杂的物联网协议，使用标准的 HTTP POST 请求，在任何支持网络的开发环境（如 Web、Python、Java、PHP、小程序等）中实现远程控制。

核心流程：

设备层： 智能两路触摸开关（如 UNI-xxx 系列）通过 WiFi 连接网络。
接口层： 芯步 API 网关（api.thingboot.com）负责鉴权与指令转发。
应用层： 你的业务系统发送包含控制指令的 HTTPS 请求。

2. 准备工作：账号与密钥

在开始编码前，需在芯步控制台完成以下配置：

注册/登录：访问芯步官网注册开发者账号。
获取凭证：进入“工作台” -> “物联网控制台” -> “开发设置”，获取 AppId（应用ID）和 AppSecret（开发者密码）。
获取设备ID：确保你手中的“两路触摸开关”已通电并配网成功，在控制台设备列表中找到该设备的 Device ID（如 820720）。

3. 核心接口与鉴权机制

芯步的接口采用动态签名验证，有效防止接口被伪造。每次请求都需要计算 sign。

请求地址： http(s)://api.thingboot.com/{AppId}/device/control/
请求方式： POST
Header ： Content-Type: application/json
URL参数
- ts：当前的 Unix 时间戳（秒），用于防重放攻击。
- sign：请求签名。

签名生成算法（关键步骤）：为了防止他人伪造请求，你需要按以下公式生成 sign

Sign = md5( md5(AppSecret) + ts )

注：+ 代表字符串拼接。

举例说明：假设 AppSecret = "abc123"，当前时间戳 ts = 1714212345。

先对 AppSecret 做一次 MD5：md5("abc123") = "e99a18c428cb38d5f22e03"。
将结果与 ts 拼接："e99a18c428cb38d5f22e03" + "1714212345" = "e99a18c428cb38d5f22e031714212345"。
对拼接后的字符串再次做 MD5：得到最终的 sign。

4. 远程控制指令集

针对芯步的两路触摸开关，接口中的 order 参数（JSON 格式）用于指定操作。主要支持以下三种控制模式

功能分类	指令Key	说明	传参示例 (order)
基础开关	`power1`	控制第1路（通常是左键/左灯）	`{"power1": 1}` (开启) / `{"power1": 0}` (关闭)
`power2`	控制第2路（通常是右键/右灯）	`{"power2": 1}` (开启) / `{"power2": 0}` (关闭)
定时（先断后通）	`reset1`	常用于门禁或排气扇：先断开，延时后自动接通。数值单位为毫秒(ms)	`{"reset1": 5000}` (断开，5秒后恢复)
`reset2`	针对第2路的先断后通	`{"reset2": 3000}` (断开，3秒后恢复)
点动（先通后断）	`point1`	常用于指示灯：先接通，延时后自动断开	`{"point1": 2000}` (接通，2秒后关闭)
`point2`	针对第2路的先通后断	`{"point2": 1000}` (接通，1秒后关闭)

5. 代码实现详解

以下以 Python 和 Bash (cURL) 为例，演示如何通过代码发送指令。

5.1 Python 实现示例

适用于后端服务、脚本或 Django/Flask 框架。

import requests
import hashlib
import time
import json

# 配置参数
AppId = "你的AppId"          # 替换为实际的 AppId
AppSecret = "你的AppSecret"  # 替换为实际的 AppSecret
DeviceId = "你的设备ID"      # 替换为实际的设备ID (例如 "820720")

def yoyo_control(device_id, order_cmd):
    """
    芯步设备控制通用函数
    :param device_id: 设备ID
    :param order_cmd: 控制命令字典, 例如 {"power1": 1}
    """
    # 1. 生成时间戳
    ts = str(int(time.time()))
    
    # 2. 生成签名
    step1 = hashlib.md5(AppSecret.encode()).hexdigest()
    step2 = step1 + ts
    sign = hashlib.md5(step2.encode()).hexdigest()
    
    # 3. 构造URL和Headers
    url = f"https://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}"
    headers = {"Content-Type": "application/json"}
    
    # 4. 构造Body
    payload = {
        "device": device_id,
        "order": order_cmd
    }
    
    # 5. 发送请求
    response = requests.post(url, headers=headers, data=json.dumps(payload))
    return response.json()

# --- 场景测试 ---

# 场景1: 远程完全开启两路灯光
print("1. 开启所有线路...")
res1 = yoyo_control(DeviceId, {"power1": 1, "power2": 1})
print(res1)

# 场景2: 远程关闭第2路
print("\n2. 关闭第2路...")
res2 = yoyo_control(DeviceId, {"power2": 0})
print(res2)

# 场景3: "下楼模式"——打开楼梯灯，5分钟后自动关闭 (防止忘记关灯)
print("\n3. 启动第1路点动模式(5秒测试)...")
res3 = yoyo_control(DeviceId, {"point1": 5000}) # 实际应用中5000代表5秒后关
print(res3)

5.2 Linux/Bash (cURL) 实现示例

适用于嵌入式设备或简单的 Shell 脚本调用。

6. 高级应用场景和需要注意的点

设备状态同步
- 芯步设备支持状态上报。你的服务器可以通过配置“消息推送”接收设备状态变更通知（例如用户手动按了开关，服务器会收到 HTTP 回调），从而保持应用界面与物理开关状态实时同步。
本地局域网控制（私有化部署）
- 如果你对延迟要求比较高（如工业控制）或处于无外网环境，芯步支持私有化部署。设备在局域网内可直接通过本地 IP 调用接口，无需经过云端。具体配置需参照设备手册开启局域网模式。
安全
- 请一定要在服务器端对 AppSecret 进行保护，不要将其写在前端（如微信小程序、H5页面）的代码中。
- 在后端服务器统一管理签名计算，前端通过调用你自己的 API 接口来间接控制设备。

7. 总结

通过芯步的开放接口接入两路触摸开关非常便捷，核心工作只需三步：

计算签名：遵循 md5(md5(AppSecret)+ts) 规则。
构造指令：利用 power1/power2 分别独立控制两路开关。
发送请求：调用统一 API 地址。

这种方案不仅支持基础的远程开/关，还利用 reset 和 point 指令实现了复杂的自动化定时控制，适用于智能家居、智慧办公、门禁联动等多种场景。