故障排除¶
物联网盒子连接¶
无法找到配对码以连接物联网盒子¶
打印配对码应该在连接到收据打印机的 IoT 盒子上打印，并且还应该在连接的显示器上显示。
在以下情况下，配对码不会显示：
The IoT box is already connected to an Odoo database.
The IoT box is not connected to the Internet.
该代码仅在 IoT（物联网） 盒子启动后的 5 分钟内有效。当此时间到期后，它将自动从连接的显示器中移除。
IoT 盒子镜像的版本太旧。如果 IoT 盒子镜像来自较早的版本，则需要重新刷写 IoT 盒子的 SD 卡以更新镜像（参见 刷写 SD 卡）。
如果以上列出的情况均未解决问题，请确保 IoT（物联网） 盒子已正确启动，方法是检查电源端口旁边是否显示固定的绿色 LED 灯。
IoT 盒子已连接，但未在数据库中显示¶
当 IoT（物联网） 盒子连接到数据库时，它可能会重启。如果是这样，可能需要长达五分钟的时间才能在数据库中显示。如果五分钟后 IoT（物联网） 盒子仍未显示，请确保 IoT（物联网） 盒子能够访问数据库，并且服务器没有使用多数据库环境。
要从 IoT 盒子访问数据库，请打开浏览器并输入数据库地址。
IoT盒子已连接到Odoo数据库，但无法访问。¶
确保 IoT 盒子和运行浏览器的计算机位于同一网络上，因为 IoT 盒子无法从本地网络外部访问。
HTTPS 证书未生成¶
为了生成 HTTPS（超文本传输安全协议） 证书，需要为 IoT（物联网） 盒子订阅 IoT 盒子服务。在为数据库和 IoT（物联网） 盒子配置 IoT（物联网） 订阅之前连接 IoT（物联网） 盒子，将会导致不安全的连接。
此外，防火墙还可以阻止 HTTPS 证书的正确生成。在这种情况下，禁用防火墙，直到证书成功生成。还应注意，某些设备，如具有内置防火墙的路由器，可能会阻止 HTTPS 证书的生成。
另请参阅
打印机¶
打印机未被检测到¶
如果打印机未出现在设备列表中，请前往 IoT 盒子主页，并确保其列在 打印机 下。
如果打印机未出现在 IoT 盒子的主页上，请点击 Printers Server，转到 Administration 标签页并点击 Add Printer。如果打印机未出现在列表中，则可能未正确连接。
打印机输出随机文本¶
对于大多数打印机，应该会自动检测并选择正确的驱动程序。然而，在某些情况下，自动检测机制可能不足够，如果找不到驱动程序，打印机可能会打印出随机字符。
解决方案是手动选择相应的驱动程序。在 IoT（物联网） 盒子主页上，点击 打印服务器，进入 打印机 标签页，并从列表中选择打印机。在 管理 下拉菜单中，点击 修改打印机。按照步骤操作，并选择与打印机对应的 品牌 和 型号。
注解
Epson 收据打印机和 Zebra 标签打印机不需要驱动程序即可工作。请确保没有为这些打印机选择驱动程序。
检测到打印机但未正确识别¶
如果打印机未被 Odoo 和 IoT（物联网） 盒子正确识别，请转到设备的表单视图（）并更改子类型。可用的三个选项是：收据打印机、标签打印机 和 办公打印机。
爱普生配置专案¶
大多数爱普生打印机都支持使用 GS v 0 指令在 Odoo POS（销售点） 中打印收据。但是，以下爱普生打印机型号不支持此指令：
TM-U220
TM-U230
TM-P60
TMP-P60II
将打印机配置为使用 ESC* 指令，即可绕过这一问题。
强制执行 ESC * 指令的流程¶
爱普生打印机兼容性¶
第一步是检查打印机是否与 GS v 0 指令不兼容。
另请参阅
Epson GS v 0 文档 适用于
GS v 0兼容打印机。Epson ESC * 文档 适用于
ESC *兼容打印机。
如果打印机不支持 ESC * 命令，则以下过程无法实现。如果打印机支持使用 ESC * 命令进行打印，请按照此过程将打印机配置到 IoT（物联网） 盒子中。
用于 ESC* 的物联网盒子配置¶
要配置 IoT（物联网） 盒子使用 ESC * 命令打印，请通过导航至 进入 IoT（物联网） 盒子主页。然后点击 IP地址，将引导您进入 IoT（物联网） 盒子主页。
选择打印机
现在点击 打印机服务器 按钮。这将把浏览器重定向到 CUPS 页面。接下来，进入 ，选择要修改的打印机，然后单击 继续。
小技巧
如果打印机名称仍不确定，请采取以下步骤：
注意 CUPS 页面上列出的打印机。
关闭打印机并刷新页面。
现在比较两个列表的差异，查看哪个打印机消失了。
重新打开打印机，再次刷新页面。
再次仔细检查列表，看看打印机是否再次出现。
消失并重新出现在打印机列表的就是该打印机名称。
注解
在 本地打印机 下可能显示为 Unknown。
CUPS 命名规范
CUPS 将提示管理员输入三条信息：名称、描述 和 位置。后两条信息不需要特别具体，但 名称 应遵循特定的约定，以便与 ESC * 命令一起使用。
Name 应遵循以下命名规范：<printer_name>__IMC_<param_1>_<param_2>_..._<param_n>__
命名规则的细分：
打印机名称：这是打印机的名称。它可以是任何字符，只要不包含`_`、/、#、或 ` `（空格字符）。IMC: 这代表 *Image Mode Column*（ESC *的简化名称）。param_1：代表特定参数：缩放<X>：图片的缩放比例（保持相同的纵横比）。X应该是一个整数，描述应该使用的缩放百分比。Example
100是原始大小，50是一半大小，200是两倍大小。LDV: 低密度垂直*（如果未指定，将设置为 *高密度垂直）。LDH: Low Density Horizontal*（如果未指定，将设置为 *High Density Horizontal）。注解
密度 参数可能需要根据打印机型号以特定方式进行配置。
另请参阅
访问 Epson’s ESC * 文档，并在上面的表格中点击打印机型号，以查看是否应该设置这些参数。
Example
以下是正确和不正确名称格式的示例：
正确名称格式：
EPSONTMm30II__IMC__EPSON_TM_U220__IMC_LDV_LDH_SCALE80__
名称格式不正确（不会妨碍打印，但结果可能不是预期的打印内容）：
EPSON TMm 30II-> 名称不能包含空格。EPSONTMm30II-> 名称本身是正确的，但它不会使用ESC *。EPSONTMm30II__IMC-> 该名称缺少结尾__。EPSONTMm30II__IMC_XDV__-> 参数XDV与任何现有参数不匹配。EPSONTMm30II__IMC_SCALE__-> 参数SCALE缺少比例值。
完成添加打印机
使用适当的命名约定设置打印机名称后，点击 继续。接下来，将 制造商 值设置为 Raw，并将 型号 值设置为 Raw Queue (en)。
完成这些步骤后，点击 添加打印机。如果一切操作正确，页面应该会重定向到 横幅 页面。
此时，打印机应该已经创建，现在，物联网（IoT） 盒子只需检测到它，然后同步到 Odoo 服务器（这可能需要几分钟时间）。
将打印机添加到 Odoo 销售点 (PoS)
一旦打印机在Odoo数据库中可见，别忘了在 PoS 配置中选择它作为 IoT 打印机。导航至 。
注解
如果打印机设置错误（仍在打印随机文本或打印的收据过大或过小），则不能通过打印机名称 CUPS 进行修改。相反，可以重复上述过程，从头开始设置另一台打印机，创建一台参数已修改的打印机。
使用 ESC 设置 Epson TM-U220B 打印机的示例
以下是使用 ESC * 命令对 TM-U220B 打印机型号进行故障排除的示例。下图中的收据是由于格式正确（理论上）而正确打印的收据示例：
由于 TM-U220B 打印机型号不支持 GS v 0，因此在正确格式化之前立即打印该收据将不起作用。打印出来的将是随机字符：
要正确配置 Epson TM-U220B 打印机型号的格式化，请执行以下步骤。
在查阅了 Epson 网站关于以下两个命令的兼容性后：GS v 0 和 ESC *，可以看出 TM-U220B 确实不兼容 GS v 0，但兼容 ESC *。
添加打印机时，CUPS 会询问应添加哪台打印机：
在这种情况下，打印机通过 USB（通用串行总线） 连接，因此它不会出现在 已发现的网络打印机 中。相反，它很可能是 本地打印机 下的 未知 选项的一部分。通过将打印机的 USB（通用串行总线） 线缆从 IoT（物联网） 盒子上拔下并刷新页面，未知 打印机会消失。重新插上线缆后，打印机会再次出现，因此可以确定这就是所讨论的打印机。
对于命名约定，由于需要使用 ESC * 命令进行打印，因此必须添加 __IMC。参考 Epson 的 ESC * 网站 上的打印机型号，以了解更多关于 density 参数的信息。
对于 TM-U220 这种特定型号，m 应等于 0 或 1。参考上图中粉色方框下方的 描述 时，m 值可能是 0、1、32 或 33。因此，在该打印机中，`m`值不能为 32 或 33（否则将打印出随机字符）。
该表格包含数值：32 和 33，它们都会在 垂直数据的位数 设置为 24 时出现。这意味着这是一个 高垂直密度。在配置 Epson TM-U220 时，需要强制使用 低垂直密度，因为此打印机型号不支持该命令 ESC * 的 高垂直密度。
要添加 低垂直密度，请在命名约定中添加 LDV 参数。
点击 继续 以继续。接下来，将 制造商 值设置为 原始，并将 型号 值设置为 原始队列 (en)。
然而，当尝试使用命名约定 EpsonTMU220B__IMC_LDV__ 进行打印时，虽然可以打印出收据，但收据过大且超出边距。为解决此问题，请添加一个新的打印机（及命名约定），并使用 SCALE<X> 参数以适应我们的收据尺寸。
以下是一些例子：
打印机命名规则 |
|
需要翻译的内容是: |
|
|
|---|---|---|---|---|
|
|
|
|
|
|
DYMO LabelWriter 打印问题¶
DYMO LabelWriter 在使用 IoT（物联网） 盒子打印时存在一个已知问题。OpenPrinting CUPS 服务器使用 本地 RAW 打印机 驱动程序安装打印机。为了能够打印任何内容，需要设置正确的 制造商和型号，以便在使用设备时引用正确的驱动程序。
此外，需要添加一台新打印机以减少更新驱动程序后出现的打印延迟。
重要
DYMO LabelWriter 450 DUO 打印机是推荐与 Odoo 和 IoT（物联网） 盒子一起使用的 DYMO 打印机。它 必须 已经连接到 IoT（物联网） 盒子并被其识别。
DYMO LabelWriter 450 DUO 打印机集两种功能于一体：标签打印机和胶带打印机。在配置以下流程时，选择正确的型号（无论是 DYMO LabelWriter 450 DUO Label (en) 还是 DYMO LabelWriter 450 DUO Tape (en)）至关重要。
为保持一致性，以下两个过程详细介绍了 DYMO LabelWriter 450 DUO Label (en) 型号的配置。需要时请更改型号。
DYMO LabelWriter 无法打印¶
如果 DYMO LabelWriter 无法打印任何内容，则需要安装新的驱动程序。
首先，通过点击 IoT 盒子主页底部的 打开 OpenPrinting CUPS 控制台。接着，点击顶部菜单中的 。点击相关打印机，并在第一个下拉菜单中选择 Maintenance。然后，在第二个下拉菜单中选择 Modify Printer。
接下来，选择应进行修改的特定网络连接/打印机。点击 继续。
在下一页上，点击 继续 以进行设置打印机的 制造商。
在 Make 下从菜单中选择 DYMO。点击 Continue 以设置 Model。
在接下来的页面中，将 Model 设置为 DYMO LabelWriter 450 DUO Label (en)`（或正在使用的任何 DYMO 打印机型号）。点击 :guilabel:`Modify Printer 以完成新驱动程序的设置，随后将出现确认页面。
在重定向到确认页面并确认更新成功后，点击顶部菜单中的 按钮。
安装在 OpenPrinting CUPS 服务器上的所有打印机都会显示出来，包括新更新的： DYMO LabelWriter 450 DUO Label （或正在使用的任何 DYMO 打印机型号）。点击刚刚更新的打印机。
要打印测试标签，请点击 Administration 下拉菜单左侧的 Maintenance 下拉菜单，然后选择 Print Test Page。如果驱动程序更新成功，测试标签将在十秒延迟后打印出来。
要减少此延迟，需要添加一台新的打印机，请按照以下步骤操作。
DYMO LabelWriter 打印延迟¶
要解决修改驱动程序后的延迟问题，必须 重新安装打印机。要重新安装打印机，请点击 ，在 IoT 盒子主页的底部打开 OpenPrinting CUPS 管理页面。然后，点击顶部菜单中的 ，接着点击 Add a Printer。
小技巧
如果 DYMO LabelWriter 450 DUO 打印机完全无法打印，或无法识别（具有 RAW 驱动程序类型），请更新设备上的驱动程序。 参见 DYMO LabelWriter 无法打印。
在下一个屏幕上，在 本地打印机 部分，选择预安装的 DYMO LabelWriter 450 DUO Label (DYMO LabelWriter 450 DUO Label) （或正在使用的任何 DYMO 打印机型号）。点击 继续。
在接下来的屏幕上，将 名称 修改为可识别的名称，因为原始打印机仍然存在。点击 继续 进入下一个屏幕。
接下来，选择 型号。选择 DYMO LabelWriter 450 DUO Label (en)`（或正在使用的任何 DYMO 打印机型号），最后点击 :guilabel:`添加打印机 以完成安装。
在重定向到确认页面并确认安装成功后，点击顶部菜单中的 按钮。
安装在 OpenPrinting CUPS 服务器上的所有打印机都会显示出来，包括新安装的： DYMO LabelWriter 450 DUO Label （或正在使用的任何 DYMO 打印机型号）。点击刚刚安装的打印机。
要打印测试标签，请点击 Administration 下拉菜单左侧的 Maintenance 下拉菜单，然后选择 Print Test Page。测试标签应立即打印出来（延迟一到两秒）。
斑马打印机未打印任何内容¶
Zebra 打印机对打印的 Zebra 编程语言 (ZPL) 代码的格式非常敏感。如果打印机没有输出任何内容或打印空白标签，请尝试通过访问 下）并查找相应的模板来更改发送给打印机的报表的格式。
另请参阅
查看Zebra有关打印 ZPL 文件的说明 此处。
条码扫描仪¶
条码扫描器读取的字符与条码不匹配¶
默认情况下，大多数条码扫描仪都配置为美国QWERTY格式。如果条码扫描仪使用不同的布局，请转到设备的表单视图（）并选择正确的格式。
扫描条形码时没有任何反应¶
确保在 配置中选择了正确的设备，并且条形码配置为在每个条形码的末尾发送一个 ENTER 字符（键码 28）。要这样做，请导航到 。
条形码扫描器被检测为键盘¶
重要
有些条码扫描器不会将自己标识为条码扫描器，而是标识为 USB 键盘，因此无法被 IoT 盒子识别。
设备类型可以通过转到其表单视图 () 并激活 Is scanner 选项来手动更改。
条码扫描器逐个处理条码字符¶
当通过 IoT 盒子从移动设备或平板电脑访问 Odoo 的移动版本，并与条码扫描器配对时，扫描器可能会将每个条码字符处理为单独的扫描。在这种情况下，条码扫描器 表单页面上的 键盘布局 选项 必须 填写为条码扫描器的适当语言。
小技巧
通过导航到 访问条码扫描器表单页面。
The Keyboard Layout is language based, and the options available vary, depending on the device and the language of the database. For example: English (UK), English (US), etc.
现金抽屉¶
现金抽屉无法打开¶
现金抽屉应连接到打印机，并且在 PoS 配置中应勾选 现金抽屉 复选框。要执行此操作，请导航至 。
比例尺¶
称重设备在结账过程中起着至关重要的作用，尤其是对于按重量而非固定价格销售的产品。
设置 Ariva S 秤¶
Odoo 已确定 Ariva S 系列秤（由 Mettler-Toledo, LLC. 制造）中的特定设置需要修改，并且需要一个专用的 Mettler USB（通用串行总线）-to-proprietary RJ45 电缆，以使秤能够与 Odoo 的 IoT（物联网） 盒子一起工作。
要正确配置秤以被 IoT（物联网） 盒子识别，请按照以下设置过程操作，适用于 Ariva S 系列秤。
重要
在此过程中，使用官方的 Mettler USB-to-RJ45 电缆至关重要。
Cable¶
Mettler 的零件编号是 72256236 - USB 转 POS 电缆。请联系 Mettler 或其合作伙伴购买正品电缆。请注意，除了 这种 Mettler 电缆之外，没有其他 电缆适用于此配置。使用仅支持串行的电缆连接到串行转 USB 适配器是 无效的。
设置¶
在以下配置过程中，请参考 Mettler 的 Ariva S 系列秤的设置指南：Ariva 收银秤用户指南。
首先，请参阅上述手册的第17页以了解 设置。本指南列出了Ariva S系列秤的潜在设置。
按照说明以及以下流程，将秤设置为设置模式。首先，按住 >T< 按钮八秒钟，或直到出现 CONF。
接下来，按下 >T< 直到出现 GRP 3，然后按下 >0< 以确认。
在 3.1 下，确保设置设为 :guilabel:`1`（USB 虚拟 COM 端口）。按 >T< 以循环浏览组 3.1 下的选项。
一旦 3.1 设置为 1，按 >0< 确认选择。继续按 >0< 直到 GRP 4 出现。
现在，按下 >T< 直到 EXIT 出现。
重要
除非必要，否则 不要 进行任何其他更改
一旦出现 EXIT，按下 >0<。接着，再次按下 >0< 以 SAVE。现在，秤将重新启动。
最后，重启 IoT 盒子以识别对秤配置所做的更改。重启后，秤显示为 Toledo 8217，而之前显示为 Adam Equipment Serial。