2.2 KiB
Waveshare non-touch V2 hardware
Target: ESP32-S3-ePaper-1.54 V2 (owner confirmed). Waveshare says V2 uses ESP32-S3-PICO-1-N8R8 with 8 MB flash and 8 MB PSRAM and that V1/V2 examples are not interchangeable. Source: https://docs.waveshare.com/ESP32-S3-ePaper-1.54
The pinned official support commit is aaf395c1bbd86f7c5b7a2f9f0401241ff5c44956. Its Arduino 08_Audio_Test board configuration selects ES8311 with I2C SDA/SCL 47/48 and I2S BCLK 15, WS 38, DOUT 45, DIN 16, MCLK 14, PA 46. The official 04_SD_Card example uses SDMMC CLK 39, D0 40, CMD 41. The sketch's user_config.h matches the official Arduino example for ePaper SPI and power gates. Do not copy M5Stack Atom Echo pins.
The codec API reports success/failure for a requested read, but not the actual byte count. The firmware clears the raw buffer, discards failed reads, and aborts an active clip; short successful reads cannot be measured through this wrapper. AUDIO_MIC_SLOT=0 selects one fixed stereo slot. This assignment is not physically verified; inspect a V2 recording and slot levels before field deployment.
The firmware retains the Arduino sketch layout because the official support expects that structure and no PlatformIO toolchain is currently installed. Use Arduino IDE 2.x, Espressif ESP32 Arduino core 3.3.12, board ESP32S3 Dev Module, 8 MB flash, enabled 8 MB PSRAM, Waveshare's pinned LVGL8 (lvgl 8.4.0), and ArduinoJson 7.4.3. Run ./prepare_from_waveshare.sh to copy the pinned official support. The copied support and build products are ignored by Git. The codec_board support has Espressif Modified MIT licensing, esp_codec_dev has Apache-2.0, ArduinoJson has MIT, and LVGL has MIT. The Waveshare repository has no top-level license statement; preserve upstream attribution and check redistribution terms before vendoring its files.
Build, flash, and serial monitor from Arduino IDE at 115200 baud. Arduino CLI 1.5.1 compiled this sketch with ESP32 core 3.3.12, FlashSize=8M, PSRAM=opi, and PartitionScheme=default_8MB. The reported program size was 1,513,404 bytes (45% of the selected application partition), with 101,808 bytes (31%) of global dynamic memory. A successful compile does not establish microphone, display, SD, TLS, or power behavior; no board was flashed.