云打印对接协议
<p><img src="http://doc.szzkc.com/server/../Public/Uploads/2022-06-11/62a44f27760b4.png" alt="" /><img src="http://doc.szzkc.com/server/../Public/Uploads/2022-06-11/62a4513aa0ca6.png" alt="" /><img src="http://doc.szzkc.com/server/../Public/Uploads/2022-06-11/62a4514b04d89.png" alt="" />
<img src="https://www.showdoc.com.cn/server/api/attachment/visitFile?sign=1975f964a8ddc6f760d2bd005afa78ee&amp;file=file.png" alt="" /><img src="https://www.showdoc.com.cn/server/api/attachment/visitFile?sign=742ed507da35e4714c55139c05b40a07&amp;file=file.png" alt="" />
<strong>信息说明:</strong>
服务端及客户端的共同约定: 通讯质量等级SOC设置为2, 没有遗嘱信息, 主题为打印机的IMEI号;
服务器提供给客户端的信息: 服务器须提供MQTT的ip, port, 账户, 密码给客户端;
打印机提供给服务器的信息: 打印机提供自身的IMEI给服务器, 这个IMEI用作主题;
<strong>阿里云服务器，采用P2P方式发送消息给设备，需要按照阿里云协议定义Topic</strong></p>
<p><strong>打印过程说明:</strong>
发布端用SOC2向指定的主题(topic)发布信息;
打印机订阅自身IMEI的主题(topic). 接收到信息根据特定的指令来直接打印;</p>
<p><strong>指令说明:</strong>
多联打印指令
（16进制格式）
1E 10 multi_cnt len_MSB len_LSB N1 N2 N3 ... Nk 1B 63 CRC16_MSB CRC16_LSB </p>
<p>1E 10: 固定头
multi_cnt: 重复打印次数
len_MSB: 有效数据长度, 高位字节, (有效数据长度包含打印内容和标识码和CRC16校验字节)
len_LSB: 有效数据长度, 低位字节, (有效数据长度包含打印内容和标识码和CRC16校验字节)
N1 N2 N3 ... Nk 打印内容
k 打印内容长度, k = (len_MSB*256 + len_LSB - 4) (k表示N1 N2 N3 ... Nk的长度)
1B 63: 标识字节
CRC16_MSB: CRC16校验码, 高位字节, 对打印内容进行的CRC16校验, 仅对 N1 N2 N3 ... Nk 进行校验
CRC16_LSB: CRC16校验码, 低位字节, 对打印内容进行的CRC16校验, 仅对 N1 N2 N3 ... Nk 进行校验</p>
<h1><strong>例如: </strong>打印3联内容为 "ABCD\r\n" 居中打印的订单</h1>
<p>> 十六进制报文为: 1E 10 03 00 0d 1b 61 01 41 42 43 44 0d 0a 1B 63 B2 CA
1E 10： 固定协议头
03： 重复打印次数
00 0d： 有效数据长度，报文总长度减去1E 10 03 00 0a这5个字节的长度
1b 61 01: 对齐指令
41 42 43 44 0d 0a： 要打印的内容："ABCD\r\n"
1B 63： 固定协议尾
B2 CA： 校验结果数据，校验内容：1b 61 01 41 42 43 44 0d 0a，采用CRC16 X25算法，
文末有C语言的源码，其他语言可以根据C语言转换或查找语言对应算法</p>
<p><strong>php高低位运算，长度计算示例</strong></p>
<pre><code class="language-php">&lt;?php
$ZPL=&quot;414243440D0A1B636f90&quot;;
$hexBin=pack(&quot;H*&quot;,$ZPL);
$len=strlen($hexBin);
$lenHex=dechex($len);
$len_MSB=dechex(($len&amp;0xff00)&gt;&gt;8);
$len_LSB=dechex($len&amp;0x00ff);
echo &quot;数据长度：&quot;.$len;
echo &quot;\r数据长度hex：&quot;.$lenHex;
echo &quot;\r最高位是&quot;.$len_MSB;
echo &quot;\r最低位是&quot;.$len_LSB;
?&amp;</code></pre>
<p>打印内容如果是纯文本打印，直接UTF8编码即可，如果需要一些特殊效果，或者条码二维码打印，请参考ESC/POS指令进行编码，打印机指令开发手册。
手册下载地址：[打印机指令开发手册](<a href="http://112.74.26.209:8099/Resource/Data/YC%E6%89%93%E5%8D%B0%E6%8C%87%E4%BB%A4%E9%9B%86200919v1.07.pdf">http://112.74.26.209:8099/Resource/Data/YC%E6%89%93%E5%8D%B0%E6%8C%87%E4%BB%A4%E9%9B%86200919v1.07.pdf</a> "打印机指令开发手册")</p>
<p>云打印QRCode示例：[云打印QRCode代码示例](<a href="http://112.74.26.209:8099/Resource/Data/%E4%BA%91%E6%89%93%E5%8D%B0QRCode%E4%BB%A3%E7%A0%81Java%E7%A4%BA%E4%BE%8B.pdf">http://112.74.26.209:8099/Resource/Data/%E4%BA%91%E6%89%93%E5%8D%B0QRCode%E4%BB%A3%E7%A0%81Java%E7%A4%BA%E4%BE%8B.pdf</a> )
修改后缀.doc，可下载.doc文档</p>
<p><strong>CRC校验工具</strong>
<a href="http://www.ip33.com/crc.html">http://www.ip33.com/crc.html</a>
<img src="http://doc.szzkc.com/Public/Uploads/2019-10-25/5db2b8df1f812.png" alt="" />
<img src="https://www.showdoc.com.cn/server/api/attachment/visitFile?sign=48c637ced52d9f5261fa74dc5ead1365&amp;file=file.png" alt="" /></p>
<hr />
<p><strong>附录: </strong></p>
<p>CRC16校验 PHP算法：</p>
<pre><code class="language-php">&lt;?php
/**
* 将一个字符按比特位进行反转 eg: 65 (01000001) --&gt; 130(10000010)
* @param $char
* @return $char
*/
function reverseChar($char) {
$byte = ord($char);
$tmp = 0;
for ($i = 0; $i &lt; 8; ++$i) {
if ($byte &amp; (1 &lt;&lt; $i)) {
$tmp |= (1 &lt;&lt; (7 - $i));
}
}
return chr($tmp);
}
/**
* 将一个字节流按比特位反转 eg: 'AB'(01000001 01000010) --&gt; '\x42\x82'(01000010 10000010)
* @param $str
*/
function reverseString($str) {
$m = 0;
$n = strlen($str) - 1;
while ($m &lt;= $n) {
if ($m == $n) {
$str{$m} = reverseChar($str{$m});
break;
}
$ord1 = reverseChar($str{$m});
$ord2 = reverseChar($str{$n});
$str{$m} = $ord2;
$str{$n} = $ord1;
$m++;
$n--;
}
return $str;
}
/**
* @param string $str 待校验字符串
* @param int $polynomial 二项式
* @param int $initValue 初始值
* @param int $xOrValue 输出结果前异或的值
* @param bool $inputReverse 输入字符串是否每个字节按比特位反转
* @param bool $outputReverse 输出是否整体按比特位反转
* @return int
*/
function crc16($str, $polynomial, $initValue, $xOrValue, $inputReverse = false, $outputReverse = false) {
$crc = $initValue;
for ($i = 0; $i &lt; strlen($str); $i++) {
if ($inputReverse) {
// 输入数据每个字节按比特位逆转
$c = ord(reverseChar($str{$i}));
} else {
$c = ord($str{$i});
}
$crc ^= ($c &lt;&lt; 8);
for ($j = 0; $j &lt; 8; ++$j) {
if ($crc &amp; 0x8000) {
$crc = (($crc &lt;&lt; 1) &amp; 0xffff) ^ $polynomial;
} else {
$crc = ($crc &lt;&lt; 1) &amp; 0xffff;
}
}
}
if ($outputReverse) {
// 把低地址存低位，即采用小端法将整数转换为字符串
$ret = pack('cc', $crc &amp; 0xff, ($crc &gt;&gt; 8) &amp; 0xff);
// 输出结果按比特位逆转整个字符串
$ret = reverseString($ret);
// 再把结果按小端法重新转换成整数
$arr = unpack('vshort', $ret);
$crc = $arr['short'];
}
return $crc ^ $xOrValue;
}
// CRC-16/X25
printf(&quot;%x\n&quot;, crc16(hex2bin(&quot;414243440D0A&quot;), 0x1021, 0xffff, 0xffff, true, true));
?&gt;</code></pre>
<p>CRC16校验C算法，可以根据不用语言语法转换: </p>
<pre><code class="language-c">/*
* 参数模型 NAME : CRC-16/X25 CRC=X16+X12+X5+1
* 宽度 WIDTH : 16
* 多项式 POLY(Hex) : 1021
* 初始值 INIT(Hex) : FFFF
* 结果异或值 XOROUT(Hex) : FFFF
* 输入数据反转(REFIN) : 使能
* 输出数据反转(REFOUT) : 使能
* MSB/LSB : 高位在左, 低位在右
* 校验工具网址 : http://www.ip33.com/crc.html
*/
const uint16_t tab_crc16[256] =
{
0x0000, 0x1189, 0x2312, 0x329b, 0x4624, 0x57ad, 0x6536, 0x74bf,
0x8c48, 0x9dc1, 0xaf5a, 0xbed3, 0xca6c, 0xdbe5, 0xe97e, 0xf8f7,
0x1081, 0x0108, 0x3393, 0x221a, 0x56a5, 0x472c, 0x75b7, 0x643e,
0x9cc9, 0x8d40, 0xbfdb, 0xae52, 0xdaed, 0xcb64, 0xf9ff, 0xe876,
0x2102, 0x308b, 0x0210, 0x1399, 0x6726, 0x76af, 0x4434, 0x55bd,
0xad4a, 0xbcc3, 0x8e58, 0x9fd1, 0xeb6e, 0xfae7, 0xc87c, 0xd9f5,
0x3183, 0x200a, 0x1291, 0x0318, 0x77a7, 0x662e, 0x54b5, 0x453c,
0xbdcb, 0xac42, 0x9ed9, 0x8f50, 0xfbef, 0xea66, 0xd8fd, 0xc974,
0x4204, 0x538d, 0x6116, 0x709f, 0x0420, 0x15a9, 0x2732, 0x36bb,
0xce4c, 0xdfc5, 0xed5e, 0xfcd7, 0x8868, 0x99e1, 0xab7a, 0xbaf3,
0x5285, 0x430c, 0x7197, 0x601e, 0x14a1, 0x0528, 0x37b3, 0x263a,
0xdecd, 0xcf44, 0xfddf, 0xec56, 0x98e9, 0x8960, 0xbbfb, 0xaa72,
0x6306, 0x728f, 0x4014, 0x519d, 0x2522, 0x34ab, 0x0630, 0x17b9,
0xef4e, 0xfec7, 0xcc5c, 0xddd5, 0xa96a, 0xb8e3, 0x8a78, 0x9bf1,
0x7387, 0x620e, 0x5095, 0x411c, 0x35a3, 0x242a, 0x16b1, 0x0738,
0xffcf, 0xee46, 0xdcdd, 0xcd54, 0xb9eb, 0xa862, 0x9af9, 0x8b70,
0x8408, 0x9581, 0xa71a, 0xb693, 0xc22c, 0xd3a5, 0xe13e, 0xf0b7,
0x0840, 0x19c9, 0x2b52, 0x3adb, 0x4e64, 0x5fed, 0x6d76, 0x7cff,
0x9489, 0x8500, 0xb79b, 0xa612, 0xd2ad, 0xc324, 0xf1bf, 0xe036,
0x18c1, 0x0948, 0x3bd3, 0x2a5a, 0x5ee5, 0x4f6c, 0x7df7, 0x6c7e,
0xa50a, 0xb483, 0x8618, 0x9791, 0xe32e, 0xf2a7, 0xc03c, 0xd1b5,
0x2942, 0x38cb, 0x0a50, 0x1bd9, 0x6f66, 0x7eef, 0x4c74, 0x5dfd,
0xb58b, 0xa402, 0x9699, 0x8710, 0xf3af, 0xe226, 0xd0bd, 0xc134,
0x39c3, 0x284a, 0x1ad1, 0x0b58, 0x7fe7, 0x6e6e, 0x5cf5, 0x4d7c,
0xc60c, 0xd785, 0xe51e, 0xf497, 0x8028, 0x91a1, 0xa33a, 0xb2b3,
0x4a44, 0x5bcd, 0x6956, 0x78df, 0x0c60, 0x1de9, 0x2f72, 0x3efb,
0xd68d, 0xc704, 0xf59f, 0xe416, 0x90a9, 0x8120, 0xb3bb, 0xa232,
0x5ac5, 0x4b4c, 0x79d7, 0x685e, 0x1ce1, 0x0d68, 0x3ff3, 0x2e7a,
0xe70e, 0xf687, 0xc41c, 0xd595, 0xa12a, 0xb0a3, 0x8238, 0x93b1,
0x6b46, 0x7acf, 0x4854, 0x59dd, 0x2d62, 0x3ceb, 0x0e70, 0x1ff9,
0xf78f, 0xe606, 0xd49d, 0xc514, 0xb1ab, 0xa022, 0x92b9, 0x8330,
0x7bc7, 0x6a4e, 0x58d5, 0x495c, 0x3de3, 0x2c6a, 0x1ef1, 0x0f78
};
/*******************************************************************************
* Function Name : adcrc16_encode_stream
* Description : CRC16 编码数据流
* Input Para : void* *src, uint32_t src_len
* Output Para : uint16_t *dst
* Return Value : 0: ok, other: fail;
*******************************************************************************/
int adcrc16_encode_stream(void* src, uint32_t src_len, uint16_t* dst)
{
uint16_t crc_reg = 0xFFFF;
uint8_t* p_src = src;
if((src == NULL)||(dst == NULL)){
return -1;
}
if(src_len == 0){
*dst = 0;
return 0;
}
while (src_len--){
crc_reg = (crc_reg &amp;&amp; 8) ^ tab_crc16[(crc_reg ^ *p_src++) &amp; 0xff];
}
*dst = (~crc_reg);
return 0;
} </code></pre>