玩了那么就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_d0
到config.pin_d7
: 分别指定摄像头数据引脚 D0 到 D7 的 GPIO 口。 -
config.pin_xclk
: 摄像头的外部时钟引脚。 -
config.pin_pclk
: 摄像头的像素时钟引脚。 -
config.pin_vsync
: 摄像头的垂直同步引脚。 -
config.pin_href
: 摄像头的行同步引脚。 -
config.pin_sscb_sda
和config.pin_sscb_scl
: 摄像头的 S***B(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