camera.h

 
#pragma once
 
#include "esp_camera.h"
#include "pins.h" // Camera bus GPIOs (pins::CAM_*)
 
typedef struct {
    void* buffer;
    size_t length;
    size_t width;
    size_t height;
} camera_buffer_t;
 
class Camera
{
private:
    camera_config_t _config; 
 
public:
    Camera()
    {
        this->_config.ledc_channel = LEDC_CHANNEL_0;
        this->_config.ledc_timer = LEDC_TIMER_0;
        this->_config.pin_d0 = pins::CAM_Y2;
        this->_config.pin_d1 = pins::CAM_Y3;
        this->_config.pin_d2 = pins::CAM_Y4;
        this->_config.pin_d3 = pins::CAM_Y5;
        this->_config.pin_d4 = pins::CAM_Y6;
        this->_config.pin_d5 = pins::CAM_Y7;
        this->_config.pin_d6 = pins::CAM_Y8;
        this->_config.pin_d7 = pins::CAM_Y9;
        this->_config.pin_xclk = pins::CAM_XCLK;
        this->_config.pin_pclk = pins::CAM_PCLK;
        this->_config.pin_vsync = pins::CAM_VSYNC;
        this->_config.pin_href = pins::CAM_HREF;
        this->_config.pin_sccb_sda = pins::CAM_SIOD;
        this->_config.pin_sccb_scl = pins::CAM_SIOC;
        this->_config.pin_pwdn = pins::CAM_PWDN;
        this->_config.pin_reset = pins::CAM_RESET;
 
        this->_config.xclk_freq_hz = 12000000; // not 20 MHz: it cripples WiFi (docs/engineering-notes.md section 3)
        this->_config.pixel_format = PIXFORMAT_JPEG; // the /stream WebSocket sends JPEG frames as they are
        this->_config.frame_size = FRAMESIZE_QVGA;   // 320x240
        // 0-63, lower = bigger files. 18 keeps heavy-scene frames small enough for the detection decode budget and
        // WiFi; 12 made close-up scenes 2.5-4x bigger (measured 2026-10-13).
        this->_config.jpeg_quality = 18;
        this->_config.fb_count = 2; // the driver fills one buffer while the camera task copies the other
        this->_config.fb_location = CAMERA_FB_IN_PSRAM;
        this->_config.grab_mode = CAMERA_GRAB_LATEST;
    }
 
    bool begin();
};