Mharmal Printer

이 애플리케이션은 강력한 인쇄 서비스 드라이버 역할을 하여 모든 웹 기반 애플리케이션(POS, 재고 관리, 주문 관리)이 Bluetooth 또는 USB를 통해 Android 기기에 연결된 ESC/POS 열전사 프린터와 직접 통신할 수 있도록 합니다.

주요 기능:

- 범용 연결: Bluetooth 및 USB ESC/POS 또는 StarPRNT 열전사 프린터를 모두 지원합니다.

- WebSocket 브리지: Android 기기에서 로컬 WebSocket 서버(기본 포트 22300)를 실행합니다. 웹 앱은 ws://localhost:22300(또는 기기 IP 주소)에 연결하여 인쇄 작업을 전송할 수 있습니다.

- 백그라운드 서비스: 앱은 안정적인 백그라운드 서비스로 실행되어 화면이 꺼지거나 앱이 최소화된 경우에도 연결이 유지됩니다.

- 이미지 인쇄: Base64로 인코딩된 이미지 인쇄에 최적화되어 있습니다. 웹 앱에서 생성한 영수증, 바코드, QR 코드 인쇄에 적합합니다.

- 금전함 지원: 연결된 금전함을 여는 명령을 전송할 수 있습니다.

- 용지 자동 절단 지원: 호환되는 프린터에 대한 자동 절단 명령을 지원합니다.

- 실시간 상태: WebSocket 서버와 프린터의 연결 상태를 실시간으로 모니터링합니다.

- 진단: 연결 및 인쇄 품질을 테스트할 수 있는 내장 도구가 제공됩니다.

사용 방법:
- 연결: 블루투스 프린터를 페어링하거나 USB 열전사 프린터를 연결합니다.

시작: 앱을 열고 WebSocket 서비스를 시작합니다.

- 통합: 웹 애플리케이션에서 Android 기기에서 실행 중인 WebSocket 서버에 연결합니다.

- 인쇄: 웹 앱에서 Base64 이미지 데이터 또는 ESC/POS 명령을 전송하여 즉시 인쇄합니다.

적합한 용도:
- Android 태블릿에서 실행되는 웹 기반 POS(판매 시점 관리) 시스템

- 영수증 인쇄가 필요한 KDS(주방 디스플레이 시스템)

- 라벨 인쇄가 필요한 재고 관리 앱

- 브라우저와 하드웨어 프린터 간의 연결이 필요한 모든 개발자

기술 사양:

기본 포트: 22300
프로토콜: WebSocket (ws://)
데이터 형식: Base64 인코딩 이미지 / 원시 ESC/POS 바이트
요구 사항:

Android 5.0 이상
블루투스 또는 USB OTG 지원 기기
ESC/POS 호환 열전사 프린터 (58mm 또는 80mm)

테스트 기기:
- SEIKO SII RP-F10
- SEIKO SII MP-B20
- EPSON TM-m30
- MUNBYN TM-m30III
- Star Micronics Mc-Print3