[IMP] iot: 19.0 updates

task-5108135

content/applications/general/iot.rst

@@ -18,7 +18,7 @@ The following IoT systems are supported:
 
 .. note::
    - :abbr:`MRP (Material Requirement Planning)` devices, including cameras and measurement tools,
-     are not compatible with Windows virtual IoT.
+     are not compatible with the Windows virtual IoT.
    - Multiple IoT systems can be used at the same time.
    - It is also possible to create a Windows Virtual Machine on a MacOS/Linux computer. However,
      this option is not supported by Odoo, and no troubleshooting assistance will be provided.
@@ -28,12 +28,10 @@ The following IoT systems are supported:
 IoT box subscription
 ====================
 
-An IoT box subscription is required for production use of IoT systems. If you have issues related
+An IoT box subscription is required for production use of IoT systems and generating the
-to your subscription, contact the database's account manager or Odoo partner for assistance.
+:ref:`HTTPS certificate <iot/connect/https_certificate>`. It is created automatically
-
+when an IoT system is :doc:`connected to the database <iot/connect>`. If you have issues related to
-.. tip::
+your subscription, contact the database's account manager or Odoo partner for assistance.
-   If the subscription is linked to an `Odoo.com <https://www.odoo.com>`_ portal user, check the
-   information on the portal's subscription page.
 
 .. seealso::
    - `Odoo's compatible IoT devices <https://www.odoo.com/app/iot-hardware>`_
@@ -55,7 +53,7 @@ to your subscription, contact the database's account manager or Odoo partner for
       :target: iot/windows_iot
       :large:
 
-      Set up Windows virtual IoT.
+      Set up a Windows virtual IoT.
 
    .. card:: IoT system connection to Odoo
       :target: iot/connect
@@ -67,11 +65,10 @@ to your subscription, contact the database's account manager or Odoo partner for
 
       Connect devices such as printers, screens, measurement tools, etc., to the IoT system.
 
-   .. card:: HTTPS certificate
+   .. card:: Troubleshooting
-      :target: iot/iot_advanced/https_certificate_iot
+      :target: iot/iot_advanced/troubleshooting
 
-      Verify your IoT system and database meet the eligibility requirements for HTTPS certificate
+      Diagnose and resolve common IoT system connection and configuration issues.
-      generation and address any related issues.
 
    .. card:: IoT system updates
       :target: iot/iot_advanced/updating_iot

content/applications/general/iot/connect.rst

@@ -9,7 +9,7 @@ To connect the IoT system to an Odoo database, the following prerequisites must
 
 - The Internet of Things (IoT) app must be :ref:`installed <general/install>`.
 - The IoT system must be connected to the network.
-- The computer connecting to Odoo must be on the same network as the IoT system.
+- The device connecting to Odoo must be on the same network as the IoT system.
 
 .. note::
    It is recommended to connect the IoT system to a **production** instance, as other types of
@@ -23,33 +23,44 @@ To connect the IoT system to an Odoo database, the following prerequisites must
 Connection
 ==========
 
-The IoT system can be connected to the Odoo database using a :ref:`pairing code
+To connect the IoT system to the Odoo database, open the IoT app and click :guilabel:`Connect`.
+
+The browser then scans the network to which the computer is connected for available IoT systems. If
+an IoT system is detected, it is connected automatically. If multiple IoT systems are found, select
+the appropriate one in the popup that opens, then click :guilabel:`Connect`. If no IoT system is
+detected automatically, try connecting it to the database using a :ref:`pairing code
 <iot/connect/pairing-code>` or a :ref:`connection token <iot/connect/token>`.
 
+.. tip::
+   The IoT system’s name is composed of either the :doc:`IoT box <iot_box>` or the
+   :doc:`Windows computer <windows_iot>`’s motherboard serial number, followed by its :ref:`pairing
+   code <iot/connect/pairing-code>`.
+
 .. _iot/connect/pairing-code:
 
 Connection using a pairing code
 -------------------------------
 
 .. note::
-   - The pairing code is displayed for up to 5 minutes after the IoT system starts. If the code is
+   - The pairing code is valid for up to 2 hours after the IoT system starts. If the code is
-     no longer visible, reboot the IoT box or :ref:`restart the Windows virtual IoT service
+     no longer valid, restart the IoT box or :ref:`restart the Windows virtual IoT service
-     <iot/windows_iot/restart>` to display the pairing code again. Alternatively, connect the IoT
+     <iot/windows_iot/restart>` to display another pairing code. Alternatively, connect the IoT
      system to the database using a :ref:`connection token <iot/connect/token>`.
    - The pairing code is not displayed if the IoT system is already connected to a database (e.g.,
-     a test database).
+     a test database). If necessary, :ref:`disconnect the IoT system from the database
+     <iot/connect/disconnect>`.
 
-#. Retrieve the IoT's system pairing code:
+#. Retrieve the IoT system's pairing code:
 
    .. tabs::
 
       .. group-tab:: IoT box
 
          Connect the IoT box to an external monitor or printer. If the IoT box was already plugged
-         prior to this, reboot it by unplugging it for a few seconds and replugging it.
+         prior to this, :ref:`restart <iot/iot-box/restart>` it.
 
-         - External monitor: The pairing code should be displayed on the screen a few minutes after
+         - External monitor: The pairing code will be displayed on the screen after (re)starting the
-           rebooting the IoT box.
+           IoT box.
          - Printer: The pairing code should be printed automatically.
 
          .. tip::
@@ -64,8 +75,8 @@ Connection using a pairing code
          :guilabel:`Pairing Code` section.
 
 #. In Odoo, open the IoT app and click :guilabel:`Connect`.
-#. In the :guilabel:`Connect an IoT Box` popup that opens, enter the :guilabel:`Pairing code`.
+#. In the :guilabel:`Searching for an IoT Box` popup that opens, click :guilabel:`Use Pairing Code`.
-#. Click :guilabel:`Pair`.
+#. Enter the :guilabel:`Pairing code` and click :guilabel:`Connect`.
 
 .. _iot/connect/token:
 
@@ -73,14 +84,41 @@ Connection using a connection token
 -----------------------------------
 
 #. In Odoo, open the IoT app and click :guilabel:`Connect`.
-#. In the :guilabel:`Connect an IoT Box` popup that opens, copy the :guilabel:`Token`.
+#. In the :guilabel:`Searching for an IoT Box` popup that opens, click :guilabel:`Offline pairing`.
+#. In the :guilabel:`Pair an IoT Box offline` popup that opens, copy the :guilabel:`Token`.
 #. Access the :ref:`IoT box's <iot/iot-box/homepage>` or :ref:`Windows virtual IoT's
    <iot/windows-iot/homepage>` homepage.
 #. In the :guilabel:`Odoo database connected` section, click :guilabel:`Configure`.
 #. Paste the token into the :guilabel:`Server Token` field and click :guilabel:`Connect`.
 
 .. note::
-   Once the IoT box is connected to a database, its green LED remains constantly lit.
+   Once the IoT system is connected to a database:
+
+   - If the :doc:`Point of Sale app </applications/sales/point_of_sale>` is installed, a popup
+     appears to select the :doc:`POS the IoT system should be associated with
+     </applications/sales/point_of_sale/configuration/pos_iot>`.
+   - If using an :doc:`IoT box <iot_box>`, wait a few minutes for it to update before using the
+     connected :doc:`devices <devices>`.
+   - A request is sent to `<https://www.odoo.com>`_, which returns an :ref:`HTTPS certificate
+     <iot/connect/https_certificate>` after a few minutes if the database meets the
+     :ref:`eligibility criteria <iot/https_certificate_iot/iot-eligibility>`. Once the certificate
+     is received, the IoT system's homepage is updated to a new HTTPS URL ending with
+     `.odoo-iot.com`.
+
+.. seealso::
+   :doc:`iot_advanced/troubleshooting`
+
+.. _iot/connect/disconnect:
+
+Disconnecting an IoT system from a database
+===========================================
+
+To disconnect the IoT system from a database, follow these steps:
+
+#. Access the :ref:`IoT box's <iot/iot-box/homepage>` or :ref:`Windows virtual IoT's
+   <iot/windows-iot/homepage>` homepage.
+#. Click :guilabel:`Configure` in the :guilabel:`Odoo database connected` section.
+#. Click :guilabel:`Disconnect` in the popup that opens.
 
 .. _iot/connect/IoT-form:
 
@@ -88,64 +126,52 @@ IoT system form
 ===============
 
 Once the IoT system is connected to the Odoo database, it is displayed as a card in the IoT app.
-Click the IP address on the card to access the :ref:`IoT box's <iot/windows-iot/homepage>` or
+Click the card to access the IoT system's form, which allows to access the :ref:`IoT box's
-:ref:`Windows virtual IoT's <iot/iot-box/homepage>` homepage. Click the card to access the
+<iot/windows-iot/homepage>` or :ref:`Windows virtual IoT's <iot/iot-box/homepage>` homepage and
-list of :doc:`devices <devices>` connected to the IoT system.
+view the list of :doc:`devices <devices>` connected to the IoT system.
 
 .. tip::
-   :ref:`Enable the developer mode <developer-mode>` to access the IoT system's
+   Enable the :ref:`developer mode <developer-mode>` to access the IoT system's :guilabel:`Technical
-   :guilabel:`Technical Information`, such as its :guilabel:`Identifier`, :guilabel:`Domain
+   Information`, such as its :guilabel:`Domain address`, :guilabel:`Image version`, and
-   address`, and :guilabel:`Image version`.
+   :ref:`SSL certificate <iot/connect/https_certificate>` :guilabel:`End Date`.
-
-.. note::
    By default, drivers are automatically :ref:`updated <iot_updating_iot/handlers>` every time the
    IoT system is restarted. To disable automatic updates, uncheck the :guilabel:`Automatic drivers
    update` option.
 
-.. _iot/connect/troubleshooting:
+.. _iot/connect/https_certificate:
 
-Troubleshooting
+HTTPS certificate
-===============
+=================
 
-The pairing code does not appear or does not work
+:abbr:`HTTPS (Hypertext Transfer Protocol Secure)` is the secure, encrypted version of :abbr:`HTTP
--------------------------------------------------
+(Hypertext Transfer Protocol)`. It uses :abbr:`TLS (Transport Layer Security)` (previously
+:abbr:`SSL (Secure Sockets Layer)`) certificates to authenticate the server and protect the data
+exchanged between a browser and a website. Some network devices, such as payment terminals, require
+a valid HTTPS certificate to communicate with the IoT system; without it, they cannot interact
+properly.
 
-The :ref:`pairing code <iot/connect/pairing-code>` might not be displayed or printed under the
+.. note::
-following circumstances:
+   In this documentation and throughout Odoo, the term *HTTPS certificate*  refers to a valid
+   SSL certificate that allows an HTTPS connection.
 
-- The IoT system is not connected to the Internet.
+When the IoT system is (re-)started (e.g., after it is connected to the Odoo database), a request
-- The IoT system is already connected to an Odoo database.
+is sent to `<https://www.odoo.com>`_, which returns the HTTPS certificate after a few minutes if
-- The :ref:`pairing code <iot/connect/pairing-code>` display time has expired. Reboot the IoT box
+the database meets the following eligibility criteria:
-  or :ref:`restart the Windows virtual IoT service <iot/windows_iot/restart>` to display the pairing
-  code again.
-- The IoT system's image version is too old and needs to be :ref:`updated
-  <iot/updating_iot/image-code>`.
 
-The IoT system is connected but does not appear in the database
+.. _iot/https_certificate_iot/iot-eligibility:
----------------------------------------------------------------
 
-The IoT system might take a few minutes to restart when it connects to a database. If it still does
+- The database must be a **production** instance. The database instance should not be a copy, a
-not appear after a few minutes:
+  duplicate, a staging, or a development environment.
+- The Odoo subscription must be ongoing (:guilabel:`In Progress` status).
 
-- Verify that the IoT system can reach the database and the server does not use a multi-database
+When the certificate has been received:
-  environment.
-- Reboot the IoT box or :ref:`restart the Windows virtual IoT service <iot/windows_iot/restart>`.
 
-The IoT box is connected to the Odoo database but cannot be reached
+- The IoT system's homepage address is updated to a new HTTPS URL ending with `.odoo-iot.com`.
--------------------------------------------------------------------
+- The :guilabel:`HTTPS certificate` banner displays the certificate's validity period. To view this
+  information, click the :icon:`fa-cogs` (:guilabel:`cogs`) button on the IoT system's homepage.
 
-Verify that the IoT system and the computer running the Odoo database are connected to the same
+  .. image:: connect/https-valid.png
-network.
+     :alt: IoT box homepage with HTTPS certificate validity date.
 
-The Windows virtual IoT's homepage cannot be accessed from another device
+.. seealso::
--------------------------------------------------------------------------
+   :ref:`iot/troubleshooting/https_certificate`
-
-Check the :ref:`iot/windows-iot/firewall`.
-
-The IoT system is disconnected from the database after an Odoo upgrade
-----------------------------------------------------------------------
-
-:ref:`Update the IoT system's image <iot/updating_iot/image-code>` by flashing the IoT box's card or
-:ref:`uninstalling the Windows virtual IoT program <iot/windows_iot/uninstall>` and
-:ref:`reinstalling <iot/windows-iot/installation>` the latest package for Windows **matching your
-database's version**.

content/applications/general/iot/devices.rst

@@ -6,19 +6,21 @@
 Devices
 =======
 
+.. toctree::
+   :titlesonly:
+   :glob:
+
+   devices/printer
+   devices/scale
+   devices/screen
+   devices/measurement_tool
+   devices/camera
+   devices/footswitch
+
 .. seealso::
    - :doc:`Connect a Worldline payment terminal
      <../../sales/point_of_sale/payment_methods/terminals/worldline>`
    - :doc:`Connect an Ingenico payment terminal
      <../../sales/point_of_sale/payment_methods/terminals/ingenico>`
-
+   - :doc:`Connect a SIX payment terminal
-.. toctree::
+     <../../sales/point_of_sale/payment_methods/terminals/six>`
-   :titlesonly:
-   :glob:
-
-   devices/screen
-   devices/measurement_tool
-   devices/camera
-   devices/footswitch
-   devices/printer
-   devices/scale

content/applications/general/iot/devices/printer.rst

@@ -16,14 +16,18 @@ Connection
 ==========
 
 IoT systems support printers connected through USB, network connection, or Bluetooth.
-`Supported printers <https://www.odoo.com/page/iot-hardware>`__ are detected automatically, and
+`Supported printers <https://www.odoo.com/page/iot-hardware>`_ are detected automatically, and
 appear in the :guilabel:`Devices` list of the IoT app.
 
 .. image:: printer/printer-detected.png
    :alt: The printer as it would appear in the IoT app devices list.
 
+.. important::
+   Printers connecting to the IoT system via the network must be on the **same network** as the IoT
+   system.
+
 .. note::
-   Printers can take up to two minutes to appear in the IoT app :guilabel:`Devices` list.
+   Printers can take up to two minutes to appear in the IoT app's :guilabel:`Devices` list.
 
 Link a printer
 ==============

content/applications/general/iot/devices/scale.rst

@@ -19,7 +19,8 @@ scale's drivers <iot_updating_iot/handlers>`.
    the Odoo IoT system <https://www.odoo.com/page/iot-hardware>`_. In such cases, a different scale
    must be used.
 
-Once the scale is connected to the IoT system, :ref:`configure it in the POS settings <pos/scale>`.
+Once the scale is connected to the IoT system, :ref:`configure it in the POS settings
+<pos/hardware/scale>`.
 
 .. seealso::
    :doc:`Connect an IoT system to a POS </applications/sales/point_of_sale/configuration/pos_iot>`

content/applications/general/iot/devices/screen.rst

@@ -2,109 +2,31 @@
 Connect a screen
 ================
 
-In Odoo, an :abbr:`IoT (Internet of Things)` box can be connected to a screen display. After being
+The :doc:`IoT box <../iot_box>` can be connected to a screen, e.g. to ease the IoT box's setup
-configured, the screen can be used to display a Point of Sale (PoS) order to a client.
+and/or serve as a :ref:`customer display <pos/hardware/display>` to show customers their :doc:`Point
-
+of Sale </applications/sales/point_of_sale>` orders.
-.. figure:: screen/screen-pos-client-display.png
-
-   An example of a PoS (point of sale) order on a screen display.
-
-Access the customer display by going to the :abbr:`IoT (Internet of Things)` box homepage and
-clicking on the :guilabel:`PoS Display` button. To get to the :abbr:`IoT (Internet of Things)` box
-homepage, navigate to :menuselection:`IoT app --> IoT Boxes` and click on the :abbr:`IoT (Internet
-of Things)` box homepage link.
 
 Connection
 ==========
 
-The way to connect the screen display to the :abbr:`IoT (Internet of Things)` box differs depending
+Connect the screen to the IoT box using a micro-HDMI cable. If the connection was successful, the
-on the model.
+external monitor displays the :guilabel:`Status display` screen.
 
-.. tabs::
+.. image:: screen/screen-status-display.png
+   :alt: Default Status Display screen
 
-   .. tab:: IoT Box model 4
+The screen also appears in the IoT box's list of devices:
 
-      Connect up to two screens with micro-HDMI cables on the side of the :abbr:`IoT (Internet of
+- on the :ref:`IoT box's form <iot/connect/IoT-form>`;
-      Things)` box. If two screens are connected, they can display distinct content (see
+- on the :ref:`IoT box's homepage <iot/iot-box/homepage>`;
-      :ref:`Screen Usage <iot/usage_screen>`).
+- in the IoT app, under the menu :menuselection:`IoT --> Devices`.
 
-   .. tab:: IoT Box model 3
+Customer display
+================
 
-      Connect the screen with an HDMI cable on the side of the :abbr:`IoT (Internet of Things)` box.
+To use the screen as a :ref:`customer display <pos/hardware/display>`, :ref:`configure the POS
+accordingly <pos/hardware/display-configuration>`.
 
-.. seealso::
+To display a specific website on the screen instead of the POS customer display, go to
-   :ref:`See the Raspberry Pi Schema <pos/pos_iot/connect_schema>`.
+:menuselection:`IoT --> Devices`, click the screen's card, then enter the desired website's URL in
-
+the :guilabel:`Display URL` field.
-.. important::
-   Screen(s) should be connected before the :abbr:`IoT (Internet of Things)` box is switched on. If
-   it is already on, connect the screen(s), and then restart the :abbr:`IoT (Internet of Things)`
-   box by unplugging it for ten seconds and plugging it back into its power source.
-
-.. warning::
-   The usage of HDMI/micro-HDMI adapters may cause issues which will result in a blank, black screen
-   on the screen display. Using the specific cable for the display connection is recommended.
-
-If the connection was successful, the screen should display the :guilabel:`POS Client display`
-screen.
-
-.. image:: screen/screen-pos-client-display-no-order.png
-   :align: center
-   :alt: The default "POS Client Display" screen that appears when a screen display is successfully
-         connected to an IoT box.
-
-The screen should also appear in the list of :guilabel:`Displays` on the :abbr:`IoT (Internet of
-Things)` box homepage. Alternatively, the display can be seen by accessing :menuselection:`IoT app
---> Devices`.
-
-.. image:: screen/screen-screen-name-example.png
-   :align: center
-   :alt: An example of a screen display name shown on the IoT Box Home Page.
-
-.. note::
-   If no screen is detected, a default display named :guilabel:`Distant Display` will be displayed
-   instead. This indicates that there is no hardware screen connected.
-
-    .. image:: screen/screen-no-screen.png
-       :align: center
-       :alt: The "Distant Display" screen name will be used if no screen is detected.
-
-.. _iot/usage_screen:
-
-Usage
-=====
-
-Show Point of Sale orders to customers
---------------------------------------
-
-To use the screen in the *Point of Sale app*, go to :menuselection:`Point of Sale -->
-Configuration --> Point of Sale`, select a :abbr:`PoS (Point of Sale)`, click :guilabel:`Edit` if
-necessary, and enable the :guilabel:`IoT Box` feature.
-
-Next, select the screen from the :guilabel:`Customer Display` drop-down menu. Then click
-:guilabel:`Save`, if required.
-
-.. image:: screen/screen-pos-screen-config.png
-   :align: center
-   :alt: Connect the screen display to the Point of Sale app.
-
-The screen is now available for :abbr:`PoS (Point of Sale)` sessions. A screen icon will appear in
-the menu at the top of the screen to indicate the screen's connection status.
-
-.. image:: screen/screen-pos-icon.png
-   :align: center
-   :alt: The "screen" icon on the Point of Sale display shows the connection status with the
-         screen.
-
-The screen will automatically show the :abbr:`PoS (Point of Sale)` orders and update when changes
-are made to the order.
-
-.. image:: screen/screen-pos-client-display.png
-   :align: center
-   :alt: An example of a PoS order on a screen display.
-
-Display a website on the screen
--------------------------------
-
-Open the screen form view by accessing :menuselection:`IoT app --> Devices --> Customer Display`.
-This allows the user to choose a particular website URL to display on the screen using the
-:guilabel:`Display URL` field.

content/applications/general/iot/iot_advanced.rst

@@ -6,6 +6,6 @@ Advanced
 
 .. toctree::
 
-   iot_advanced/https_certificate_iot
+   iot_advanced/troubleshooting
    iot_advanced/updating_iot
    iot_advanced/ssh_connect

content/applications/general/iot/iot_advanced/ssh_connect.rst

@@ -16,10 +16,9 @@ IoT box SSH connection
 To provide an :abbr:`SSH (secure shell protocol)` connection to an IoT box, you must generate a
 password:
 
-#. Access the IoT box's homepage by opening the IoT app and clicking the IP address displayed
+#. Open the IoT app, click the relevant IoT box's card, and click :guilabel:`Homepage`.
-   on the IoT box's card.
+#. On the IoT system's homepage, click the :icon:`fa-cogs` (:guilabel:`cogs`) button at the
-#. Click the :icon:`fa-cogs` (:guilabel:`cogs`) button at the top-right, then :guilabel:`Remote
+   top-right, then :guilabel:`Remote Debug`.
-   Debug`.
 #. In the :guilabel:`Remote Debugging` popup that opens, click :guilabel:`Generate` and save the
    password securely. Once you close the popup, the password will no longer be available.
 

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

@@ -1,76 +1,57 @@
-.. _iot/https_certificate_iot:
+:hide-page-toc:
 
-=======================
+===============
-HTTPS certificate (IoT)
+Troubleshooting
-=======================
+===============
 
-*Hypertext Transfer Protocol Secure* (HTTPS) is the secure and encrypted version of *Hypertext
+The pairing code does not appear or does not work
-Transfer Protocol* (HTTP), which is the primary protocol used for data communication between a web
+=================================================
-browser and a website. It secures communications by using an encryption protocol known as *Transport
-Layer Security* (TLS), previously called *Secure Sockets Layer* (SSL). The security of
-:abbr:`HTTPS (Hypertext Transfer Protocol Secure)` relies on :abbr:`TLS (Transport Layer Security)`
-/:abbr:`SSL (Secure Sockets Layer)` certificates, which authenticate the provider and verify their
-identity.
 
-The use of HTTPS is required to communicate with certain network devices, particularly payment
+The :ref:`pairing code <iot/connect/pairing-code>` might not be displayed or printed under the
-terminals. If the HTTPS certificate is not valid, some devices cannot interact with the IoT
+following circumstances:
-system.
 
-.. note::
+- The IoT system is not connected to the network.
-   In this documentation and throughout Odoo, the term *HTTPS certificate*  refers to a valid
+- The IoT system is already connected to an Odoo database. :ref:`Disconnect it from the database
-   SSL certificate that allows an HTTPS connection.
+  <iot/connect/disconnect>`.
+- The :ref:`pairing code <iot/connect/pairing-code>` display time has expired. Restart the :ref:`IoT
+  box <iot/iot-box/restart>` or the :ref:`Windows virtual IoT service <iot/windows_iot/restart>` to
+  generate and display the pairing code.
 
-.. _iot/https_certificate_iot/generation:
+The IoT system does not connect to the database
+===============================================
 
-HTTPS certificate generation
+The IoT system might take a few minutes to restart when it connects to a database. If it still does
-============================
+not appear after a few minutes:
 
-The HTTPS certificate is generated automatically. When the IoT system is (re-)started (e.g., after
+- Verify that the IoT system can reach the database and the server does not use a multi-database
-it is connected to the Odoo database), a request is sent to `<https://www.odoo.com>`_, which returns
+  environment.
-the HTTPS certificate if the IoT system and database meet the eligibility criteria:
+- Restart the :ref:`IoT box <iot/iot-box/restart>` or the :ref:`Windows virtual IoT service
+  <iot/windows_iot/restart>`.
 
-.. _iot/https_certificate_iot/iot-eligibility:
+The IoT system is connected to the Odoo database but cannot be reached
+======================================================================
 
-- The database must be a **production** instance. The database instance should not be a copy, a
+Verify that the IoT system and the computer running the Odoo database are connected to the same
-  duplicate, a staging, or a development environment.
+network.
-- The Odoo subscription must be ongoing (:guilabel:`In Progress` status) and have an :ref:`IoT
-  box subscription <iot/iot/iot-subscription>` line.
 
-When the certificate has been received:
+The Windows virtual IoT's homepage cannot be accessed from another device
+=========================================================================
 
-- The IoT system's homepage address is updated to a new HTTPS URL ending with `.odoo-iot.com`. Click
+- Ensure the device is connected to the same network as the Windows virtual IoT.
-  the URL to establish a secure HTTPS connection.
+- Check the :ref:`iot/windows-iot/firewall`.
 
-  .. image:: https_certificate_iot/iot-new-domain.png
+The IoT system does not work after an Odoo upgrade
-     :alt: Odoo IoT app IoT box with .odoo-iot.com domain.
+==================================================
 
-- The :guilabel:`HTTPS certificate` banner displays the certificate's validity period. To view this
+Restart the :ref:`IoT box <iot/iot-box/restart>` or the :ref:`Windows virtual IoT service
-  information, click the :icon:`fa-cogs` (:guilabel:`cogs`) button on the IoT system's homepage.
+<iot/windows_iot/restart>`.
 
-  .. image:: https_certificate_iot/https-valid.png
+If the issue persists, :ref:`update its image <iot/updating_iot/image-code>` by flashing the IoT
-     :alt: IoT box homepage with HTTPS certificate validity date.
+box's card or :ref:`uninstalling the Windows virtual IoT program <iot/windows_iot/uninstall>` and
-
+:ref:`reinstalling the virtual IoT package <iot/windows-iot/installation>`.
-HTTPS certificate generation issues and errors
-==============================================
-
-The HTTPS certificate does not generate
----------------------------------------
-
-Potential causes include the following:
-
-- No :ref:`IoT box subscription <iot/iot/iot-subscription>` is linked to your account.
-- The :ref:`IoT box subscription <iot/iot/iot-subscription>` was added *after* connecting the IoT
-  system to the database. In this case, refresh the IoT system's homepage or reboot/:ref:`restart
-  <iot/windows_iot/restart>` the IoT system to regenerate the HTTPS certificate.
-- The firewall is preventing the HTTPS certificate from generating correctly. In this case,
-  deactivate the firewall until the certificate is successfully generated.
-
-  .. note::
-     Some devices, such as routers with a built-in firewall, can prevent the HTTPS certificate from
-     generating.
 
 The IoT system's homepage can be accessed using its IP address but not the `xxx.odoo-iot.com` URL
--------------------------------------------------------------------------------------------------
+=================================================================================================
 
 Contact your system or network administrator to address the issue. Network-related problems are
 beyond the scope of Odoo support services.
@@ -88,6 +69,25 @@ beyond the scope of Odoo support services.
    - On some browsers, an error code mentioning the DNS (such as `DNS_PROBE_FINISHED_NXDOMAIN`) is
      displayed.
 
+.. _iot/troubleshooting/https_certificate:
+
+HTTPS certificate generation issues and errors
+==============================================
+
+The HTTPS certificate does not generate
+---------------------------------------
+
+Potential causes include the following:
+
+- The database doesn't meet the :ref:`eligibility requirements
+  <iot/https_certificate_iot/iot-eligibility>` for generating an HTTPS certificate.
+- The firewall is preventing the HTTPS certificate from generating correctly. In this case,
+  deactivate the firewall until the certificate is successfully generated.
+
+  .. note::
+     Some devices, such as routers with a built-in firewall, can prevent the HTTPS certificate from
+     generating.
+
 Errors
 ------
 
@@ -102,7 +102,7 @@ generation or reception of the HTTPS certificate.
 `ERR_IOT_HTTPS_CHECK_NO_SERVER`
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-The server configuration is missing, i.e., the Odoo instance is not :doc:`connected <../connect>` to
+The server configuration is missing, i.e., the database is not :doc:`connected <../connect>` to
 the IoT system.
 
 `ERR_IOT_HTTPS_CHECK_CERT_READ_EXCEPTION`
@@ -114,11 +114,11 @@ Verify that the HTTPS certificate file is readable.
 `ERR_IOT_HTTPS_LOAD_NO_CREDENTIAL`
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-The contract and/or database :abbr:`UUID (Universal Unique Identifier)` is missing form the IoT.
+The contract and/or database :abbr:`UUID (Universal Unique Identifier)` is missing from the IoT.
 
 Verify that both values are correctly configured. To update them, :ref:`access the IoT box's
 <iot/iot-box/homepage>` or :ref:`Windows virtual IoT's homepage <iot/windows-iot/homepage>`,
-click the :icon:`fa-cogs` (:guilabel:`cogs`) button, then click :guilabel:`Credential`.
+click the :icon:`fa-cogs` (:guilabel:`cogs`) button, then click :guilabel:`Credentials`.
 
 `ERR_IOT_HTTPS_LOAD_REQUEST_EXCEPTION`
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

content/applications/general/iot/iot_advanced/updating_iot.rst

@@ -39,8 +39,8 @@ Image and core code update
 
       #. `Download balenaEtcher. <https://etcher.balena.io/#download-etcher>`_
       #. Insert the IoT box's micro SD card into the computer or adapter.
-      #. Open balenaEtcher, click :guilabel:`Flash from URL`, and enter the following URL:
+      #. | Open balenaEtcher, click :guilabel:`Flash from URL`, and enter the following URL:
-         `http://nightly.odoo.com/master/iotbox/iotbox-latest.zip`.
+         | `http://nightly.odoo.com/master/iotbox/iotbox-latest.zip`.
       #. Click :guilabel:`Select target` and select the SD card.
       #. Click :guilabel:`Flash` and wait for the process to finish.
 
@@ -52,10 +52,9 @@ Image and core code update
       To update the IoT box's core code, click :guilabel:`Update` under :guilabel:`IoT Box Update`
       in the :guilabel:`Update` popup.
 
-      .. danger::
+      .. warning::
-         This process may take over 30 minutes. **Do not turn off or unplug the IoT box** during
+         **Do not turn off or unplug the IoT box** during the update process, as doing so could leave
-         this time, as doing so could leave the device in an inconsistent state, requiring the IoT
+         the device in an inconsistent state, requiring the IoT box to be reflashed with a new image.
-         box to be reflashed with a new image.
 
    .. group-tab:: Windows virtual IoT
 

content/applications/general/iot/iot_box.rst

@@ -4,18 +4,13 @@ IoT box
 
 To start using an IoT box:
 
-#. Make sure you have a :ref:`valid IoT box subscription <iot/iot/iot-subscription>` in addition to
-   your Odoo subscription.
 #. Connect your :doc:`devices <devices>` to the IoT box.
 #. :ref:`Connect the IoT box to the network <iot/iot_box/network>`.
 #. :doc:`Connect the IoT box to your Odoo database <connect>`.
 
 .. seealso::
-   `Video: How to Set Up and Use the Odoo IoT Box: A Beginner's Guide <https://www.youtube.com/watch?v=w2_Dcm3r_7o&ab_channel=Odoo>`_
+   - `Video: How to Set Up and Use the Odoo IoT Box: A Beginner's Guide <https://www.youtube.com/watch?v=w2_Dcm3r_7o&ab_channel=Odoo>`_
-
+   - :doc:`iot_advanced/troubleshooting`
-.. note::
-   Devices can also be connected after the IoT box is added to the network and/or connected to the
-   database; however, a reboot of the IoT box might be required.
 
 .. _iot/iot_box/network:
 
@@ -25,9 +20,13 @@ Network connection
 The IoT box can be connected to the network via :ref:`Ethernet <iot/iot_box/network-ethernet>` or
 :ref:`Wi-Fi <iot/iot_box/network-wifi>`.
 
+.. note::
+   It is recommended to connect the IoT box to the same network as the :doc:`devices <devices>`
+   connecting to it.
+
 .. important::
-   **All** devices must be connected to the **same network**: the IoT box, the device(s) connected
+   The IoT box should only be accessible on the local network and must not be reachable from
-   to the IoT box, and the computer connected to Odoo.
+   external networks.
 
 .. _iot/iot_box/network-ethernet:
 
@@ -53,10 +52,15 @@ Make sure no Ethernet cable is connected to the IoT box and follow these steps:
      .. note::
         Depending on your operating system, the browser might not open and redirect to the IoT box's
         homepage. In this case, open your browser manually and navigate to `http://10.11.12.1`
-        or any url starting with **http** (e.g., `http://odoo.com`).
+        or any URL starting with **http** (e.g., `http://odoo.com`).
 
   #. On the IoT box's homepage, click :guilabel:`Configure` next to the :guilabel:`Internet Status`
      section.
+
+     .. image:: iot_box/iot-wifi.png
+        :scale: 75%
+        :alt: IoT box's WiFi hotspot
+
   #. Wait a few minutes for the available networks to be scanned, select the network, enter the
      Wi-Fi's password, and click :guilabel:`Connect`.
 
@@ -65,6 +69,27 @@ Make sure no Ethernet cable is connected to the IoT box and follow these steps:
    computer should automatically reconnect to its original network. If it does not, reconnect to it
    manually.
 
+.. tip::
+   If the IoT box is connected to an :doc:`external monitor <devices/screen>`, you can also scan the
+   first QR code displayed on the screen to connect to the network, then scan the second QR code to
+   access the IoT box's :ref:`homepage <iot/iot-box/homepage>`. On the homepage, click
+   :guilabel:`Configure` in the :guilabel:`Internet Status` section, select the relevant Wi-Fi
+   network, enter the password, and click :guilabel:`Connect`.
+
+.. _iot/iot-box/led-status:
+
+LED status
+==========
+
+The IoT box features two LEDs, located to the right of the SD card slot, which show its status and
+help with troubleshooting when no display is connected. The LEDs can be interpreted as follows:
+
+- **Red LED lit**: The IoT box has no Internet connection. Ensure the Ethernet cable is properly
+  connected or :ref:`connect the IoT box via Wi-Fi <iot/iot_box/network-wifi>`.
+- **Green LED flashing**: The IoT box is awaiting :doc:`connection to a database <connect>`.
+- **Green LED constantly lit**: The IoT box is connected to a database; no further action is
+  required.
+
 .. _iot/iot-box/homepage:
 
 IoT box homepage
@@ -79,30 +104,33 @@ navigate to the IoT box's IP address.
 
 The IoT box's IP address can be retrieved by:
 
-- connecting the IoT box to an external monitor: the IP address is displayed on the screen.
+- connecting the IoT box to an :doc:`external monitor <devices/screen>`: the IP address is displayed
+  on the screen.
 
-  .. image:: iot_box/iot-pos-display.png
+  .. image:: iot_box/iot-status-display.png
      :scale: 75%
-     :alt: POS display with IoT box's IP address
+     :alt: Status display with IoT box's IP address
 
 - connecting the IoT box to a `supported receipt or label printer <https://www.odoo.com/app/iot-hardware>`_
   with a USB cable: the IP address is automatically printed.
 - accessing the administrator interface of the router to which the IoT box is connected or using
   third-party software to scan the network.
 
+.. tip::
+   If the IoT box is connected to an external monitor or a printer, its homepage can also be
+   accessed by scanning the displayed or printed QR code with a device connected to the same
+   network as the IoT box.
+
 Once the IoT box is :doc:`connected to the Odoo database <connect>`, its homepage can be accessed
-from Odoo by opening the IoT app and clicking the URL displayed on the IoT box's card.
+from the IoT app: click the relevant IoT box's card, then click :guilabel:`Homepage`.
 
-.. _iot/iot-box/led-status:
+.. _iot/iot-box/restart:
 
-LED status
+IoT box restart
-==========
+===============
 
-The IoT box features two LEDs, located to the right of the SD card slot, which show its status and
+To manually restart the IoT box, access its :ref:`homepage <iot/iot-box/homepage>`, then click the
-help with troubleshooting when no display is connected. The LEDs can be interpreted as follows:
+:icon:`fa-power-off` :guilabel:`(power off)` button in the top-right corner.
 
-- **Red LED lit**: The IoT box has no Internet connection. Ensure the Ethernet cable is properly
+.. tip::
-  connected or :ref:`connect the IoT box via Wi-Fi <iot/iot_box/network-wifi>`.
+   You can also fully reboot the IoT box by unplugging and plugging it back in.
-- **Green LED flashing**: The IoT box is awaiting :doc:`connection to a database <connect>`.
-- **Green LED constantly lit**: The IoT box is connected to a database; no further action is
-  required.

content/applications/general/iot/windows_iot.rst

@@ -4,29 +4,22 @@ Windows virtual IoT
 
 To start using the Windows virtual IoT:
 
-#. Make sure all :ref:`prerequisites <iot/windows-iot/prerequisites>` are met.
+#. Make sure the computer runs an updated version of Windows (Windows 10 or Windows 11), whether
-#. :ref:`Install the Windows virtual IoT <iot/windows-iot/installation>` on a Windows computer.
+   it's a laptop, desktop, or server.
+#. :ref:`Install the Windows virtual IoT <iot/windows-iot/installation>` on the Windows computer.
 #. :ref:`Configure the Windows Firewall <iot/windows-iot/firewall>`.
 #. Connect your :doc:`devices <devices>` to the Windows virtual IoT.
 #. :doc:`Connect the Windows virtual IoT to your Odoo database <connect>`.
 
-.. _iot/windows-iot/prerequisites:
-
-Prerequisites
-=============
-
-The following prerequisites must be met before setting up and using the Windows virtual IoT:
-
-- A valid :ref:`IoT box subscription <iot/iot/iot-subscription>`.
-- An updated and recent version of Windows (i.e., Windows 10 or Windows 11) installed on a Windows
-  computer (laptop, desktop, or server).
-
 .. note::
    - :abbr:`MRP (Material Requirement Planning)` devices, including cameras and measurement tools,
      are not compatible with Windows virtual IoT.
-   - It is also possible to create a Windows Virtual Machine on a MacOS/Linux computer. However,
+   - It is also possible to create a Windows Virtual Machine on a macOS/Linux computer. However,
      this option is not supported by Odoo, and no troubleshooting assistance will be provided.
 
+.. seealso::
+   :doc:`iot_advanced/troubleshooting`
+
 .. _iot/windows-iot/installation:
 
 Installation
@@ -44,7 +37,7 @@ To install the Windows virtual IoT on a Windows computer:
 
    .. warning::
       Do not install Odoo's Windows virtual IoT in any Windows user directory, as this can cause
-      issues with :ref:`iot/https_certificate_iot/generation`.
+      issues with :ref:`HTTPS certificate generation <iot/connect/https_certificate>`.
 
 #. Set up GPL Ghostscript: Click :guilabel:`Next`, agree to the terms and conditions, click
    :guilabel:`Install`, then :guilabel:`Finish`.
@@ -52,7 +45,6 @@ To install the Windows virtual IoT on a Windows computer:
    :ref:`IoT system's homepage <iot/windows-iot/homepage>` automatically opens in a web browser with
    the URL `http://localhost:8069`.
 #. :ref:`Restart <iot/windows_iot/restart>` the Windows virtual IoT service.
-
 #. Check that you can access the :ref:`IoT system's homepage <iot/windows-iot/homepage>` in a web
    browser:
 
@@ -60,8 +52,8 @@ To install the Windows virtual IoT on a Windows computer:
    - on another device **on the same network as the IoT system** by navigating to the URL
      `http://xxx:8069` (where `xxx` is the IoT system's IP address).
    - on another device **on the same network as the IoT system** by navigating to the URL
-     `https://xxx` (where `xxx` is the IoT system's IP address) to test for :doc:`HTTPS
+     `https://xxx` (where `xxx` is the IoT system's IP address) to test for :ref:`HTTPS
-     <iot_advanced/https_certificate_iot>` connection.
+     <iot/connect/https_certificate>` connection.
 
      .. tip::
         If you cannot access the :ref:`IoT system's homepage <iot/windows-iot/homepage>` from
@@ -74,7 +66,7 @@ Windows Firewall configuration
 ==============================
 
 Firewalls help keep devices secure but can sometimes block legitimate connections. If the Windows
-virtual IoT isn't accessible on the :abbr:`LAN (Local Area Network)`, for example from another
+virtual IoT isn't accessible on the :abbr:`LAN (Local Area Network)`, for example, from another
 device, it could be due to a firewall blocking the connection. To prevent this issue, configure
 exceptions for network discovery in the :abbr:`OS (Operating System)` or firewall settings.
 
@@ -122,8 +114,8 @@ the IoT system** and navigate to the URL `http://xxx:8069` (where `xxx` is the I
 address).
 
 Once the Windows virtual IoT is :doc:`connected to the Odoo database <connect>`, its homepage can
-be accessed from Odoo by opening the IoT app and clicking the URL displayed on the IoT system's
+be accessed from Odoo by opening the IoT app, clicking the relevant IoT box's card, and
-card.
+clicking :guilabel:`Homepage`.
 
 .. image:: windows_iot/iot-windows-homepage.png
    :scale: 75%
@@ -153,8 +145,8 @@ Windows virtual IoT restart
 ===========================
 
 To manually restart the Windows IoT server, search the Windows start menu for `services` and
-select the :guilabel:`Services` app. Scroll down to the :guilabel:`odoo-server-xxx` service (where
+select the :guilabel:`Services` app. Scroll down to the :guilabel:`odoo-server-xxx` service,
-`xxx` is the odoo version), right-click it, and select :guilabel:`Start` or :guilabel:`Restart`.
+right-click it, and select :guilabel:`Start` or :guilabel:`Restart`.
 
 .. _iot/windows_iot/uninstall:
 

content/applications/sales/point_of_sale/configuration/pos_iot.rst

@@ -27,23 +27,24 @@ To connect the POS with an :doc:`IoT system </applications/general/iot>`:
           the barcode scanner to be compatible. This is most likely the barcode scanner's default
           configuration.
       * - Scale
-        - Connect the scale and power it on. Refer to :doc:`/applications/general/iot/devices/scale`.
+        - Connect the scale and power it on. Refer to :ref:`pos/hardware/scale`.
       * - Customer display
         - Connect a screen to the :abbr:`IoT (Internet of Things)` box to display the :abbr:`PoS
-          (Point of Sale)` order. Refer to :doc:`/applications/general/iot/devices/screen`.
+          (Point of Sale)` order. Refer to :ref:`pos/hardware/display`.
       * - Payment terminal
         - The connection process depends on the terminal. Refer to the :doc:`payment terminals
           documentation </applications/sales/point_of_sale/payment_methods>`.
 
 #. :doc:`Connect the IoT system to your Odoo database </applications/general/iot/connect>`.
-#. :ref:`Access the POS settings <configuration/settings>` and select your POS, or click the
+#. In the :guilabel:`Connect to a Point of Sale` popup that opens, select the :guilabel:`Associated
-   vertical ellipsis button (:guilabel:`⋮`) on a POS card and click :guilabel:`Edit`. Scroll down
+   POS` and click :guilabel:`Continue`. The IoT system and its devices are automatically linked to
-   to the :guilabel:`Connected Devices` section, enable :guilabel:`IoT Box`, then select the devices
+   the POS.
-   to be used for the POS. Click :guilabel:`Save`.
 
-.. tip::
+   .. tip::
-   Click :guilabel:`IoT Devices` to access the list of :doc:`/applications/general/iot/devices` for
+      Alternatively, :ref:`access the POS settings <configuration/settings>` and select the POS, or
-   your POS and view their connection status. Click a card to access the device's form.
+      click the vertical ellipsis button (:guilabel:`⋮`) on a POS card and click :guilabel:`Edit`.
+      Scroll down to the :guilabel:`Connected Devices` section, enable :guilabel:`IoT Box`, then
+      select the devices to be used for the POS. Click :guilabel:`Save`.
 
 .. seealso::
    - `List of supported hardware <https://www.odoo.com/page/point-of-sale-hardware>`_.

content/applications/sales/point_of_sale/pos_hardware.rst

@@ -4,11 +4,11 @@ Hardware
 
 Odoo Point of Sale supports integration with a variety of hardware, including :doc:`payment
 terminals <payment_methods/terminals>` and cash drawers, as well as :ref:`customer displays
-<pos/display>`, :ref:`scales <pos/scale>`, :doc:`barcode scanners <shop/barcode>`,
+<pos/hardware/display>`, :ref:`scales <pos/hardware/scale>`, :doc:`barcode scanners <shop/barcode>`,
 :doc:`ePOS printers <configuration/epos_printers>`, and in-store :doc:`electronic shelf labels
 <pricing/electronic_labels>`.
 
-.. _pos/display:
+.. _pos/hardware/display:
 
 Customer display
 ================
@@ -26,6 +26,8 @@ the selected :doc:`payment method <payment_methods>`, and any change to be retur
    Both the customer and POS displays must have a minimum diagonal size of 6 inches. For optimal
    readability, larger screens are recommended.
 
+.. _pos/hardware/display-configuration:
+
 Configuration
 -------------
 
@@ -76,7 +78,7 @@ support, follow these steps:
 #. Click the :icon:`fa-desktop` (:guilabel:`Customer Display`) icon, which opens the customer
    display on the terminal's secondary screen.
 
-.. _pos/scale:
+.. _pos/hardware/scale:
 
 Scale
 =====
@@ -156,7 +158,7 @@ turns green.
 
 .. admonition:: Additional guidelines
 
-   Both the :ref:`customer <pos/display>` and POS displays must have a minimum diagonal
+   Both the :ref:`customer <pos/hardware/display>` and POS displays must have a minimum diagonal
    size of 6 inches. For optimal readability, larger screens are recommended.
 
 Using a scale in PoS

redirects/19.0.txt

@@ -12,4 +12,8 @@ applications/inventory_and_mrp/inventory/product_management/inventory_valuation/
 # applications/finance
 
 applications/finance/payment_providers/wire_transfer.rst applications/finance/payment_providers/bank_payments.rst
-applications/finance/payment_providers/sdd.rst applications/finance/payment_providers/bank_payments.rst
+applications/finance/payment_providers/sdd.rst applications/finance/payment_providers/bank_payments.rst
+
+#applications/general
+
+applications/general/iot/iot_advanced/https_certificate_iot.rst applications/general/iot/iot_advanced/troubleshooting.rst