JC3636W518EN/CLAUDE.md

JC3636W518EN — Project Notes

Vendor kit and documentation for the JC3636W518 (Shenzhen Jingcai / JCZN, Guition), a round 1.8" ESP32-S3 touch-display puck. Goal: write a new custom program for this device.

Working agreement (from the user)

• Before starting any task, ask questions first and make sure requirements are clearly understood.
• While working, describe what is being done at each step.
• Keep this file updated with new findings.

Hardware summary

Item	Detail
MCU	ESP32-S3R8 (dual-core LX7 @ 240 MHz, 512 KB SRAM, 8 MB OPI PSRAM in-package)
Flash	16 MB confirmed (esptool flash_id: mfr 0x85, dev 0x2018, quad mode). Chip rev v0.2, MAC f0:9e:9e:1e:60:40
Radio	WiFi + BLE 5 only — NO Bluetooth Classic (ESP32-S3 has no BR/EDR, so no SPP / BluetoothSerial)
Connection	Board shows up on COM21 on this PC. esptool: %LOCALAPPDATA%\Arduino15\packages\esp32\tools\esptool_py\4.6\esptool.exe
Display	1.8" round IPS, 360×360, driver ST77916 over QSPI, RGB565 used (panel is 262K/18-bit)
Touch	CST816S capacitive, I2C (addr 0x15), single touch + gestures
Audio out	PCM5100A I2S DAC → 3.5 mm line-out jack (no speaker amp on board)
Microphone	MSM261S4030H0R I2S MEMS mic ("pickup port")
Storage	microSD (TF) slot, 4-bit SD_MMC
Button	BOOT button on GPIO0 (only user button)
Power	5 V USB-C (~180 mA), plus Qi wireless receiver (standalone, no MCU signals)
USB	Native USB (GPIO19/20) — USB-CDC serial, no separate USB-UART chip
Expansion	CN2 4-pin connector: 5V, GPIO39, GPIO38, GND (the only free GPIOs)
Size	58 × 58 × 11 mm metal case, active area 45.68 × 45.68 mm

Pin map (from pincfg.h, cross-checked against schematic)

LCD QSPI : CS=10  SCK=9  D0=11 D1=12 D2=13 D3=14  RST=47  BL=15 (PWM, LEDC, via AO3400 MOSFET)
           LCD_TE is on the FPC; schematic net near GPIO47/RST is hard to read — treat TE as unused
Touch I2C: SDA=7  SCL=8  INT=41  RST=40
SD_MMC   : CLK=3  CMD=4  D0=2  D1=1  D2=6  D3=5
DAC I2S  : BCK=18 WS/LRCK=16 DOUT=17  MCK=21 (code uses -1, PCM5100A PLLs from BCK)  MUTE/XSMT=48 (LOW = mute)
Mic I2S  : SCK=42 WS=45 SD=46
Button   : GPIO0 (BOOT)
Free     : GPIO38, GPIO39 (on CN2 header)
USB      : D-=19 D+=20

Software stack used by the vendor demo

• Arduino IDE + arduino-esp32 core ≥ 3.0.1 (core 3.0.5 already installed on this PC under %LOCALAPPDATA%\Arduino15).
• Libraries (bundled in 2-Program Example/Demo_Arduino/library/):
  • ESP32_Display_Panel 0.1.4 (Espressif) — ST77916 QSPI LCD + CST816S touch + backlight
  • ESP32_IO_Expander 0.0.2 (dependency)
  • lvgl 8.3.11 bundled (instructions say "8.4.0 and below"; LVGL 9 is NOT supported by the demo)
• lv_conf.h must be copied next to the lvgl library folder (Documents\Arduino\libraries\lv_conf.h); for the LVGL demos, move lvgl/demos into lvgl/src/.
• Key lv_conf.h settings: LV_COLOR_DEPTH 16, LV_COLOR_16_SWAP 1, LV_MEM_CUSTOM 1 (uses malloc → can use PSRAM), LV_TICK_CUSTOM 1, LV_USE_GIF 1, LV_USE_PNG 1, LV_USE_SJPG 1, Montserrat 48 enabled.
• None of these libraries are currently in Documents\Arduino\libraries (only unrelated Adafruit libs). No arduino-cli / PlatformIO / ESP-IDF installed. Python 3.12 and git are available.

Arduino board settings (from Arduino set up.png)

Board ESP32S3 Dev Module, USB CDC On Boot Enabled, CPU 240 MHz, Flash QIO 120 MHz, Flash Size 16 MB, Partition Huge APP (3MB No OTA/1MB SPIFFS), PSRAM OPI PSRAM, Upload Mode UART0/Hardware CDC, Upload speed 921600. If upload fails: hold BOOT (GPIO0) while plugging in / resetting.

Display driver pattern (scr_st77916.h)

scr_lvgl_init() does everything: LEDC backlight → CST816S on I2C @400 kHz → QSPI bus @50 MHz → ESP_PanelLcd_ST77916(bus, 16bpp, RST) → invertColor(true) → LVGL draw buffer of 72 rows (360×72×2 = ~52 KB, internal RAM) → flush callback with DMA-done callback → touch indev. Helpers: setRotation(0..3), set_brightness(0..100), screen_switch(bool). Note: scr_lvgl_init() already calls lv_init(); the demo .ino calls it again (redundant).

Folder contents

Folder	What it is
1-Instructions	Spec PDF (duplicate), AIDA64 remote-sensor layout aida_remote_1.85.rslcd, MJPEG conversion tool (Windows .NET, converts video to 360×360 MJPEG 25 fps)
2-Program Example/Demo_Arduino	Libraries, sd/ (SD card listing example), ST77916_LVGL_DEMO/ (main LVGL demo)
…/ST77916_LVGL_DEMO/8.4	Clean LVGL 8.x demo version
…/ST77916_LVGL_DEMO/9.1	Broken / half-ported LVGL 9 attempt (garbled code, touch commented out) — don't use
…/ST77916_LVGL_DEMO/working version	Earlier working copy
…/ST77916_LVGL_DEMO/*.ino (top level)	Modified (not vendor) — plays a large GIF compiled in (loligod.c, 13.9 MB C array) + WiFi HTTP client polling http://192.168.4.1/speed
…/esp23_elm327_to_wifi	Companion sketch for a second ESP32: Bluetooth ELM327 (OBD-II) → WiFi AP "ESP32-Access-Point" serving /speed (needs esp32 core 2.0.x, ESPAsyncWebServer, ELMduino)
…/ELMulator-master	ELM327 emulator (zip) for testing OBD without a car
…/gifs	GIF assets (+ dump/)
…/montserrat_100.c	Custom 100 px Montserrat font (digits, for large speed readout)
3-Specification	Spec sheet (factory firmware features, interface photo)
4-Chip manual	ESP32-S3R8 datasheet, PCM5100A datasheet
5-Dimension	Mechanical drawings (JPG + DWG)
6-Schematic diagram	5 pages: power/USB/SD/mic, ESP32-S3, DAC, LCD FPC, Qi receiver
7-User's manual	"Getting started" — Arduino IDE setup, library install steps (16 pages)
8-Tool	Network debugging assistant, SSCOM serial tool (Chinese Windows tools, .rar)
9-Burn	Espressif Flash Download Tool 3.9.3, factory demo 1.85_demo.bin (1.7 MB, flash at 0x0), screenshots. logs/ are old (2022) logs from other boards — ignore

Factory firmware (for reference)

AIDA64 secondary screen (18 styles), mic spectrum, MP3 player (/music on SD), photo frame (/pic, 360×360 JPEG), MJPEG player (/mjpeg), weather, theme clocks, WiFi provisioning AP "My App"/12345678 + web config at device IP. Re-flash it with Flash Download Tool: ESP32-S3, 1.85_demo.bin @ 0x0.

Gotchas / observations

• Display is round: corners of the 360×360 framebuffer are not visible — design UI within a 360 px circle.
• Compiling a 13.9 MB GIF into the firmware will not fit "Huge APP" (3 MB); large media should live on SD (or in a custom partition).
• The top-level demo setup() returns early if no SD card is present, before showing anything.
• Draw buffer is in internal RAM; PSRAM is available for larger buffers / images.