Kuittitulostin + Bluetooth: Star Micronics TSP143 Web Bluetooth API:n kautta

Kahvila Istanbulin Cihangirin alueella osti $260:n Star Micronics TSP143IIIBI Bluetooth-tulostimen ja rakensi koko POS-järjestelmänsä $0 ohjelmistolisenssimaksuilla — koska Chrome'n Web Bluetooth API puhuu ESC/POS:ää suoraan selaimesta. Tämä opas kattaa toimivan koodin, suomen merkkikoodauksen ja todelliset reunatapaukset.

Web Bluetooth Pariutus

Chrome 56+ Androidilla, macOS:llä, Linuxilla ja Windowsilla tukee Web Bluetoothia — iOS Safari ei. Kutsu navigator.bluetooth.requestDevice UUID:llä 000018f0 avaa OS-valitsimen. TSP143IIIBI altistaa FFE1-ominaisuuden ESC/POS-tavuvirran kirjoittamiseen.

Pariutus on kertaluonteinen, mutta Chrome vaatii user-gesturen per istunto. Ratkaisu: "Yhdistä tulostin" -painike, säilytä BluetoothDevice-viite muistissa.

Suomen Merkkikoodaus (CP858)

Oletus-ASCII tulostaa "ä, ö, å" merkkinä "?". TSP143 tukee CP858 code pagea:

• 0x1B 0x74 0x13 — valitse CP858
• Muunna teksti Uint8Array:ksi hakutaulukolla
• Paperin leikkaus: 0x1D 0x56 0x00

Reset-Strategia

Bluetooth-yhteys katkeaa 4-5 minuutin käyttämättömyyden jälkeen; tarkista device.gatt.connected ennen jokaista tulostusta. Soft-reset komennolla 0x1B 0x40 tyhjentää code pagen — lähetä uudelleen tulostuksen alussa.

Cihangir-kahvila tulosti 11 400 kuittia 90 päivässä vain 3 reset-tapahtumalla.

UKK

Toimiiko iPadilla? Ei, iOS Safari ei tue Web Bluetoothia.

USB-malli? Kyllä Web USB API:n kautta.

HTTPS pakollinen? Kyllä, secure context vaaditaan.

Oliko tästä hyötyä? Jaa se.