iOS 藍牙打印小票命令匯總

在SaaS App中有很多地方需要通過連接藍牙打印機打印結算及訂單小票,而且在結算的時候使用打印機的的頻率比較高,這就需要保證藍牙的鏈接,同時支持各種類型的排版,這篇文章主要是通過藍牙鏈接打印機通過排版和組合各種指令來進行打印,過程比較繁瑣,所以做了一個匯總,以備后續(xù)查詢。

藍牙打印機命令

在藍牙打印過程中,首先要保證藍牙鏈接的及時和穩(wěn)定性,其次比較麻煩的不是搜索、連接藍牙設備,而是小票的排版。要做出樣式整齊好看的小票排版,就得先熟知藍牙打印機的各種命令。在查找資料后,收集到藍牙打印的命令表,每個品牌的打印機,一般在官網或者技術支持哪里可以找到打印機的操作和指令文檔。

打印機分了很多型號,不同的打印機所使用的指令集可能不同,比如Star打印機和Epson打印機,他們的所使用的指令集就不太一樣。我們常用的一般是佳博熱敏打印機使用的是:ESC/POS打印命令集。而一般的打印機支持三種格式:ASCII、十進制、十六進制(一般使用十六進制格式較多)。
這份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 最多可以允許多少個字節(jié),后面加...
  */
  - (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)打印控制命令

ESC&POS打印控制指令

佳博GP-2120TU標簽打印機使用教程-小票篇
佳博打印機技術支持

最后編輯于
?著作權歸作者所有,轉載或內容合作請聯系作者
【社區(qū)內容提示】社區(qū)部分內容疑似由AI輔助生成,瀏覽時請結合常識與多方信息審慎甄別。
平臺聲明:文章內容(如有圖片或視頻亦包括在內)由作者上傳并發(fā)布,文章內容僅代表作者本人觀點,簡書系信息發(fā)布平臺,僅提供信息存儲服務。

相關閱讀更多精彩內容

友情鏈接更多精彩內容