在SaaS App中有很多地方需要通過連接藍牙打印機打印結算及訂單小票,而且在結算的時候使用打印機的的頻率比較高,這就需要保證藍牙的鏈接,同時支持各種類型的排版,這篇文章主要是通過藍牙鏈接打印機通過排版和組合各種指令來進行打印,過程比較繁瑣,所以做了一個匯總,以備后續查詢。
藍牙打印機命令
在藍牙打印過程中,首先要保證藍牙鏈接的及時和穩定性,其次比較麻煩的不是搜索、連接藍牙設備,而是小票的排版。要做出樣式整齊好看的小票排版,就得先熟知藍牙打印機的各種命令。在查找資料后,收集到藍牙打印的命令表,每個品牌的打印機,一般在官網或者技術支持哪里可以找到打印機的操作和指令文檔。
打印機分了很多型號,不同的打印機所使用的指令集可能不同,比如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 最多可以允許多少個字節,后面加...
*/
- (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)];
}