القائمة
Common ESP32-S3 platform reference for all Waveshare devices in this monorepo. Use when working with PlatformIO setup, toolchain, common libraries, or adding a new device.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
Development reference for Waveshare ESP32-S3-ePaper-1.54G (200×200 4-color e-paper, ES8311 audio, SHTC3, PCF85063 RTC, battery). Use when working with this device, its e-paper display (EPD_1in54g driver), power rails, audio codec, sensors, deep-sleep, or restoring the factory firmware.
Development reference for Waveshare ESP32-S3-Touch-AMOLED-1.75C (round 1.75" watch form factor). Use when working with this device, its AMOLED display (CO5300 QSPI 466×466), touch (CST9217), audio (ES8311 playback + ES7210 mic-array AEC), power (AXP2101), IMU (QMI8658), or restoring the factory firmware.
Development reference for Guition JC3636K718 (ESP32-S3, round 1.8" 360×360 + encoder + RGB ring). Use when working with this device, its display (ST77916 QSPI), audio chain (PCM5100A DAC + NS4150B amp), 13× WS2812 ring on GPIO 0, encoder, microphone, DRV2605 + LRA haptics, or restoring the factory firmware.
Development reference for Waveshare ESP32-S3-Knob-Touch-LCD-1.8. Use when working with this device, its dual-MCU architecture, display (ST77916 QSPI), touch (CST816), haptics (DRV2605), or audio (PCM5100A).
Development reference for Waveshare ESP32-S3-Touch-AMOLED-1.8. Use when working with this device, its AMOLED display (SH8601 QSPI), touch (FT3168), audio (ES8311), power (AXP2101), IMU (QMI8658), or RTC (PCF85063).
| name | waveshare-esp32 |
| description | Common ESP32-S3 platform reference for all Waveshare devices in this monorepo. Use when working with PlatformIO setup, toolchain, common libraries, or adding a new device. |
| Device | Directory | Display | Resolution | Key ICs | Skill |
|---|---|---|---|---|---|
| ESP32-S3-Knob-Touch-LCD-1.8 (Waveshare) | devices/knob/ | ST77916 IPS LCD | 360×360 | CST816, DRV2605, PCM5100A | waveshare-knob |
| ESP32-S3-Touch-AMOLED-1.8 (Waveshare) | devices/amoled/ | SH8601 AMOLED | 368×448 | FT3168, ES8311, AXP2101, QMI8658, PCF85063 | waveshare-amoled |
| ESP32-S3-Touch-AMOLED-1.75C (Waveshare) | devices/amoled_175c/ | CO5300 AMOLED (round) | 466×466 | CST9217, ES8311+ES7210, AXP2101, QMI8658 | waveshare-amoled-175c |
| JC3636K718 (Guition) | devices/guition_knob/ | ST77916 IPS LCD | 360×360 | PCM5100A, NS4150B, 13× WS2812 RGB ring | guition-k718 |
| ESP32-S3-ePaper-1.54G (Waveshare) | devices/epaper_154g/ | e-paper 4 couleurs (SPI) | 200×200 | ES8311, SHTC3, PCF85063, ETA6098 | waveshare-epaper-154g |
All three QSPI display devices share shared/lib/qspi_panel/esp_lcd_sh8601 (the panel framework is QSPI-generic; the ST77916 init lives in each device's lib/<name>_hw/).
Waveshare/
├── shared/lib/qspi_panel/ # Common QSPI display driver
├── devices/knob/ # Waveshare Knob (skill: waveshare-knob)
├── devices/amoled/ # Waveshare AMOLED (skill: waveshare-amoled)
├── devices/guition_knob/ # Guition JC3636K718
├── build.ps1 # Build (Windows / PowerShell)
└── build.sh # Build (macOS / Linux / bash)
Each device has its own skill with hardware-specific details:
devices/knob/.claude/skills/waveshare-knob/SKILL.mddevices/amoled/.claude/skills/waveshare-amoled/SKILL.mddevices/amoled_175c/.claude/skills/waveshare-amoled-175c/SKILL.mddevices/guition_knob/.claude/skills/guition-k718/SKILL.mddevices/epaper_154g/.claude/skills/waveshare-epaper-154g/SKILL.mdFor PlatformIO setup, toolchain, ESP-IDF, common libraries (LVGL, display drivers, sensors), and debugging:
Template:
devices/<name>/
├── .claude/skills/<skill-name>/ # Optional (Waveshare devices have one)
│ ├── SKILL.md # Quick ref + GPIO + progressive disclosure
│ ├── device-hardware.md # Architecture, pinout, ICs
│ └── resources.md # Wiki, GitHub, datasheets
├── CLAUDE.md # Always — conventions, gotchas, skill ref
├── README.md # Build commands (both flavors)
├── lib/<name>_hw/
│ ├── <name>_pins.h # GPIO definitions
│ └── CLAUDE.md # Lib contents
├── projects/ # PlatformIO projects
├── docs/ # demo-code, datasheets, schematics
└── firmware/ # Factory firmware .bin + restore README
Add the device row to the root CLAUDE.md table; both build.ps1 and build.sh will auto-discover it via devices/<name>/projects/.