return 0;
static long tz30_ioctl(struct file *filp, unsigned int cmd, unsigned long arg) struct tz30_device *dev = filp->private_data; switch(cmd) case TZ30_CMD_CUT: tz30_send(dev, "\x1D\x56\x01", 3); // full cut break; case TZ30_CMD_STATUS: return tz30_get_status(dev); citizen tz30-m01 driver
// Add ESC/POS init if buffer empty if(dev->buffer_pos == 0) u8 init_seq[] = 0x1B, 0x40; tz30_send(dev, init_seq, 2); return 0; static long tz30_ioctl(struct file *filp, unsigned
def print_line(self, text): self.ser.write(text.encode() + b'\n') Barcode / Graphics (Optional) | Command | Hex
// citizen_tz30.c static ssize_t tz30_write(struct file *filp, const char __user *buf, size_t count, loff_t *f_pos) struct tz30_device *dev = filp->private_data; u8 *kbuf = kmalloc(count, GFP_KERNEL); if(copy_from_user(kbuf, buf, count)) return -EFAULT;
Application → ioctl/write → Driver Core → FIFO Buffer → HAL (UART/GPIO) → TZ30-M01 | Interface | Pinout | Mode | |-----------|----------------------------|--------------------------| | TTL Serial| TX, RX, GND, DTR (busy) | 9600–115200 baud, 8N1 | | Parallel | 8-bit data, STB, BUSY, ACK | Compatibility mode | 3. Control Command Set (ESC/POS Subset) The TZ30-M01 emulates a subset of ESC/POS. Below are the core driver commands implemented. 3.1. Initialization | Command | Hex Sequence | Description | |---------|------------------|------------------------------| | Reset | 1B 40 | Clear buffer, reset margins | | Wake | 1B 1A 01 | Exit sleep/low-power mode | 3.2. Printing | Command | Hex Sequence | Description | |------------------------|---------------------|--------------------------------------| | Print text | Raw ASCII | Prints stored data in buffer | | Line feed | 0A | Feeds 1 line (4.23 mm) | | Full cut | 1D 56 01 | Full cut after print | | Partial cut (keep) | 1D 56 00 | Partial cut (one point remains) | | Paper feed (dots) | 1B 4A n | Feed n dots (max 255) | 3.3. Barcode / Graphics (Optional) | Command | Hex Sequence | Description | |----------------------|------------------------------|----------------------------| | Print raster bitmap | 1D 76 30 m xL xH yL yH d1…dk | 203 dpi raster graphic | | Code128 barcode | 1D 6B 73 m d1…dk NUL | Barcode generation | 3.4. Status Read (Serial) | Command | Hex | Response (1 byte) | Bit mask meaning | |--------------|-----|------------------|------------------| | Real-time status | 10 04 01 | 0x00–0xFF | Bit0=Paper low, Bit1=Paper out, Bit2=Cover open, Bit3=Head overtemp, Bit6=Busy | 4. Linux Kernel Driver (Pseudo-implementation) Below is a skeletal Linux cdev driver handling the TZ30-M01 via UART.
1. Overview The Citizen TZ30-M01 is a high-speed, direct thermal printer mechanism designed for integration into kiosks, POS systems, ticket validators, and medical devices. It features a 3-inch (80mm) print width, auto-cutter support, and low-voltage DC operation. This document outlines the driver architecture, control logic, and hardware abstraction for the mechanism.