使用 Tulip 排查 Zebra 打印机故障

了解 Zebra 打印机在与 Tulip 配合使用时常见的故障。

调试流程

确定哪些功能正常、哪些异常至关重要。首先，需确认当前使用的是哪种方法/驱动程序。

串行

Player

1. 在 Player 中打开开发者控制台。
2. 如果存在该控制台，请观察**“连接**串行”触发器是否成功连接。a. 如果无法连接，很可能是您的 COM 端口设置错误。
3. 尝试发送一个打印命令。a. 如果没有任何内容打印出来，但也没有发送错误信息，说明您的 zcode 有误。b. 如果没有任何内容打印出来，并且发送了错误信息，请检查该错误。

边缘设备（非Node-RED）

1. 检查设备的日志。
2. 使用左上角的菜单，按**“tulip-cell”**进行筛选，以便于阅读。
3. 查找包含**“serial”或“generic-serial**”的错误

边缘设备 Node-RED

1. 请确保在 Node-RED 启动前打印机已处于开启状态。若非如此，请通过设备的配置页面将 Node-RED 关闭后再重新启用。
2. 确认串口节点中“可用端口”的下拉列表中列有/dev/ttyUSB 路径。除非您使用的是 EIO 上的 RS232 端口，否则请使用 /dev/ttyS 系列中的某个端口
3. 确认“串行”节点显示为已连接。
4. 观察串口节点在调试面板中的输出内容。a. 若显示超时，说明在 Node-RED 运行时打印机未开启且未连接。请重启 Node-RED。
5. 如果没有错误，说明您的 zcode 存在问题。

网络

Player

1. 请使用常见问题解答中列出的方法之一确认打印机的 IP 地址是否正确：我的打印机 IP 地址是什么？a. 请记住！ 如果您通过“配置标签”获取 IP 地址，打印机将把地址的每个字节打印为三个字符——例如 010.001.002.003。Tulip 不支持这种格式！请去除前导零：10.1.2.3。
2. 请观察开发控制台。如果未显示任何错误，说明您的 Zcode 有误。

首次连接 Zebra 打印机时，请尝试进行一次简单的打印，以确保没有遇到 ZPL 错误。例如使用以下触发指令：

如果出现此类错误，请查看开发者控制台面板——超时提示表明您的 IP 地址可能有误，或者您的 Player 未与打印机处于同一网络中。

如果问题仍然存在且您可以访问终端，请运行“ping（在此处输入 IP 地址）>”。

边缘设备

1. 请确保边缘设备已联网，且触发器已配置为正确的设备/工作站等。
2. 请确保边缘设备仅通过 LAN 端口连接到打印机！a. 只要边缘设备的 WAN 端口连接了任何设备，它就会尝试通过该连接访问互联网，即使它也配置了 Wi-Fi 也不例外！
3. 请使用常见问题解答中列出的方法之一确认打印机的 IP 地址是否正确：（我的打印机 IP 地址是什么？）a. 请记住！ 如果您通过配置标签获取 IP 地址，打印机会将地址的每个字节打印为三个字符——例如 010.001.002.003。Tulip 不支持这种格式！请去除前导零：10.1.2.3。
4. 请查看设备的日志以查找任何错误。使用下拉菜单筛选**“tulip-cell**”，并查找**“zebra”**。

常见问题

我的打印机 IP 地址是什么？

• 任何驱动程序：打印配置标签。IP 地址位于标签顶部。
• 长按 Zebra 打印机上的按钮，直到指示灯闪烁一次，然后松开。它会打印出一连串标签。
• 如果最上面的标签未显示 IP 地址，说明 Zebra 打印机尚未连接到网络。如果是刚开机，请等待片刻让其启动。如果已开机一段时间，请检查连接
• 注意！该标签中的 IP 地址会包含前导零，以确保每个字节长度为三个字符。Tulip 无法识别这种格式！您必须去除前导零——例如，010.128.000.005 应改为 10.128.0.5
• 仅限 Windows 和局域网：在终端中运行ipconfig命令查看 IP 地址。
• 边缘设备：在边缘设备配置门户的**“诊断”页面下查看DHCP 租约**。确认设备已连接到局域网，其 IP 地址应为 10.0.5.X。

我的打印机串口号/路径是什么？

• Windows：右键单击**“开始”按钮**，然后选择**“设备管理器”。展开“COM 设备**”部分，并在列表中找到相应设备。
• 请参考此社区帖子中的方法，让 Tulip 自动检测端口号！
• 边缘设备：端口号为 /dev/ttyUSB$，其中 $ 表示该设备插入时的顺序编号（从 0 开始计数）。
• 例如，如果是第一个插入的设备，则为 …USB0
• 请注意！使用 Node-RED 时，必须在 Node-RED 启动前确保打印机已连接并通电。请在设备配置门户上切换开关以重启 Node-RED。

IP 地址和 COM 端口都正确，但打印机没有输出任何内容？

请确保您的 ZCode 有效。要检查这一点，只需将其粘贴到 Labelary 中。如果无法编译，则说明您的代码有误。

请注意，如果您的表达式中包含换行符（例如：按下回车键或粘贴多行 ZPL），即使 ZPL 代码本身有效，也可能无提示地失败。请删除所有换行符，确保 ZPL 代码是一个连续的字符串。

为什么我的标签打印偏离中心？

这是因为打印机的配置标签尺寸与其实际尺寸不符，导致其对“原点”（标签左上角）的判断出现偏差。

您可以在 zcode 中使用 ^LH 等“将所有内容向左偏移”的命令来修复此问题，但这并非可持续或负责任的方法，因为它只能修复该张标签。此外，该偏移量会一直保留在打印机中，直到重启打印机为止——因此您可能会导致其他标签打印出错！

正确的解决方法是下载Zebra 设置实用程序，通过 USB 将打印机连接到计算机，并使用该实用程序设置正确的标签尺寸。您还可以使用该实用程序打印配置页，以确认更改已生效。

为什么我的打印机指示灯在闪烁？

• 绿色闪烁指示灯：打印机需要进行自校准。请按一下按钮。
• 红色指示灯闪烁：存在卡纸或缺纸等问题。

我觉得我的 Zcode 有问题，但不知道具体哪里不对？

最简单的方法是调试您的触发器，通过检查记录的触发器操作来查看实际发送的 Zcode 消息内容。请注意，这通常不包含保存在设备配置中的模板信息，因此您需要将模板信息粘贴到 Labelary 中进行查看。

如果消息中包含任何变量（例如使用串行方法发送表达式），请确保它们不为空！表达式中的任何空变量都会导致整个消息为空。除非在其他地方打印该表达式，或在调试窗格中检查触发器，否则无法察觉此问题。

标签的使用

请注意，标签有两种不同的类型。一种类型的打印机无法打印另一种类型的标签——打印出来的标签将是一片空白！

热敏打印

如果打印机内部仅装有标签卷，则该打印机属于直接热敏打印机。如果标签在受热时开始变黑，则这些标签属于直接热敏标签。打印机向标签施加热量，反应性墨水变黑从而形成图像。这种打印方式不需要额外的“材料”作为墨水，仅需标签本身即可。

热转印打印

如果打印机内部有两个卷筒：色带和标签，则您的打印机是热转印打印机。如果标签在受热时不会发生反应，则您的标签是热转印标签。

您找到想要的信息了吗？

您也可以访问community.tulip.co发布您的问题，或查看其他人是否遇到过类似问题！