怎么接入单路触摸出门开关来实现自定义联动逻辑控制_解决方案

CATALOG

一、产品概述与适用场景

芯步智能触摸墙壁出门开关（单路）是一款基于WiFi通信的智能控制设备，支持标准86型底盒安装，可直接替换传统出门开关。该设备开放完整的HTTP API接口，支持公网、局域网及私有化部署，可无缝集成到各类软件系统中。

典型应用场景

办公室/会议室一键离开现场时控制：按下出门开关，自动关闭所有灯光、空调、投影仪
智能家居离家模式：触发出门开关，联动关闭家电、启动安防系统
无人值守场所：通过出门开关触发门禁系统、监控设备的联动响应

二、硬件准备与基础配置

2.1 设备清单

设备	说明
智能触摸墙壁出门开关（单路）	核心设备，型号：UNI-KG-CM-C
2.4GHz WiFi网络	设备仅支持2.4G频段
电源（AC 220V）	标准家用电源

2.2 平台账号注册与工作台创建

注册账号：访问芯步官网（）完成注册
创建工作台：登录后进入工作台页面（），点击“创建新的工作台”
进入物联网控制台：在工作台中找到并进入“物联网控制台”模块

2.3 设备配网与ID获取

按照产品手册指引将设备接入2.4G WiFi网络
设备成功联网后，在控制台设备列表页面查看并记录设备唯一ID（Device ID）
设备支持设定最多5组WiFi网络，将优先连接信号最强的网络

三、API接口规范详解

3.1 接口基础信息

项目	说明
请求地址	`https://api.thingboot.com/{AppID}/device/control/?sign={sign}&ts={ts}`
请求方式	POST
数据格式	JSON
Content-Type	`application/json`

3.2 认证参数获取

在物联网控制台的“开发设置”中获取以下凭证

参数	说明
AppID	应用唯一标识，用于标识调用者身份
AppSecret	开发者密码，用于签名计算，请妥善保管

3.3 签名算法（重要）

签名生成流程必须严格遵循以下步骤，否则将导致鉴权失败：

Step 1：对 AppSecret 进行第一次MD5加密

Step 2：将加密结果与当前Unix时间戳（秒）拼接

Step 3：对拼接字符串进行第二次MD5加密

示例代码（Shell）

3.4 请求参数说明

参数	类型	必填	说明
device	string	是	设备唯一ID，支持多个设备用英文逗号分隔
order	json	是	下发给设备的命令，具体格式见下节

四、单路触摸出门开关命令集

根据芯步官方产品手册，单路触摸出门开关支持以下命令

4.1 基础开关控制

命令格式	功能说明	示例
`{"power1":1}`	接通线路（开）	触发开门/通电动作
`{"power1":0}`	断开线路（关）	关闭输出

4.2 高级联动命令

命令格式	功能说明	典型应用
`{"power1":{"keep":"1","revert":"3"}}`	状态保持开后恢复：用户手动关闭后，3秒后自动重新打开	防误触、自动复位
`{"power1":{"keep":"0","revert":"3"}}`	状态保持关后恢复：用户手动开启后，3秒后自动关闭	脉冲触发、临时授权
`{"point1":"3000"}`	先通后断：立即接通，3000ms后自动断开	门禁控制（开锁后自动锁闭）
`{"reset1":"3000"}`	先断后通：立即断开，3000ms后自动接通	设备重启、系统复位

4.3 命令参数取值范围

参数	可选值	说明
revert（恢复时间）	1000~30000（单位：ms）	状态保持时长
point1/reset1	1000, 3000, 5000（单位：ms）	通断延时周期

五、联动逻辑实现方案

5.1 整体设计

5.2 方案一：服务器端主动轮询（推荐简单场景）

适用于联动设备较少、实时性要求不高的场景。

实现步骤

设置定时任务（如每1秒轮询一次）
通过芯步API获取设备状态
检测到出门开关状态变化时，执行预定义联动逻辑

核心代码（Python示例）

import hashlib
import time
import requests

class YoyoSwitchController:
    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_once = hashlib.md5(self.app_secret.encode()).hexdigest()
        sign_str = md5_once + str(ts)
        return hashlib.md5(sign_str.encode()).hexdigest()
    
    def get_device_status(self, device_id):
        """获取设备状态（需根据实际API调整）"""
        # 此处需调用设备状态查询接口
        pass
    
    def control_device(self, device_id, command):
        """向设备下发控制命令"""
        ts = int(time.time())
        sign = self._generate_sign(ts)
        url = f"{self.base_url}?sign={sign}&ts={ts}"
        
        payload = {
            "device": device_id,
            "order": command
        }
        
        response = requests.post(url, json=payload)
        return response.json()
    
    def execute_departure_sequence(self, exit_switch_id, target_devices):
        """执行离开现场时联动序列"""
        # 检测出门开关是否被按下
        # status = self.get_device_status(exit_switch_id)
        # if status.pressed:
        for device_id, command in target_devices.items():
            self.control_device(device_id, command)
            time.sleep(0.5)  # 避免请求过于密集

# 使用示例
controller = YoyoSwitchController("your_app_id", "your_app_secret")

# 定义联动设备及对应的关闭命令
targets = {
    "light_1_id": {"power1": 0},      # 关闭灯光1路
    "light_2_id": {"power2": 0},      # 关闭灯光2路
    "socket_id": {"power1": 0}        # 关闭插座
}

# 执行离开现场时联动
controller.execute_departure_sequence("exit_switch_id", targets)

5.3 方案二：消息推送联动（推荐企业级场景）

适用于实时性要求高、设备数量多的复杂场景。设备状态变化时，云平台主动推送消息至你的服务器。

配置步骤

配置推送服务器：在物联网控制台中设置你的服务器接收地址（Webhook URL）
接收状态变更消息：出门开关被按下时，芯步云平台推送JSON格式的状态数据
解析消息并执行联动：服务器接收消息后解析设备ID，触发对应联动逻辑

推送消息格式示例

联动逻辑处理

5.4 方案三：设备间直接联动（局域网模式）

适用于无需云端参与、低延迟、内网环境的场景。

芯步设备支持局域网模式和私有化部署，可在纯局域网环境下运行。设备间通过局域网API直接通信，无需经过公网云平台。

实现要点

确保所有联动设备连接同一局域网
使用内网API地址替代公网地址
可实现毫秒级响应速度

六、典型联动场景配置指南

第一种场景：一键离开现场时（办公室/会议室）

需求：按下出门开关后，自动关闭所有电器并启动安防。

配置

触发设备	触发条件	联动动作	命令
出门开关	按下（power1=1）	关闭主照明	`{"power1":0}`
出门开关	按下	关闭空调插座	`{"power1":0}`
出门开关	按下	启动安防传感器	`{"radar_enable":1}`
出门开关	按下	发送通知	HTTP调用企业微信/钉钉API

第二种场景：门禁控制（延时自动复位）

需求：按下出门开关后，门锁开启5秒，随后自动锁闭。

配置

使用 point1 命令实现“先通后断”，无需服务器参与即可完成脉冲控制。

第三种场景：设备重启（先断后通）

需求：按下出门开关，设备断电重启。

配置

七、常见问题与调试

7.1 签名校验失败

确认时间戳 ts 为秒级（10位），非毫秒级
确认MD5结果为32位小写格式
检查拼接顺序：先MD5(AppSecret)，再拼接ts，最后整体MD5

7.2 设备命令无响应

确认设备已成功连接2.4G WiFi
检查设备ID是否正确（在控制台确认）
使用控制台“调试”功能直接下发命令测试

7.3 局域网模式下无法访问

确认设备和服务器在同一网段
使用内网IP访问API地址
检查防火墙是否放行对应端口

7.4 推送消息未收到

确认推送服务器地址为公网可达URL
检查服务器SSL证书是否有效（HTTPS要求）
查看控制台推送日志，确认消息是否成功发送

八、总结

芯步单路触摸出门开关通过开放的HTTP API接口，提供了灵活的联动控制能力。开发者可根据实际场景选择：

简单场景：服务器轮询方案，快速实现
企业场景：消息推送方案，实时可靠
内网场景：局域网直连方案，低延迟响应

通过合理利用状态保持、脉冲通断等进阶命令，可大大简化联动逻辑的复杂度，实现“云端+端侧”协同的自动化控制体系。