Laci Uang, Auto Cutter, dan Status Epson TM-T82

Printer struk adalah satu-satunya perangkat di toko kecil yang menyentuh uang secara fisik. Ia membuka laci, ia menghasilkan bukti pembayaran bagi pelanggan, dan ia pula yang disalahkan kasir ketika salah satunya gagal. Tiga fitur ESC/POS di bawah inilah yang mengubah printer dari sekadar perangkat keluaran teks menjadi bagian dari proses penanganan uang tunai — dan masing-masing punya satu detail yang tidak kelihatan sampai ia mempermalukan Anda di depan antrean.

Semua isi tulisan ini berasal dari command reference ESC/POS Epson dan dari memasang printer semacam ini di meja kasir sungguhan. Di bagian yang perilakunya berbeda antar firmware, saya menyebutkannya, bukan berpura-pura ada satu jawaban.

Laci terbuka lewat printer, bukan lewat komputer

Tidak ada driver laci uang. Laci itu adalah solenoid dengan kumparan 24 volt, tersambung ke port drawer kick printer dengan kabel yang mirip kabel telepon, dan terbuka ketika printer mengirim pulsa tegangan lewat kabel tersebut. Satu-satunya tugas perangkat lunak Anda adalah meminta pulsa itu kepada printer, dan itulah fungsi ESC p.

ESC p m t1 t2      generate pulse on the drawer kick connector
   m  = 0  -> pin 2      m = 1 -> pin 5
   t1 = ON  time in 2 ms units
   t2 = OFF time in 2 ms units

// 50 ms on, 50 ms off on pin 2 — the setting that opens every
// 24 V drawer I have wired to a TM-T82 so far.
const kickDrawer = Buffer.from([0x1b, 0x70, 0x00, 0x19, 0x19]);

// The pulse is a QUEUED command: it fires when the print buffer
// reaches it, not when your process writes it. Put it AFTER the
// receipt bytes if you want the drawer to open with the paper,
// BEFORE them if the cashier should reach for cash first.

Parameternya lebih penting daripada penampakannya. Dua byte pewaktuan menentukan berapa lama pulsa menyala dan mati dalam satuan dua milidetik, dan pulsa yang terlalu pendek hanya akan membuat solenoid berbunyi klik tanpa melepas kaitnya — gejala klasik laci yang terbuka di sebagian mesin dan tidak di mesin lain meski perangkat lunaknya identik. Sekitar lima puluh milidetik adalah titik awal yang aman; sebagian laci yang lebih berat menuntut lebih.

Memotong tanpa membelah baris total

Auto cutter terletak beberapa milimeter di atas kepala cetak. Jarak itulah penyebab paling umum struk yang baris terakhirnya terpotong separuh, dan itu pula alasan perintah potong punya dua bentuk.

• Bentuk polos memotong di posisi kertas saat itu, yaitu di bawah kepala cetak — sehingga apa pun yang terakhir Anda cetak masih berada di atas pisau.
• Bentuk feed-lalu-potong memajukan kertas sejumlah titik tertentu dulu sehingga konten tercetak lolos dari pisau. Bentuk inilah yang hampir selalu Anda butuhkan.
• Partial cut menyisakan sedikit sambungan yang menahan struk, mencegahnya jatuh ke lantai di toko yang ramai; full cut melepasnya sepenuhnya, yang tepat untuk tiket dapur yang langsung ditusuk ke spike.

GS V m            cut, no feed        m = 0 full, 1 partial
GS V m n          feed n dots, then cut   m = 65 full, 66 partial

// Wrong: the last three lines are still under the print head,
// above the blade, so the cut lands in the middle of the total.
buffer.push(GS, 0x56, 0x01);

// Right: feed the gap between head and blade first. On TM-class
// printers that gap is why "GS V B n" exists at all.
const FEED_DOTS_TO_BLADE = 0x64;   // ~100 dots, tune per model
buffer.push(GS, 0x56, 0x42, FEED_DOTS_TO_BLADE);

Jarak feed yang tepat berbeda per model dan layak diukur sekali, bukan disalin dari forum. Cetak penggaris berisi baris bernomor, potong, lalu hitung berapa baris yang hilang — angka itu, dikonversi ke titik, adalah konstanta Anda, dan tempatnya adalah nilai konfigurasi bernama, bukan tersebar di dalam kode.

Status real-time adalah satu-satunya status yang bisa dipercaya

Sebagian besar perintah ESC/POS diantrekan: ia dieksekusi ketika buffer printer sampai padanya. Itu tidak berguna untuk menanyakan apakah kertas habis, karena pertanyaan Anda akan berbaris di belakang struk yang justru Anda khawatirkan. DLE EOT berbeda — ia permintaan real-time yang dijawab firmware seketika, bahkan di tengah pekerjaan, dan mengembalikan satu byte berisi flag.

DLE EOT n        transmit real-time status  (0x10 0x04 n)
   n = 1  printer status      n = 2  offline cause
   n = 3  error cause         n = 4  roll paper sensor status

// Real-time means the printer answers immediately, even while a
// long receipt is still printing — this is the only status query
// that is not stuck behind your own buffered job.
const askPaper = Buffer.from([0x10, 0x04, 0x04]);

// One reply byte. Bits 5 and 6 both set means the roll is out;
// bits 2 and 3 mean "near end" — the warning you want to surface
// to the cashier BEFORE the next customer, not during.
function paperState(reply: number): "ok" | "near-end" | "out" {
  if ((reply & 0x60) === 0x60) return "out";
  if ((reply & 0x0c) === 0x0c) return "near-end";
  return "ok";
}

Dalam praktik saya menanyakan dua hal. Status sensor gulungan kertas memberi tahu apakah kertas habis atau hampir habis, dan itulah beda antara peringatan dan meja kasir yang berhenti. Status printer memberi tahu apakah penutup terbuka atau printer offline, dan itulah yang mengubah kegagalan senyap yang misterius menjadi pesan yang bisa ditindaklanjuti kasir.

Kegagalan yang terlihat seperti bug perangkat lunak padahal bukan

Empat keluhan muncul berulang kali, dan di semua kasus itu kodenya tidak bersalah. Mengenali polanya menghemat satu kunjungan ke lokasi.

• Laci terbuka di satu kasir dan tidak di kasir sebelahnya. Hampir selalu durasi pulsa yang pas-pasan untuk laci tertentu, atau laci yang dikabelkan ke pin yang lain.
• Struk tercetak tetapi laci tetap tertutup hanya untuk pembayaran kartu. Itu biasanya perilaku yang memang benar dan lupa dikonfigurasi siapa pun — layak dipastikan sebelum men-debug apa pun.
• Struk berhenti di tengah baris saat jam sibuk. Periksa ketidakcocokan flow control serial sebelum menyalahkan aplikasi; buffer printer yang penuh tanpa handshake terlihat persis seperti struk terpotong.
• Baris terakhir hilang di sebagian struk. Lagi-lagi jarak feed, dan hanya terlihat ketika baris terakhirnya cukup pendek sehingga berada tepat di garis pisau.

Pelajaran umumnya: kelas perangkat keras ini gagal secara fisik dan hampir tidak melaporkan apa pun sendiri. Aplikasi Andalah yang harus bertanya, dan harus mencatat jawabannya, kalau tidak setiap insiden menjadi cerita, bukan baris log.

Memodelkan status cetak dan laci di dalam POS

Karena aksi-aksi ini bersifat fisik dan bisa berhasil sebagian, ia pantas punya status eksplisit alih-alih sekadar boolean. Transisi di bawah adalah himpunan terkecil yang mencakup semua sengketa nyata yang pernah harus saya telusuri.

SALE_CLOSED
   -> PRINT_QUEUED      row written to print_jobs, id = payment id
   -> PRINT_SENT        bytes handed to the transport
   -> PRINT_CONFIRMED   DLE EOT 1 says online, no error, after send
   -> DRAWER_PULSED     only reached for cash payments

// The states that matter operationally are the ones you can be
// stuck in. PRINT_SENT with no confirmation is the reprint case;
// PRINT_CONFIRMED with no DRAWER_PULSED is the "drawer never
// opened" complaint, and it is a wiring fault, not a POS bug.

Nilai dari menuliskannya seperti ini adalah setiap status macet memetakan ke instruksi konkret bagi staf: tercetak tapi belum terkonfirmasi berarti cetak ulang aman, terkonfirmasi tapi tanpa pulsa laci berarti periksa kabel, mengantre dan sudah lama berarti printer offline dan shift butuh catatan manual.

Rutinitas commissioning sepuluh menit

Setiap meja kasir yang saya pasang kini melewati rutinitas pendek yang sama sebelum melayani satu pelanggan pun. Rutinitas ini pernah menangkap pin laci yang salah, baud rate yang tidak cocok, dan pisau yang macet — yang ketiganya pasti muncul saat jam sibuk pertama.

1. Kirim perintah inisialisasi dan self test, lalu pastikan konfigurasi yang tercetak cocok dengan antarmuka dan kecepatan yang Anda harapkan.
2. Picu pulsa laci sendirian, tanpa struk, dan pastikan kaitnya lepas bersih alih-alih hanya berbunyi klik.
3. Cetak penggaris bernomor lalu potong, dan tetapkan konstanta feed dari baris yang benar-benar hilang.
4. Tarik gulungan kertas di tengah pencetakan dan pastikan aplikasi Anda menampilkan pesan kertas habis serta pulih ketika gulungan diganti.

Pulsa laci, feed pemotong, dan byte status real-time adalah tiga potongan kecil ESC/POS yang memikul sebagian besar beban operasional sebuah sistem point-of-sale. Ketiganya murah untuk diimplementasikan dan mahal untuk dilewatkan: masing-masing adalah kegagalan yang akan dilihat kasir sebelum Anda melihatnya, di depan pelanggan, dengan antrean yang memanjang di belakangnya.