热敏打印机编程

Posted 2020-08-20 polymax

      在刚接触热敏打印机的时候，觉得这玩儿意还挺神奇的，这么小个东西，完全摆脱了我之前对打印机笨笨的映像，更神奇的是这东西不需要墨，于是去度娘了下，才发现跟普通的喷墨打印机有本质不同，它是通过打印头加热，使得纸上显示想要的图案，因此这个纸也不一般，表层有特殊的化学涂料，所以以后去超时，饭店吃饭，可不要随随便便的把各种小票放嘴里，其连接方式又可分为网络，蓝牙，USB，串口等等，作为码农来说连接方式与我何干，我只关心如何按照指令打印出我想要的东西，下面逐一介绍。

　　1.指令集

　　几乎看到的所有的热敏打印机都支持EPSON的ESC POS指令，因此首先可以去度娘上找一份热敏打印机指令集，阅读一番

　　2.打印纸宽度

　　目前市面上主要有两种宽度的打印机，58mm和80mm，这是指打印纸的宽度，其中80mm对应384pt，80mm对应586pt

　　2.打印方式

　　（1） 位图模式打印，通过文档发现支持位图打印模式，可以打印图片，就意味着我们可以通过随意定制html模板，然后填充数据，最后渲染成图片，对于打印机来说，就是打印图片，一个接口就可以搞定所有问题，这里只是提供一种思路，具体细节实现不在这里发散，感兴趣可以私信我，通过我们的实践，这种打印方式打印出来的效果最好，字体不受打印机限制，可以打印的特别清楚，这也是最为推荐的一种方式，有几个坑需要注意：

　　a.通过渲染成图片打印并不适应于串口打印机，原因是渲染成图片数据量较大，而串口的传输速度明显不能满足，实测完美支持网口和USB打印机，没有测过蓝牙打印机

　　b.谨防打印机内存溢出，不停的打印乱码，当图片很长的时候，需要进行截断打印，例如一张图片是576*10240，可以截成10章576*1024

　　(2) 通过指令集进行打印，按照指令集文档进行打印，这种打印的优点就是数据量小，非常适合串口打印机，缺点是格式受限制，字体受限制，打出来的小票没有图片打印方式好看，下面是我们在打印过程中的一些常用命令的实现

printerprotocal.h

 1 #ifndef PRINTERPROTOCAL_H
 2 #define PRINTERPROTOCAL_H
 3 #include <vector>
 4 #include <string>
 5 #define SERIAL_SIZE 8
 6 class PrinterProtocal {
 7  private:
 8   std::vector<std::string> data_;
 9   std::string tmp_data_;
10   PrinterProtocal &writeString(std::string str);
11   PrinterProtocal &writeByte(std::initializer_list<uint8_t>);
12  public:
13   PrinterProtocal();
14   enum CharacterSet {
15     USA,
16     FRANCE,
17     GERMANY,
18     UK,
19     DENMARK,
20     SWEDEN,
21     ITALY,
22     SPAIN,
23     JAPAN,
24     NORWAY,
25     DENMARK2,
26     SPAIN2,
27     LATINAMERICA,
28     KOREA,
29     Slovenia,
30     Chinese
31   };
32 
33   enum CodeTable {
34     PC437,
35     PC850,
36     CHINESE = 30
37   };
38 
39   enum AlignMode {
40     LEFT,
41     MIDDLE,
42     RIGHT
43   };
44 
45   enum PrintReadable {
46     NONE,
47     ABOVE,
48     BELOW,
49     BOTH
50   };
51 
52   enum BarcodeType {
53     UPCA,
54     UPCE,
55     EAN13,
56     EAN8,
57     CODE39,
58     I25,
59     CODEBAR,
60     CODE93,
61     CODE128,
62     CODE11,
63     MSI
64   };
65 
66 
67   PrinterProtocal &write(std::string str, int32_t size = 0, char ch = ‘ ‘);
68   PrinterProtocal &init();
69   PrinterProtocal &reset();
70   PrinterProtocal &setFontSize(uint8_t);
71   PrinterProtocal &setControlParameter(uint8_t heatingDots = 20,
72                                        uint8_t heatingTime = 255, uint8_t heatingInterval = 250);
73   PrinterProtocal &setSleepTime(uint8_t seconds = 0);
74   PrinterProtocal &setStatus(bool state = true);
75   PrinterProtocal &setPrintDensity(uint8_t printDensity = 14,
76                                    uint8_t printBreakTime = 4);
77 
78   PrinterProtocal &setDoubleWidth(bool state = false);
79   PrinterProtocal &setBold(bool state = false);
80   PrinterProtocal &setReverse(bool state = false);
81   PrinterProtocal &setUpDown(bool state = false);
82   PrinterProtocal &setUnderline(bool state = false);
83   PrinterProtocal &setKeyPanel(bool state = false);
84 
85   PrinterProtocal &setCharacterSet(CharacterSet set = USA);
86   PrinterProtocal &setCodeTable(CodeTable table = PC437);
87   PrinterProtocal &feed();
88   PrinterProtocal &feed(uint8_t lines);
89   PrinterProtocal &setLineSpacing(uint8_t spacing = 32);
90   PrinterProtocal &setAlign(AlignMode align = LEFT);
91   PrinterProtocal &setLeftBlankCharNums(uint8_t space = 0);
92   PrinterProtocal &setMarginBottom(uint8_t lines = 100);
93   std::vector<std::string> getResult();
94   PrinterProtocal &done();
95 };
96 
97 #endif // PRINTERPROTOCAL_H

 

printerprotocal.cpp

  1 #include "printerprotocal.h"
  2 #include <unistd.h>
  3 #include "base/string_helper.h"
  4 PrinterProtocal::PrinterProtocal() {
  5   reset();
  6 }
  7 
  8 
  9 // write single byte
 10 PrinterProtocal &PrinterProtocal::writeByte(std::initializer_list<uint8_t>
 11     params) {
 12   //先清理
 13   if ((params.size() + tmp_data_.size()) > SERIAL_SIZE) {
 14     done();
 15   }
 16   for (auto ch : params) {
 17     tmp_data_.push_back(ch);
 18   }
 19   return *this;
 20 }
 21 
 22 // write a string
 23 PrinterProtocal &PrinterProtocal::writeString(std::string str) {
 24   for (auto ch : str) {
 25     if (tmp_data_.size() >= SERIAL_SIZE) {
 26       done();
 27     }
 28     tmp_data_.push_back(ch);
 29   }
 30   return *this;
 31 }
 32 //输入str，如果长度小于size，不足的部分用空格填充
 33 PrinterProtocal &PrinterProtocal::write(std::string str, int32_t size,
 34                                         char ch) {
 35   std::string gbk_str = StringHelper::GetGBK(str);
 36   while (static_cast<int>(gbk_str.size()) < size) {
 37     gbk_str.push_back(ch);
 38   }
 39   writeString(gbk_str);
 40   return *this;
 41 }
 42 PrinterProtocal &PrinterProtocal::done() {
 43   if (tmp_data_.size() > 0) {
 44     data_.push_back(tmp_data_);
 45     tmp_data_.clear();
 46   }
 47   return *this;
 48 }
 49 
 50 // initialize the printer
 51 PrinterProtocal &PrinterProtocal::init() {
 52   writeByte({27, 64}).done();
 53   return *this;
 54 }
 55 
 56 // reset the printer
 57 PrinterProtocal &PrinterProtocal::reset() {
 58   data_.clear();
 59   return *this;
 60 }
 61 
 62 // sets the printer online (true) or ofline (false)
 63 PrinterProtocal &PrinterProtocal::setStatus(bool state) {
 64   writeByte({27, 61, (uint8_t)state}).done();
 65   return *this;
 66 }
 67 
 68 // set control parameters: heatingDots, heatingTime, heatingInterval
 69 PrinterProtocal &PrinterProtocal::setControlParameter(uint8_t heatingDots,
 70     uint8_t heatingTime, uint8_t heatingInterval) {
 71   writeByte({27, 55, heatingDots, heatingTime, heatingInterval}).done();
 72   return *this;
 73 }
 74 
 75 
 76 //width,height均表示倍数
 77 PrinterProtocal &PrinterProtocal::setFontSize(uint8_t size) {
 78   //低4位表示高度，高4位表示宽度
 79   uint8_t ret = (0x0f & (2 * size)) | (0xf0 & (16 * size));
 80   writeByte({29, 33, ret}).done();
 81   return *this;
 82 }
 83 
 84 // set the used character set
 85 PrinterProtocal &PrinterProtocal::setCharacterSet(CharacterSet set) {
 86   writeByte({27, 82, (uint8_t)set}).done();
 87   return *this;
 88 }
 89 
 90 // set the used code table
 91 PrinterProtocal &PrinterProtocal::setCodeTable(CodeTable table) {
 92   writeByte({27, 116, (uint8_t)table}).done();
 93   return *this;
 94 }
 95 
 96 //打印并换行
 97 PrinterProtocal &PrinterProtocal::feed() {
 98   writeByte({10}).done();
 99   return *this;
100 }
101 
102 //打印并换lines行
103 PrinterProtocal &PrinterProtocal::feed(uint8_t lines) {
104   writeByte({27, 74, lines}).done();
105   return *this;
106 }
107 
108 //设置行间距
109 PrinterProtocal &PrinterProtocal::setLineSpacing(uint8_t spacing) {
110   writeByte({27, 51, spacing}).done();
111   return *this;
112 }
113 
114 // set Align Mode: LEFT, MIDDLE, RIGHT
115 PrinterProtocal &PrinterProtocal::setAlign(AlignMode align) {
116   writeByte({27, 97, (uint8_t)align}).done();
117   return *this;
118 }
119 
120 //设置左边空白间距
121 PrinterProtocal &PrinterProtocal::setLeftBlankCharNums(uint8_t space) {
122   if (space >= 47) {
123     space = 47;
124   }
125   writeByte({29, 76, space}).done();
126   return *this;
127 }
128 
129 
130 
131 // set Bold Mode: on=true, off=false
132 PrinterProtocal &PrinterProtocal::setBold(bool state) {
133   writeByte({27, 69, (uint8_t)state}).done();
134   return *this;
135 }
136 //设定/解除反白打印模式
137 // set Reverse printing Mode
138 PrinterProtocal &PrinterProtocal::setReverse(bool state) {
139   writeByte({29, 66, (uint8_t)state}).done();
140   return *this;
141 }
142 //设置/解除颠倒打印模式
143 // set Up/Down Mode
144 PrinterProtocal &PrinterProtocal::setUpDown(bool state) {
145   writeByte({27, 123, (uint8_t)state}).done();
146   return *this;
147 }
148 
149 //设置/取消汉字字符下划线模式
150 PrinterProtocal &PrinterProtocal::setUnderline(bool state) {
151   writeByte({28, 45, (uint8_t)state}).done();
152   return *this;
153 }
154 
155 // enable / disable the key on the frontpanel
156 //激活/禁止面板按键
157 PrinterProtocal &PrinterProtocal::setKeyPanel(bool state) {
158   writeByte({27, 99, 53, (uint8_t)state}).done();
159   return *this;
160 }
161 
162 PrinterProtocal &PrinterProtocal::setMarginBottom(uint8_t lines) {
163   writeByte({27, 74, lines}).done();
164   return *this;
165 }
166 
167 std::vector<std::string> PrinterProtocal::getResult() {
168   return data_;
169 }

 

热敏打印机指令集中很多不一定用得到，而且感觉国内生产的这些打印机，对个别指令支持并不是特别好，要想做到完全兼容，还需要个性化的去适配。