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

m0_62364527 2024-06-22 12:03:08 阅读 93

玩了那么就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结构体中包含一些摄像头初始化需要的参数

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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



声明

本文内容仅代表作者观点,或转载于其他网站,本站不以此文作为商业用途
如有涉及侵权,请联系本站进行删除
转载本站原创文章,请注明来源及作者。