Skip to content

Latest commit

 

History

History
93 lines (59 loc) · 4.17 KB

README_CN.md

File metadata and controls

93 lines (59 loc) · 4.17 KB

ESP-WHO [English]

ESP-WHO 是基于乐鑫芯片的图像处理开发平台,其中包含了实际应用中可能出现的开发示例。

概述

ESP-WHO 提供了人脸检测、人脸识别、行人检测等示例。您可以基于这些示例,衍生出丰富的实际应用。ESP-WHO 的运行基于 ESP-IDF。ESP-DL 为 ESP-WHO 提供了丰富的深度学习相关接口,配合各种外设可以实现许多有趣的应用。

新功能

  1. 该仓库已完全重构。适配新版 ESP-DL
  2. 支持新芯片 ESP32-P4
  3. 摄像头和深度学习模型现在异步执行,可实现更高的帧率。
  4. 添加 lvgl(轻量级多功能图形库) 支持,您可以自由开发自己的图形应用程序。
  5. 添加了新的行人检测模型。

某些芯片(如 esp32 和 esp32-s2)以及示例(如猫脸检测、颜色检测、二维码识别)目前不在此分支中,还未适配完成。旧分支可在此处找到。 老 ESP-WHO 分支

准备工作

硬件准备

我们推荐新手开发者使用乐鑫设计的开发板。ESP-WHO 提供的示例基于以下乐鑫开发板开发,开发板与芯片的对应关系如下表所示。

芯片 ESP32-S3 ESP32-P4
开发板 ESP-S3-EYE ESP32-P4-Function-EV-Board

使用上表中未提及的开发板,需要手动修改外设的管脚配置,例如摄像头、LCD 和按键等。

软件准备

获取 ESP-IDF

ESP-WHO 在 ESP-IDF release/v5.4 分支上运行。有关获取 ESP-IDF 的详细信息,请参阅 ESP-IDF 编程指南

获取 ESP-WHO

在终端中运行以下命令下载 ESP-WHO:

git clone https://github.com/espressif/esp-who.git

运行示例

ESP-WHO 的所有示例都存放在 examples 中。该文件夹架构如下所示:

├── examples
│   ├── human_face_detect       // 仅使用esp_lcd,帧率高
│   ├── human_face_detect_lvgl  // 帧率较低,但是图形库更强大
│   ├── human_face_recognition  // 和实体按键(s3)或者触摸屏(p4)交互
│   │                           // 体验人脸识别示例
│   ├── pedestrian_detect
│   └── pedestrian_detect_lvgl  

对于硬件准备中所提到的开发板,所有示例都是开箱即用的,要运行示例仅需执行步骤 1:硬件连接步骤 2:设置目标芯片步骤 4:运行和监视

步骤 1:硬件连接

如果您使用的是 ESP32-P4-Function-EV-Board,请按照用户指南ESP32-P4 用户指南将摄像头和液晶显示屏连接到开发板。

步骤 2:设置目标芯片

打开终端并转到存储示例的任何文件夹(例如 examples/human_face_detection)。运行以下命令设置目标芯片:

idf.py set-target [SoC]

将 [SoC] 替换为您的目标芯片,例如 esp32s3、esp32p4

步骤 3:(可选)更改 menuconfig 中的选项

除了默认配置外,示例中可能还有一些您可以自由修改的选项。有关更多详细信息,请阅读示例下的 README.md。

idf.py menuconfig

步骤 4:运行和监视

烧录程序,运行 IDF 监视器:

idf.py flash monitor

反馈

如果在使用中发现任何问题,请提交相关 issue,我们将尽快予以答复。