ESP32-CAM项目实战：用ESP-WHO和VSCode快速打造一个简易门禁原型

ESP32-CAM实战：从零构建人脸门禁系统的全流程指南

在智能家居和安防领域，人脸识别技术正逐渐从高端商业场景走向日常生活。ESP32-CAM凭借其出色的性价比和丰富的功能接口，成为创客和开发者实现小型人脸识别项目的首选硬件。本文将带您从硬件选型到代码调试，完整实现一个具备实用价值的人脸门禁原型系统。

1. 硬件准备与环境搭建

1.1 核心硬件选型与连接

ESP32-CAM开发板集成了ESP32芯片和OV2640摄像头模块，是构建低成本人脸识别系统的理想选择。以下是关键硬件清单：

硬件连接示意图：

ESP32-CAM GPIO12 → 继电器IN 继电器VCC → 5V电源正极 继电器GND → 5V电源负极 继电器COM → 门锁正极 继电器NO → 门锁负极

注意：实际门锁控制应根据锁具类型调整接线方式，电磁锁通常需要持续供电，而电插锁多为脉冲触发。

1.2 开发环境配置

VSCode配合PlatformIO插件提供了最佳的ESP32开发体验：

1. 安装VSCode后，通过扩展市场添加以下插件：

   • PlatformIO IDE
   • C/C++ IntelliSense
   • CMake Tools

2. 创建新项目：

   pio init --board esp32cam

3. 添加ESP-WHO库依赖： 在platformio.ini中添加：

   lib_deps = https://github.com/espressif/esp-who.git

4. 配置摄像头参数： 在sdkconfig.defaults中设置：

   CONFIG_ESP32_CAMERA_PINS_AI_THINKER=y CONFIG_OV2640_SUPPORT=y

2. 人脸检测核心功能实现

2.1 基础人脸检测流程

ESP-WHO提供了完整的人脸检测流水线，我们只需关注业务逻辑实现：

#include "esp_camera.h" #include "human_face_detect_msr01.hpp" void setup() { // 初始化摄像头 camera_config_t config; config.ledc_channel = LEDC_CHANNEL_0; config.pixel_format = PIXFORMAT_JPEG; // 其他配置参数... esp_camera_init(&config); // 创建人脸检测模型 HumanFaceDetectMSR01 detector(0.3F, 0.3F, 10, 0.3F); } void loop() { camera_fb_t *fb = esp_camera_fb_get(); if (fb) { std::list<dl::detect::result_t> results = detector.infer((uint16_t *)fb->buf, {(int)fb->height, (int)fb->width, 3}); if (!results.empty()) { // 检测到人脸后的处理逻辑 triggerRelay(); } esp_camera_fb_return(fb); } }

2.2 检测结果优化策略

实际部署中需要考虑以下优化点：

• 光照补偿：在低光环境下启用补光灯

  digitalWrite(4, HIGH); // 控制板载LED

• 多帧验证：避免误触发

  int detectionCount = 0; const int threshold = 5; if (!results.empty()) { detectionCount++; if (detectionCount >= threshold) { triggerRelay(); detectionCount = 0; } } else { detectionCount = 0; }

• ROI区域限制：只关注特定区域的人脸

  for (auto &result : results) { if (result.box[0] > 100 && result.box[0] < 200) { // 只在特定水平区域触发 } }

3. 门禁控制逻辑实现

3.1 继电器控制模块

安全可靠的门禁控制需要合理的电气隔离和状态管理：

const int relayPin = 12; bool doorState = false; void setup() { pinMode(relayPin, OUTPUT); digitalWrite(relayPin, HIGH); // 初始保持断开 } void triggerRelay() { digitalWrite(relayPin, LOW); // 激活继电器 delay(500); // 保持500ms digitalWrite(relayPin, HIGH); // 断开继电器 doorState = !doorState; // 切换门状态 Serial.printf("Door %s\n", doorState ? "Opened" : "Closed"); }

3.2 安全机制设计

1. 防尾随检测：

   • 使用超声波传感器监测门后区域
   • 设置开门后自动锁定时间

2. 多重验证：

   bool validateFace(dl::detect::result_t &face) { return face.score > 0.8 && face.box[2] - face.box[0] > 50 && // 最小宽度 face.box[3] - face.box[1] > 60; // 最小高度 }

3. 异常报警：

   void checkSecurity() { static unsigned long lastDetection = 0; if (millis() - lastDetection > 30000) { // 30秒无活动触发警报 soundAlarm(); } }

4. 系统集成与性能优化

4.1 电源管理方案

ESP32-CAM的功耗特性：

低功耗配置示例：

void enterLowPowerMode() { camera_deinit(); WiFi.disconnect(true); esp_sleep_enable_timer_wakeup(30 * 1000000); // 30秒后唤醒 esp_deep_sleep_start(); }

4.2 部署实践要点

1. 摄像头安装角度：

   • 最佳高度：1.5-1.8米
   • 倾斜角度：15-30度向下
   • 检测距离：0.5-2米

2. 环境适应性处理：

   void adjustCameraSettings() { sensor_t *s = esp_camera_sensor_get(); s->set_gain_ctrl(s, 1); // 自动增益 s->set_exposure_ctrl(s, 1); // 自动曝光 s->set_awb_gain(s, 1); // 自动白平衡 }

3. 故障排查流程：

   • 检查电源稳定性
   • 验证GPIO电平状态
   • 监控堆内存使用情况

   Serial.printf("Free heap: %d\n", esp_get_free_heap_size());

5. 进阶功能扩展思路

5.1 人脸识别与授权管理

基于ESP-WHO的人脸识别示例，我们可以构建简单的授权系统：

1. 特征注册流程：

   # PC端特征提取工具 import face_recognition image = face_recognition.load_image_file("user.jpg") encoding = face_recognition.face_encodings(image)[0] print(encoding.tolist()) # 将输出复制到ESP32代码中

2. 嵌入式端比对：

   const float knownEncodings[][128] = { {0.12, -0.23, ...}, // 用户1 {0.08, -0.19, ...} // 用户2 }; bool checkAuthorization(dl::detect::result_t &face) { float distance = 1.0; for (auto &known : knownEncodings) { float currDist = cosineDistance(face.embedding, known); if (currDist < 0.6) return true; } return false; }

5.2 无线管理与OTA更新

1. Web配置界面：

   void startWebServer() { server.on("/", HTTP_GET, [](){ String html = "<form action='/update' method='POST'>"; html += "<input type='file' name='firmware'>"; html += "<input type='submit' value='Update'>"; server.send(200, "text/html", html); }); server.on("/update", HTTP_POST, [](){ server.send(200, "text/plain", Update.hasError() ? "FAIL" : "OK"); }, [](){ HTTPUpload& upload = server.upload(); if (upload.status == UPLOAD_FILE_START) { Update.begin(UPDATE_SIZE_UNKNOWN); } else if (upload.status == UPLOAD_FILE_WRITE) { Update.write(upload.buf, upload.currentSize); } else if (upload.status == UPLOAD_FILE_END) { Update.end(true); } }); }

2. MQTT远程监控：

   void mqttCallback(char* topic, byte* payload, unsigned int length) { if (strcmp(topic, "home/door/command") == 0) { if (payload[0] == '1') triggerRelay(); } } void publishStatus() { client.publish("home/door/status", doorState ? "1" : "0"); }

在实际部署中，我发现OV2640摄像头在低照度环境下表现欠佳，通过添加红外补光灯和调整传感器增益，识别率可以从40%提升到85%以上。另一个实用技巧是在继电器控制回路中加入光耦隔离，能有效防止电磁干扰导致的系统重启。