설치 가이드
CrossPoint Reader 한국어 펌웨어를 Xteink X3/X4에 설치하는 방법을 안내합니다. 단일 펌웨어로 두 모델 모두 지원하며, 웹 플래셔·SD카드·OTA 등 다양한 설치 방법을 제공합니다.
방법 1: 웹 플래셔 사용 (권장)
가장 쉽고 빠른 방법입니다. 이 사이트의 웹 플래셔에서 바로 펌웨어를 설치할 수 있습니다.
USB 연결
X4: USB-C 케이블로 컴퓨터에 연결합니다.
X3: 동봉된 마그네틱 충전/데이터 케이블로 컴퓨터에 연결합니다.
※ 시리얼 넘버가 붙은 X3 패키지의 경우 USB가 인식되지 않을 수 있습니다. 이 경우 아래 방법 2: SD카드 업데이트를 사용하세요.
웹 플래셔로 이동
웹 플래셔 페이지로 이동합니다. Chrome 또는 Edge 브라우저를 사용해주세요.
웹 플래셔 열기펌웨어 플래싱
한국어 펌웨어 플래싱 (커뮤니티) 버튼을 클릭합니다.
- 장치 선택 팝업에서 USB 시리얼 장치를 선택합니다
- 플래싱이 자동으로 진행됩니다
펌웨어 적용
플래시가 완료되면 자동으로 재부팅됩니다. 만약 멈춰있다면:
- 기기의 Reset 버튼을 한 번 누릅니다
- 전원 버튼을 1초 이상 눌러 부팅합니다
방법 2: SD카드 펌웨어 업데이트
USB 연결이 어렵거나 무선으로 업데이트하기 어려운 환경에서 사용할 수 있는 방법입니다. v1.2.0-ko.15부터 지원되며, X3 스토어 펌웨어로의 롤백에도 사용할 수 있습니다.
A. 처음 사용자 (USB가 안 되는 X3 OEM 펌웨어 상태)
- GitHub 릴리즈에서
firmware.bin을 다운로드합니다. - SD카드 루트 폴더에 복사하면서 파일명을
update.bin으로 변경합니다. - SD카드를 디바이스에 삽입합니다.
- 왼쪽 사이드 버튼을 누른 상태에서 전원 버튼을 길게 눌러 부팅합니다.
- OEM 부트로더가 자동으로 펌웨어를 인식해 플래싱합니다.
B. 기존 사용자 (이미 CrossPoint Reader-KO 사용 중)
- GitHub 릴리즈에서
firmware.bin을 다운로드해 SD카드에 복사합니다. - SD카드를 디바이스에 삽입합니다.
- 설정 → 시스템 → SD카드 펌웨어 업데이트로 이동합니다.
- SD카드의 펌웨어 파일을 선택하면 자동으로 플래싱이 진행됩니다.
- 플래싱이 완료되면 자동으로 재부팅됩니다.
💡 같은 메뉴에서 다운로드 받은 스토어 펌웨어(X3/X4 OEM)도 선택해 롤백할 수 있습니다.
참고: OTA(WiFi) 업데이트도 같은 메뉴에서 가능
WiFi가 연결되어 있다면 설정 → 시스템 → 업데이트로 이동해 별도 파일 없이 OTA 업데이트할 수 있습니다. SD/OTA 모두 X4 실리콘에서 동작하도록 raw 파티션 쓰기 + 직접 otadata 갱신 방식으로 동작합니다.
방법 3: 펌웨어 다운로드 후 플래셔 사용
펌웨어 파일을 직접 다운로드하여 웹 플래셔에서 설치하는 방법입니다.
3. OTA 플래시
OTA fast flash controls 섹션에서:
- Select File 버튼을 클릭하여 다운로드한 .bin 파일을 선택
- Flash firmware from file 버튼을 클릭하여 플래시 시작
방법 4: esptool 사용 (고급)
명령줄 도구를 사용하여 직접 펌웨어를 플래시하는 방법입니다. 머지된 바이너리 파일을 사용합니다.
1. 펌웨어 다운로드
GitHub 릴리즈 페이지에서 CrossPoint-1.2.0-ko.18.bin 파일을 다운로드합니다. (esptool 전용 머지된 바이너리)
2. esptool 설치
pip install esptool3. 펌웨어 플래시
esptool.py --chip esp32c3 write_flash 0x0 CrossPoint-1.2.0-ko.18.bin주의사항
플래시 중 USB 케이블을 분리하지 마세요. 기기가 손상될 수 있습니다.
원래 펌웨어로 복원 (스토어 펌웨어)
원래 Xteink 공식 펌웨어로 되돌리려면 다음 방법 중 하나를 사용하세요. 아래에서 X3/X4용 최신 스토어 펌웨어를 직접 다운로드 받을 수 있습니다.
CrossPoint 펌웨어와 스토어 펌웨어 간 전환 시 모든 설정(WiFi, 읽기 설정 등)은 변경되지 않고 그대로 유지됩니다.
스토어 펌웨어 다운로드
파일명은 OEM 원본 파일명을 그대로 유지합니다. 다운로드 후 아래 방법 중 하나로 플래싱하세요.
방법 1: 웹 플래셔
웹 플래셔에서 X3 또는 X4 스토어 펌웨어를 직접 플래시할 수 있습니다.
방법 2: SD카드 업데이트
위에서 다운로드 받은 스토어 펌웨어 파일을 SD카드에 복사한 뒤, 설정 → 시스템 → SD카드 펌웨어 업데이트에서 해당 파일을 선택하면 자동으로 플래싱됩니다.
방법 3: 외부 웹 플래셔
xteink.dve.al에서 공식 펌웨어를 플래시합니다.