214 lines
8.4 KiB
Python
214 lines
8.4 KiB
Python
# -*- 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 <https://github.com/mike42/escpos-php>`_.
|
|
|
|
:author: `Manuel F Martinez <manpaz@bashlinux.com>`_ and others
|
|
:organization: Bashlinux and `python-escpos <https://github.com/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 <pin> <on time: 2*ms> <off time: 2*ms>)
|
|
_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
|
|
|
|
# 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
|
|
|
|
# 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_FONT_A = ESC + b'\x4d\x00' # Font type A
|
|
TXT_FONT_B = ESC + b'\x4d\x01' # Font type B
|
|
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
|
|
|
|
# Char code table
|
|
CHARCODE_PC437 = ESC + b'\x74\x00' # USA: Standard Europe
|
|
CHARCODE_JIS = ESC + b'\x74\x01' # Japanese Katakana
|
|
CHARCODE_PC850 = ESC + b'\x74\x02' # Multilingual
|
|
CHARCODE_PC860 = ESC + b'\x74\x03' # Portuguese
|
|
CHARCODE_PC863 = ESC + b'\x74\x04' # Canadian-French
|
|
CHARCODE_PC865 = ESC + b'\x74\x05' # Nordic
|
|
CHARCODE_WEU = ESC + b'\x74\x06' # Simplified Kanji, Hirakana
|
|
CHARCODE_GREEK = ESC + b'\x74\x07' # Simplified Kanji
|
|
CHARCODE_HEBREW = ESC + b'\x74\x08' # Simplified Kanji
|
|
CHARCODE_PC1252 = ESC + b'\x74\x11' # Western European Windows Code Set
|
|
CHARCODE_PC866 = ESC + b'\x74\x12' # Cirillic #2
|
|
CHARCODE_PC852 = ESC + b'\x74\x13' # Latin 2
|
|
CHARCODE_PC858 = ESC + b'\x74\x14' # Euro
|
|
CHARCODE_THAI42 = ESC + b'\x74\x15' # Thai character code 42
|
|
CHARCODE_THAI11 = ESC + b'\x74\x16' # Thai character code 11
|
|
CHARCODE_THAI13 = ESC + b'\x74\x17' # Thai character code 13
|
|
CHARCODE_THAI14 = ESC + b'\x74\x18' # Thai character code 14
|
|
CHARCODE_THAI16 = ESC + b'\x74\x19' # Thai character code 16
|
|
CHARCODE_THAI17 = ESC + b'\x74\x1a' # Thai character code 17
|
|
CHARCODE_THAI18 = ESC + b'\x74\x1b' # Thai character code 18
|
|
|
|
# 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 <type as integer> <data> NUL"
|
|
# - TYPE B: "GS k <type as letter> <data length> <data>"
|
|
# 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%
|