## 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](https://github.com/ultramcu/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](https://github.com/ultramcu/guition-jc4880p4-bsp/blob/main/src/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](https://github.com/pschatzmann/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](https://github.com/pschatzmann/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

-   [arduino-audio-tools](https://github.com/pschatzmann/arduino-audio-tools)
    (`audio-out`, `audio-in`, `player-sdmmc`)
-   [arduino-audio-driver](https://github.com/pschatzmann/arduino-audio-driver)
    (`audio-out`, `audio-in`, `player-sdmmc`)
-   [codec-helix](https://github.com/pschatzmann/codec-helix)
    (`player-sdmmc`)
-   [TinyGPU](https://github.com/pschatzmann/TinyGPU) (`lcd-test`)
-   `sdmmc-test`, `wifi-test` need no extra library beyond what
    arduino-esp32 itself bundles (`SD_MMC`, `WiFi`/`esp32-hal-hosted.h`).

## Further Info

-   https://github.com/ultramcu/guition-jc4880p4-bsp