[IMP] general: iot troubleshooting printer addition

closes odoo/documentation#8574

Signed-off-by: Timothy Kukulka (tiku) <tiku@odoo.com>
This commit is contained in:
tiku-odoo 2024-04-05 16:16:15 -04:00
parent e7dc7815b5
commit e444f8678e
12 changed files with 148 additions and 0 deletions

View File

@ -343,6 +343,154 @@ Save`.
:align: center
:alt: Receipt format using naming convention: EpsonTMU220B__IMC_LDV_LDH_SCALE35__.
DYMO LabelWriter print issue
----------------------------
The DYMO LabelWriter has a known issue in printing with the :abbr:`IoT (Internet of Things)` box.
The OpenPrinting CUPS server installs the printer using :guilabel:`Local RAW Printer` drivers. In
order to print anything, the correct :guilabel:`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.
.. important::
The DYMO LabelWriter 450 DUO printer is the recommended DYMO printer for use with Odoo and the
:abbr:`IoT (Internet of Things)` box. It **must** already be connected to, and recognized on, the
:abbr:`IoT (Internet of Things)` 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.
.. _troubleshooting/dymo/update_drivers:
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 :menuselection:`Printers server` at the bottom
of the :abbr:`IoT (Internet of Things)` box homepage. Next, click on :menuselection:`Printers` in
the top menu. Click into the printer in question, and select :guilabel:`Maintenance` in the first
drop-down menu. Then, select :guilabel:`Modify Printer` in the second drop-down menu.
.. image:: troubleshooting/main-modify.png
:align: center
:alt: 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
:guilabel:`Continue`.
.. image:: troubleshooting/modify-select-printer.png
:align: center
:alt: Printer selection screen with Continue highlighted.
On the next page, click :guilabel:`Continue` to proceed to set the :guilabel:`Make` of the printer.
.. image:: troubleshooting/modify-printer-dymo.png
:align: center
:alt: Printer modification screen with Continue highlighted.
Under :guilabel:`Make` select :guilabel:`DYMO` from the menu. Click on :guilabel:`Continue` to set
the :guilabel:`Model`.
.. image:: troubleshooting/setting-make.png
:align: center
:alt: Setting the make page, with DYMO and continue highlighted.
On the following page, set the :guilabel:`Model` to :guilabel:`DYMO LabelWriter 450 DUO Label (en)`
(or whichever DYMO printer model is being used). Click on :guilabel:`Modify Printer` to complete
setting the new driver, a confirmation page will appear.
.. image:: troubleshooting/setting-model.png
:align: center
:alt: 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
:menuselection:`Printers` button in the top menu.
All the printers installed on the OpenPrinting CUPS server appear, including the newly updated:
:guilabel:`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 :guilabel:`Maintenance` drop-down menu to the left of the
:guilabel:`Administration` drop-down menu, and select :guilabel:`Print Test Page`. The test label
will print out with a ten-second delay if the driver update was successful.
.. image:: troubleshooting/print-test.png
:align: center
:alt: 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
:menuselection:`Printers server`, at the bottom of the :abbr:`IoT (Internet of Things)` box
homepage. Then, click on :menuselection:`Administration` in the top menu, then click :guilabel:`Add
a Printer`.
.. tip::
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
:ref:`troubleshooting/dymo/update_drivers`.
.. image:: troubleshooting/add-printer-dymo.png
:align: center
:alt: Add a printer button highlighted on the Printer CUPS management page.
On the next screen, in the :guilabel:`Local Printers` section, select the :guilabel:`DYMO
LabelWriter 450 DUO Label (DYMO LabelWriter 450 DUO Label)` (or whichever DYMO printer model is
being used) pre-installed printer. Click :guilabel:`Continue`.
.. image:: troubleshooting/local-printer.png
:align: center
:alt: Add a printer screen on OpenPrinting CUPS with DYMO LabelWriter 450 DUO Label highlighted.
On the following screen, modify the :guilabel:`Name` to something recognizable, as the original
printer will still be present. Click :guilabel:`Continue` to be taken to the next screen.
.. image:: troubleshooting/rename-printer.png
:align: center
:alt: Rename printer page in the 'Add a Printer' flow, with the name field highlighted.
Next, choose the :guilabel:`Model`. Select :guilabel:`DYMO LabelWriter 450 DUO Label (en)` (or
whichever DYMO printer model is being used), and finally, click :guilabel:`Add Printer` to complete
the installation.
.. image:: troubleshooting/choose-printer.png
:align: center
:alt: 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
:menuselection:`Printers` button in the top menu.
All the printers installed on the OpenPrinting CUPS server appear, including the newly installed:
:guilabel:`DYMO LabelWriter 450 DUO Label` (or whichever DYMO printer model is being used). Click
into the printer that was just installed.
.. image:: troubleshooting/printer-page.png
:align: center
:alt: Printer page with newly installed printer highlighted.
To print a test label, click on the :guilabel:`Maintenance` drop-down menu to the left of the
:guilabel:`Administration` drop-down menu, and select :guilabel:`Print Test Page`. The test label
should print out immediately (one-to-two seconds delay).
.. image:: troubleshooting/print-test.png
:align: center
:alt: Printing a test page from the administration drop-down menu in the OpenPrinting CUPs
server.
The Zebra printer does not print anything
-----------------------------------------

Binary file not shown.

After

Width:  |  Height:  |  Size: 22 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 45 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 40 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 38 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 37 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 56 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 36 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 22 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 32 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 39 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 53 KiB