Target PC에서 COM 포트 없이(HID-only) 사용하기

Target PC에 연결했을 때 USB 입력장치(키보드)로만 인식되게 하고, Windows에서 COM 포트(Ports: COM & LPT)가 생성되지 않게 하는 운영 방법을 정리합니다.

0) 결론 요약

• COM 포트의 원인은 대부분 USB CDC(Serial) 인터페이스가 디스크립터에 포함되는 것입니다.
• nice_nano_v2_compatible_hid_only는 CFG_TUD_CDC=0로 CDC를 제거합니다.
• HID-only 펌웨어로 정상 부팅된 상태라면 Target PC에서 COM 포트가 생기지 않아야 합니다.

참고: 업로드(DFU) 순간에는 부트로더가 COM 포트를 제공할 수 있어 업로드 중 COM이 잠깐 보이는 것은 정상일 수 있습니다.

1) 빠른 절차(간단)

1. (개발 PC) HID-only 빌드
   C:\Users\j1445\.platformio\penv\Scripts\platformio.exe run --environment nice_nano_v2_compatible_hid_only
2. (개발 PC) Web UI로 BLE 연결 → 부트로더 진입 버튼
3. (개발 PC) 업로드(둘 중 하나)
   HID-only 유지:
   C:\Users\j1445\.platformio\penv\Scripts\platformio.exe run --target upload --environment nice_nano_v2_compatible_hid_only
   
   개발용(Composite) 복귀:
   C:\Users\j1445\.platformio\penv\Scripts\platformio.exe run --target upload --environment nice_nano_v2_compatible
4. 포트 자동 탐색이 실패하면(DFU COM 지정)
   $env:PIO_UPLOAD_PORT = "COM7"
5. (Target PC) 장치 관리자에서 “포트(COM 및 LPT)”에 새 COM이 없어야 성공

2) 막히면(최소)

• BLE로 DFU 진입이 안 되면: 보드가 지원하는 경우 RESET 더블탭으로 DFU 진입
• 그래도 안 되면: SWD(디버거)로 플래시
• 업로드(DFU) 중 COM이 잠깐 보일 수 있습니다(정상). 확인은 일반 동작 모드에서 하세요.

원본(Markdown): docs/hid-only-target-build.md