ws-ESP32-S3-CAM: Command for Claude Code

Peripheral cookbook — ESP32-S3-CAM-GC2145

Use the vendor BSP waveshare/esp32_s3_cam_ovxxxx for anything nontrivial. It hides the CH32V003 IO-expander quirks, I²C bus init, camera pin config, and codec addresses. Header: ref/demo/ESP32-S3-CAM-OVxxxx/examples/ESP-IDF-v5.5.1/04_dvp_camera_display/components/waveshare__esp32_s3_cam_ovxxxx/include/bsp/esp32_s3_cam_ovxxxx.h

Dependency Line

# main/idf_component.yml
dependencies:
  waveshare/esp32_s3_cam_ovxxxx: ^1.0.0

Standard Init Sequence

#include "bsp/esp-bsp.h"

bsp_i2c_init();                    // GPIO 7/8 shared bus for everything
bsp_io_expander_init();            // CH32V003 — needed before display/touch/LED
bsp_audio_init(NULL);              // default duplex mono 16-bit 22050 Hz

// Then any of:
esp_codec_dev_handle_t spk = bsp_audio_codec_speaker_init();     // ES8311 DAC
esp_codec_dev_handle_t mic = bsp_audio_codec_microphone_init();  // ES7210 ADC
esp_camera_init(&(camera_config_t)BSP_CAMERA_DEFAULT_CONFIG);    // GC2145
// bsp_display_start() only if an LCD is fitted

---

Camera (GC2145)

Driver auto-detects the sensor. BSP provides a filled-in config macro:

camera_config_t cfg = BSP_CAMERA_DEFAULT_CONFIG;
// cfg: pin_xclk=38, pin_pclk=41, pin_vsync=17, pin_href=18, D0-D7 = 45/47/48/46/42/40/39/21
// cfg: RGB565, QVGA (320×240), 2 framebuffers in PSRAM, XCLK 20 MHz, JPEG q=12
esp_camera_init(&cfg);
sensor_t *s = esp_camera_sensor_get();
s->set_framesize(s, FRAMESIZE_UXGA);    // 1600×1200 if you want max
s->set_pixformat(s, PIXFORMAT_JPEG);    // or RGB565/YUV422

Boot log expectation: 3 E (…) SCCB probe-miss lines for OV2640/OV5640/GC0308 before I (…) gc2145: Detected Camera sensor PID=0x2145. Not errors.

• SCCB shares the main I²C (no separate pins)
• PWDN and RESET are NC — sensor is always powered; no software power-cycle
• XCLK ≥ 16 MHz enables EDMA to PSRAM (faster throughput)

Audio Out (ES8311 → speaker)

esp_codec_dev_handle_t spk = bsp_audio_codec_speaker_init();
esp_codec_dev_sample_info_t fs = {
    .sample_rate = 16000, .channel = 1, .bits_per_sample = 16,
};
esp_codec_dev_open(spk, &fs);
esp_codec_dev_set_out_vol(spk, 70);     // 0-100
esp_codec_dev_write(spk, wav_samples, len);
esp_codec_dev_close(spk);