菜单
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).
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
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.
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-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-knob |
| description | 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). |
| Spec | Value |
|---|---|
| Main MCU | ESP32-S3R8 — Xtensa dual-core 240 MHz, WiFi + BLE 5 |
| Secondary MCU | ESP32-U4WDH — Xtensa dual-core 240 MHz, BT Classic + BLE |
| Flash / PSRAM | 16 MB Flash (Quad SPI) / 8 MB PSRAM (Octal SPI) |
| Display | 1.8" IPS LCD, 360x360, ST77916 QSPI, 262K colors, 600 cd/m² |
| Touch | CST816 capacitive, I2C |
| Haptics | DRV2605 + LRA motor, I2C (0x5A) |
| Audio Out | PCM5100A DAC stereo → 3.5 mm jack line-out (no onboard speaker, no power amp). I2S source muxed via GPIO 0: HIGH = ESP32-S3, LOW = ESP32 secondary |
| Audio In | PDM microphone (I2S on ESP32-S3) |
| Encoder | Rotary encoder on ESP32-S3 (+ 2nd encoder on ESP32) |
| Storage | MicroSD (SDMMC 4-wire) |
| USB | Type-C, CH445P switch (MCU select by plug orientation) |
| Power | USB 5V / Li-ion 3.7V MX1.25 (800mAh optional), charger intégré |
| Framework | PlatformIO (ESP-IDF + Arduino) |
| Function | GPIOs | Interface |
|---|---|---|
| Display (ST77916) | CLK:13 D0:15 D1:16 D2:17 D3:18 CS:14 RST:21 BL:47 | QSPI 80MHz |
| Touch (CST816) | SDA:11 SCL:12 INT:9 RST:10 | I2C |
| Haptics (DRV2605) | SDA:11 SCL:12 | I2C (0x5A) |
| Rotary Encoder | A:8 B:7 | GPIO |
| Microphone | CLK:45 DATA:46 | I2S PDM RX |
| SD Card (SDMMC) | CMD:3 CLK:4 D0:5 D1:6 D2:42 D3:2 | SDMMC 4-wire |
| Audio I2S out | BCLK:39 WS:40 DOUT:41 | I2S STD → PCM5100A |
| Inter-MCU UART | TX:43 RX:44 | UART (↔ ESP32 GPIO16/17) |
| Battery ADC | GPIO 1 (ADC1_CH0) | ADC (divider 1:1) |
| Audio mux / BOOT | GPIO 0 | HIGH=S3 controls DAC |
# Build + upload via USB
pio run -t upload
# Monitor serial
pio device monitor -b 115200
For deeper information, consult these files in order:
Convention :
esp32-platform.mdcontains generic ESP32-S3/PlatformIO knowledge.device-hardware.mdcontains everything specific to this Waveshare device.