PlatformIO 빌드/업로드 문제 해결

1) 기본 빌드/업로드 명령

• 빌드: platformio run --environment nice_nano_v2_compatible
• 업로드: platformio run --target upload --environment nice_nano_v2_compatible

2) 보드가 맞는지(가장 중요)

이 프로젝트는 BLE + Native USB Device가 동시에 필요해서 보통 nRF52840 계열을 전제로 합니다.

3) 업로드가 안 될 때(Windows)

Q. 업로드가 계속 실패한다(포트 에러)

• 부트로더 모드에서 COM 포트가 바뀌는지 확인
• RESET 더블탭 → 부트로더 진입 후 장치 관리자에서 새 COM 포트 확인

Q. 부트로더 모드로 안 들어간다

• 충전 전용 USB 케이블 여부 확인 → 데이터 케이블로 교체
• USB 포트/허브 변경(가능하면 메인보드 후면 포트)

4) 빌드가 안 될 때

• VS Code PlatformIO 확장 설치 확인
• pio --version로 CLI 동작 확인
• platformio.ini env/board 설정이 실제 보드와 일치하는지 확인

5) 빠른 체크리스트

• 올바른 env로 빌드/업로드
• 부트로더 모드 진입(필요 시)
• 업로드 시점의 COM 포트 확인
• 데이터 USB 케이블 사용

원본(Markdown): docs/platformio-build-upload.md