iOS 蓝牙打印小票命令汇总

在SaaS App中有很多地方需要通过连接蓝牙打印机打印结算及订单小票,而且在结算的时候使用打印机的的频率比较高,这就需要保证蓝牙的链接,同时支持各种类型的排版,这篇文章主要是通过蓝牙链接打印机通过排版和组合各种指令来进行打印,过程比较繁琐,所以做了一个汇总,以备后续查询。

蓝牙打印机命令

在蓝牙打印过程中,首先要保证蓝牙链接的及时和稳定性,其次比较麻烦的不是搜索、连接蓝牙设备,而是小票的排版。要做出样式整齐好看的小票排版,就得先熟知蓝牙打印机的各种命令。在查找资料后,收集到蓝牙打印的命令表,每个品牌的打印机,一般在官网或者技术支持哪里可以找到打印机的操作和指令文档。

打印机分了很多型号,不同的打印机所使用的指令集可能不同,比如Star打印机和Epson打印机,他们的所使用的指令集就不太一样。我们常用的一般是佳博热敏打印机使用的是:ESC/POS打印命令集。而一般的打印机支持三种格式:ASCII、十进制、十六进制(一般使用十六进制格式较多)。
这份PDF文件说明了各个命令的作用和对应的三种格式:打印命令集打印控制命令.pdf)

打印命令一览表

下表中都是用ASCII码格式

727768-ed26a9ae574b08d3.png

命令详解

下面会详细的介绍每个每一个命令对应的ASCII码、十进制和十六进制格式

1、初始化命令

初始化或者重置

初始化.png

2、打印命令

打印命令有两种

打印命令.png

3、行间距设置

行间距设置.png

4、对齐设置

对齐设置.png

5、对齐设置

5.png

6.png

7.png
8.png

6、钱箱控制命令

9.png

7、按键控制命令

10.png

8、图形打印命令

727768-44b62ecabba7c7e9.png

11.png

9、图形打印命令

12.png

13.png

10、条码打印命令

14.png

101.png

11、位置和页模式命令

16.png

18.png

12、切纸模式

102.png

换行和制表符:

直接输出对应的字符:这两个指令在打印订单详情的时候使用最多。尤其是制表符,可以让每一列的文字对齐。

常用的打印机命令方法

 /** 文字对齐方式 */
 typedef NS_ENUM(NSInteger, LLTextAlignment) {
     LLTextAlignmentLeft = 0x00,
     LLTextAlignmentCenter = 0x01,
     LLTextAlignmentRight = 0x02
 };

 /** 字号 */
 typedef NS_ENUM(NSInteger, LLFontSize) {
     LLFontSizeTitleSmalle = 0x00,
     LLFontSizeTitleMiddle = 0x11,
     LLFontSizeTitleBig = 0x22
 };


  /** * 换行 */
 - (void)appendNewLine
 {
       Byte nextRowBytes[] = {0x0A};
       [_printerData appendBytes:nextRowBytes length:sizeof(nextRowBytes)];
 }

 /** * 回车 */
 - (void)appendReturn
 {
       Byte returnBytes[] = {0x0D};
       [_printerData appendBytes:returnBytes length:sizeof(returnBytes)];
 }

  /** * 设置对齐方式 * @param alignment 对齐方式:居左、居中、居右 */
 - (void)setAlignment:(LLTextAlignment)alignment
 {
       Byte alignBytes[] = {0x1B,0x61,alignment};
       [_printerData appendBytes:alignBytes length:sizeof(alignBytes)];
 }

  /** * 设置字体大小 * 
 @param fontSize 字号
 */
 - (void)setFontSize:(LLFontSize)fontSize
 {
       Byte fontSizeBytes[] = {0x1D,0x21,fontSize};
       [_printerData appendBytes:fontSizeBytes length:sizeof(fontSizeBytes)];
 }

 /** * 添加文字,不换行
 * @param text 文字内容
 */
 - (void)setText:(NSString *)text
 {
       NSStringEncoding enc = CFStringConvertEncodingToNSStringEncoding(kCFStringEncodingGB_18030_2000);
       NSData *data = [text dataUsingEncoding:enc];
       [_printerData appendData:data];
 }

 * 添加文字,不换行
 * * @param text 文字内容
 * @param maxChar 最多可以允许多少个字节,后面加...
 */
 - (void)setText:(NSString *)text maxChar:(int)maxChar
 {
 NSStringEncoding enc = CFStringConvertEncodingToNSStringEncoding(kCFStringEncodingGB_18030_2000);
 NSData *data = [text dataUsingEncoding:enc];
 if (data.length > maxChar) {
       data = [data subdataWithRange:NSMakeRange(0, maxChar)];
       text = [[NSString alloc] initWithData:data encoding:enc];
       if (!text) {
             data = [data subdataWithRange:NSMakeRange(0, maxChar - 1)];
             text = [[NSString alloc] initWithData:data encoding:enc];
       }
       text = [text stringByAppendingString:@"..."];
 }
       [self setText:text];
 }

  /** * 设置偏移文字
 * @param text 文字 偏移设置必须在文字设置之前
 */
 - (void)setOffsetText:(NSString *)text
 {
       // 1.计算偏移量,因字体和字号不同,所以计算出来的宽度与实际宽度有误差(小字体与22字体计算值接近)
       NSDictionary *dict = @{NSFontAttributeName:[UIFont systemFontOfSize:22.0]};
       NSAttributedString *valueAttr = [[NSAttributedString alloc] initWithString:text attributes:dict];
       int valueWidth = valueAttr.size.width;
       // 2.设置偏移量
       [self setOffset:368 - valueWidth];
       // 3.设置文字
       [self setText:text];
 }

  /** * 设置偏移量
 * @param offset 偏移量
 */
 - (void)setOffset:(NSInteger)offset
 {
       NSInteger remainder = offset % 256;
       NSInteger consult = offset / 256;
       Byte spaceBytes2[] = {0x1B, 0x24, remainder, consult};
       [_printerData appendBytes:spaceBytes2 length:sizeof(spaceBytes2)];
 }

 /** 设置行间距
 * @param points 多少个点
 */
 - (void)setLineSpace:(NSInteger)points
 {
       //最后一位,可选 0~255
       Byte lineSpace[] = {0x1B,0x33,points};
       [_printerData appendBytes:lineSpace length:sizeof(lineSpace)];
 }

 /** 设置行默认间距 2 
 * 设置行间距为1/6英寸,约34个点
 */ 同一个打印流程中如果设置多个行间距,后面的设置会覆盖掉前面的间距设置
 - (void)seDefaultLineSpace
 {
     Byte lineSpace[] = {0x1B,0x32};
     [_printerData appendBytes:lineSpace length:sizeof(lineSpace)];
 }

/***  设置尾部换行间距
 *  @param points 多少个点
 */
- (void)setFooterSpace:(NSInteger)points
{
    //最后一位,可选 0~255
    Byte footerSpace[] = {0x1B,0x4A,points};
    [_printerData appendBytes:footerSpace length:sizeof(footerSpace)];
}

文档备注

ESC(POS)打印控制命令%E6%89%93%E5%8D%B0%E6%8E%A7%E5%88%B6%E5%91%BD%E4%BB%A4.pdf)

ESC&POS打印控制指令

佳博GP-2120TU标签打印机使用教程-小票篇
佳博打印机技术支持

-------------本文结束感谢您的阅读-------------