diff --git a/content/applications/general/iot/config/troubleshooting.rst b/content/applications/general/iot/config/troubleshooting.rst index 3e87d20f8..f1d38f9fe 100644 --- a/content/applications/general/iot/config/troubleshooting.rst +++ b/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 ----------------------------------------- diff --git a/content/applications/general/iot/config/troubleshooting/add-printer-dymo.png b/content/applications/general/iot/config/troubleshooting/add-printer-dymo.png new file mode 100644 index 000000000..a91085059 Binary files /dev/null and b/content/applications/general/iot/config/troubleshooting/add-printer-dymo.png differ diff --git a/content/applications/general/iot/config/troubleshooting/choose-printer.png b/content/applications/general/iot/config/troubleshooting/choose-printer.png new file mode 100644 index 000000000..ac9e4c9c3 Binary files /dev/null and b/content/applications/general/iot/config/troubleshooting/choose-printer.png differ diff --git a/content/applications/general/iot/config/troubleshooting/local-printer.png b/content/applications/general/iot/config/troubleshooting/local-printer.png new file mode 100644 index 000000000..f2ee841a2 Binary files /dev/null and b/content/applications/general/iot/config/troubleshooting/local-printer.png differ diff --git a/content/applications/general/iot/config/troubleshooting/main-modify.png b/content/applications/general/iot/config/troubleshooting/main-modify.png new file mode 100644 index 000000000..853f2f4f4 Binary files /dev/null and b/content/applications/general/iot/config/troubleshooting/main-modify.png differ diff --git a/content/applications/general/iot/config/troubleshooting/modify-printer-dymo.png b/content/applications/general/iot/config/troubleshooting/modify-printer-dymo.png new file mode 100644 index 000000000..aa6716be1 Binary files /dev/null and b/content/applications/general/iot/config/troubleshooting/modify-printer-dymo.png differ diff --git a/content/applications/general/iot/config/troubleshooting/modify-select-printer.png b/content/applications/general/iot/config/troubleshooting/modify-select-printer.png new file mode 100644 index 000000000..6bf96d910 Binary files /dev/null and b/content/applications/general/iot/config/troubleshooting/modify-select-printer.png differ diff --git a/content/applications/general/iot/config/troubleshooting/print-test.png b/content/applications/general/iot/config/troubleshooting/print-test.png new file mode 100644 index 000000000..69b9c2706 Binary files /dev/null and b/content/applications/general/iot/config/troubleshooting/print-test.png differ diff --git a/content/applications/general/iot/config/troubleshooting/printer-page.png b/content/applications/general/iot/config/troubleshooting/printer-page.png new file mode 100644 index 000000000..a48e8d7ea Binary files /dev/null and b/content/applications/general/iot/config/troubleshooting/printer-page.png differ diff --git a/content/applications/general/iot/config/troubleshooting/rename-printer.png b/content/applications/general/iot/config/troubleshooting/rename-printer.png new file mode 100644 index 000000000..8c0a7df82 Binary files /dev/null and b/content/applications/general/iot/config/troubleshooting/rename-printer.png differ diff --git a/content/applications/general/iot/config/troubleshooting/setting-make.png b/content/applications/general/iot/config/troubleshooting/setting-make.png new file mode 100644 index 000000000..b7f1d2db5 Binary files /dev/null and b/content/applications/general/iot/config/troubleshooting/setting-make.png differ diff --git a/content/applications/general/iot/config/troubleshooting/setting-model.png b/content/applications/general/iot/config/troubleshooting/setting-model.png new file mode 100644 index 000000000..8ada0d8f7 Binary files /dev/null and b/content/applications/general/iot/config/troubleshooting/setting-model.png differ