NM-CYD-C5 딥다이브
— ESP32-C5 기반, 'ESP32 최초의 듀얼밴드 Wi-Fi 6'를 단 2.8″ 터치 개발보드 '값싼 노란 디스플레이'

RockBase-iot/NM-CYD-C5. 2.8인치 터치 LCD가 붙은 ESP32-C5 개발보드다. 핵심은 두 가지 — 첫째, 원조 '값싼 노란 디스플레이(CYD, ESP32-2432S028)'와 핀·치수가 그대로 호환되어 기존 CYD 펌웨어를 거의 꽂기만 하면 돌릴 수 있고, 둘째 ESP32 계열 최초로 5GHz Wi-Fi 6(802.11ax)·Zigbee 3.0·Thread를 모두 지원한다(기존 ESP32는 전부 2.4GHz 전용이었다). 저장소 자체는 독립 펌웨어 앱이 아니라, Arduino · PlatformIO(Bruce) · MicroPython 세 툴체인의 보드 지원 파일 + 데모 + 커스텀 TFT_eSPI 드라이버 포트 + 하드웨어 문서(데이터시트·회로도 PDF)를 모아 둔 '보드 벤더 공식 지원 레포'다. (저장소: RockBase-iot/NM-CYD-C5 · SoC ESP32-C5-WROOM-1 RISC-V 240MHz · 16MB Flash + 8MB PSRAM · 디스플레이 240×320 ST7789 + XPT2046 터치 · 세 툴체인 데모 + 11개 연계 펌웨어 프로젝트 큐레이션 · 라이선스 표기는 데모별 상이(TFT_eSPI/st7789py 등 원작 라이선스 승계) · TrendShift 라이브 멘션 #62141)

1프로젝트 한줄 요약

"기존에 가장 인기 있던 ESP32 터치보드(CYD)와 똑같은 모양·핀배치에, ESP32 최초로 5GHz Wi-Fi·Zigbee·Thread를 얹은 '업그레이드판' 보드와 그 사용 설명서."

조금 더 구체적으로, 이 보드의 두뇌는 ESP32-C5-WROOM-1 모듈입니다 — RISC-V 240MHz, 16MB Flash + 8MB PSRAM. 화면은 2.8″ 240×320 TFT(ST7789 컨트롤러, ILI9341로 교체 가능)에 XPT2046 저항막 터치가 붙고, microSD 슬롯·WS2812 RGB LED·여러 확장 핀이 있습니다. 전원·프로그래밍용 USB-C가 두 개(하나는 ESP32-C5 네이티브 USB, 하나는 CH340 USB-UART 변환기)입니다. 레포는 이 하드웨어를 ① Arduino IDE, ② PlatformIO(주로 Bruce 펌웨어 빌드), ③ MicroPython 세 갈래로 켜는 법을 각각의 README·설정파일·드라이버로 안내합니다.

이 문서가 파고드는 건 "보드 스펙 나열"이 아니라 그 안에서 배울 수 있는 것입니다 — "디스플레이 드라이버를 새 칩(ESP32-C5)에 포팅한다는 게 무슨 뜻인지", "디스플레이·터치·SD카드가 한 SPI 버스를 어떻게 나눠 쓰는지", "왜 ESP32-C5만 펌웨어를 0x2000 주소에 써야 하는지", "Zigbee End Device가 뭔지". 임베디드·IoT를 처음 공부하는 사람에게 실물 하드웨어로 배우는 좋은 교본입니다.

2왜 주목받는가

"인기 보드의 '핀 호환 업그레이드'라는 영리한 포지셔닝 + ESP32 최초의 5GHz·Zigbee·Thread + 보안·펜테스트 펌웨어 붐."

① '깨지 않는 업그레이드' — 생태계를 그대로 물려받는다

새 하드웨어의 가장 큰 적은 "쓸 만한 소프트웨어가 없다"입니다. NM-CYD-C5는 이 문제를 정공법으로 피합니다 — 원조 CYD와 치수·핀배치·인터페이스를 일부러 똑같이 맞춰서, 이미 존재하는 수많은 CYD용 펌웨어와 케이스·액세서리를 거의 그대로 재사용하게 했습니다. README의 표현으로 "seamless replacement(매끄러운 교체)". 사용자는 익숙한 보드의 모양 그대로, 알맹이만 신형 칩으로 바꾼 셈입니다.

② ESP32 최초의 듀얼밴드 — 스펙 비교표

가장 큰 기술적 뉴스는 5GHz Wi-Fi 6입니다. 지난 10년간 모든 ESP32는 2.4GHz 전용이었는데, 2.4GHz는 전자레인지·블루투스·이웃집 공유기로 극심하게 혼잡합니다. 5GHz로 올라가면 간섭이 줄고 처리량이 늘죠. 여기에 Zigbee·Thread까지 더해, 이 작은 보드 하나가 Wi-Fi 허브이자 스마트홈 메시 노드가 될 수 있습니다.

③ 시기를 탔다 — 보안·펜테스트·AI 에이전트 펌웨어 붐

마침 ESP32 기반 휴대용 무선 보안 도구가 유행입니다. README가 직접 연결해 두는 펌웨어들이 바로 그 흐름의 한복판에 있습니다.

즉 NM-CYD-C5는 "가장 인기 있는 보드의 모양 + 가장 최신의 무선 칩 + 마침 뜨거운 보안/AI 펌웨어 생태계"가 겹친 지점에 있습니다. 5GHz Wi-Fi가 되니 5GHz 워드라이빙(ESP32DualBandWardriver)처럼 이전 ESP32로는 불가능하던 작업도 열립니다.

3기술 스택 전체 지도

"하나의 보드, 세 갈래 길 — Arduino(C++) · PlatformIO(Bruce 빌드) · MicroPython(Python). 그리고 셋을 떠받치는 ST7789 디스플레이 드라이버."

NM-CYD-C5는 '서버·프론트엔드·인프라'로 나뉘는 웹 프로젝트가 아니라 임베디드 보드라, 기술 지도는 "같은 하드웨어를 켜는 세 개의 펌웨어 툴체인"으로 보는 게 가장 정확합니다. 각 길은 난이도·자유도가 다릅니다.

① 펌웨어 툴체인 세 갈래

② 진짜 알맹이 — ESP32-C5용 TFT_eSPI 드라이버 포트

이 레포에서 가장 '코드다운 코드'는 Demos/Arduino/libraries/TFT_eSPI/Processors/ 아래 TFT_eSPI_ESP32_C5.c(857줄)와 .h(571줄)입니다. 신형 칩 ESP32-C5의 SPI 하드웨어는 구형 ESP32와 레지스터가 달라, 표준 TFT_eSPI가 그대로 동작하지 않습니다. 그래서 개발자는 C5 전용 SPI 구동 코드를 새로 작성했습니다. README는 사용자에게 "이 두 파일을 TFT_eSPI의 Processors에 넣고, 라이브러리를 CONFIG_IDF_TARGET_ESP32C5로 인식하도록 패치하라"고 안내합니다.

// User_Setup-NM-CYD-C5.h 핵심 정의(요약)
#define ST7789_DRIVER            // 디스플레이 컨트롤러 = ST7789
#define TFT_WIDTH   240
#define TFT_HEIGHT  320
#define SPI_FREQUENCY        20000000   // 화면 SPI 20MHz
#define SPI_TOUCH_FREQUENCY   2500000   // 터치는 2.5MHz(느리게)

③ PlatformIO 빌드 — 보드를 '플래그'로 정의

PlatformIO 쪽은 platformio.ini의 빌드 플래그로 보드 특성을 통째로 기술합니다. Bruce 펌웨어를 NM-CYD-C5로 빌드하는 환경의 실제 값들:

; platformio.ini (NM-CYD-C5 / Bruce 환경, 요약)
board            = nm-cyd-c5
board_build.partitions = support_files/custom_16Mb.csv
build_flags =
  -DNM_CYD_C5 -DPART_16MB=1 -DHAS_TOUCH=1
  -DST7789_DRIVER=1 -DTFT_WIDTH=240 -DTFT_HEIGHT=320
  -DROTATION=3 -DDIMMER_SETUP=60
  -DARDUINO_USB_CDC_ON_BOOT=1 -DARDUINO_USB_MODE=1
lib_deps =
  ESP32Async/ESPAsyncWebServer
  bblanchon/ArduinoJson @ ^7.0.4
  moononournation/GFX Library for Arduino @ ^1.5.5

별도 환경(nm-cyd-c5.ini)은 순정 esp32-c5-devkitc-1 보드로 빌드하며 -DBOARD_HAS_PSRAM=1, GPS 핀(TX=5/RX=4), Grove I2C(SDA=8/SCL=9), 선택적 FM 라디오(-DFM_SI4713=1) 등을 켭니다.

④ 보드 매니페스트가 말하는 하드웨어 정체성

PlatformIO 보드 정의(_jsonfiles/nm-cyd-c5.json)는 이 보드의 '신분증'입니다. 주요 값:

4아키텍처 심화 분석 (한 SPI 버스에 모든 걸 매단 보드)

"이 보드의 설계를 이해하는 열쇠는 단 하나 — 화면·터치·SD카드·무선모듈이 전부 '같은 SPI 버스'를 CS로 번갈아 쓴다."

전체 하드웨어 구조 한 장

핵심은 SPI 버스 하나(SCK=6, MISO=2, MOSI=7)를 디스플레이·터치·SD카드·외부 RF 모듈이 전부 공유한다는 점입니다. 그러면 신호선이 충돌하지 않을까요? 안 합니다 — CS(Chip Select)라는 '말할 차례' 핀으로 한 번에 하나씩만 깨우기 때문입니다.

설계 ① — 공유 SPI 버스와 CS 중재

그래서 Bruce 보드 지원 코드(interface.cpp)의 _setup_gpio()는 부팅 직후 모든 CS 핀(TFT·NRF24·CC1101·SD·W5500)을 HIGH로 올려 전부 '비활성'으로 만들어 둡니다 — 누가 실수로 동시에 버스를 잡는 것을 막는 안전 초기화입니다. 외부 RF 모듈(CC1101/NRF24/W5500)이 같은 CS=9, GDO0/CE/INT=8을 공유하므로, connections.md는 "어느 모듈을 쓸지 CS·CE 라인에 스위치를 달아 고르라"고 안내합니다.

설계 ② — ESP32-C5만의 SPI '핸드셰이크' (포팅의 핵심)

왜 디스플레이 드라이버를 새로 포팅해야 했을까요? 구형 ESP32는 SPI 전송을 시작할 때 레지스터에 SPI_USR 비트만 세우면 됐는데, ESP32-C5는 전송 전에 SPI_UPDATE라는 '설정 반영' 신호를 추가로 줘야 합니다. 이 한 줄 차이 때문에 표준 TFT_eSPI가 C5에서 멈춥니다. 포트 코드의 핵심:

// TFT_eSPI_ESP32_C5.c — 전송 직전 C5 전용 핸드셰이크
#if CONFIG_IDF_TARGET_ESP32C5
    *_spi_cmd = SPI_UPDATE;            // "방금 바꾼 설정을 반영해"
    while (*_spi_cmd & SPI_UPDATE);    // 반영될 때까지 대기
#endif
    *_spi_cmd = SPI_USR;               // 이제 전송 시작

헤더(.h)에서는 레지스터 베이스 주소도 C5에 맞게 다시 매핑합니다 — REG_SPI_BASE → DR_REG_SPI2_BASE, SPI_MOSI_DLEN_REG → SPI_MS_DLEN_REG, SPI_PORT = SPI2_HOST. 이렇게 "같은 라이브러리, 다른 칩"을 메우는 게 임베디드 포팅의 전형적 작업입니다.

설계 ③ — 회전에 따라 터치 좌표를 뒤집는다

화면을 가로/세로로 돌리면(rotation), 디스플레이는 회전해도 터치 패널의 원점은 그대로라 좌표가 어긋납니다. interface.cpp의 InputHandler()는 회전값에 따라 좌표를 수학적으로 변환합니다(rotation 3의 예):

// 회전 3일 때 터치 좌표 보정
if (rotation == 3) {
    t.y = (tftHeight + 20) - t.y;   // 세로축 뒤집기(+오프셋 보정)
    t.x = tftWidth - t.x;           // 가로축 뒤집기
}

또한 이 보드엔 배터리 게이지가 없어 getBattery()는 0, isCharging()은 false를 반환하도록 정직하게 스텁(stub) 처리돼 있습니다 — 없는 하드웨어를 있는 척하지 않는 좋은 예입니다.

esptool erase_flash
esptool --baud 961200 write_flash 0x2000 ESP32_GENERIC_C5-20260406-v1.28.0.bin

5디렉토리 구조 해부

"루트는 단출하다 — 데모(세 툴체인) + 문서(데이터시트·회로도). 무게는 Demos/ 폴더에 쏠려 있다."

최상위 한눈에

구조가 말해 주는 것

이 디렉토리 배치는 레포의 정체성을 그대로 드러냅니다. 독립 앱 폴더(src/, main/)가 없고 Demos/와 Documention/만 있다는 건, 이 레포가 "펌웨어 제품"이 아니라 "보드를 켜는 출발점 키트 + 하드웨어 레퍼런스"라는 뜻입니다. 가장 기술적으로 깊은 자산은 TFT_eSPI_ESP32_C5.c/.h(신형 칩 드라이버 포트)와 SCH_*.pdf(회로도)이며, interface.cpp가 그 하드웨어와 외부 펌웨어를 잇는 다리입니다.

6학습 포인트 (기술별 — 배울 것 + 실습 아이디어)

"이 작은 보드 하나에 디스플레이 드라이버 포팅·SPI 버스 설계·무선 프로토콜·세 가지 임베디드 툴체인이 다 들어 있다."

① 디스플레이 드라이버 포팅 (레지스터 · SPI 핸드셰이크)

배울 것: "같은 라이브러리를 새 칩에 올린다"는 게 실제로 무슨 작업인지. 칩이 바뀌면 레지스터 주소·비트 배치가 달라지고, ESP32-C5처럼 SPI_UPDATE 같은 새 절차가 끼어듭니다. #if CONFIG_IDF_TARGET_ESP32C5 조건부 컴파일로 칩별 코드를 가르는 패턴도.

실습: TFT_eSPI_ESP32_C5.c에서 #if CONFIG_IDF_TARGET_ESP32C5 블록을 모두 찾아, "구형 ESP32와 무엇이 달라졌는지"를 한 표로 정리해 보기.

② 공유 SPI 버스 + CS 중재

배울 것: 핀을 아끼려고 여러 장치가 한 SPI 버스를 공유할 때, CS(Chip Select)로 충돌 없이 번갈아 쓰는 법. 부팅 시 모든 CS를 비활성(HIGH)으로 초기화하는 안전 습관, 그리고 같은 CS를 쓰는 모듈은 스위치로 골라야 하는 한계까지.

실습: 회로도(SCH_NM-CYD-C5-v1.0.pdf)를 열어 SCK/MISO/MOSI가 LCD·터치·SD로 어떻게 갈라지는지 선을 따라가 보고, 각 장치의 CS 핀을 표로 적기.

③ ST7789 디스플레이 bring-up (초기화 시퀀스)

배울 것: LCD를 처음 켤 때 보내는 초기화 명령 시퀀스(sleep-out 0x11, 픽셀 포맷 0x3A=RGB565, 포치/게이트/VCOM, 감마 커브 0xE0/0xE1…)의 의미. tft_config.py의 17개 init_cmds 튜플이 교과서입니다.

실습: tft_config.py의 초기화 명령 각 줄에 "이 명령이 무엇을 설정하는지" 주석을 달아 보기. 0x3A를 RGB666으로 바꾸면 화면이 어떻게 되는지 가설을 세워 보기.

④ 세 임베디드 툴체인 비교 (Arduino vs PlatformIO vs MicroPython)

배울 것: 같은 보드를 세 방식으로 켜 보며 트레이드오프를 체감. MicroPython은 즉시성·실험, Arduino는 풍부한 라이브러리·입문, PlatformIO는 빌드 플래그로 정밀 제어. platformio.ini의 build_flags 한 줄 한 줄이 어떤 하드웨어 특성을 켜는지.

실습: 같은 "화면에 Hello" 작업을 MicroPython과 Arduino 두 방식으로 해 보고, 코드량·반복속도·디버깅 편의를 비교한 짧은 메모 작성.

⑤ 무선 — Wi-Fi 6 · BLE · 802.15.4 (Zigbee/Thread)

배울 것: 한 칩에서 Wi-Fi(굵은 회선)와 Zigbee/Thread(저전력 메시)가 각각 무엇에 적합한지. Zigbee의 End Device / Router / Coordinator 역할 구분, Thread가 IPv6·Matter와 이어지는 맥락. Arduino에서 Zigbee ED 모드 + 전용 파티션을 고르는 절차.

실습: "우리 집 온도센서를 만든다면 Wi-Fi·BLE·Zigbee·Thread 중 무엇을 쓸까?"를 전력·중계·인터넷연결 기준으로 표로 비교해 결정해 보기.

⑥ 터치 입력 · 회전 좌표 변환

배울 것: 저항막 터치(XPT2046)의 원시 좌표를 화면 회전에 맞춰 변환하는 수학(축 뒤집기·오프셋), 그리고 보드별 터치 보정값(calibration)이 왜 필요한지. 없는 하드웨어(배터리)를 스텁으로 정직하게 처리하는 설계.

실습: interface.cpp의 rotation 0/2/3 좌표 변환식을 종이에 그려, 화면을 돌렸을 때 터치 점이 어디로 가는지 손으로 따라가 보기.

7하드웨어 / 시스템 요구사항

"보드 본체 + USB-C 케이블이면 시작 끝. 고급 기능엔 외부 모듈 몇 개가 추가된다."

보드 핵심 스펙

개발 환경 요구사항

선택적 외부 모듈(고급 기능)

8직접 해볼 수 있는 실습 과제

"펌웨어 굽기 → 화면에 글자 → 인터넷 연결 → 터치 입력 → 무선 메시 → 풀스택 펌웨어 빌드, 난이도 순서대로."

import network
wlan = network.WLAN(network.STA_IF)
wlan.active(True)
wlan.connect("내5GHz_SSID", "비밀번호")
print(wlan.isconnected(), wlan.ifconfig())

9관련 기술 심화 학습 로드맵 (6주 플랜)

"ESP32 기초에서 출발해 디스플레이·터치·무선·메시 IoT·펌웨어 포팅까지, NM-CYD-C5를 실습대 삼아."

10핵심 키워드 사전

"이 문서와 저장소에서 반복되는 용어를 한곳에 모았다."

11참고 링크

• GitHub 저장소 — github.com/RockBase-iot/NM-CYD-C5
• 원조 CYD 가이드 — witnessmenow/ESP32-Cheap-Yellow-Display
• MicroPython C5 펌웨어 — micropython.org/download/ESP32_GENERIC_C5
• ST7789 파이썬 드라이버 — russhughes/st7789py_mpy
• TFT_eSPI 라이브러리 — Bodmer/TFT_eSPI
• PlatformIO 플랫폼(pioarduino) — pioarduino/platform-espressif32
• Arduino Zigbee 예제 — espressif/arduino-esp32 · Zigbee
• 연계 펌웨어 — Bruce (BruceDevices/firmware) · ESP-Claw (espressif/esp-claw)
• 웹 플래셔 — flash.nmminer.com · flash.nmiot.net
• TrendShift 페이지 — trendshift.io/repositories/62141