如何接入86型左灯右门复合开关以实现远程控制照明与门禁_解决方案

CATALOG

86型左灯右门复合开关是一款将照明控制与门禁管理合二为一的智能设备，特别适合空间有限或需要一体化管控的场景。以下是基于芯步开放接口的技术解决方案。

1. 解决概述

本方案的目标是指导开发者如何利用芯步开放的 HTTP API 接口 ，对型号为 UNI-KG-CM-KC 的86型“左灯右门”复合开关进行二次开发。通过该方案，开发者可以实现以下两个核心目标：

远程照明控制：通过网络远程控制开关的“左灯”继电器，实现灯的开关。
远程门禁管理：通过网络远程控制开关的“右门”继电器（通常接电锁），实现远程开门/关门。

适用场景：公寓/酒店远程入住管理、办公室远程接待、无人值守门禁、家庭智能化改造等。

2. 硬件与接口准备

在开始开发前，请确认硬件基础条件及接口凭证。

2.1 硬件型号确认

请确保使用的设备是 左灯右门 版本。

产品型号UNI-KG-CM-KC
核心逻辑
- 第1路（左/灯）：控制照明灯具。
- 第2路（右/门）：控制门锁（常开/常闭切换）。
接线说明
- 照明端：接入零火线，负载接灯。
- 门禁端：公共端（COM）和常开（NO）或常闭（NC）接入电锁（如磁力锁、阴极锁）。

2.2 开放接口凭证

在芯步开放平台完成以下准备

获取 AppID：应用唯一标识。
获取 AppSecret：用于签名计算的密钥。
获取 Device ID：设备的唯一ID，可在控制台查看或配网后自动同步。

3. 接口鉴权与签名机制

芯步 API 使用动态签名机制进行安全验证，开发时需按照以下规则生成签名。

签名算法步骤

先对 AppSecret 进行一次 MD5 加密： secret_md5 = md5(AppSecret)
拼接时间戳（秒级）： str = secret_md5 + ts
再次进行 MD5 加密得到最终签名： sign = md5(str)

请求示例

URL： https://api.thingboot.com/{AppID}/device/control/?sign={sign}&ts={ts}
Method： POST
Content-Type： application/json

4. 核心功能开发实现

基于 HTTP 协议，通过下发不同的 order 指令实现场景控制。

4.1 远程控制照明（左灯）

通过控制继电器1的通断来开关灯。

开启照明
- order 参数： {"power1": 1}
关闭照明
- order 参数： {"power1": 0}

4.2 远程控制门禁（右门）

通过控制继电器2的通断来触发门锁。门禁控制通常有两种逻辑：

点动模式（推荐）：按下开关，继电器瞬间接通（如1秒）后自动断开，适合控制电插锁或磁力锁，防止烧坏线圈。
切换模式：第一次远程“开”，第二次远程“关”。

命令示例（点动/脉宽控制）通过 reset2（先断后通）或 point2（先通后断）参数来控制门锁吸合时间。

远程开门（触发模式）：让第2路断开 特定时间 后自动闭合，或反之。
- 示例：开门2秒自动复位： {"reset2": "2000"} （常用于平时通电关，断电开的电锁）。

注：具体命令格式（究竟是 power2 还是 reset2），请参考该设备具体的“产品手册”页面，因门锁类型（常开/常闭）不同，命令写法有所区别。

4.3 完整的业务代码示例（Python）

假设我们需要实现一个“访客一键开门并开灯”的 API 调用。

import hashlib
import time
import requests
import json

# 配置参数
APP_ID = "Your_AppID"        # 替换控制台获取的AppID
APP_SECRET = "Your_Secret"   # 替换控制台获取的Secret
DEVICE_ID = "Your_Device_ID" # 左灯右门开关的设备ID

def generate_sign(secret, ts):
    # 1. md5(secret)
    secret_md5 = hashlib.md5(secret.encode('utf-8')).hexdigest()
    # 2. md5(secret_md5 + ts)
    sign_str = secret_md5 + str(ts)
    sign = hashlib.md5(sign_str.encode('utf-8')).hexdigest()
    return sign

def control_device(command):
    ts = int(time.time())
    sign = generate_sign(APP_SECRET, ts)
    
    url = f"https://api.thingboot.com/{APP_ID}/device/control/"
    params = {
        "sign": sign,
        "ts": ts
    }
    payload = {
        "device": DEVICE_ID,
        "order": command
    }
    
    response = requests.post(url, params=params, json=payload)
    return response.json()

# 场景 1: 开灯 (控制第1路)
print("1. 开灯指令下发:", control_device({"power1": 1}))

# 场景 2: 远程开门 (控制第2路，触发脉冲)
# 假设门锁接在第2路，下发脉冲信号，继电器跳变一次
print("2. 远程开门指令下发:", control_device({"reset2": "1000"})) # 典型脉冲开门命令

# 场景 3: 关闭所有 (关闭灯，同时切断门锁电源)
print("3. 关闭所有指令下发:", control_device({"power1": 0, "power2": 0}))

4.4 状态同步与事件推送

为了实现高效的门禁日志记录，可利用芯步的 消息推送 机制。

设置回调 URL：在控制台配置您的服务器接收地址。
数据用途
- 记录门禁开启时间和操作人。
- 检测照明状态，结合人体传感器实现自动化（如人走灯灭）。

5. 常见问题和需要注意的点

Q1：为什么远程控制门锁没反应？
- 排查：检查 Device ID 是否正确；检查第2路的命令格式。若是门磁锁，通常需要配置为“点动模式”，直接发 power2（持续通电）容易烧锁，使用 reset2。
Q2：如果设备断网了怎么办？
- 该开关支持本地触摸控制。虽然 API 无法连接，但物理按键依然有效。WiFi 模块仅支持 2.4GHz 频段，不支持 5G WiFi 。
Q3：私有化部署支持？
- 芯步平台支持私有化部署。若您的系统部署在本地服务器，可将 API 地址指向私有化部署的服务器地址，实现内网高稳定控制。

6. 总结

通过芯步提供的标准 HTTP 接口，对接 86型左灯右门复合开关 是非常简便的过程。开发者只需关注以下三个核心点：

签名：正确的 MD5 嵌套加密。
路由：明确 power1 是灯，power2/reset2 是门。
逻辑：门禁控制请一定要考虑安全延时（脉冲）。