Nyugtanyomtató + Bluetooth: Star Micronics TSP143 Web Bluetooth API-n keresztül

Egy kávézó Isztambul Cihangir negyedében vásárolt egy 260 dolláros Star Micronics TSP143IIIBI Bluetooth nyomtatót, és 0 dolláros szoftverlicenc költséggel építette fel teljes POS-rendszerét — mert a Chrome Web Bluetooth API-ja közvetlenül a böngészőből beszél ESC/POS-t. Ez az útmutató tartalmazza a működő kódot, a magyar karakterek kódolását és valós szélsőséges eseteket.

Web Bluetooth Párosítás

A Chrome 56+ Androidon, macOS-en, Linuxon és Windowsban támogatja a Web Bluetooth-ot — az iOS Safari nem. A navigator.bluetooth.requestDevice hívás 000018f0 UUID-vel megnyitja az OS-választót. A TSP143IIIBI az FFE1 karakterisztikát teszi elérhetővé ESC/POS bájtfolyamok írásához.

A párosítás egyszeri, de a Chrome biztonsági okokból user-gesture-t követel meg munkamenetenként. Megoldás: "Nyomtató csatlakoztatása" gomb, BluetoothDevice referencia megtartása memóriában.

Magyar Karakter Kódolás (CP852)

Az alapértelmezett ASCII az "á, é, í, ó, ö, ő, ú, ü, ű" karaktereket "?"-ként nyomtatja. A TSP143 támogatja a CP852 kódlapot:

• 0x1B 0x74 0x12 — CP852 kiválasztása
• Szöveg konvertálása Uint8Array-ré keresőtáblával
• Papírvágás: 0x1D 0x56 0x00

Reset Stratégia

A Bluetooth kapcsolat 4-5 perc tétlenség után megszakad; ellenőrizd a device.gatt.connected-ot minden nyomtatás előtt. A soft-reset 0x1B 0x40-en keresztül törli a kódlapot — minden nyomtatás elején újraküldeni.

A Cihangir kávézó 11 400 nyugtát nyomtatott 90 nap alatt mindössze 3 reset-incidenssel.

GYIK

Működik iPaden? Nem, az iOS Safari nem támogatja a Web Bluetooth-ot.

USB modell? Igen, a Web USB API-n keresztül.

HTTPS kötelező? Igen, secure context szükséges.

Hasznosnak találtad? Oszd meg.