NM-CYD-C5
产品概述
NM-CYD-C5 是一款基于 ESP32-C5 的 Cheap Yellow Display 开发板，内置 2.8 英寸 320×240 TFT LCD 电容触摸屏。它与 ESP32-Cheap-Yellow-Display（CYD）的尺寸和接口完全兼容，可实现无缝替换，同时新增了双频 Wi-Fi 6、BLE 5、Zigbee 3.0 和 Thread 支持。
主要特性
- ESP32-C5-WROOM-1 — RISC-V 32 位 @ 240 MHz
- 16 MB Flash + 8 MB PSRAM
- 2.8 英寸 TFT LCD — 320 × 240 分辨率，ST7789 驱动，电容触摸屏
- 双 USB-C 接口 — 一个用于 ESP32-C5 编程/供电，一个 CH340 UART
- SD 卡槽 + RGB LED + 额外 GPIO 引脚
- 12 针 FPC 连接器 — 方便连接外部模块
- 完全兼容 ESP32-Cheap-Yellow-Display 外形尺寸
无线能力
| 协议 | 规格 |
|---|---|
| Wi-Fi | 双频 Wi-Fi 6（802.11ax），2.4 GHz 和 5 GHz |
| 蓝牙 | BLE 5.3 + 经典蓝牙（SPP、HID、GATT） |
| Zigbee | IEEE 802.15.4，Zigbee 3.0 终端设备 |
| Thread | 基于 IPv6 的网状网络（Thread 1.3） |
与标准 CYD 对比
| 特性 | 标准 CYD（ESP32） | NM-CYD-C5 |
|---|---|---|
| Wi-Fi 频段 | 2.4 GHz | 2.4 + 5 GHz |
| Wi-Fi 标准 | 802.11 b/g/n | 802.11ax（Wi-Fi 6） |
| Zigbee | 不支持 | Zigbee 3.0 |
| Thread | 不支持 | Thread 1.3 |
| Flash | 4 MB | 16 MB |
| PSRAM | 无 | 8 MB |
硬件版本
- NM-CYD-C5（标准版） — 板载天线，外形尺寸与标准 CYD 完全兼容。
- NM-CYD-C5-Colorful-Ant — 基于彩色特别版的外置天线版本，新增 IPEX 1 接口并附带 2.4 GHz / 5 GHz 双频天线（峰值增益平均 3.2 / 3.7 dBi），Wi-Fi 和蓝牙信号接收效果更好，适合对无线性能要求更高的用户。外壳 3MF 文件已在 NM-CYD-C5 仓库 开源。
引脚定义
SPI 总线（显示、触摸、SD 卡共用）
| 设备 | SCK | MISO | MOSI | CS |
|---|---|---|---|---|
| 显示屏（ST7789） | GPIO 6 | GPIO 2 | GPIO 7 | GPIO 23 |
| 触摸屏（XPT2046） | GPIO 6 | GPIO 2 | GPIO 7 | GPIO 1 |
| SD 卡 | GPIO 6 | GPIO 2 | GPIO 7 | GPIO 10 |
LP-UART（P5）— GPS 模块
| 信号 | 引脚 |
|---|---|
| RX | GPIO 4 |
| TX | GPIO 5 |
I2C 接口（CN1）
| 引脚 1 | 引脚 2 | 引脚 3 | 引脚 4 |
|---|---|---|---|
| 3.3V | IO 9 | IO 8 | GND |
注意：IO8 和 IO9 已在板上通过 R32/R33 上拉——连接外部 I2C 设备时请注意这一点。
扩展 IO（P1）
| 引脚 1 | 引脚 2 | 引脚 3 | 引脚 4 |
|---|---|---|---|
| IO 4 | IO 8 | IO 26 | GND |
12 针 FPC 连接器（FPC2）
| 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 |
|---|---|---|---|---|---|---|---|---|---|---|---|
| IO 2 | IO 6 | IO 7 | IO 10 | GND | IO 4 | IO 8 | IO 5 | IO 9 | USB D- | USB D+ | GND |
WS2812 RGB LED 与 LCD 背光
| 功能 | 引脚 |
|---|---|
| LCD 背光 | GPIO 25 |
| WS2812 RGB LED | GPIO 27 |
快速开始
PlatformIO（推荐）
在 platformio.ini 中添加：
[env:nm-cyd-c5]
platform = https://github.com/pioarduino/platform-espressif32/releases/download/55.03.36/platform-espressif32.zip
board = esp32-c5-devkitc-1
framework = arduino
TFT_eSPI 配置
使用 TFT_eSPI 驱动 LCD 时，需将 TFT_eSPI_ESP32_C5.c/h 文件添加到 Processors 文件夹，并在 TFT_eSPI.c/h 中更新 CONFIG_IDF_TARGET_ESP32C5。这些文件可在 NM-CYD-C5 仓库 的 Demos/Arduino/libraries/TFT_eSPI 目录中找到。
如果在 Arduino/TFT_eSPI 下出现颜色反转，请在 TFT_eSPI 配置中添加以下定义（见 issue #3）：
#define TFT_INVERSION_OFF
#define TFT_RGB_ORDER TFT_BGR
MicroPython
esptool.py --chip esp32c5 --port COM3 erase_flash
esptool.py --chip esp32c5 --port COM3 --baud 460800 write_flash -z 0x1000 firmware.bin
mpremote connect COM3 repl
支持的项目
- NMMiner
- Bruce
- HaleHound-CYD
- ESP32Marauder
- Rogue-Radar — 将多种无线与实用工具集成到旋钮驱动界面的手持固件
- CYM (Cheap Yellow Monster) — 便携式触屏 WiFi 安全工具集
- Launcher — 适用于 M5Stack、Lilygo、CYD、Marauder 等 ESP32 设备的应用启动器
- GhostESP — 开源无线研究平台（NM-CYD-C5 适配进行中）
- ESPectre — 基于 WiFi CSI 的动作检测，已适配 NM-CYD-C5（见 ESPectre × NM-CYD-C5）
- ESP-Claw — 乐鑫面向物联网设备的对话式编程 AI 智能体框架
适配中的项目
固件烧录
如果只想快速刷入固件，可使用：