Jannis/BirdNet-goMikrofon
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
BirdNet-goMikrofon/Arduino-audio-tools-main/arduino-audio-tools-main/examples/examples-custom-boards/esp32-p4-480x800-guition-mipi-dsi-touch-display/README.md
Jannis 2316edfd4b Done
2026-09-26 01:20:55 +02:00

5.9 KiB
Raw Permalink Blame History

Guition JC4880P443C_I_W (ESP32-P4, 4.3" MIPI-DSI Touch Display)

Status: TESTED. Confirmed working on real hardware.

Hardware

  • MCU: ESP32-P4 (dual-core RISC-V @ 400MHz) + ESP32-C6 Wi-Fi/BT co-processor over SDIO (ESP-Hosted)
  • Display: 4.3", 480x800, ST7701S over MIPI-DSI (2-lane)
  • Touch: GT911 capacitive, I2C
  • Audio: ES8311 codec + NS4150 speaker amp
  • Storage: microSD via SDMMC (4-bit), separate bus from the C6's Wi-Fi SDIO
  • Power: IP5306 Li-ion charger (single-cell, connector CN4)
  • 32MB QSPI PSRAM, 16MB QIO flash

Known risk

This board's ESP32-P4 is an engineering-sample chip (rev v1.3). The guition-jc4880p4-bsp library - not itself a dependency of these examples (see Dependencies below), but the source of the pin map and ST7701S init sequence facts used here - documents that under PlatformIO this board requires "chip_variant": "esp32p4_es" and a pinned toolchain (pioarduino 55.03.36-1), or it hits "Illegal instruction" at the 2nd-stage bootloader. These examples instead target arduino-cli's generic esp32:esp32:esp32p4 board, which has been confirmed to work on real hardware.

Pins

Source: board_p4_pins.h in guition-jc4880p4-bsp - documented there as "on-hardware VERIFIED" for display/touch/SD/Wi-Fi; the audio pins are board-documented but "not driven by the core BSP" (i.e. not exercised by that library). These examples only reuse the pin/timing/register facts, not the library itself - see Dependencies below.

Function Pins
Display (ST7701S MIPI-DSI) RST=5, Backlight=23 (LEDC PWM). DSI is 2 PHY lanes @ 500Mbps, not GPIOs.
Touch I2C (GT911) SDA=7, SCL=8 (shared with codec I2C), RST=3, INT unused (polled); address 0x5D, falls back to 0x14
Audio I2S (ES8311) MCLK=13, BCK=12, WS=10, DOUT=9, DIN=48
Codec I2C (ES8311) SDA=7, SCL=8 (same bus as touch)
Amp enable (NS4150) GPIO11 - polarity not documented, assumed active-high here, see audio-out.ino
SD (SDMMC, 4-bit) CLK=43, CMD=44, D0=39, D1=40, D2=41, D3=42. TF_VCC is powered from on-chip LDO channel 4 @ 3.3V, not a GPIO - see sdmmc-test.ino
Wi-Fi/BT (ESP32-C6 over ESP-Hosted SDIO) CLK=18, CMD=19, D0=14, D1=15, D2=16, D3=17, C6 reset=54. Separate bus from the SD card's SDMMC, so both run together - see wifi-test.ino

Setup

  1. Install TinyGPU as an Arduino library (needed by lcd-test).
  2. Build with FQBN esp32:esp32:esp32p4 (or your board manager's equivalent).

No other third-party libraries are needed - none of these examples depend on guition-jc4880p4-bsp or its esp_lcd_touch_gt911 vendoring (earlier versions of lcd-test did; see Examples below).

Examples

  • lcd-test - the same SpriteDisplay RGB-test/greyscale-test pattern as this repo's other lcd-test examples (tap to toggle between a red/green/blue band test and a 20-band greyscale ramp), via TinyGPU rather than guition-jc4880p4-bsp's own framebuffer/touch API: this board's ST7701S MIPI-DSI panel drove the addition of a new DisplayDriverDSI/ST7701Driver to TinyGPU itself (DBI command-channel + DPI video-channel plumbing, plus this panel's init register sequence - transcribed verbatim from the BSP's board_p4_st7701_init.h/board_p4.c, which documents it as VERIFIED-ON-HARDWARE on this exact board), and touch needed no new TinyGPU code at all - GT911 is a plain I2C part, and TinyGPU's existing TouchDriverGT911 (already proven on a different GT911 board in this repo) is entirely MCU/BSP-agnostic.
  • audio-out - sine wave playback through the ES8311/NS4150 path via I2SCodecStream. No existing arduino-audio-driver board entry covers this board, so the example uses the driver's GenericES8311 board (the generic ES8311 codec driver with no predefined pins - same pattern the wiki documents for GenericWM8960/ES8388): Wire is set up manually for codec I2C, I2S pins are set directly on the stream config, and the NS4150 amp-enable pin is toggled manually (there's no PinFunction::PA pin on a Generic* board).
  • audio-in - reads the ES8311's ADC path and prints PCM samples to Serial as CSV, via I2SCodecStream/GenericES8311 (see audio-out above). Confirmed on real hardware - the board has a working onboard microphone.
  • sdmmc-test - brings up the microSD card over SD_MMC in 4-bit mode, writes/reads a test file, lists the root directory. Needs SD_MMC.setPowerChannel(4) before begin() on this board - see its header comment and the Pins table above.
  • player-sdmmc - MP3 playback off the microSD card (AudioSourceSDMMC + MP3DecoderHelix) through the ES8311/NS4150 path via I2SCodecStream/GenericES8311.
  • wifi-test - connects to a Wi-Fi AP via the onboard ESP32-C6 (ESP-Hosted over SDIO) and prints the assigned IP. Needs hostedSetPins() before WiFi.begin() since this board's C6 SDIO wiring doesn't match arduino-esp32's default pins - see its header comment for a real, BSP-documented firmware-version-mismatch risk on this specific board's Wi-Fi.

Dependencies

Further Info