영수증 프린터 + Bluetooth: Star Micronics TSP143 Web Bluetooth API로

이스탄불 지한기르 지구의 한 카페가 $260짜리 Star Micronics TSP143IIIBI 블루투스 프린터를 구입하고 $0 소프트웨어 라이선스 비용으로 전체 POS를 구축했습니다 — Chrome의 Web Bluetooth API가 브라우저에서 직접 ESC/POS를 말하기 때문입니다. 이 가이드는 작동 코드, 한글 인코딩, 실제 엣지 케이스를 다룹니다.

Web Bluetooth 페어링

Chrome 56+는 Android, macOS, Linux, Windows에서 Web Bluetooth를 지원 — iOS Safari는 미지원. UUID 000018f0으로 navigator.bluetooth.requestDevice를 호출하면 OS 선택기가 열립니다. TSP143IIIBI는 ESC/POS 바이트 스트림 쓰기용 FFE1 특성을 노출합니다.

페어링은 한 번이지만 Chrome은 보안상 세션마다 사용자 제스처를 요구합니다. 해결: "프린터 연결" 버튼, BluetoothDevice 참조를 메모리에 보관.

한글 인코딩 (EUC-KR)

기본 ASCII는 한글을 "?"로 인쇄합니다. TSP143은 EUC-KR 2바이트 모드를 지원:

• 0x1C 0x26 — EUC-KR 모드 활성화
• 룩업 테이블로 텍스트를 Uint8Array로 변환
• 용지 절단: 0x1D 0x56 0x00

리셋 전략

Bluetooth 연결은 4-5분 유휴 후 끊김; 인쇄 전 device.gatt.connected를 확인하세요. 소프트 리셋 0x1B 0x40은 EUC-KR 설정도 지웁니다 — 각 인쇄 시작 시 재전송.

지한기르 카페는 90일간 11,400장의 영수증을 인쇄했고 리셋 사고는 3건뿐.

자주 묻는 질문

iPad에서 작동합니까? 아니요, iOS Safari는 Web Bluetooth를 지원하지 않습니다.

USB 모델? 예, Web USB API 통해.

HTTPS 필수? 예, 보안 컨텍스트 필요.

도움이 되셨나요? 공유해 주세요.