怎样二次开发3路独立控制墙壁开关来实现两路照明一路门禁控制_解决方案

CATALOG

芯步的3路智能墙壁开关不仅支持三路独立控制，还提供了丰富的边缘指令（如点动模式、状态锁定），非常适合改造成“照明+门禁”二合一设备。以下方案利用第3路的脉冲控制功能驱动门禁电磁锁，同时保持前两路用于照明独立管理。

1. 项目概述与背景

在智能化改造中，墙面面板资源往往非常紧张。传统的方案中，门禁系统和照明系统相互独立，不仅占用墙面空间，也增加了布线复杂度。芯步推出的3路独立控制墙壁开关（型号：UNI-KG-3），本质上是一个支持WiFi直连、拥有3路继电器输出的智能设备。

本方案的目标是通过二次开发，利用该设备的“三路独立控制”特性，将其2路用于照明（走廊/室内），1路用于门禁控制（电磁锁/电插锁）。核心挑战在于：灯光控制通常需要状态保持（常开/常闭），而门禁控制通常需要脉冲信号（通电几秒后自动断开）。我们将利用设备开放的HTTP API接口及其内置的“点动模式”来解决这一问题。

2. 硬件选型与原理

2.1 硬件

主控设备：芯步智能墙壁开关3路（UNI-KG-3）。
- 参数：支持100-240V AC，每路最大负载10A，WiFi 2.4G通讯。
- 特点：支持HTTP控制、局域网通讯、状态上报。
照明负载：LED灯组（接入L1/L2口）。
门禁负载：12V电插锁或磁力锁（需配合外置12V电源及继电器进行电路转换，因开关输出为220V，门禁通常为12V，需中间继电器隔离）。

2.2 原理逻辑

L1/L2（照明路）：执行标准继电器逻辑，开/关命令对应灯亮/灭。
L3（门禁路）：执行脉冲逻辑。当接收到开门指令时，继电器吸合（通电），延迟1-2秒后自动断开（断电），模拟按下门禁按钮的动作。

3. 开放接口能力解析

芯步的开放接口基于HTTP协议，支持云端API调用和局域网直连两种模式，适配高实时性场景。

3.1 接口核心参数

URLhttps://api.thingboot.com/{AppID}/device/control/?sign={sign}&ts={ts}
Method：POST
HeaderContent-Type: application/json
Body Payload
{ "device": "device_id_here", "order": {} }

3.2 关键命令逻辑（针对本方案）

根据官方命令集，我们可以通过Json参数实现精细控制

照明控制（标准模式）控制L1开灯："order": {"power1":"1"}；关灯："order": {"power1":"0"}
门禁控制（点动/脉冲模式）控制L3输出2秒脉冲"order": {"point3":"2000"}（此命令会使第3路通电2000ms后自动断电，非常适合门禁触发）。

4. 二次开发实施步骤

为了实现“两路照明一路门禁”的统一管理，你需要开发一个简单的后端服务或直接调用API。

4.1 环境准备

将芯步3路开关接入220V电路，L1接照明1，L2接照明2，L3接中间继电器（再去控制门锁）。
配置设备WiFi，确保设备在物联网平台（ThingBoot Console）在线。
获取API关键凭证：AppID、设备ID (Device ID)、API Key（用于生成sign）。

4.2 后端逻辑伪代码示例

你可以使用Python、Node.js或Shell脚本发起HTTP请求。以下示例展示了如何封装三个核心功能：

import requests
import time
import hashlib

# 配置参数
app_id = "YOUR_APP_ID"
device_id = "YOUR_DEVICE_ID"
api_key = "YOUR_API_KEY"
base_url = f"https://api.thingboot.com/{app_id}/device/control/"

def control_device(order_data):
    """通用控制函数"""
    ts = str(int(time.time()))
    # 签名计算，具体算法参考官方Sign文档
    sign = hashlib.md5(f"{api_key}{ts}".encode()).hexdigest() 
    
    url = f"{base_url}?sign={sign}&ts={ts}"
    payload = {"device": device_id, "order": order_data}
    
    response = requests.post(url, json=payload)
    return response.json()

# 1. 门禁控制功能 (利用第三路的点动模式)
def open_door():
    # 执行 point3 命令，脉冲持续1.5秒，相当于按门禁键
    return control_device({"point3": "1500"})

# 2. 照明控制功能 (标准开关)
def light_control(light_num, action):
    # light_num: 1 或 2
    key = f"power{light_num}"
    # action: "1" 或 "0"
    return control_device({key: action})

# 3. 场景联动:开门同时打开走廊灯 (自动化场景)
def open_door_and_light():
    # 组合命令，同一包下发
    return control_device({
        "point3": "1500",   # 开锁1.5秒
        "power1": "1"       # 打开照明1
    })

4.3 集成到现有系统

如果你的系统是微信小程序或Web管理后台，只需调用上述封装好的API。

请求示例POST /api/controlBody: {"cmd": "open_door"}

5. 关键优化与体验设计

在混合控制中，需要注意电气安全与逻辑合理性。

5.1 门禁的电气隔离（重要安全提示）

芯步UNI-KG-3的继电器输出是220V交流电，而标准门禁电磁锁通常是12V/24V直流电。

错误做法：直接将L3输出接门锁，会烧毁门锁。
正确做法：将L3接入一个220V交流接触器或中间继电器的线圈端，利用继电器的干触点去控制12V门禁电路的通断。

5.2 定时与自动化联动

利用开放接口，你可以轻松实现：

定时全关：每天晚上23:00，自动关闭L1/L2照明，同时可触发L3确认门锁已锁闭。
防误触机制对于门禁控制，在前端（App/小程序）设置二次确认按钮，避免误触导致门锁频繁开合。

5.3 故障恢复机制

芯步设备支持状态锁定功能。需要注意的是，如果用于门禁，不要开启L3的“状态保持”功能（不要设置keep参数），否则门锁可能一直通电发热。利用point命令是最佳实践。

6. 方案总结

通过上述二次开发，原本只用于控制灯泡的芯步3路墙壁开关被成功改造为集照明、门禁于一体的智能面板：

功能模块	对应端口	使用的API命令	实现效果
照明回路A	L1	`{"power1":"1" \ "0"}`	标准开关，状态记忆
照明回路B	L2	`{"power2":"1" \ "0"}`	标准开关，状态记忆
门禁回路	L3	`{"point3":"1000"}`	脉冲模式，安全开锁

该方案利用了设备现有的HTTP API接口，无需修改固件，仅通过调用point（点动）和power（通断）命令即可实现逻辑区分。这不仅节省了一个专用门禁控制器的成本，也实现了墙面美观的统一管理。