怎么接入2路双功能墙壁开关来实现场景联动照明门禁控制_解决方案

CATALOG

芯步的2路墙壁开关是一款基础执行设备，本身不具备传感能力。要实现“场景联动”，关键在于将其HTTP API与人体传感器、门磁等设备的数据上报打通——由传感器触发事件，你的服务器接收后下发开关指令。以下方案涵盖硬件选型、接口对接逻辑和典型场景代码实现。

解决方案：基于芯步2路双功能墙壁开关实现照明与门禁场景联动

1. 概述

本方案的目标是利用芯步智能触摸墙壁开关2路的开放HTTP API接口，结合人体传感器、门磁传感器或门禁控制器，实现“人来灯亮、人走灯灭”以及“开门亮灯”等场景联动。

核心逻辑： 传感器（输入） $\rightarrow$ 云端/服务器（逻辑判断） $\rightarrow$ 墙壁开关（输出执行）。

2. 硬件选型与角色分工

主控设备：智能触摸墙壁开关2路
- 角色： 执行终端。
- 功能： 控制两路照明电路的通断，或接入电插锁/磁力锁控制门禁。
- 接口能力： 支持HTTP API、TCP/UDP、MQTT及局域网控制。
传感设备（联动触发器）：
- 人体存在传感器： 用于探测人员进出，触发照明开关。
- 门磁传感器： 用于检测门锁的开闭状态。
控制核心：芯步开放平台 或 用户自建服务器。
- 负责接收传感器上报的状态，执行逻辑判断（如：若检测到人，则向开关下发“闭合”命令）。

3. 硬件接线与安装

电气接线（以照明联动为例）：
- L线（火线）： 接入开关的L端。
- 负载线： 第一路照明接入L1，第二路照明接入L2。
- 零线： 智能开关必须接入零线（N）以确保待机供电。
门禁场景接线：
- 若控制门禁，通常将开关的常开（NO） 或常闭（NC） 触点串联到门禁电源的PUSH（开门）信号端。接收到API指令后，开关触点闭合，触发门禁开门。

4. 开放接口开发指南（API对接）

为了编写联动程序，后端开发者需要重点掌握以下接口细节。

4.1 鉴权与基础配置

所有API请求都需要进行签名验证，具体流程如下表所示：

参数	说明	获取位置
AppID	应用唯一标识	芯步控制台开发设置
AppSecret	应用密钥	芯步控制台开发设置
Device ID	目标设备ID	设备外壳标签或控制台设备列表
Sign	请求签名	计算公式：`MD5(MD5(AppSecret) + ts)`
ts	UNIX时间戳	当前时间的秒数

4.2 控制2路开关的核心命令

请求地址：http(s)://api.thingboot.com/{AppID}/device/control/?sign={sign}&ts={ts}Method：POSTContent-Type：application/json

常用JSON命令示例：

开启照明（第1路）
{ "device": "设备ID", "order": {"power1": 1} }
注：power1对应线路1，设为1代表接通（开灯），设为0代表关闭。
门禁控制（第2路 - 点动模式）门禁通常需要“通电1秒后自动断开”以确保控制器复位，开关支持设置先通后断功能非常实用。
{ "device": "设备ID", "order": {"point2": 1000} }
注：point2代表第2路执行“先通后断”，1000单位是毫秒（即接通1秒后自动断开），模拟按门铃的动作。
批量控制与延时复位
{ "device": "设备ID", "order": {"reset": {"relay": [1,2], "interval": 5000}} }
注：该命令场景通常用于定时任务或安防联动，如5秒后自动关闭所有灯和门。

4.3 场景联动逻辑实现（伪代码示例）

假设场景：在卫生间部署了“人体传感器”，当传感器上报“无人”状态持续2分钟后，自动关灯。

5. 典型场景联动方案详解

以下是基于该产品的四种典型应用场景，可根据实际需求灵活组合。

场景名称	联动逻辑	涉及产品	关键命令
人来灯亮（楼道/洗手间）	传感器探测到人 $\rightarrow$ 开启开关第1路（照明）	人体传感器 + 2路开关	`{"power1":1}`
人走灯灭（节能策略）	持续无人时长超阈值（如5分钟） $\rightarrow$ 关闭所有照明	人体传感器 + 2路开关	`{"power1":0}`
开门联动（门禁/照明）	门磁检测到门被打开 $\rightarrow$ 开启第2路（门锁）或客厅灯	门磁传感器 + 2路开关	`{"point2":1000}`
安防全关（离家模式）	用户点击App“离家”按钮 $\rightarrow$ 切断所有灯并锁定	云端/服务器 + 2路开关	`{"batch":{"power":0}}`

6. 核心代码集成示例

Python 示例：实现开门自动点灯功能：当检测到门磁传感器打开（门被推开）时，自动打开2路开关的第1路照明，并在3分钟后自动关闭。

import requests
import hashlib
import time

# 配置信息（从控制台获取）
APP_ID = "your_app_id"
APP_SECRET = "your_app_secret"
DEVICE_SWITCH_ID = "123456789" # 2路墙壁开关的设备ID

base_url = f"https://api.thingboot.com/{APP_ID}/device/control/"

def generate_sign(secret, ts):
    # 签名算法:md5(md5(secret) + ts)
    md5_secret = hashlib.md5(secret.encode()).hexdigest()
    sign_str = md5_secret + str(ts)
    sign = hashlib.md5(sign_str.encode()).hexdigest()
    return sign

def control_switch(channel, action, delay_off=None):
    ts = int(time.time())
    sign = generate_sign(APP_SECRET, ts)
    
    # 构建命令
    if channel == 1:
        order = {"power1": action}  # action 1=开，0=关
    else:
        order = {"power2": action}
        
    # 如果需要延时关灯（先通后断功能），仅支持单次脉冲
    if delay_off and action == 1:
        order = {"point1": delay_off} # 单位毫秒
            
    params = {
        'sign': sign,
        'ts': ts
    }
    payload = {
        'device': DEVICE_SWITCH_ID,
        'order': order
    }
    
    response = requests.post(base_url, params=params, json=payload)
    print(f"Control result: {response.text}")

# 示例:门磁触发调用逻辑
def door_opened_callback():
    # 门开了，开启第1路（照明），并设置为60秒后自动熄灭
    control_switch(channel=1, action=1, delay_off=60000)

if __name__ == "__main__":
    # 模拟门开了
    door_opened_callback()

7. 注意事项

网络覆盖： 2路墙壁开关依赖Wi-Fi，请一定要确保安装位置的信号强度（RSSI值大于-60dBm为佳），否则可能出现指令延迟或离线。
零线问题： 传统机械开关很多只有火线（单火），而芯步智能开关通常需要零线，在改造老旧小区时需特别注意布线。
异步反馈： 通过HTTP请求下发指令，返回的 200 代码仅代表指令已被平台接收，不代表设备实际执行成功。对于断电开门等关键安防场景，配置消息推送接收设备执行后的状态回执，以确认门锁已实际打开。
私有化部署： 若对数据安全要求较高，芯步的接口支持局域网和私有化部署，可将API地址指向本地服务器。

8. 总结

通过芯步2路墙壁开关的HTTP接口（特别是 point 点动指令和 power 通断指令），可以非常轻松地构建从“感知”到“控制”的闭环。开发者只需处理好传感器数据上报接收 和向开关下发HTTP命令这两个环节，即可在不修改硬件的情况下，实现灵活的智能联动场景。