故障排除

物联网盒子连接

无法找到连接物联网盒子的配对代码

配对代码应打印在连接到 IoT （物联网） 盒子的收据打印机上，还应在连接的显示器上显示。

The pairing code does not show under the following circumstances:

  • :abbr:`IoT（物联网）`盒子已连接到 Odoo 数据库。

  • :abbr:`IoT（物联网）`盒子没有连接到互联网。

  • The code is only valid for 5 minutes after the IoT box has started. It is automatically removed from connected displays when this time has expired.

  • The version of the IoT box image is too old. If the IoT box image is from an earlier version, then the SD card of the IoT box needs to be re-flashed to update the image (see Flashing the SD Card).

If none of the cases listed above correct the issue, then make sure the IoT box has correctly started, by checking that a fixed green LED is showing next to the power port.

IoT box is connected but it is not showing in the database

When an IoT box connects to a database, it may restart. If so, it can take up to five minutes before appearing in the database. If the IoT box is still not showing after five minutes, make sure that the IoT box can reach the database and that the server does not use a multi-database environment.

要从 IoT（物联网） 盒子访问数据库，请打开浏览器并输入数据库地址。

我的物联网盒子已连接到我的数据库，但无法访问

确保 IoT（物联网） 盒子和运行浏览器的计算机位于同一网络，因为 IoT（物联网） 盒子无法从本地网络之外进行访问。

The HTTPS certificate does not generate

要生成 HTTPS（超文本传输协议安全）`证书，需要为 :abbr:`IoT（物联网）`盒子订阅物联网盒子。在为数据库和 :abbr:`IoT（物联网） 盒子配置“账户管理平台”的 IoT （物联网） 订阅之前连接 IoT（物联网） 盒子将导致不安全连接。

此外，防火墙也可能阻止 HTTPS（超文本传输协议安全） 证书的正确生成。在这种情况下，请停用防火墙，直到成功生成证书。还应注意的是，某些设备，如内置防火墙的路由器，可能会阻止生成 HTTPS（超文本传输协议安全） 证书。

也參考

HTTPS 证书（物联网）

列印機

未检测到打印机

If a printer does not appear in the devices list, go to the IoT box homepage and make sure that it is listed under Printers.

物联网盒子主页着陆页。

If the printer is not present on the IoT box homepage, click Printers Server, go to the Administration tab and click on Add Printer. If the printer is not present in the list, it is likely not connected properly.

我打印机输出随机文本

对于大多数打印机，应自动检测并选择正确的驱动程序。然而，在某些情况下，自动检测机制可能不够，如果没有找到驱动程序，打印机可能会打印随机字符。

The solution is to manually select the corresponding driver. On the IoT box homepage, click on Printers Server, go to the Printers tab and select the printer in the list. In the Administration drop-down menu, click on Modify Printer. Follow the steps and select the make and model corresponding to the printer.

编辑连接到物联网盒子的打印机。

備註

Epson和Star收据打印机和Zebra标签打印机不需要驱动程序即可工作。确保没有为这些打印机选择驱动程序。

爱普生配置专案

大多数爱普生打印机都支持使用 GS v 0 指令在 Odoo POS（销售点） 中打印收据。但是，以下爱普生打印机型号不支持此指令：

  • TM-U220

  • TM-U230

  • TM-P60

  • TMP-P60II

将打印机配置为使用 ESC* 指令，即可绕过这一问题。

强制执行 ESC * 指令的流程
爱普生打印机兼容性

第一步是检查打印机是否与 GS v 0 指令不兼容。

也參考

如果打印机不兼容 ESC * 指令，则无法执行以下流程。如果打印机兼容使用 ESC * 指令打印，请按照以下步骤使用 IoT（物联网） 盒子配置打印机。

用于 ESC* 的物联网盒子配置

要配置 IoT（物联网） 盒子使用 ESC * 命令打印，请通过导航至 物联网应用程序 ‣ 物联网盒子 进入 IoT（物联网） 盒子主页。然后点击 IP地址，将引导您进入 IoT（物联网） 盒子主页。

选择打印机

现在点击 打印机服务器 按钮。这将把浏览器重定向到 CUPS 页面。接下来，进入 管理 ‣ 打印机 ‣ 添加打印机，选择要修改的打印机，然后单击 继续。

小訣竅

如果打印机名称仍不确定，请采取以下步骤：

  1. 注意*CUPS*页面上列出的打印机。

  2. 关闭打印机并刷新页面。

  3. 现在比较两个列表的差异，查看哪个打印机消失了。

  4. 重新打开打印机，再次刷新页面。

  5. 再次仔细检查列表，看看打印机是否再次出现。

  6. 消失并重新出现在打印机列表的就是该打印机名称。

備註

This can be Unknown under Local printers.

CUPS naming convention

CUPS will prompt the administrator for three pieces of information: the Name, Description and the Location. The last two pieces of information do not need to be specific, however, the Name should follow a particular convention to work with the ESC * command.

名称`应符合以下约定：`<printer_name>__IMC_<param_1>_<param_2>_…_<param_n>__

命名规则的细分：

  • 打印机名称：这是打印机的名称。它可以是任何字符，只要不包含`_`、/、#、或 ` `（空格字符）。

  • IMC：代表*图像模式列*（`ESC *`的简化名称）。

  • param_1：代表特定参数：

    • 缩放<X>：图片的缩放比例（保持相同的纵横比）。X 应该是一个整数，描述应该使用的缩放百分比。

      Example

      100 是原始大小，50 是一半大小，200 是两倍大小。

    • LDV: Low Density Vertical (will be set to High Density Vertical if not specified).

    • LDH: Low Density Horizontal (will be set to High Density Horizontal if not specified).

      備註

      Density parameters might need to be configured in a particular way depending on the printer model.

也參考

访问 Epson’s ESC * 文档，并在上面的表格中点击打印机型号，以查看是否应该设置这些参数。

Example

以下是正确和不正确名称格式的示例：

Proper name formatting:

  • EPSONTMm30II__IMC__

  • EPSON_TM_U220__IMC_LDV_LDH_SCALE80__

名称格式不正确（不会妨碍打印，但结果可能不是预期的打印内容）：

  • EPSON TMm 30II -> The name cannot have spaces.

  • EPSONTMm30II -> The name itself is correct, but it will not use ESC *.

  • EPSONTMm30II__IMC -> 该名称缺少结尾 __。

  • EPSONTMm30II__IMC_XDV__ -> 参数 XDV 与任何现有参数不匹配。

  • EPSONTMm30II__IMC_SCALE__ -> The parameter SCALE is missing the scale value.

完成添加打印机

After setting the name of the printer with the appropriate naming convention, click Continue. Next, set the Make value to Raw and for the Model value, set this to Raw Queue (en).

完成这些步骤后，单击 添加打印机。如果一切操作正确，页面应重定向到*横幅*页面。

此时，打印机应该已经创建，现在，物联网（IoT） 盒子只需检测到它，然后同步到 Odoo 服务器（这可能需要几分钟时间）。

将打印机添加至 Odoo PoS

Once the printer is visible on the Odoo database, do not forget to choose it in the PoS printer. Navigate to Pos App ‣ Settings ‣ Connected Devices ‣ IoT Box ‣ Receipt Printer ‣ Save.

備註

如果打印机设置错误（仍在打印随机文本或打印的收据过大或过小），则不能通过打印机名称 CUPS 进行修改。相反，可以重复上述过程，从头开始设置另一台打印机，创建一台参数已修改的打印机。

**使用 ESC 设置爱普生 TM-U220B 打印机**示例

以下是使用 ESC * 命令对 TM-U220B 打印机型号进行故障排除的示例。下图中的收据是由于格式正确（理论上）而正确打印的收据示例：

演示数据库中格式正确的收据图片。

由于 TM-U220B 打印机型号不支持 GS v 0，因此在正确格式化之前立即打印该收据将不起作用。打印出来的将是随机字符：

打印纸上的字符看似随机。

要正确配置 Epson TM-U220B 打印机型号的格式化，请执行以下步骤。

在查阅了爱普生网站上有关这两种命令的兼容性：GS v 0 和`ESC * <https://reference.epson-biz.com/modules/ref_escpos/index.php?content_id=88>`_之后，可以看到 TM-U220B 确实与`GS v 0` 不兼容，但与`ESC *` 兼容。

爱普生网站上的爱普生兼容性评估。

添加打印机时，CUPS 会询问应添加哪台打印机：

管理菜单，添加打印机选项。

在这种情况下，打印机是通过 USB （通用串行总线）`连接的，因此不会出现在 :guilabel:`已发现的网络打印机 中。相反，它可能是 本地打印机 下 未知 选项的一部分。将打印机的 :abbr:`USB （通用串行总线）`电缆从 :guilabel:`IoT（物联网）`框中拔出并刷新页面，:guilabel:`未知`打印机就会消失。重新插入后，打印机将重新出现，因此可以确定这就是所讨论的打印机。

For the naming convention, since it needs to print using the ESC * command, it is imperative to add __IMC. Reference the printer model on Epson’s ESC * site to find out more about the density parameters.

制造商网站上的爱普生 TM-U220 规格。

对于 TM-U220 这种特定型号，m 应等于 0 或 1。参考上图中粉色方框下方的 描述 时，m 值可能是 0、1、32 或 33。因此，在该打印机中，`m`值不能为 32 或 33（否则将打印出随机字符）。

表中包括数值： 32 和 33，如果 垂直数据位数 设置为 24，它们都会出现。这意味着*垂直密度高*。在配置 Epson TM-U220 时，需要强制使用 低垂直密度，因为该打印机型号不支持该命令 ESC * 的 高垂直密度。

要添加*低垂直密度*，请在命名规则中添加`LDV`参数。

在命名规则中添加*低垂直密度*（`LDV`参数）。

Click Continue to proceed. Next, set the Make value to Raw and for the Model value, set this to Raw Queue (en).

爱普生 TM-U220 的规格请参见制造商网站。

However, when trying to print with the naming convention: EpsonTMU220B__IMC_LDV__, it prints the receipt, but it is too big and outside the margin. To resolve this, add a new printer (and naming convention) with the SCALE<X> parameter to adapt to our receipt size.

示例如下：

打印机命名规则

EpsonTMU220B__IMC_LDV__

EpsonTMU220B__IMC_LDV_SCALE75__

EpsonTMU220B__IMC_LDV_LDH__

EpsonTMU220B__IMC_LDV_LDH_SCALE35__
收据示例格式。 使用命名约定的收据格式：EpsonTMU220B__IMC_LDV__。 使用命名约定的收据格式： EpsonTMU220B__IMC_LDV_SCALE75__。 使用命名约定的收据格式： EpsonTMU220B__IMC_LDV_LDH__。 使用命名约定的收据格式：EpsonTMU220B__IMC_LDV_LDH_SCALE35__。

DYMO LabelWriter print issue

The DYMO LabelWriter has a known issue in printing with the IoT box. The OpenPrinting CUPS server installs the printer using Local RAW Printer drivers. In order to print anything, the correct Make and Model needs to be set, so the correct driver is referenced when using the device.

Additionally, a new printer needs to be added to reduce a print delay that occurs after updating the driver.

重要

The DYMO LabelWriter 450 DUO printer is the recommended DYMO printer for use with Odoo and the IoT box. It must already be connected to, and recognized on, the IoT box.

The DYMO LabelWriter 450 DUO printer contains two printers in one: a label printer and a tape printer. Choosing the correct model (either DYMO LabelWriter 450 DUO Label (en) or DYMO LabelWriter 450 DUO Tape (en)) is crucial when configuring the following processes.

To keep things consistent, both of the following processes detail the configuration for the DYMO LabelWriter 450 DUO Label (en) model. Change the model when needed.

DYMO LabelWriter not printing

In the case where the DYMO LabelWriter is not printing anything, a new driver needs to be installed.

First, open the OpenPrinting CUPS console by clicking Printers server at the bottom of the IoT box homepage. Next, click on Printers in the top menu. Click into the printer in question, and select Maintenance in the first drop-down menu. Then, select Modify Printer in the second drop-down menu.

Modify the make and model of the DYMO LabelWriter. Maintenance and Modify drop-down menus highlighted.

Next, select the specific network connection/printer that the modification should be made on. Click Continue.

Printer selection screen with Continue highlighted.

On the next page, click Continue to proceed to set the Make of the printer.

Printer modification screen with Continue highlighted.

Under Make select DYMO from the menu. Click on Continue to set the Model.

Setting the make page, with DYMO and continue highlighted.

On the following page, set the Model to DYMO LabelWriter 450 DUO Label (en) (or whichever DYMO printer model is being used). Click on Modify Printer to complete setting the new driver, a confirmation page will appear.

Setting the printer model page with DYMO LabelWriter 450 DUO Label (en) highlighted.

After being redirected to a confirmation page, acknowledging a successful update, click on the Printers button in the top menu.

All the printers installed on the OpenPrinting CUPS server appear, including the newly updated: DYMO LabelWriter 450 DUO Label (or whichever DYMO printer model is being used). Click into the printer that was just updated.

To print a test label, click on the Maintenance drop-down menu to the left of the Administration drop-down menu, and select Print Test Page. The test label will print out with a ten-second delay if the driver update was successful.

Printing a test page from the administration drop-down menu in the OpenPrinting CUPs server.

To reduce this delay a new printer will need to be added, follow the process below.

DYMO LabelWriter print delay

To resolve the delay issue after modifying the driver, the printer must be reinstalled. To reinstall the printer, open the OpenPrinting CUPS administration page by clicking Printers server, at the bottom of the IoT box homepage. Then, click on Administration in the top menu, then click Add a Printer.

小訣竅

If the DYMO LabelWriter 450 DUO printer is not printing at all, or is not recognizable (has a RAW driver type), then update the drivers on the device. See DYMO LabelWriter not printing.

Add a printer button highlighted on the Printer CUPS management page.

On the next screen, in the Local Printers section, select the DYMO LabelWriter 450 DUO Label (DYMO LabelWriter 450 DUO Label) (or whichever DYMO printer model is being used) pre-installed printer. Click Continue.

Add a printer screen on OpenPrinting CUPS with DYMO LabelWriter 450 DUO Label highlighted.

On the following screen, modify the Name to something recognizable, as the original printer will still be present. Click Continue to be taken to the next screen.

Rename printer page in the 'Add a Printer' flow, with the name field highlighted.

Next, choose the Model. Select DYMO LabelWriter 450 DUO Label (en) (or whichever DYMO printer model is being used), and finally, click Add Printer to complete the installation.

Choose model screen on the OpenPrinting CUPS console with model and add a printer highlighted.

After being redirected to a confirmation page, acknowledging a successful installation, click on the Printers button in the top menu.

All the printers installed on the OpenPrinting CUPS server appear, including the newly installed: DYMO LabelWriter 450 DUO Label (or whichever DYMO printer model is being used). Click into the printer that was just installed.

Printer page with newly installed printer highlighted.

To print a test label, click on the Maintenance drop-down menu to the left of the Administration drop-down menu, and select Print Test Page. The test label should print out immediately (one-to-two seconds delay).

Printing a test page from the administration drop-down menu in the OpenPrinting CUPs server.

The Zebra printer does not print anything

Zebra 打印机对打印的 Zebra 编程语言（ZPL）代码的格式非常敏感。如果打印机没有输出任何内容或打印了空白标签，请尝试通过在:ref:`开发者模式<developer-mode>`中访问:menuselection:`设置 –> 技术 –> 用户界面 –> 视图`并查找相应的模板，更改发送到打印机的报表格式。

也參考

查看 Zebra 打印 ZPL（Zebra 编程语言） 文件的说明，请点击 <https://supportcommunity.zebra.com/s/article/Print-a-zpl-file-using-the-Generic-Text-Printer>`_。

条形码扫描器

The characters read by the barcode scanner do not match the barcode

默认情况下，大多数条形码扫描仪都配置为 US QWERTY 格式。如果条形码扫描仪使用不同的布局，请转到设备的窗体视图（物联网应用程序 ‣ 设备 ‣ 条形码设备）并选择正确的格式。

扫描条形码时不会发生任何情况

确保在 POS 配置中选择了正确的设备，并将条形码配置为在每个条形码末尾发送一个 ENTER 字符（关键码 28）。为此，请导航至 POS 应用程序 ‣ POS 上的三点菜单 ‣ 物联网盒子部分 ‣ 编辑。

条形码扫描仪被检测为键盘

重要

有些条形码扫描仪不标明自己是条形码扫描仪，而是标明自己是 USB 键盘，因此不会被 IoT （物联网） 盒子识别。

设备类型可通过进入其表单视图（物联网应用程序 ‣ 设备 ‣ 条码设备）并激活 是扫描仪 选项手动更改。

修改条形码扫描仪的窗体视图。

Barcode scanner processes barcode characters individually

When accessing the mobile version of Odoo from a mobile device, or tablet, paired with a barcode scanner, via the IoT box, the scanner may process each barcode character as an individual scan. In this case, the Keyboard Layout option must be filled out with the appropriate language of the barcode scanner on the Barcode Scanner form page.

小訣竅

Access the barcode scanner form page by navigating to IoT App ‣ Devices ‣ Barcode Scanner.

Barcode scanner form page, with keyboard layout option highlighted.

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.

钱箱

钱箱无法打开

应将钱箱连接到打印机，并在:abbr:POS（销售点）`配置中勾选 :guilabel:`钱箱`复选框。要执行此操作，请导航至 :menuselection:`POS 应用程序 --> POS 上的三点菜单 --> 物联网盒部分 --> 编辑 --> 收据打印机 --> 钱箱复选框。

比例

Scales play a crucial role in the checkout process, especially for products sold by weight, rather than fixed pricing.

Set up Ariva S scales

Odoo has determined that a specific setting in Ariva S series scales (manufactured by Mettler-Toledo, LLC.) needs modification, and a dedicated Mettler USB-to-proprietary RJ45 cable is required for the scale to function with Odoo’s IoT box.

To correctly configure the scale for recognition by the IoT box, follow this setup process for the Ariva S series scales.

重要

It is crucial to use the official Mettler USB-to-RJ45 cable during this process.

Cable

The Mettler part number is 72256236 - USB-to-POS cable. Contact Mettler, or a partner, to purchase an authentic cable. Note that no other cable outside of this Mettler cable works for this configuration. Using a serial-only cable attached to a serial-to-USB adapter is not effective.

Authentic Mettler USB to POS cable, part number 72256236.

設定

Refer to Mettler’s Setup Guide for Ariva S series scales during the following configuration: Ariva Checkout Scale User’s Guide.

To begin, go to page 17 in the above manual for Setup. This guide lists potential settings for the Ariva S series scales.

Follow the instructions, along with the following process, to set the scale to setup mode. First, hold the >T< button for eight seconds, or until CONF appears.

Next, press >T< until GRP 3 appears, then press >0< to confirm.

Under 3.1, ensure the setting is set to 1 (USB Virtual COM ports). Press >T< to cycle through the options under group 3.1.

Once 3.1 is set to 1, press >0< to confirm the selection. Continue to press >0< until GRP 4 appears.

Now, press >T< until EXIT appears.

重要

Do not make any other changes unless otherwise needed.

Once EXIT appears, press >0<. Following this, press >0< again to SAVE. Now the scale restarts.

Finally, restart the IoT box to recognize the changes made on the scale’s configuration. After restarting, the scale appears as Toledo 8217, as opposed to the previous display, where it appeared as Adam Equipment Serial.