문제 해결 및 부트루프 탈출

기기에 문제가 발생했을 때 확인할 수 있는 가이드입니다.

7. 문제 해결 및 부트루프 탈출

CrossPoint 사용 중 문제나 충돌이 발생하면 이슈 티켓을 작성하고 시리얼 모니터 로그를 첨부해 주세요. 기기를 컴퓨터에 연결하고 시리얼 모니터를 시작하면 로그를 확인할 수 있습니다. Serial Monitor 또는 다음 명령어를 사용하세요:

pio device monitor

기기가 부트루프에 빠진 경우, 리셋 버튼을 눌렀다 떼고, 설정된 뒤로 버튼과 전원 버튼을 동시에 누른 채로 유지하면 홈 화면으로 부팅됩니다.

팁: 책이 제대로 렌더링되지 않거나 이상한 동작이 발생하면, SD 카드의 .crosspoint 디렉토리를 삭제하여 캐시를 초기화해 보세요. 설정과 읽기 위치는 유지되지만 렌더링 캐시가 재생성됩니다.

v1.2.0 신기능: 기기가 비정상 종료된 경우 다음 부팅 시 충돌 원인(Crash Reason)이 화면에 표시되며, 크래시 리포트가 SD 카드 루트의 crash_report.txt 파일로 자동 저장됩니다. 이슈 제보 시 해당 파일을 첨부해 주세요.