ESP32_CAM CameraWebServer例程源码解析笔记(一)

玩了那么就cam都玩坏不知道多少个了(还好用的老师的不然得心疼死),但好像没有沉下心来好好看过它的例程源码。正好最近想搞一下linux下的监控项目,所以想先来看看这段代码多学习学习。

首先我们先来看看主函数

#include "esp_camera.h"
#include <WiFi.h>

//
// WARNING!!! PSRAM IC required for UXGA resolution and high JPEG quality
//            Ensure ESP32 Wrover Module or other board with PSRAM is selected
//            Partial images will be transmitted if image exceeds buffer size
//
//            You must select partition scheme from the board menu that has at least 3MB APP space.
//            Face Recognition is DISABLED for ESP32 and ESP32-S2, because it takes up from 15 
//            seconds to process single frame. Face Detection is ENABLED if PSRAM is enabled as well

// ===================
// Select camera model
// ===================
//#define CAMERA_MODEL_WROVER_KIT // Has PSRAM
//#define CAMERA_MODEL_ESP_EYE // Has PSRAM
//#define CAMERA_MODEL_ESP32S3_EYE // Has PSRAM
//#define CAMERA_MODEL_M5STACK_PSRAM // Has PSRAM
//#define CAMERA_MODEL_M5STACK_V2_PSRAM // M5Camera version B Has PSRAM
//#define CAMERA_MODEL_M5STACK_WIDE // Has PSRAM
//#define CAMERA_MODEL_M5STACK_ESP32CAM // No PSRAM
//#define CAMERA_MODEL_M5STACK_UNITCAM // No PSRAM
#define CAMERA_MODEL_AI_THINKER // Has PSRAM
//#define CAMERA_MODEL_TTGO_T_JOURNAL // No PSRAM
// ** Espressif Internal Boards **
//#define CAMERA_MODEL_ESP32_CAM_BOARD
//#define CAMERA_MODEL_ESP32S2_CAM_BOARD
//#define CAMERA_MODEL_ESP32S3_CAM_LCD

#include "camera_pins.h"

// ===========================
// Enter your WiFi credentials
// ===========================
const char* ssid = "**********";            //wifi账号密码,用户自行填写(一般用用只需要改这个就行)
const char* password = "**********";

void startCameraServer();

void setup() {
  Serial.begin(115200);
  Serial.setDebugOutput(true);
  Serial.println();

  camera_config_t config;             //摄像头参数设置
  config.ledc_channel = LEDC_CHANNEL_0;
  config.ledc_timer = LEDC_TIMER_0;
  config.pin_d0 = Y2_GPIO_NUM;
  config.pin_d1 = Y3_GPIO_NUM;
  config.pin_d2 = Y4_GPIO_NUM;
  config.pin_d3 = Y5_GPIO_NUM;
  config.pin_d4 = Y6_GPIO_NUM;
  config.pin_d5 = Y7_GPIO_NUM;
  config.pin_d6 = Y8_GPIO_NUM;
  config.pin_d7 = Y9_GPIO_NUM;
  config.pin_xclk = XCLK_GPIO_NUM;
  config.pin_pclk = PCLK_GPIO_NUM;
  config.pin_vsync = VSYNC_GPIO_NUM;
  config.pin_href = HREF_GPIO_NUM;
  config.pin_sscb_sda = SIOD_GPIO_NUM;
  config.pin_sscb_scl = SIOC_GPIO_NUM;
  config.pin_pwdn = PWDN_GPIO_NUM;
  config.pin_reset = RESET_GPIO_NUM;
  config.xclk_freq_hz = 20000000;
  config.frame_size = FRAMESIZE_UXGA;
  config.pixel_format = PIXFORMAT_JPEG; // for streaming
  //config.pixel_format = PIXFORMAT_RGB565; // for face detection/recognition
  config.grab_mode = CAMERA_GRAB_WHEN_EMPTY;
  config.fb_location = CAMERA_FB_IN_PSRAM;
  config.jpeg_quality = 12;
  config.fb_count = 1;

前面的一些宏定义主要是用来选择我们的摄像头种类。

camera_config_t结构体中包含一些摄像头初始化需要的参数

  1. config.ledc_channel: 指定 LED 控制通道,LED 控制用于配置某些特殊的引脚。

  2. config.ledc_timer: 指定 LED 控制的定时器。

  3. config.pin_d0config.pin_d7: 分别指定摄像头数据引脚 D0 到 D7 的 GPIO 口。

  4. config.pin_xclk: 摄像头的外部时钟引脚。

  5. config.pin_pclk: 摄像头的像素时钟引脚。

  6. config.pin_vsync: 摄像头的垂直同步引脚。

  7. config.pin_href: 摄像头的行同步引脚。

  8. config.pin_sscb_sdaconfig.pin_sscb_scl: 摄像头的 S***B(Serial Camera Control Bus)通信引脚,用于配置和控制摄像头的参数。

  9. config.pin_pwdn: 摄像头的电源关闭引脚。

  10. config.pin_reset: 摄像头的复位引脚。

  11. config.xclk_freq_hz: 外部时钟的频率,这里设置为 20,000,000 Hz(20 MHz)。

  12. config.frame_size: 摄像头输出的图像帧大小,这里设置为 FRAMESIZE_UXGA,表示Ultra eXtended Graphics Array,是一种分辨率为 1600x1200 的图像大小。

  13. config.pixel_format: 图像的像素格式,这里设置为 PIXFORMAT_JPEG,表示输出 JPEG 格式的图像,用于流式传输。

  14. config.grab_mode: 设置图像数据的抓取模式,这里设置为 CAMERA_GRAB_WHEN_EMPTY,表示在缓冲区为空时抓取图像。

  15. config.fb_location: 摄像头图像缓冲区的位置,这里设置为 CAMERA_FB_IN_PSRAM,表示使用 PSRAM 存储图像数据。

  16. config.jpeg_quality: 如果图像格式是 JPEG,这里设置 JPEG 的质量,这里设置为 12。

  17. config.fb_count: 摄像头图像缓冲区的数量,这里设置为 1。

if(config.pixel_format == PIXFORMAT_JPEG){
    if(psramFound()){
      config.jpeg_quality = 10;
      config.fb_count = 2;
      config.grab_mode = CAMERA_GRAB_LATEST;
    } else {
      // Limit the frame size when PSRAM is not available
      config.frame_size = FRAMESIZE_SVGA;
      config.fb_location = CAMERA_FB_IN_DRAM;
    }
  } else {
    // Best option for face detection/recognition
    config.frame_size = FRAMESIZE_240X240;
#if CONFIG_IDF_TARGET_ESP32S3
    config.fb_count = 2;
#endif
  }

#if defined(CAMERA_MODEL_ESP_EYE)
  pinMode(13, INPUT_PULLUP);
  pinMode(14, INPUT_PULLUP);
#endif

这段代码是针对不同摄像头对config进行不同的配置。

 // camera init
  esp_err_t err = esp_camera_init(&config);          //启动摄像头
  if (err != ESP_OK) {
    Serial.printf("Camera init failed with error 0x%x", err);
    return;
  }

  sensor_t * s = esp_camera_sensor_get();
  // initial sensors are flipped vertically and colors are a bit saturated
  if (s->id.PID == OV3660_PID) {
    s->set_vflip(s, 1); // flip it back
    s->set_brightness(s, 1); // up the brightness just a bit
    s->set_saturation(s, -2); // lower the saturation
  }
  // drop down frame size for higher initial frame rate
  if(config.pixel_format == PIXFORMAT_JPEG){
    s->set_framesize(s, FRAMESIZE_QVGA);
  }

#if defined(CAMERA_MODEL_M5STACK_WIDE) || defined(CAMERA_MODEL_M5STACK_ESP32CAM)
  s->set_vflip(s, 1);
  s->set_hmirror(s, 1);
#endif

#if defined(CAMERA_MODEL_ESP32S3_EYE)
  s->set_vflip(s, 1);
#endif

sensor_t结构体主要用来对摄像头传感器的各项参数进行设置

typedef struct _sensor {
    sensor_id_t id;             // 传感器ID。
    uint8_t  slv_addr;          // 传感器I2C从机地址。
    pixformat_t pixformat;      // 像素格式。
    camera_status_t status;     // 摄像头状态。
    int xclk_freq_hz;           // XCLK频率(时钟频率)。

    // 传感器函数指针
    int  (*init_status)         (sensor_t *sensor);             // 初始化状态。
    int  (*reset)               (sensor_t *sensor);             // 重置传感器配置,并在重置成功时返回ESP_OK。
    int  (*set_pixformat)       (sensor_t *sensor, pixformat_t pixformat);  // 设置像素格式。
    int  (*set_framesize)       (sensor_t *sensor, framesize_t framesize);  // 设置帧大小。
    int  (*set_contrast)        (sensor_t *sensor, int level);  // 设置对比度。
    int  (*set_brightness)      (sensor_t *sensor, int level);  // 设置亮度。
    int  (*set_saturation)      (sensor_t *sensor, int level);  // 设置饱和度。
    int  (*set_sharpness)       (sensor_t *sensor, int level);  // 设置锐度。
    int  (*set_denoise)         (sensor_t *sensor, int level);  // 设置降噪。
    int  (*set_gainceiling)     (sensor_t *sensor, gainceiling_t gainceiling);  // 设置增益上限。
    int  (*set_quality)         (sensor_t *sensor, int quality);  // 设置图像质量。
    int  (*set_colorbar)        (sensor_t *sensor, int enable);  // 设置彩条。
    int  (*set_whitebal)        (sensor_t *sensor, int enable);  // 设置白平衡。
    int  (*set_gain_ctrl)       (sensor_t *sensor, int enable);  // 设置增益控制。
    int  (*set_exposure_ctrl)   (sensor_t *sensor, int enable);  // 设置曝光控制。
    int  (*set_hmirror)         (sensor_t *sensor, int enable);  // 设置水平镜像。
    int  (*set_vflip)           (sensor_t *sensor, int enable);  // 设置垂直翻转。

    int  (*set_aec2)            (sensor_t *sensor, int enable);  // 设置AEC2。
    int  (*set_awb_gain)        (sensor_t *sensor, int enable);  // 设置AWB增益。
    int  (*set_agc_gain)        (sensor_t *sensor, int gain);    // 设置AGC增益。
    int  (*set_aec_value)       (sensor_t *sensor, int gain);    // 设置AEC值。

    int  (*set_special_effect)  (sensor_t *sensor, int effect);  // 设置特效。
    int  (*set_wb_mode)         (sensor_t *sensor, int mode);    // 设置白平衡模式。
    int  (*set_ae_level)        (sensor_t *sensor, int level);   // 设置AE级别。

    int  (*set_dcw)             (sensor_t *sensor, int enable);  // 设置DCW。
// 设置坏像素校正(BPC)功能
    int  (*set_bpc) (sensor_t *sensor, int enable);
    
    // 设置白平衡校正(WPC)功能
    int  (*set_wpc) (sensor_t *sensor, int enable);

    // 设置原始图像 Gamma 校正功能
    int  (*set_raw_gma) (sensor_t *sensor, int enable);
    
    // 设置镜头校正(LENC)功能
    int  (*set_lenc) (sensor_t *sensor, int enable);

    // 获取寄存器值
    int  (*get_reg) (sensor_t *sensor, int reg, int mask);
    
    // 设置寄存器值
    int  (*set_reg) (sensor_t *sensor, int reg, int mask, int value);
    
    // 设置原始图像分辨率
    int  (*set_res_raw) (sensor_t *sensor, int startX, int startY, int endX, int endY, int offsetX, int offsetY, int totalX, int totalY, int outputX, int outputY, bool scale, bool binning);
    
    // 设置相位锁定环(PLL)参数
    int  (*set_pll) (sensor_t *sensor, int bypass, int mul, int sys, int root, int pre, int seld5, int pclken, int pclk);
    
    // 设置外部时钟(XCLK)参数
    int  (*set_xclk) (sensor_t *sensor, int timer, int xclk);
} sensor_t;
 WiFi.begin(ssid, password);
  WiFi.setSleep(false);

  while (WiFi.status() != WL_CONNECTED) {
    delay(500);
    Serial.print(".");
  }
  Serial.println("");
  Serial.println("WiFi connected");

  startCameraServer();

  Serial.print("Camera Ready! Use 'http://");
  Serial.print(WiFi.localIP());
  Serial.println("' to connect");
}

void loop() {
  // Do nothing. Everything is done in another task by the web server
  delay(10000);
}

这段代码就是简单的连接wifi和串口打印数据,只有一个特殊的函数在这里被调用 startCameraServer()

在后面loop中的注释中我们也可以了解这个程序主要的逻辑实现都在该函数中。接下来我们跟着这个函数的定义进入下一个文件 app_httpd

转载请说明出处内容投诉
CSS教程_站长资源网 » ESP32_CAM CameraWebServer例程源码解析笔记(一)

发表评论

欢迎 访客 发表评论

一个令你着迷的主题!

查看演示 官网购买