硬件规格
| 产品型号 | 极客AI主板 V2（YD-ESP32-S3） |
|---|---|
| 主控芯片 | ESP32-S3-WROOM-1（双核 Xtensa LX7，主频 240MHz） |
| 存储 | 16MB Flash（Octal SPI）＋ 8MB PSRAM（Octal SPI / OPI） |
| 无线 | 2.4GHz WiFi 802.11 b/g/n |
| USB | Type-C（原生 USB OTG / CDC，程序下载与串口调试） |
| 按键 | RST（复位）、BOOT（GPIO0） |
| 供电 | Type-C 5V |
| 固件平台 | MicroPython（含自研 C 扩展模块） |
板载外设
以下外设为板载默认配置，引脚已被占用，请勿分配给外接模块：
| RGB 灯（WS2812） | GPIO48 |
|---|---|
| 喇叭（MAX98357，I2S） | GPIO15 (BCLK)、GPIO16 (LRC)、GPIO7 (DIN) |
| 麦克风（INMP441，I2S） | GPIO4 (WS)、GPIO5 (SCK)、GPIO6 (SD) |
| TFT 屏幕（ST7789，SPI） | GPIO21 (SCLK)、GPIO47 (MOSI)、GPIO45 (RST)、GPIO40 (DC)、GPIO41 (CS)、GPIO42 (BL) |
| 串口0（下载 / 调试） | GPIO43 (TX0)、GPIO44 (RX0) |
| BOOT 按键 | GPIO0 |
禁用引脚GPIO35 / 36 / 37 被内部 Flash/PSRAM 占用，GPIO19 / 20 为 USB D-/D+，GPIO45 / 46 为 Strapping 引脚——以上引脚绝对不可外接！
可用 GPIO（14 个）
外接模块请从以下引脚中选择：
G1 G2 G3 G8 G9 G10 G11 G12 G13 G14 G17 G18 G38 G39
- 模拟输入（推荐 ADC1，WiFi 开启时稳定）：GPIO 1, 2, 3, 8, 9, 10
- ADC2（WiFi 开启时模拟采集不可靠，作数字 IO 无问题）：GPIO 11, 12, 13, 14, 17, 18
- 仅数字 IO：GPIO 38, 39（适合做 I2C）
- 触摸传感器：GPIO 1, 2, 3, 8, 9, 10, 11, 12, 13, 14 均支持
常用总线建议分配
| I2C | SDA = GPIO38，SCL = GPIO39 |
|---|---|
| SPI（外接设备） | MOSI = GPIO11，MISO = GPIO13，SCK = GPIO12，CS = GPIO10 |
| UART1 | TX = GPIO17，RX = GPIO18 |
排针定义（J1 / J3）
可用
已占用 / 禁用
电源
| 左侧排针 J1（22 pin） | |||
|---|---|---|---|
| # | 丝印 | GPIO | 状态 |
| 1 | GND | — | 电源 |
| 2 | 3V3 | — | 电源 |
| 3 | EN | GPIO0 | BOOT 按键 |
| 4 | G4 | GPIO4 | 麦克风 WS |
| 5 | G5 | GPIO5 | 麦克风 SCK |
| 6 | G6 | GPIO6 | 麦克风 SD |
| 7 | G7 | GPIO7 | 喇叭 DIN |
| 8 | G15 | GPIO15 | 喇叭 BCLK |
| 9 | G16 | GPIO16 | 喇叭 LRC |
| 10 | G17 | GPIO17 | ✔ 可用 (ADC2) |
| 11 | G18 | GPIO18 | ✔ 可用 (ADC2) |
| 12 | G8 | GPIO8 | ✔ 可用 (ADC1) |
| 13 | G3 | GPIO3 | ✔ 可用 (ADC1) |
| 14 | G46 | GPIO46 | Strapping |
| 15 | G9 | GPIO9 | ✔ 可用 (ADC1) |
| 16 | G10 | GPIO10 | ✔ 可用 (ADC1) |
| 17 | G11 | GPIO11 | ✔ 可用 (ADC2) |
| 18 | G12 | GPIO12 | ✔ 可用 (ADC2) |
| 19 | G13 | GPIO13 | ✔ 可用 (ADC2) |
| 20 | G14 | GPIO14 | ✔ 可用 (ADC2) |
| 21 | 5V | — | 电源 |
| 22 | G | — | 电源 |
| 右侧排针 J3（22 pin） | |||
|---|---|---|---|
| # | 丝印 | GPIO | 状态 |
| 1 | G | — | 电源 |
| 2 | TX0 | GPIO43 | 串口0 |
| 3 | RX0 | GPIO44 | 串口0 |
| 4 | G1 | GPIO1 | ✔ 可用 (ADC1) |
| 5 | G2 | GPIO2 | ✔ 可用 (ADC1) |
| 6 | G42 | GPIO42 | TFT 背光 |
| 7 | G41 | GPIO41 | TFT 片选 |
| 8 | G40 | GPIO40 | TFT DC |
| 9 | G39 | GPIO39 | ✔ 可用 (数字IO) |
| 10 | G38 | GPIO38 | ✔ 可用 (数字IO) |
| 11 | G37 | GPIO37 | 禁用 (Octal) |
| 12 | G36 | GPIO36 | 禁用 (Octal) |
| 13 | G35 | GPIO35 | 禁用 (Octal) |
| 14 | G0 | GPIO0 | BOOT 按键 |
| 15 | G45 | GPIO45 | TFT 复位 |
| 16 | G48 | GPIO48 | 板载 RGB 灯 |
| 17 | G47 | GPIO47 | TFT MOSI |
| 18 | G21 | GPIO21 | TFT SCLK |
| 19 | G20 | GPIO20 | 禁用 (USB D+) |
| 20 | G19 | GPIO19 | 禁用 (USB D-) |
| 21 | G | — | 电源 |
| 22 | G | — | 电源 |
固件体系
主板固件基于 MicroPython，采用三层体系设计，各司其职：
| ① C 模块层（编进固件） | 性能敏感驱动：geeklcd（ST7789 + 中文字库）、geekaudio（I2S 录音/播放）、geekled（WS2812 后台灯效） |
|---|---|
| ② Python 框架层（geekfw） | 上电自动「亮屏 → 配网 → 注册 → 加密长连接 → 跑用户程序」，并提供用户态 API |
| ③ 用户 Python 层 | 学生代码（积木 / AI 生成）与普通传感器驱动，随刷随用 |
- 运行：代码经串口直发执行，不落盘，断电不保留（调试用）。
- 刷入：写入
/user/main.py，每次上电由框架自动执行（固化作品）。