[IMP] general: iot troubleshooting printer addition

closes odoo/documentation#8574

Signed-off-by: Timothy Kukulka (tiku) <tiku@odoo.com>

content/applications/general/iot/config/troubleshooting.rst

@@ -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
 -----------------------------------------