无人门店人脸门禁 — 部署指南

• 一台装有 Docker 和 compose 插件的 Linux 服务器，门口设备能访问到它，不需要 GPU。
• 服务器时钟已开启 NTP 同步，门口设备以它为准。
• 服务器上 8080（人脸库）、8088（管理界面）、1883（MQTT）端口空闲。
• 「门口设备」按本套餐选：标准版 reCamera。
• 签名密钥和 admin token 自动生成，部署后在本步骤底部「自动生成的密钥」里查看，登录管理界面用 admin token。

• 步骤 1 的 admin token。
• 每人 3 到 8 张清晰的正脸照片。
• 步骤 1 已填写识别服务地址，否则注册的人不会被识别。

• 摄像头通过 USB-C 连接（IP 192.168.42.1）或在同一网络，并知道 recamera 用户的 SSH 密码。
• 摄像头能访问 http://<服务器 IP>:8080。
• /userdata 至少 20 MB 空闲。
• 器材：Grove Relay（SKU 103020005）、它自带的 4 芯 Grove 线、杜邦线（排针不是 Grove 座，Grove 线另一端要转成单根）、一路 3.3–5 V 电源、万用表。

1. 认准排针脚位（官方 wiki）：GND、GPIO488、GPIO487、TX、GPIO490、RX。三路 IO 是 D1 = GPIO490、CLK = GPIO487、SMD = GPIO488，本方案用 D1。
2. 排针没有供电脚，继电器 VCC 另外取电，见下方「继电器怎么取电」。GPIO 输出 3.3 V 逻辑电平，而 Grove Relay 工作电流 100 mA，GPIO 带不动，只接 SIG。这条路线不需要 XIAO。
3. 电平未文档化，接继电器之前先用万用表量 GPIO490 的高电平。
4. 接三根线，继电器的 NC 线不接：排针 GPIO490 → 继电器 SIG，5 V → VCC，排针 GND → GND（取电电源的地也接到这里）。
5. 先用 LED 试。 LED 加限流电阻接在 GPIO490 与 GND 之间，部署后看它是否按配置的脉宽亮一次；确认引脚和极性都对，再换成继电器。
6. 确认继电器每个脉冲响一次。 不响就回到第 3 步核对电平。
7. 接门禁控制器。 继电器 COM 与 NO 接门控的开门输入，这两个端子上量不到我们的电压。断电开门的电磁锁需要常闭触点，Grove Relay 没有 NC 端子，换 Grove - SPDT Relay 30A（SKU 103020012），接 COM 与 NC。
8. 在表单中填写设备 ID 和执行器 ID。人脸库地址、匹配阈值、签名密钥已从步骤 1 带入；只有摄像头访问服务器的地址不同才需要改地址。然后部署。

继电器怎么取电。 两种都行：

外部 5 V——一个 5 V USB 充电头，或门控侧已有的 12 V 经 DC-DC 降到 5 V，电源的地接到排针 GND，不用动板子。

板上焊接——PoE 底板（B3 PoE v1.2）上有 5 V 与 GND 焊盘，位置见下图，焊两根线出来。PoE 供电总量有限（板上保险 2 A、主路标称 1.2 A），继电器 100 mA 在余量内。焊前用万用表确认这两点是 5 V 与 GND。

• 摄像头已上电并联网。
• 至少注册了一个人。
• 步骤 1 的设备控制端点里已填入这台摄像头。

• 门禁控制器已接好，至少注册了一个人。
• 此人的一张打印照片。
• 步骤 1 的 admin token。

1. 已注册的人站到摄像头前：继电器响一次，管理界面出现放行事件。
2. 马上退开再上前：管理界面出现 debounced，继电器不再响。
3. 举起打印照片：管理界面出现 liveness_failed，继电器不响。
4. 在管理界面「设备」页点开门：继电器响一次，回执为 executed。
5. 删除一个人：30 s 内门不再为他打开，回滚到仍包含此人的版本会被拒绝。
6. 断开服务器后站到摄像头前：门照常打开。
7. 正式使用前：MQTT broker 改用 TLS 和按设备分配的账号，管理界面放到 HTTPS 后面。

• 一台装有 Docker 和 compose 插件的 Linux 服务器，门口设备能访问到它，不需要 GPU。
• 服务器时钟已开启 NTP 同步，门口设备以它为准。
• 服务器上 8080（人脸库）、8088（管理界面）、1883（MQTT）端口空闲。
• 「门口设备」按本套餐选：标准版 reCamera。
• 签名密钥和 admin token 自动生成，部署后在本步骤底部「自动生成的密钥」里查看，登录管理界面用 admin token。

• 步骤 1 的 admin token。
• 每人 3 到 8 张清晰的正脸照片。
• 步骤 1 已填写识别服务地址，否则注册的人不会被识别。

• 摄像头通过 USB-C 连接（IP 192.168.42.1）或在同一网络，并知道 recamera 用户的 SSH 密码。
• 摄像头能访问 http://<服务器 IP>:8080。
• /userdata 至少 20 MB 空闲。
• 一台连到同一 MQTT broker 的 R1000 或 XIAO ESP32-S3 继电器节点，并已设置好它的 Relay ID。

1. 摄像头没有可用排针，继电器接到继电器节点上：XIAO ESP32-S3 按继电器固件的 GPIO → 继电器 SIG，3V3 → VCC，GND → GND；R1000 则接到其 Modbus 点位号对应的输出。
2. 继电器 COM、NO 接门禁控制器的开门输入（断电开门的电磁锁接 COM、NC）。
3. 在表单中填写设备 ID，执行器 ID 填继电器节点上配置的 Relay ID。人脸库地址、匹配阈值、签名密钥已从步骤 1 带入；只有摄像头访问服务器的地址不同才需要改地址。然后部署。

• 摄像头已上电并联网。
• 至少注册了一个人。
• 步骤 1 的设备控制端点里已填入这台摄像头。

• 门禁控制器已接好，至少注册了一个人。
• 此人的一张打印照片。
• 步骤 1 的 admin token。

1. 已注册的人站到摄像头前：继电器响一次，管理界面出现放行事件。
2. 马上退开再上前：管理界面出现 debounced，继电器不再响。
3. 举起打印照片：管理界面出现 liveness_failed，继电器不响。
4. 在管理界面「设备」页点开门：继电器响一次，回执为 executed。
5. 删除一个人：30 s 内门不再为他打开，回滚到仍包含此人的版本会被拒绝。
6. 正式使用前：MQTT broker 改用 TLS 和按设备分配的账号，管理界面放到 HTTPS 后面。

• 一台装有 Docker 和 compose 插件的 Linux 服务器，门口设备能访问到它，不需要 GPU。
• 服务器时钟已开启 NTP 同步，门口设备以它为准。
• 服务器上 8080（人脸库）、8088（管理界面）、1883（MQTT）端口空闲。
• 「门口设备」按本套餐选：AI 主机。
• 签名密钥和 admin token 自动生成，部署后在本步骤底部「自动生成的密钥」里查看，登录管理界面用 admin token。

• 步骤 1 的 admin token。
• 每人 3 到 8 张清晰的正脸照片。
• 步骤 1 已填写识别服务地址，否则注册的人不会被识别。

• 主机上装好 Docker 与 compose 插件。
• 摄像头的 RTSP 地址已在主机上测通。
• 能访问 sensecraft-statics.seeed.cc，用于下载约 32 MB 模型文件。
• 至少 15 GB 可用空间。首次启动约需 4 分钟（reComputer J40 实测）。
• 门锁类型：断电开门（fail-safe）还是断电保持锁闭（fail-secure）。

• 门口设备已上电并联网。
• 至少注册了一个人。

• 门禁控制器已接好，至少注册了一个人。
• 此人的一张打印照片。
• 步骤 1 的 admin token。

1. 已注册的人站到摄像头前：继电器响一次，管理界面出现放行事件。
2. 马上退开再上前：管理界面出现 debounced，继电器不再响。
3. 举起打印照片：管理界面出现 liveness_failed，继电器不响。
4. 在管理界面「设备」页点开门：继电器响一次，回执为 executed。
5. 删除一个人：30 s 内门不再为他打开，回滚到仍包含此人的版本会被拒绝。
6. 正式使用前：MQTT broker 改用 TLS 和按设备分配的账号，管理界面放到 HTTPS 后面。