这是一个基于芯步产品的硬件选型与软件集成方案。针对“一路门禁 + 一路照明”的控制需求，核心思路是利用多路独立控制的控制器将两个系统整合到一个逻辑中，并通过传感器实现自动化联动。

以下是详细解决方案：

一、 背景与目标

在许多智能化场景（如民宿、公寓、办公室或设备间）中，既要控制门口的门锁（门禁），又要管理室内的照明，且希望两者能够联动（例如：开门即亮灯、关门自动断灯并锁门）。

目标：

1. 独立控制：能够远程查看门锁状态并控制门锁开合，同时独立控制照明开关。

2. 场景联动：实现“回家模式”（开门+开灯）和“离家模式”（关灯+锁门）。

3. 接口集成：通过HTTP API将这些功能集成到现有的管理系统或小程序中。

二、 硬件选型

基于芯步的产品线，不分别采购智能锁和智能灯泡，因为这会增加两套软件对接成本。针对“一路门禁+一路照明”的需求，最经济且接口标准化的方案如下：

1. 核心控制设备：智能控制器

由于门禁锁通常需要12V电压或通断电控制，照明是220V交流电，推荐使用芯步 [智能控制器4路|交流电压版]。

• 选型理由：该设备支持85-265V宽电压输入，提供4路继电器输出（每路最大10A）。

• 物理接线方案

  • 第1路（照明）：直接接入220V照明电路，控制灯的开关。

  • 第2路（门禁）：如果门锁是电控锁（通电开锁或断电开锁），通过此路继电器控制门锁电源或触发信号。

2. 传感设备：人体存在传感器

为了实现“人走灯灭”或自动感应，需要感知环境状态。

• 推荐型号：芯步 [智能WiFi人体存在传感器]（双模/红外+雷达版）。

• 作用：解决普通红外传感器在人体静止时误判“无人”的问题，用于检测是否有人，从而控制照明。

3. 可选辅助：语音喇叭

• 推荐型号：芯步 [智能语音喇叭86型] 。

• 作用：在门禁异常或有人闯入时，通过HTTP接口推送语音告警。

三、 接口集成方案

芯步方案的核心优势在于 “开放性” 。所有设备均不强制使用官方APP，而是通过HTTP API将数据和控制权交给开发者。

以下是具体的接入逻辑与代码实现思路：

1. 设备注册与连接

• 步骤：将控制器通电并连接WiFi。在芯步开发者后台获取设备ID（Device ID）和API Key（AppId/AppSecret）。

• 协议：API请求地址格式为 http(s)://api.thingboot.com/{AppId}/device/control/，采用POST请求，携带签名（Sign）验证。

2. 实现远程控制 (HTTP API)

您可以通过任何后端语言（Python, PHP, Go）或前端（小程序）发起HTTP请求来控制这两路开关。

场景A：控制照明开/关假设照明接在线路1，需要开灯。

• 请求命令

  { "device": "设备ID", "order": {"power1":"1"} // 1代表开，0代表关 }

• 签名示例 (PHP伪代码) ：

  $ts = time(); $sign = md5(md5($AppSecret) . $ts); $url = "https://api.thingboot.com/{$AppId}/device/control/?sign={$sign}&ts={$ts}"; // 发送POST数据: device=xxx&order={"power1":"1"}

  参考数据格式

场景B：控制门禁开锁假设门禁接在线路2（注意：门锁若为断电开锁，则配置常闭模式，发送{"power2":"0"}即视为开门）。

• 请求命令

  { "device": "设备ID", "order": {"power2":"1"} // 通电开门（视具体锁型而定） }

3. 实现自动化联动 (服务端逻辑)

芯步支持设备状态主动推送到您的服务器，这样您就不需要一直轮询。

联动逻辑：有人自动开灯

1. 设备：人体传感器。

2. 推送：当传感器检测到“有人”，它会向您的服务器回调接口（例如：/api/sensor/callback）发送数据。

3. 您的代码处理：接收到{"radar":"someone"}后，调用上面场景A的接口，打开照明。

联动逻辑：离家模式（关门+关灯）

• 触发方式：通过在您的APP/小程序点击“离家”按钮，或通过门磁传感器检测。

• 执行：后端依次调用API {"power1":"0"}（关灯）和 {"power2":"0"}（断电锁门）。

四、 项目落地步骤

如果你正在编写项目解决方案，按照以下 4 个阶段组织内容：

第一阶段：硬件电路设计与接线

• 照明线路：控制器火线进线接总闸，出线（L1）接灯具。

• 门禁线路：需确认电锁类型（磁力锁/阴极锁/电插锁）。如果是12V电锁，控制器只起到开关作用，需外接12V电源适配器，将控制器第2路串联在电源与锁的正极线上。

• 注意：控制器支持最大10A电流，足以覆盖常规照明和锁具。

第二阶段：环境搭建与设备配网

• 利用芯步提供的配网工具，将硬件设备（控制器、传感器）绑定到开发者账号下，记录下唯一标识（Device ID）。

第三阶段：后端接口开发

• 封装API：在您的后端服务中封装一个函数 controlRelay(deviceId, channel, action)，处理复杂的Sign签名逻辑。

• 接收推送：搭建一个公网可访问的接收地址，用于接收传感器的状态上报。

第四阶段：前端/应用开发

• 在管理后台或微信小程序中制作界面：

  • 一个大的“开锁”按钮（调用门禁线路）。

  • 一个“照明开关”按钮（调用照明线路）。

  • 一个开关，用于启用“人来灯亮/人走灯灭”的自动化规则。

五、 总结

采用芯步的4路控制器来完成这个项目，是最具性价比且最稳定的方式。它将复杂的硬件电路控制抽象成了简单的{"power1":"1"}这种JSON命令，极大地降低了软件开发的难度。

• 对于照明：利用继电器直接控制强电通断。

• 对于门禁：利用继电器模拟开关信号或控制锁具电源。

在集成时，重点阅读官方文档关于 “签名计算” 的部分，这是唯一的技术门槛。一旦打通API，您就可以根据自己的业务逻辑（如：刷卡成功 -> 开锁 -> 检测到人 -> 开灯）编写流程代码了。