Commit Graph

1 Commits

Author SHA1 Message Date
David Montero Crespo 20bda8e427 docs(examples): add ESP32-CAM + ILI9341 live preview example
First end-user demo of the new ESP32-CAM emulation capability —
shows how to wire an ESP32-CAM to an ILI9341 320×240 SPI TFT,
decode JPEG frames from the emulated webcam with jpg2rgb565()
(built into esp32-camera/conversions, header now exposed by the
Velxio compile template), and render the resulting RGB565 bitmap
to the screen at ~10 fps.

Two sketches in the same example folder:

- esp32-cam-lcd-preview.ino — full demo: decode JPEG → render the
  bitmap (160×120 centered in the TFT) + status bar with fps,
  frame counter, decode-fail counter, live pulse dot.

- esp32-cam-lcd-status.ino — companion that doesn't decode the
  JPEG; instead it shows a status dashboard (frame counter, byte
  histogram, JPEG header hex dump). Useful when the source JPEG
  exceeds the deliverable byte budget and jpg2rgb565 fails on the
  truncation.

diagram.json wires the two parts using velxio-esp32-cam +
wokwi-ili9341 part types over VSPI:
   ILI9341 ↔ ESP32-CAM
   CS ↔ GPIO 15, RST ↔ GPIO 2, D/C ↔ GPIO 14,
   MOSI ↔ GPIO 13, SCK ↔ GPIO 12

libraries.txt lists Adafruit GFX + Adafruit ILI9341. esp_camera.h
and img_converters.h ship with arduino-esp32 — no extra install.

Adds examples/README.md as the index for future demos.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-02 22:14:42 -03:00