菜单
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 页面并帮你完成安装。
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).
基于 SOC 职业分类
| 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/.