智能门禁系统：Windows + Face++ 人脸识别 + Bolt IoT + Arduino 舵机开锁

项目概述

基于「Windows Forms (C#) + Face++ API + Bolt IoT Cloud + Arduino Uno + 舵机」的分布式人脸识别门禁系统。PC 端负责人脸采集、注册、比对 (Face++) 与 Bolt Cloud API 调用；Bolt WiFi 模块作透传网关，将开/关锁指令经 GPIO 传给 Arduino；Arduino 驱动舵机通过尼龙线拉动改装瓶盖联轴机构实现物理开锁。支持门铃按钮触发验证、手动加锁按钮、红绿灯状态指示、蜂鸣器声光反馈。适合抽屉、柜门、鞋柜等小型门禁改造。

系统架构

[Windows PC: 摄像头 + Face++ API + Bolt Cloud API]
        ↑ HTTPS/JSON (指令: D0/D3 高低电平)
[Bolt WiFi Module: 云端透传网关]
        ↑ GPIO 直连 (D0=锁信号, D3=开信号, D4=门铃输入, D6=门铃回传)
[Arduino Uno: 舵机驱动 + 物理机构 + LED/蜂鸣器]

硬件清单

电路连接

Bolt 模块 GPIO 分配

• D0 → Arduino D2 (锁信号，高电平有效)
• D3 → Arduino D3 (开信号，高电平有效)
• D4 ← Arduino D6 (门铃触发回传，高电平 = 按下)
• GND 共地

Arduino 侧引脚

#define ServoPin 4
#define LockSignalPin 2    // 从 Bolt D0
#define UnLockSignalPin 3  // 从 Bolt D3
#define BellButtonPin 5    // 物理门铃按钮 (可选冗余)
#define LockButtonPin 8    // 手动加锁按钮
#define RingBellSignalPin 6 // 向 Bolt D4 回传门铃事件
#define BuzzerPin 7
#define GreenLedPin 9
#define RedLedPin 10

软件核心流程

Windows Forms (C#) 端

1. 初始化：读取配置的 Bolt Device ID / API Key、Face++ API Key/Secret；实例化 Bolt 客户端；启动摄像头预览 (AForge.NET)
2. 人脸注册：按「添加」→ 调用 Face++ Detect API 确认画面有人脸 → 将当前帧 Base64 编码存入本地 Settings (ImageDataList + NameList)
3. 门铃监听线程：后台轮询 Bolt.DigitalRead(D4)，检测到高电平 → 触发 RingBell_Click (抓拍 → 比对 → 开锁)
4. 人脸比对：遍历本地人脸库，调用 Face++ Compare API，confidence > 80% 判定通过 → 调用 UnlockDoor()
5. 开/锁指令：DigitalMultiWrite 同时置 D0/D3 高低电平，脉冲宽度 ~100ms (见代码)，防止抖动误触发

Arduino 端

• setup()：引脚模式、舵机附着、初始红灯亮/绿灯灭 (锁定态)
• loop() 轮询：
  • Bolt D2 高 → 舵机转 120° (锁) + 红灯 + 蜂鸣 1s
  • Bolt D3 高 → 舵机转 0° (开) + 绿灯 + 延时 2s
  • 物理门铃按钮 (D5) 按下 → 置 D6 高回传 Bolt + 蜂鸣铃声模式 + 延时 1.5s 复位 D6
  • 手动加锁按钮 (D8) 按下 → 同 Bolt 锁指令逻辑

机械联轴机构：瓶盖 + 尼龙线

1. 饮料瓶颈部锯下，瓶盖钻孔，拧回瓶颈 → 固定于柜门锁舌轴上
2. 另一瓶盖用铜丝绑定舵机输出臂
3. 尼龙线绑定两瓶盖，张紧长度使舵机 0°↔120° 对应门完全开/锁
4. 热熔胶固定舵机机身于柜体

优点：零成本、自适应间隙、可拆卸。缺点：长期拉伸可能松动，建议定期检查张紧度。

关键代码片段

C# 开锁脉冲

private async Task UnlockDoor() {
  var cfg = new MultiPinConfig();
  cfg.AddPinState(DigitalPins.D0, DigitalStates.Low);   // 锁信号低
  cfg.AddPinState(DigitalPins.D3, DigitalStates.High);  // 开信号高
  await myBolt.DigitalMultiWrite(cfg);
  cfg = new MultiPinConfig();
  cfg.AddPinState(DigitalPins.D0, DigitalStates.Low);
  cfg.AddPinState(DigitalPins.D3, DigitalStates.Low);   // 复位
  await myBolt.DigitalMultiWrite(cfg);
}

Arduino 舵机控制

if (lock == HIGH) {
  myServo.write(120);  // 锁定角度
  digitalWrite(GreenLedPin, LOW);
  digitalWrite(RedLedPin, HIGH);
  beep(1000);
} else if (unlock == HIGH) {
  myServo.write(0);    // 解锁角度
  digitalWrite(GreenLedPin, HIGH);
  digitalWrite(RedLedPin, LOW);
  delay(2000);
}

进阶改进方向

• 离线人脸识别：引入 OpenCV DNN / TensorFlow Lite，脱离 Face++ 云端，保护隐私且零延迟
• 移动端 App：Bolt Cloud 支持 REST API，可开发 Android/iOS App 远程开锁、查看记录
• 多用户权限管理：数据库存储用户/有效期/开锁日志，Web 后台管理
• 防撬报警：加装震动传感器 (SW-420) 接 Bolt/Arduino，触发推送通知
• 电池供电优化：Arduino 低功耗睡眠 + Bolt 深度睡眠，太阳能板充电，实现真无线部署
• 机械升级：改用电磁锁/电控锁舌，替代舵机+尼龙线，提升可靠性与安防等级

常见问题排查

总结

本项目展示了「云端 AI (Face++) + IoT 网关 (Bolt) + 本地执行器 (Arduino)」的经典三层物联网架构。Windows Forms 做人机交互与人脸库管理，Bolt 模块解决了跨网段设备联网难题，Arduino 专注实时舵机控制。瓶盖+尼龙线的低成本机械结构极具创客精神。对于入门物联网、人脸识别集成、云边协同开发的学习者，本项目提供了可落地的完整参考实现。代码与原理图已开源，可直接复现并扩展至智能家居门锁、柜员箱、包裹柜等场景。