# 得实打印机

来源快照：`result_data_new_260518.json`

- 来源 ID：`1251556463857106944`
- 模块：资产管理
- 目录：标签打印
- space ID：`1183287979989131273`
- 原文链接：未提供
- 产品基线：未提供

## 正文

# 一、前置准备

工具准备：请提前将标签纸、碳带、打印机等相关硬件设施正常安装，并开启电源键，通过USB正常连接某台Windows电脑。

环境要求：WindowsPC

网络要求：OA服务器 需要可以访问 打印机USB连接的电脑。

如何检测网络条件是否满足？参考3.3

二、

# 核心操作

## 2.1、如何配置打印机？

**第一步** ：**开启** 打印机，并**通过USB** 连接一台Windows电脑 （下文简称打印PC）。

**第二步** ：在打印PC**下载附件** 【得实打印机智能助手1.0.97.exe】并**安装运行** ，效果如下图：

![](https://weapp.eteams.cn/papi/file/preview?fileId=1251556592680927246&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

点击**连接** ，**选中** 对应**型号打印机** ：

![](https://weapp.eteams.cn/papi/file/preview?fileId=1251556592518643721&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

**连接** 成功**后** 点击**更新** ：

选择**更新文件** DL735RFID_vA8.07.04.00.zip（从附件下载）点击开始后等待更新完成即可

![](https://weapp.eteams.cn/papi/file/preview?fileId=1251556583979040772&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

更新完毕后，点击【测试】，如果打印机可以正常出纸，代表硬件层面**准备工作完成，退出【助手】程序** 。

**第三步** ：**下载** 附件【得实TP2x-Windows-SDK-V1.1.1570.7.7z】并在打印PC上**解压，运行** ：

DSTP2x的运行程序：\1.1\web_server\x64，**右键以管理员身份运行** 当前目录下的 DSTP2xWebPrtServer.exe；运行后效果如下图：

![](https://weapp.eteams.cn/papi/file/preview?fileId=1251556584149712910&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

**第四步** ：**添加** 打印PC的**防火墙入站规则** ，确保打印服务的端口可以正常被访问。

打开防火墙高级设置，点击入站规则，新建规则，选择TCP协议，端口配置 9001

![](https://weapp.eteams.cn/papi/file/preview?fileId=1251556596855554053&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

![](https://weapp.eteams.cn/papi/file/preview?fileId=1251556588226576402&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

**第五步** ：获取打印PC的IP，尝试访问打印服务，**确认服务运行状态**

win+R呼出CMD命令，输入：ipconfig，拿到ipv4地址，如下图

![](https://weapp.eteams.cn/papi/file/preview?fileId=1251556596938448901&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

假设IPv4的地址是：10.10.20.5，那么当前打印PC的服务则为[ _http://10.10.20.5:9001_](http://10.10.20.5:9001)

通过任意浏览器访问该地址，如果出现如下图效果，代表服务运行正常：

![](https://weapp.eteams.cn/papi/file/preview?fileId=1251556596917174275&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

**第六步** ：将打印**服务注册到OA系统** 中。

使用管理员账号登录系统，访问菜单：设置—>物联设备，准备将我们刚刚启用的打印机注册到OA系统中：

![](https://weapp.eteams.cn/papi/file/preview?fileId=1251556588299173892&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

点击【添加设备】，在弹出的表单页面中，填入打印设备相关的信息，如下图：

![](https://weapp.eteams.cn/papi/file/preview?fileId=1251556601119866888&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

## 2.2、如何配置打印模板？

使用管理员账号，在设置->标签打印->标签模板中新建

![](https://weapp.eteams.cn/papi/file/preview?fileId=1251556579717627907&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

![](https://weapp.eteams.cn/papi/file/preview?fileId=1251556579742326793&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

保存后，页面自动跳转到模板设计器，可在模板设计器中通过新增、拖拽元素，搭建自己的模板效果：

![](https://weapp.eteams.cn/papi/file/preview?fileId=1251556584154210305&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

附件提供了一份65*35的标准模板（资管家6535标准模板.txt），如有需要，可下载后复制内容到配置项中保存使用，效果如下：

![](https://weapp.eteams.cn/papi/file/preview?fileId=1251556584087625735&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

## 2.3、如何批量打印？

在资产列表中，通过顶部【标签打印】按钮可批量选择数据，前往打印页面：

![](https://weapp.eteams.cn/papi/file/preview?fileId=1251556579742326789&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

![](https://weapp.eteams.cn/papi/file/preview?fileId=1251556601141141511&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

注意：如果你的标签打印机中放置的是非RFID芯片标签纸，请关闭RFID模式。

# 三、后续查询

## 3.1、如何查询打印记录？

在打印页面右侧区域提供了打印历史记录查询入口，每一次打印操作都会留痕记录。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1251556588226576393&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

## 3.2、如何查询打印服务日志？

日志目录：C:\Users\用户名\AppData\Local\Temp\DSSDKTemp\ThermalLog；

也可按下Win＋R键，输入“%temp%”命令，然后回车，找到DSSDKTemp文件夹，里面就是得实服务运行记录的日志

![](https://weapp.eteams.cn/papi/file/preview?fileId=1251556601250717703&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

## 3.3、如何检测OA服务器是否可以访问打印服务？

打印请求是需要通过OA服务器中转抵达的，因此需要OA服务可以正常访问打印服务，以下是Linux检测网络的常见方式：

1.

### 使用 curl 命令（推荐，直接检测 HTTP 服务响应）

示例：curl -v [_http://10.10.10.1:9001_](http://10.10.10.1:9001)

成功访问：会显示 HTTP 响应（如状态码 200、404 等）

失败情况：

连接超时：可能网络不通或目标端口未开放

拒绝连接：目标端口未监听服务

无法解析主机：IP 地址格式错误或 DNS 问题

2.

### 使用 wget 命令（下载服务响应内容）

示例：wget -O - [_http://10.10.10.1:9001_](http://10.10.10.1:9001)

成功：会显示下载进度和服务返回内容

失败：会提示 "无法连接"、"超时" 等错误

3.

### 先检测端口是否可达（排除网络层问题）

示例：telnet 10.10.10.1 9001

端口开放：telnet 会显示 "Connected"；nc 会显示 "succeeded!"

端口未开放：会提示 "Connection refused" 或超时

如果OA服务器没有办法访问打印服务，需要将打印服务做内网穿透映射到外网，并且配置相关安全策略，如仅限OA服务器的IP可访问。示例：打印服务：[ _http://10.10.10.1:9001_](http://10.10.10.1:9001) ，通过穿透映射，产生一个外网地址：http://zgjprint-server-demo.com.cn:9001(http://172.14.20.152:9001)。

四、

# 问题解决

以下是一些常见的得实标签打印机使用报错提示及解决方案，更多问题常见解决方案可参考附件DSTP2x-xxxxxx.zip解压后的1.1\doc\index.html

![](https://weapp.eteams.cn/papi/file/preview?fileId=1251556584149712898&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

## 1、枚举失败

①请检查打印机是否已正常开机；  
② 请检查是否正确使用usb线将打印机和电脑U口连接起来；  
③ 请检查打印机与电脑的usb物理连接线是否松脱；  
④ 可能是当前SDK尚未支持的新上市产品，请打印自检页并联系工厂技术支持人员协助分析确认；  
⑤ 如果当前是网页应用，请查看在客户端上 DSTP2xWebPrtServer.exe 服务是否已启动；

## 2、连接串口打印机失败

① 请检查软件与打印机的波特率是否一致，如果不清楚打印机波特率，可以通过打印自检页或者用智能助手连接打印机查看；  
② 如果是使用u转串转接板或u转串转接线进行连接的，请确保已正确安装U转串驱动，再进行串口连接操作；

## 3、打印不全/打印效果大小与预期不符

① 请检查打印机放纸位置是否正确，放纸后有没有用逼纸块固定好纸张；  
② 请通过自检页查看当前页长值来确定打印机已正确实施过标签定位；  
③ 请检查程序中设置的dpi是否与打印机当前的dpi一致。如果dpi设置比该机器实际dpi大，换算后，打印数据整体会被放大，可能超标签规格，导致打印不全；比如DL-218（203dpi），如果接口中设置为300dpi，代码数据里10mm，打出来实际会变成15mm，打印出来的尺寸会比预期大。应根据打印机的实际DPI（如203dpi）进行正确设置；  
④ 请检查打印数据内容或坐标有没有超过标签的大小，模板以及接口参数设置的页长页宽要按实际标签规格设置；  
 

## 4、打印效果坐标问题

①横坐标问题  
检查一下机器放纸位置有没有偏移；  
检查打印数据前，有没有调用接口设置页长页宽，因机器有差异，可能计算坐标的起始位置有差异，因此需先按实际打印需求设置页长页宽；  
②纵坐标问题  
检查一下有没有对标签进行定位校准,可打印自检页看看定位出来的页长是否跟实际标签一样打印（±2mm为正常范围），打印自检页方法：  
【DP便携系列】：开机状态下长按走纸键，等待打印自检页；  
【DL桌面系列】：关机状态，按走纸键开机，响一声松开手打印自检页；带面板机器可进入测试模式菜单-->>自检打印操作打印自检页；  
如果使用黑标纸进行定位，要把传感器改成反射再进行定位；如果是用标签间隙来定位，传感器改成穿透，穿透需要上下传感器都对齐，要移到对着标签间隙的位置再进行定位；如果模式错误，会影响打印出来的纵坐标位置；  
**批量打印时如果上一张没有打印完成，就发送下一张，导致位置打偏，建议打印流程发送前获取状态（目前版本打印默认同步返回打印状态结果），状态正常情况下，再进行发送下一份数据打印；**

##  5、打印有动作但无内容

① 请检查纸张类型是否使用正确；如使用普通纸张则需安装碳带（DP系列一般只能使用热敏纸）；  
② 请检查纸张是否装反了（热敏纸可用指甲划一下表面，会有明显划痕为打印面）；  
③ 检查打印内容坐标是否超出标签范围，例如：实际标签规格宽高为40*30，打印文本内容横坐标设置为40mm，那么内容显示超出画布；  
④ 批量打印丢数据缺漏乱码，先重启一下打印机清除打印机数据，数据不要一次发送太多或多份数据不要发送太快；建议批量打印流程：每份数据发送前先轮询获取状态，判断状态正常（有纸、联机、设备不忙、缓存空无其它报错等状态情况下，再进行发送下一份数据打印；

## 6、打印数据发送成功但打印机没有动作

①检查打印机仿真模式与发送的仿真是否一致；  
②检查打印机是否处于异常状态  
按走纸键打印机是否能正常走一张标签纸,如机器卡死没有动作可重启机器再重新操作  
查看打印机面板或指示灯是否处于报错状态（有面板机器会直接返回错误信息，无面板机器指示灯会亮红灯），如果因报错导致无法打印，可取消报错状态或重启机器再操作

## 7、发送数据后打印机面板报“rfid无epc”或指示灯报错

## **【报错含义】：**  
打印机当前已开启RFID功能，但打印机执行打印数据时并未捡到任何待处理的RFID数据；  
**【诊断步骤及应对措施】：**

**如果当前应用场景无需RFID相关功能，可在系统中打印时，关闭RFID模式** 。  
如当前应用场景无需RFID功能，请通过面板或“智能助手”关闭RFID功能；否则，请在调用DSTP2x_PrintXXX前先调用DSTP2x_LcRfid_SetData，确保已向打印机固件下发RFID数据。打印机开启RFID功能但只发送了打印数据没有写epc，打印机只收到打印数据，没有epc数据所致；  
如不需要打印RFID标签可用“智能助手”关闭RFID功能，如需打印RFID必须先动态写入epc数据再打印；

## 8、执行打印PDF时返回"42074112"报错

**【错误码含义】：**  
未能找到相对应插件  
**【应对措施】：**  
检查依赖的sdkcfg.xml文件有没有配置好pdf插件路径  
目前支持两种形式打印PDF，内部逻辑处理PDF在sdkcfg.xml文件中设置为“0”并且需要授权文件，如需PDF插件则需先插件配置路径；

## 9、执行打印PDF返回“42074113”报错

**【错误码含义】：**  
程序试图使用PDF打印功能，但未能找到相应的插件  
**【应对措施】：**  
检查依赖的sdkcfg.xml文件有没有配置好pdf插件路径，需要根据实际存放xpdf文件路径调整;

## 10、执行打印返回“25182210”报错

**【错误码含义】：**  
usb发送数据失败  
**【应对措施】：**  
① 请先检查电脑与打印机的通讯是否正常（检查电脑识别打印机是否正常、usb线是否掉了，电脑是否中途关机或重启等情况）；  
② 如果有其他软件占用端口收发数据会导致调用发送超时，就会发送数据失败；  
③ 如以上步骤都检查过，可重启打印机或再进行操作验证；  
④ 如果重启打印机后，该问题还是必现或出现频率很高，可依次按如下步骤进行排查：  
► 更换一条usb连接线再进行验证  
► 更换另一台电脑再进行验证

## 11、执行打印返回“25182213”报错

**【错误码含义】：**  
usb接收不到应答数据  
**【诊断步骤及应对措施】：**  
① 请先检查usb连接线是否松脱；如是，请重新接牢；  
② 请先检查打印机是否被电脑正常识别；  
③ 请确认程序是否对一台（RFID功能尚未开启的）RFID打印机调用了RFID相关的读取功能；如是，请先开启打印机的RFID功能，然后重启打印机后再进行验证；  
④ 请通过按打印机的按键观察打印机是否有动作进而判断打印机当前是否卡死；  
⑤ 请检查打印机当前是否报错；如是，请先消除当前报错，然后再次操作看通讯是否正常；  
⑥ 请确认打印机固件与SDK是否适配；此诊断策略适用于以下情况：  
► 首次使用SDK与打印机对接开发项目  
► 最近升级过打印机固件或SDK版本  
**如果是读epc/user/tid时返回错误：**  
① 打印自检页，检查一下该打印机是普通打印机、高频打印机还是RFID超高频打印机，如果是RFID超高频打印机，检查是否没有开启 RFID 的功能；  
② RFID标签用软件测试前，是否没有进行RFID标签定位校准（要确保标签定位校准成功：校准成功后，按一下走纸键，走一张标签，且打印自检页，能看到校准后的标签页长是实际标签页长，定位后标签页长有±1mm左右误差都是正常的。）  
③ 读写功率或频段设置的不对，可用智能助手修改频段再重新定位检验RFID标签；  
④ 观察走纸动作是否异常；是否有卡纸、滑纸或碳带粘住标签等异常动作，导致RFID 标签芯片没有到达打印机读写芯片位；  
⑤ 检查标签是否损坏或有无进行过特殊操作，如销毁标签操作等等；

## 12、执行打印返回“25198597”报错

**【错误码含义】：**  
TCP发送数据失败  
**【应对措施】：**  
① 请检查打印机是否已正常开机;  
② 请检查打印机与电脑、（与电脑组网的）交换机/路由器的网线是否松脱;  
③ 请检查电脑是否能ping通打印机;  
④ 请通过telnet PrinterIp 9100命令（PrinterIp为打印机Ip地址）检查打印机的9100端口当前是否可连通;

## 13、执行打印返回“25198604”报错

**【错误码含义】：**  
未能从TCP接收到打印机的应答数据  
**【应对措施】：**  
① 请检查打印机是否已正常开机;  
② 请检查打印机与电脑、（与电脑组网的）交换机/路由器的网线是否松脱;  
③ 请检查电脑是否能ping通打印机;  
④ 请通过telnet PrinterIp 9100命令（PrinterIp为打印机Ip地址）检查打印机的9100端口当前是否可连通;  
⑤ 请确认打印机固件与SDK是否适配；此诊断策略适用于以下情况：;  
► 首次使用SDK与打印机对接开发项目  
► 最近升级过打印机固件或SDK版本 

## 14、执行打印返回“42270720”报错

**【错误码含义】：**  
打印机返回给SDK的状态数据表明打印机当前出错了  
**【应对措施】：**  
检查打印机是否处于报错状态，查看打印机面板或指示灯状态（有面板机器会显示错误信息，无面板机器指示灯会亮红灯）。其次，带面板的机器，需要再检查打印机是否处于非打印就绪界面，如果因报错或其它原因导致无法打印，可先取消报错状态或直接重启机器，机器恢复正常状态再继续操作；

## 15、加载动态库返回“41992207”报错

**【错误码含义】：**  
已有依赖库的程序运行，表明当前已有一个基于libDSThermal.dll或libDSThermal.so的程序正在运行，再多开一个程序导致的报错;  
**【应对措施】：**  
原则上同一时间只由一个应用程序独占使用打印机；通过任务管理器查看是否已有DSTP2xDemo.exe、DSTP2xWebPrtServer.exe、DSTP2xDemo.out、DSTP2xWebPrtServer.out或者客户基于libDSThermal.dll或libDSThermal.so开发的程序正在运行，并由客户决定最终让哪个程序运行;

## 16、打印RFID标签会打印“作废”字样

**【报错含义】：**  
对于带epc/user数据的RFID打印操作，当打印过程中打印机无法将epc/user数据写入标签芯片时，打印机会在当前标签上打印“作废”字样；然后转到下一张标签进行补打，如果连续三次补打依旧失败，打印机将报错并停止工作；  
**【诊断步骤及应对措施】：**  
① 请检查标签是否已损坏。  
② 请检查标签有没有对标签进行RFID标签定位校准（换不同规格标签/更新升级固件/打印机恢复出厂设置等操作后，都需要重新进行RFID标签定位校准操作）  
③ 请检查是否对不带user区的标签执行写user操作。  
④ 请检查epc/user数据是否过长。可以查看标签规格书看标签支持多少数据，如果超标签规格，会因写不进去导致打印作废。  
⑤ 请检查将要写入的epc/user数据长度是否合法。ASCII类型数据长度必须为2个字符的整数倍，HexStr类型数据长度必须为4个字符的整数倍。  
⑥ 使用了普通标签进行打印，无法读写到标签RFID区域；  
⑦ 标签协议与机器模块不设配（比如标签的频段对不上，高频协议标签在超高频机器上使用）  
⑧ 如果是特殊标签，需要对应标签规格书的要求进行操作；检查标签密码是否定制，还有标签epc/user数据长度写入规则是否不一样。

## 17、关于锁定标签的注意事项

① 锁定/解锁操作均须在打印前调用执行。  
② 如需已修改过密码，后续写入epc、user时都需要带新密码进行操作，否则打印机会因无法写入而打印作废及执行补打；

## 18、微软、UC、QQ、edge、谷歌、猎豹等浏览器跨域问题

**【报错原因】：**  
目前打印服务已支持对浏览器发起跨域请求，但如果出现谷歌浏览器上返回跨错误时，由于谷歌98版本之后，网站对私有服务发出请求前，浏览器都会自动发出一个“预检请求”，如果服务不认识预检请求，就不会正确返回，浏览器便会拦截所有预检请求不通过的请求。同时报跨域的错误；  
**【处理措施】：**  
因为是浏览器拦截了数据包的请求；该跨域问题在于浏览器本身，新版本的谷歌浏览器就需要进入浏览器在地址栏输入：chrome://flags/#block-insecure-private-network-requests 回车访问 搜索Block insecure private network requests，将其设置为Disabled后重启浏览器运行才能解决；

![](https://weapp.eteams.cn/papi/file/preview?fileId=1251556592518643726&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

19、

## 打印机面板提示“缺纸错误”，如何解决？

![](https://weapp.eteams.cn/papi/file/preview?fileId=1251556592518643714&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

 

第一步：关机，长按住下方>>键，开机，听到滴的两声后松手

第二步：打开该打印机服务器的得实助手连接打印机，点击RFID标签校验，校验进度100%后可打印检验效果。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1251556601141141505&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)
