创客工坊的门禁照明联动，关键在于“人-设备-规则”三者的闭环。以下是基于芯步开放接口的完整方案，从硬件选型到接口时序都有具体说明，可直接用于开发评估。

解决方案：基于芯步开放接口的创客工坊智能照明与门禁联动系统

1. 背景与需求分析

在许多创客工坊（Makerspace）的运营管理中，安全与节能是两大痛点。传统模式下，工坊大门关闭后，照明系统常被遗忘开启造成能源浪费；或者在非工作时间，安保人员难以判断无人区域是否需要关闭电源。

核心需求：

• 安全强化：只有授权人员在合法时间段刷卡/扫码，大门才能开启。

• 节能自动化：门禁触发开门的同时，工坊内的主照明自动亮起；当最后一人离开（门禁锁门且传感器检测无人）时，自动切断电源。

• 权限可编程：创客工坊常有夜间活动或特定项目借用，需支持临时密码或远程授权开门并联动灯光。

2. 系统设计

本方案基于云-端-边架构，采用芯步开放的API能力，将门禁控制器与照明回路解耦又联动。

• 感知执行层

  • 智能门禁：联网型刷卡/二维码门禁主机（具备信号输出接口）。

  • 智能照明回路：采用芯步的 智能断路器 或 智能继电器模块。

  • 状态传感器：芯步 人体存在雷达传感器（用于确认人员是否完全离开现场时，防止误关灯）。

• 网络传输层：通过工坊内的Wi-Fi/以太网接入公网，或局域网部署。

• 平台控制层：芯步开放平台（负责设备状态上报与指令下发）。

• 业务逻辑层：你的创客工坊管理后台（SaaS/本地服务器），负责接收门禁事件，并决策是否下发照明指令。

3. 核心联动逻辑与流程

以下是实现“开门即亮灯，离开现场时即关灯”的标准时序逻辑：

场景 A：正常进入模式

1. 创客成员在工坊门口通过手机动态码或门禁卡验证。

2. 门禁主机通过网络向你的工坊管理后台推送“解锁成功事件”。

3. 你的后台判断当前时间（例如：18:00 - 08:00 属于照明时段）或判断该工位预约状态。

4. 触发联动规则：调用芯步开放接口 https://api.thingboot.com/{AppId}/device/control/。

5. 芯步平台下发指令给“工坊总照明智能断路器”（设备ID：xxxx），执行 闭合回路（开灯）。

6. 照明亮起，用户进入工作状态。

场景 B：无人节能模式

1. 最后一位用户刷卡离开，门禁上报“门关事件”。

2. 芯步的 人体存在雷达传感器 实时上报数据：{"radar_state":"unoccupied"}。

3. 你的服务器设定策略：确认门关事件 + 持续5分钟无人状态 = 空闲。

4. 调用接口向照明设备下发 断开回路（关灯） 指令。

4. 关键设备选型与接口定义

要实现上述联动，在工坊中部署以下芯步产品线中的关键硬件：

A. 智能照明控制器（执行器）

• 推荐型号：芯步 4路智能断路器/继电器模块。

• 对接参数

  • 设备ID21308845

  • 控制指令

  // 控制灯光开启 (线路闭合) { "device": 21308845, "order": {"power": 1} } // 控制灯光关闭 (线路断开) { "device": 21308845, "order": {"power": 0} }

  • 响应时间： ≤120ms，确保开门瞬间灯亮，无延迟感。

B. 人体存在雷达传感器（防误判）

• 作用：区分“无人”与“静止工作”。普通红外传感器在人体不动时易误判，雷达传感器可探测呼吸微动。

• 数据上报格式

  // 当人员进入或离开时，设备主动推送消息到你的服务器 { "device": 820720, "radar_enable": 1, // 雷达开启 "illuminance": 120, // 光照度 "presence": "true" // true=有人，false=无人 }

C. 门禁控制器联动

• 需选购具备继电器信号输出或网络API回调功能的门禁机。

• 配置门禁机的“开锁成功回调地址”为你服务器的接口（例如：http://你的域名/api/door/event）。

5. 服务器端对接实施方案

作为“怎么接”的核心，你需要开发一个轻量级的桥接服务（Middleware），使用 Python (Flask) 或 Node.js 编写，逻辑如下：

1. 接收门禁事件

• 监听端口，接收门禁系统的HTTP POST请求（开门记录）。

• 关键字段提取：UserID, DoorID, Timestamp, ActionType(进门/出门)。

2. 状态机判断逻辑

• 查数据库：查询当前工坊照明状态（On/Off）。

• 防抖逻辑：如果1分钟内该门重复触发，忽略后续请求，防止反复下发指令烧坏继电器。

3. 调用芯步接口

• 签名机制：请求芯步接口必须携带 sign 和 ts。你需要根据芯步分配的 AppId 和 AppSecret 生成MD5签名。

• HTTP请求示例（伪代码）：

  import requests # 组装URL url = f"http://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}" payload = { "device": 照明设备ID, # 例如 21308845 "order": {"power": 1} # 1开 0关 } response = requests.post(url, json=payload)

4. 接收传感器上行数据

• 配置芯步平台的消息推送地址（Webhook）为你专用的接收地址。

• 当雷达检测状态变化，你收到数据后存入Redis缓存，供关灯逻辑判断使用。

6. 部署注意事项

1. 网络隔离与安全：将物联网设备（智能断路器）划分在独立VLAN中，通过防火墙仅允许其与芯步API及你的业务服务器通信，防止本地ARP攻击导致灯控失效。

2. 断网容灾：若工坊网络中断，依赖公网API的开灯联动将失效。

   • 措施：在本地部署 芯步边缘网关。边缘网关支持局域网控制（LAN模式），即使外网断开，刷卡触发的局域网广播包依然能控制灯泡亮起。

3. 手动优先原则：在智能断路器旁保留物理翘板开关。接口下发指令虽快，但创客工坊常有带电调试场景，物理硬断隔离是必须的安全底线。

7. 落地价值总结

通过接入芯步开放接口，创客工坊的照明管理不再是一个孤立的定时任务，而成为了安防流程的一环：

• 极致节能：解决创客工坊“人走忘记关灯”的顽疾，预期节电30%以上。

• 体验提升：夜间到达工坊无需摸黑找开关，门禁验证通过即亮灯，提升科技感。

• 数字化管理：所有开关门记录、灯光耗电时长均在后台可查，形成工坊使用率的数字化报表。