# -*- coding: utf-8 -*- """ Set of ESC/POS Commands (Constants) This module contains constants that are described in the esc/pos-documentation. Since there is no definitive and unified specification for all esc/pos-like printers the constants could later be moved to `capabilities` as in `escpos-php by @mike42 `_. :author: `Manuel F Martinez `_ and others :organization: Bashlinux and `python-escpos `_ :copyright: Copyright (c) 2012 Bashlinux :license: GNU GPL v3 """ from __future__ import absolute_import from __future__ import division from __future__ import print_function from __future__ import unicode_literals import six # Control characters # as labelled in http://www.novopos.ch/client/EPSON/TM-T20/TM-T20_eng_qr.pdf NUL = b'\x00' EOT = b'\x04' ENQ = b'\x05' DLE = b'\x10' DC4 = b'\x14' CAN = b'\x18' ESC = b'\x1b' FS = b'\x1c' GS = b'\x1d' # Feed control sequences CTL_LF = b'\n' # Print and line feed CTL_FF = b'\f' # Form feed CTL_CR = b'\r' # Carriage return CTL_HT = b'\t' # Horizontal tab CTL_SET_HT = ESC + b'\x44' # Set horizontal tab positions CTL_VT = b'\v' # Vertical tab # Printer hardware HW_INIT = ESC + b'@' # Clear data in buffer and reset modes HW_SELECT = ESC + b'=\x01' # Printer select HW_RESET = ESC + b'\x3f\x0a\x00' # Reset printer hardware # (TODO: Where is this specified?) # Cash Drawer (ESC p ) _CASH_DRAWER = lambda m, t1='', t2='': ESC + b'p' + m + six.int2byte(t1) + six.int2byte(t2) CD_KICK_2 = _CASH_DRAWER(b'\x00', 50, 50) # Sends a pulse to pin 2 [] CD_KICK_5 = _CASH_DRAWER(b'\x01', 50, 50) # Sends a pulse to pin 5 [] # Paper Cutter _CUT_PAPER = lambda m: GS + b'V' + m PAPER_FULL_CUT = _CUT_PAPER(b'\x00') # Full cut paper PAPER_PART_CUT = _CUT_PAPER(b'\x01') # Partial cut paper # Beep BEEP = b'\x07' # Panel buttons (e.g. the FEED button) _PANEL_BUTTON = lambda n: ESC + b'c5' + six.int2byte(n) PANEL_BUTTON_ON = _PANEL_BUTTON(0) # enable all panel buttons PANEL_BUTTON_OFF = _PANEL_BUTTON(1) # disable all panel buttons # Sheet modes SHEET_SLIP_MODE = ESC + b'\x63\x30\x04' # slip paper SHEET_ROLL_MODE = ESC + b'\x63\x30\x01' # paper roll # Text format # TODO: Acquire the "ESC/POS Application Programming Guide for Paper Roll # Printers" and tidy up this stuff too. TXT_FLIP_ON = ESC + b'\x7b\x01' TXT_FLIP_OFF = ESC + b'\x7b\x00' TXT_SMOOTH_ON = GS + b'\x62\x01' TXT_SMOOTH_OFF = GS + b'\x62\x00' TXT_SIZE = GS + b'!' TXT_WIDTH = {1: 0x00, 2: 0x10, 3: 0x20, 4: 0x30, 5: 0x40, 6: 0x50, 7: 0x60, 8: 0x70} TXT_HEIGHT = {1: 0x00, 2: 0x01, 3: 0x02, 4: 0x03, 5: 0x04, 6: 0x05, 7: 0x06, 8: 0x07} TXT_NORMAL = ESC + b'!\x00' # Normal text TXT_2HEIGHT = ESC + b'!\x10' # Double height text TXT_2WIDTH = ESC + b'!\x20' # Double width text TXT_4SQUARE = ESC + b'!\x30' # Quad area text TXT_UNDERL_OFF = ESC + b'\x2d\x00' # Underline font OFF TXT_UNDERL_ON = ESC + b'\x2d\x01' # Underline font 1-dot ON TXT_UNDERL2_ON = ESC + b'\x2d\x02' # Underline font 2-dot ON TXT_BOLD_OFF = ESC + b'\x45\x00' # Bold font OFF TXT_BOLD_ON = ESC + b'\x45\x01' # Bold font ON TXT_ALIGN_LT = ESC + b'\x61\x00' # Left justification TXT_ALIGN_CT = ESC + b'\x61\x01' # Centering TXT_ALIGN_RT = ESC + b'\x61\x02' # Right justification TXT_INVERT_ON = GS + b'\x42\x01' # Inverse Printing ON TXT_INVERT_OFF = GS + b'\x42\x00' # Inverse Printing OFF # Fonts SET_FONT = lambda n: ESC + b'\x4d' + n TXT_FONT_A = SET_FONT(b'\x00') # Font type A TXT_FONT_B = SET_FONT(b'\x01') # Font type B # Text colors TXT_COLOR_BLACK = ESC + b'\x72\x00' # Default Color TXT_COLOR_RED = ESC + b'\x72\x01' # Alternative Color (Usually Red) # Spacing LINESPACING_RESET = ESC + b'2' LINESPACING_FUNCS = { 60: ESC + b'A', # line_spacing/60 of an inch, 0 <= line_spacing <= 85 360: ESC + b'+', # line_spacing/360 of an inch, 0 <= line_spacing <= 255 180: ESC + b'3', # line_spacing/180 of an inch, 0 <= line_spacing <= 255 } # Prefix to change the codepage. You need to attach a byte to indicate # the codepage to use. We use escpos-printer-db as the data source. CODEPAGE_CHANGE = ESC + b'\x74' # Barcode format _SET_BARCODE_TXT_POS = lambda n: GS + b'H' + n BARCODE_TXT_OFF = _SET_BARCODE_TXT_POS(b'\x00') # HRI barcode chars OFF BARCODE_TXT_ABV = _SET_BARCODE_TXT_POS(b'\x01') # HRI barcode chars above BARCODE_TXT_BLW = _SET_BARCODE_TXT_POS(b'\x02') # HRI barcode chars below BARCODE_TXT_BTH = _SET_BARCODE_TXT_POS(b'\x03') # HRI both above and below _SET_HRI_FONT = lambda n: GS + b'f' + n BARCODE_FONT_A = _SET_HRI_FONT(b'\x00') # Font type A for HRI barcode chars BARCODE_FONT_B = _SET_HRI_FONT(b'\x01') # Font type B for HRI barcode chars BARCODE_HEIGHT = GS + b'h' # Barcode Height [1-255] BARCODE_WIDTH = GS + b'w' # Barcode Width [2-6] # NOTE: This isn't actually an ESC/POS command. It's the common prefix to the # two "print bar code" commands: # - Type A: "GS k NUL" # - TYPE B: "GS k " # The latter command supports more barcode types _SET_BARCODE_TYPE = lambda m: GS + b'k' + six.int2byte(m) # Barcodes for printing function type A BARCODE_TYPE_A = { 'UPC-A': _SET_BARCODE_TYPE(0), 'UPC-E': _SET_BARCODE_TYPE(1), 'EAN13': _SET_BARCODE_TYPE(2), 'EAN8': _SET_BARCODE_TYPE(3), 'CODE39': _SET_BARCODE_TYPE(4), 'ITF': _SET_BARCODE_TYPE(5), 'NW7': _SET_BARCODE_TYPE(6), 'CODABAR': _SET_BARCODE_TYPE(6), # Same as NW7 } # Barcodes for printing function type B # The first 8 are the same barcodes as type A BARCODE_TYPE_B = { 'UPC-A': _SET_BARCODE_TYPE(65), 'UPC-E': _SET_BARCODE_TYPE(66), 'EAN13': _SET_BARCODE_TYPE(67), 'EAN8': _SET_BARCODE_TYPE(68), 'CODE39': _SET_BARCODE_TYPE(69), 'ITF': _SET_BARCODE_TYPE(70), 'NW7': _SET_BARCODE_TYPE(71), 'CODABAR': _SET_BARCODE_TYPE(71), # Same as NW7 'CODE93': _SET_BARCODE_TYPE(72), 'CODE128': _SET_BARCODE_TYPE(73), 'GS1-128': _SET_BARCODE_TYPE(74), 'GS1 DATABAR OMNIDIRECTIONAL': _SET_BARCODE_TYPE(75), 'GS1 DATABAR TRUNCATED': _SET_BARCODE_TYPE(76), 'GS1 DATABAR LIMITED': _SET_BARCODE_TYPE(77), 'GS1 DATABAR EXPANDED': _SET_BARCODE_TYPE(78), } BARCODE_TYPES = { 'A': BARCODE_TYPE_A, 'B': BARCODE_TYPE_B, } # QRCode error correction levels QR_ECLEVEL_L = 0 QR_ECLEVEL_M = 1 QR_ECLEVEL_Q = 2 QR_ECLEVEL_H = 3 # QRcode models QR_MODEL_1 = 1 QR_MODEL_2 = 2 QR_MICRO = 3 # Image format # NOTE: _PRINT_RASTER_IMG is the obsolete ESC/POS "print raster bit image" # command. The constants include a fragment of the data's header. _PRINT_RASTER_IMG = lambda data: GS + b'v0' + data S_RASTER_N = _PRINT_RASTER_IMG(b'\x00') # Set raster image normal size S_RASTER_2W = _PRINT_RASTER_IMG(b'\x01') # Set raster image double width S_RASTER_2H = _PRINT_RASTER_IMG(b'\x02') # Set raster image double height S_RASTER_Q = _PRINT_RASTER_IMG(b'\x03') # Set raster image quadruple # Printing Density PD_N50 = GS + b'\x7c\x00' # Printing Density -50% PD_N37 = GS + b'\x7c\x01' # Printing Density -37.5% PD_N25 = GS + b'\x7c\x02' # Printing Density -25% PD_N12 = GS + b'\x7c\x03' # Printing Density -12.5% PD_0 = GS + b'\x7c\x04' # Printing Density 0% PD_P50 = GS + b'\x7c\x08' # Printing Density +50% PD_P37 = GS + b'\x7c\x07' # Printing Density +37.5% PD_P25 = GS + b'\x7c\x06' # Printing Density +25% PD_P12 = GS + b'\x7c\x05' # Printing Density +12.5%