怎样对接门禁照明一体开关以实现照明电源开关控制_解决方案

CATALOG

芯步的开放接口采用标准HTTP协议，门禁与照明两类设备的命令结构高度一致——门禁用reset实现延时断电开锁，照明用power直接控制开关，两者可通过同一套签名机制调用。以下方案以“门禁验证通过后自动开灯”为核心场景，给出代码示例与联动策略。

一、概述与适用场景

在现代智能楼宇、共享办公空间、公寓及配电房中，门禁系统与照明系统的联动是提升能效与通行体验的关键。本方案基于芯步（ThingBoot） 的开放平台与硬件生态，旨在解决如何通过标准的HTTP接口，将智能门禁设备与门禁照明一体开关（或独立智能墙壁开关）进行逻辑绑定。

核心价值

安全节能：实现“人来灯亮，人走灯灭”或“开门即亮”，避免长明灯浪费。
极简改造：利用现有Wi-Fi网络，无需额外布设控制线，10分钟内完成接口对接。
高扩展性：支持单路、4路控制器，可同时控制门锁、照明、排风扇及语音播报。

二、硬件选型与角色定义

为实现“门禁触发照明”，我们需要两类硬件，均为芯步生态内支持HTTP开放式接口的产品：

设备角色	推荐产品型号	核心功能	在本方案中的作用
控制大脑/触发源	智能墙壁出门开关 / 智能门禁控制器	通过继电器控制电磁锁通断，支持`reset`（先断后通）指令	检测通行信号（如按下出门按钮或刷卡），并作为逻辑触发器
执行单元	智能墙壁开关1路 / 2路（门禁照明一体）	控制灯光电路的通断，支持`power`指令	执行照明电源的开关与关闭
可选辅助	智能控制器4路	若需同时控制多盏灯或设备，可使用此设备	批量控制照明与排风

关联说明：在“门禁照明一体开关”的场景下，物理设备可能包含两个继电器模块（一个控制门锁，一个控制照明）。但在逻辑接口上，它们是独立的命令通道。

三、接口对接架构与鉴权

3.1 架构模型

采用标准的 云对云 或 设备直连 架构：

客户端/服务器 -> 芯步开放API -> 智能硬件（门禁/照明）

3.2 准备工作与鉴权机制

所有控制指令均需通过HTTP POST请求发送至 https://api.thingboot.com/{AppId}/device/control/，并携带以下动态签名参数以防止篡改

AppID：应用唯一标识。
AppSecret：开发者密码。
ts：当前Unix时间戳（秒）。
sign：签名。计算公式为：sign = md5( md5(AppSecret) + ts )即：先将AppSecret进行MD5加密得到字符串A，再将字符串A与时间戳ts拼接，最后对整个字符串再次进行MD5加密。

开发提示：在测试阶段，可在芯步控制台开启“调试模式”，此时系统将暂时忽略Sign和ts校验，方便快速验证业务逻辑。

四、业务逻辑深度实现：门禁联动照明

本章节将演示如何通过代码实现“当门禁打开（人通过）时，照明灯自动开启，并在延时一段时间后自动关闭”。

4.1 控制门禁（例如：按下开门按钮）

门禁控制通常使用 先断后通（Reset） 指令。例如，需要控制电磁锁开门5秒，需发送以下JSON：

命令解释reset 参数单位是毫秒。例如 5000 代表锁断开5秒（开门），随后吸合（锁门）。

4.2 控制照明（例如：开灯并延时关灯）

照明控制标准的开关指令为 Power。若需实现“照明保持开启2分钟后自动关断（节能）”，通常利用客户端的延时任务，或利用设备自带的reset定时功能（如果设备支持）。

开灯{"power1": "1"}
2分钟后关灯{"reset1": "120000"} （部分开关支持此参数）或由业务服务端计时发送关灯指令。

4.3 联动代码实战（Python示例）

以下代码模拟了一个完整的联动：接收门禁事件 -> 控制门禁动作 -> 自动开灯。

import requests
import hashlib
import time
import json

# 配置信息
APP_ID = "Your_App_ID"
APP_SECRET = "Your_App_Secret"
API_HOST = "https://api.thingboot.com"

# 设备ID列表
DOOR_DEVICE_ID = "123456"   # 智能门禁设备ID
LIGHT_DEVICE_ID = "789012"  # 墙壁开关设备ID

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_device(device_id, order_json):
    """通用设备控制函数"""
    ts = int(time.time())
    sign = generate_sign(APP_SECRET, ts)
    
    url = f"{API_HOST}/{APP_ID}/device/control/?sign={sign}&ts={ts}"
    payload = {
        "device": device_id,
        "order": order_json
    }
    headers = {'Content-Type': 'application/json'}
    
    response = requests.post(url, headers=headers, data=json.dumps(payload))
    print(f"控制设备 {device_id} 响应: {response.text}")
    return response

def door_open_and_light_on():
    """场景1:有人按下出门开关 -> 开门 -> 立即开灯 -> 30秒后自动关灯"""
    
    print(f"[{time.strftime('%Y-%m-%d %H:%M:%S')}] 检测到门禁触发")
    
    # 1. 执行门禁动作:断开电磁锁5秒，允许人员通过
    # 注意:若门禁是"出门开关"类型，通常发送 reset 指令
    control_device(DOOR_DEVICE_ID, {"reset": 5000})
    
    # 2. 执行照明动作:打开照明线路1
    control_device(LIGHT_DEVICE_ID, {"power1": "1"})
    
    # 3. 联动逻辑:30秒后自动关闭照明
    # :此处可启动一个定时线程，或在任务队列中注册一个30秒后的任务
    # 为了演示严谨性，这里简单的延时30秒后发送关灯指令。
    # 注意:生产环境使用消息队列或异步框架，避免阻塞。
    print("灯光已开启，将在30秒后自动关闭...")
    time.sleep(30)
    control_device(LIGHT_DEVICE_ID, {"power1": "0"})

# 模拟调用
if __name__ == "__main__":
    # 实际对接中，此函数通常由Webhook（消息推送）触发。
    # 此处为手动调用示例。
    door_open_and_light_on()

4.4 接口调试技巧

如果不确定设备指令格式，可以直接利用芯步物联网控制台登录控制台 -> 进入设备详情页 -> 点击 “控制” 选项卡。在此界面上手动点击“开灯”或“开门”，浏览器的开发者工具（F12）或控制台界面上会直接显示出发送给设备的原始JSON命令。直接复制该命令即可用于代码开发，极大降低学习成本。

五、高级联动策略

为了实现更智能、更节能的体验，结合芯步的其他传感器设备，构建“照明跟随策略”

5.1 门禁联动（APB逻辑）

适用于配电房或机房场景：

策略：门禁通过身份验证（刷卡/人脸）开门时，自动联动照明开关开启，并联动风机系统排风。
指令组合：同时调用门禁设备的 power（或门磁相关）和照明设备的 power。
参考：利用智能控制器4路，在开门的同时，给照明回路和风机回路供电。

5.2 无人自动关灯（人体感应联动）

利用芯步的 “人体红外传感器”

策略：门禁开启后照明亮起。若人体传感器检测到该区域无人活动超过15分钟，服务器主动下发 {"power1":"0"} 指令关闭照明，实现“人来灯亮、人走灯灭”的精细化节能管理。

5.3 临时访客模式（密码门禁联动）

适用于短租公寓或共享办公室

策略：通过接口生成临时访客密码（调用门禁的pwd或list接口）。当访客输入密码开门成功的瞬间，服务器接收到门禁事件推送，立刻触发照明回路开启，营造宾至如归的体验。

六、常见问题排查指南

设备离线
- 检查设备是否已通过“芯步”APP完成配网。
- 确保设备供电正常（零火线接入，智能开关需要接零线的通常更稳定）。
签名错误
- 请核对 sign 的生成逻辑：必须经过双重MD5加密，且 ts 是服务器当前时间戳（误差不宜超过5分钟）。测试阶段可开启“调试模式”暂时绕过签名校验。
命令不生效
- 确认 order 的Key值是否正确。例如：单路开关通常用 power1，若是四路控制器则用 power1 到 power4。
- 确认 order 的Value类型。有些接口要求字符串 "1"，有些要求布尔值，请严格参考设备《产品手册》。

七、总结

芯步的开放接口通过统一的HTTP协议，将物理上独立的“门禁”与“照明”在云端实现了逻辑上的“一体化”。开发者仅需掌握 reset（用于门禁延时复位） 与 power（用于照明开关） 两组核心命令，配合简易的签名鉴权，即可在极短时间内（官方承诺10分钟）搭建出一套具备商业级稳定性的门禁照明联动系统，不仅适用于新项目建设，也常用于传统门禁的智能化节能改造。