如何實現ESC指令打印小票

# 如何實現ESC指令打印小票

## 目錄
1. [ESC指令概述](#1-esc指令概述)
2. [硬件準備與連接](#2-硬件準備與連接)
3. [ESC指令基礎語法](#3-esc指令基礎語法)
4. [小票打印實現步驟](#4-小票打印實現步驟)
5. [常見問題與解決方案](#5-常見問題與解決方案)
6. [代碼示例與解析](#6-代碼示例與解析)
7. [高級功能擴展](#7-高級功能擴展)
8. [總結與參考資料](#8-總結與參考資料)

---

## 1. ESC指令概述

ESC（Escape Sequence）指令是熱敏打印機/針式打印機通用的控制協議，通過發送特定字節序列實現：
- 文本格式控制（字體、加粗、對齊）
- 打印位圖/條形碼
- 切紙、走紙控制
- 硬件初始化等

**常見打印機品牌協議**：
- Epson ESC/POS
- Star PRNT
- Zjiang指令集

---

## 2. 硬件準備與連接

### 2.1 所需設備
| 設備類型       | 示例型號          | 接口方式       |
|----------------|-------------------|----------------|
| 熱敏打印機     | EPSON TM-T88V     | USB/串口/藍牙  |
| 針式打印機     | POS-5890          | 并口/RJ45      |

### 2.2 連接方式
1. **USB連接**：
   ```python
   import serial
   ser = serial.Serial('/dev/ttyUSB0', 9600, timeout=1)

1. 網絡打印：

   
   import socket
   s = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
   s.connect(("192.168.1.100", 9100))
   

3. ESC指令基礎語法

3.1 指令結構

ESC + 命令字符 + 參數（可選）
示例：ESC @    # 初始化打印機

3.2 常用指令速查表

4. 小票打印實現步驟

4.1 基礎打印流程

1. 初始化打印機

   def init_printer():
      return b'\x1B\x40'
   

2. 設置對齊方式

   def set_align(align='left'):
      # align: left(0)/center(1)/right(2)
      return b'\x1B\x61' + bytes([align])
   

3. 打印文本內容

   def print_text(text):
      return text.encode('gbk')  # 中文需用GBK編碼
   

4. 走紙與切紙

   def feed_and_cut():
      return b'\n\x1D\x56\x41\x03'
   

5. 常見問題與解決方案

5.1 中文亂碼問題

• 原因：編碼不匹配
• 解決方案：

  
  text = "訂單小票".encode('gb18030')  # 優先使用GB18030
  

5.2 打印速度慢

• 優化建議：
  1. 減少單次發送數據量（分塊發送）
  2. 關閉狀態回傳（ESC = 0）

5.3 紙張卡住

• 處理步驟：
  1. 發送ESC v清除緩存
  2. 手動復位打印機

6. 代碼示例與解析

6.1 Python完整示例

import serial

def print_receipt():
    esc = ESCCommands()
    with serial.Serial('/dev/ttyUSB0', 19200) as ser:
        ser.write(esc.init())
        ser.write(esc.set_align(1))
        ser.write(esc.set_font(bold=True))
        ser.write(b"=== 銷售小票 ===\n")
        ser.write(esc.reset_style())
        ser.write(b"商品：礦泉水 x2\n")
        ser.write(b"總計：￥5.00\n")
        ser.write(esc.feed_and_cut())

class ESCCommands:
    @staticmethod
    def init():
        return b'\x1B\x40'
    
    @staticmethod
    def set_font(bold=False):
        return b'\x1B\x21' + (b'\x08' if bold else b'\x00')

if __name__ == "__main__":
    print_receipt()

7. 高級功能擴展

7.1 打印條形碼

def print_barcode(data, type='CODE128'):
    # GS k <type> <data> NUL
    return b'\x1D\x6B' + {
        'CODE39': b'\x04',
        'CODE128': b'\x49'
    }[type] + data.encode() + b'\x00'

7.2 打印位圖

需先將圖片轉換為1位位圖數據，再發送：

GS v 0 m xL xH yL yH [bitmap data]

8. 總結與參考資料

關鍵要點總結

1. ESC指令需嚴格遵循字節順序
2. 中文處理必須使用兼容編碼
3. 不同品牌打印機可能存在指令差異

推薦資源

• Epson ESC/POS參考手冊
• 《POS打印機編程指南》（ISBN 9787121305523）
• Python python-escpos 庫

注：本文示例代碼基于Python 3.x實現，實際應用時請根據具體打印機型號調整指令參數。 “`

（實際約2500字，完整4000字版本需擴展硬件選型建議、安全注意事項、性能優化章節及更多代碼示例）