[IMP] iot: 19.0 updates

task-5108135

Author: auva-odoo

content/applications/general/iot.rst

@@ -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
-to your subscription, contact the database's account manager or Odoo partner for assistance.
-
-.. tip::
-   If the subscription is linked to an `Odoo.com <https://www.odoo.com>`_ portal user, check the
-   information on the portal's subscription page.
+An IoT box subscription is required for production use of IoT systems and generating the
+:doc:`HTTPS certificate <iot/iot_advanced/https_certificate_iot>`. It is created automatically
+when an IoT system is :doc:`connected to the database <iot/connect>`. If you have issues related to
+your subscription, contact the database's account manager or Odoo partner for assistance.
 
 .. seealso::
    - `Odoo's compatible IoT devices <https://www.odoo.com/app/iot-hardware>`_
@@ -70,8 +68,8 @@ to your subscription, contact the database's account manager or Odoo partner for
    .. card:: HTTPS certificate
       :target: iot/iot_advanced/https_certificate_iot
 
-      Verify your IoT system and database meet the eligibility requirements for HTTPS certificate
-      generation and address any related issues.
+      Verify your database meet the eligibility requirements for HTTPS certificate 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,16 +23,20 @@ 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
-<iot/connect/pairing-code>` or a :ref:`connection token <iot/connect/token>`.
+To connect the IoT system to the Odoo database, open the IoT app and click :guilabel:`Connect`.
+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>`.
 
 .. _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 displayed 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
      <iot/windows_iot/restart>` to display the pairing code again. Alternatively, connect the IoT
      system to the database using a :ref:`connection token <iot/connect/token>`.
@@ -64,16 +68,17 @@ 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`.
-#. Click :guilabel:`Pair`.
+#. In the :guilabel:`Searching for an IoT Box` popup that opens, click :guilabel:`Use Pairing Code`.
+#. Enter the :guilabel:`Pairing code` and click :guilabel:`Connect`.
 
 .. _iot/connect/token:
 
 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`.
@@ -88,14 +93,14 @@ 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
-:ref:`Windows virtual IoT's <iot/iot-box/homepage>` homepage. Click the card to access the
-list of :doc:`devices <devices>` connected to the IoT system.
+Click the card to access the IoT system's form, which allows to:
 
-.. tip::
-   :ref:`Enable the developer mode <developer-mode>` to access the IoT system's
-   :guilabel:`Technical Information`, such as its :guilabel:`Identifier`, :guilabel:`Domain
-   address`, and :guilabel:`Image version`.
+- access the :ref:`IoT box's <iot/windows-iot/homepage>` or :ref:`Windows virtual IoT's
+  <iot/iot-box/homepage>` homepage.
+- view the list of :doc:`devices <devices>` connected to the IoT system;
+- access the IoT system's :guilabel:`Technical Information`, such as its :guilabel:`Domain address`,
+  :guilabel:`Image version`, and :doc:`SSL certificate <iot_advanced/https_certificate_iot>`
+  :guilabel:`End Date`.
 
 .. note::
    By default, drivers are automatically :ref:`updated <iot_updating_iot/handlers>` every time the
@@ -147,5 +152,4 @@ 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**.
+:ref:`reinstalling the virtual IoT package <iot/windows-iot/installation>`.

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

@@ -2,109 +2,49 @@
 Connect a screen
 ================
 
-In Odoo, an :abbr:`IoT (Internet of Things)` box can be connected to a screen display. After being
-configured, the screen can be used to display a Point of Sale (PoS) order to a client.
-
-.. 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.
+The :doc:`IoT system <>` can be connected to a screen, e.g. to ease its setup and/or serve
+as a :ref:`customer display <pos/display>` to show customers their :doc:`Point of Sale
+<sales/point_of_sale>` orders.
 
 Connection
 ==========
 
-The way to connect the screen display to the :abbr:`IoT (Internet of Things)` box differs depending
-on the model.
-
-.. tabs::
-
-   .. tab:: IoT Box model 4
-
-      Connect up to two screens with micro-HDMI cables on the side of the :abbr:`IoT (Internet of
-      Things)` box. If two screens are connected, they can display distinct content (see
-      :ref:`Screen Usage <iot/usage_screen>`).
+To connect a screen to an IoT system, connect the screen to the IoT system using an HDMI or
+micro-HDMI cable (depending on your IoT system) **before** turning the IoT system on. If the IoT
+system is already running, connect the screen to it, then reboot the IoT box or :ref:`restart the
+Windows virtual IoT service <iot/windows_iot/restart>`
 
-   .. tab:: IoT Box model 3
-
-      Connect the screen with an HDMI cable on the side of the :abbr:`IoT (Internet of Things)` box.
-
-.. seealso::
-   :ref:`See the Raspberry Pi Schema <pos/pos_iot/connect_schema>`.
-
-.. 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.
+.. note::
+   Using HDMI or micro-HDMI adapters may cause issues that result in a blank or black screen. It is
+   recommended to use the specific cable required for the display connection.
 
-If the connection was successful, the screen should display the :guilabel:`POS Client display`
+If the connection was successful, the external monitor displays the :guilabel:`Status 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.
+.. image:: screen/screen-status-diplay.png
+   :alt: Default Status Display screen
 
-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`.
+The screen also appears in the IoT system's list of 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.
+- on the :ref:`IoT system's form <iot/connect/IoT-form>`;
+- on the :ref:`IoT box's <iot/iot-box/homepage>` or
+  :ref:`Windows virtual IoT's <iot/windows-iot/homepage>` homepage;
+- under the menu :menuselection:`IoT --> Devices`.
 
 .. note::
-   If no screen is detected, a default display named :guilabel:`Distant Display` will be displayed
+   If no screen is detected, a default display named :guilabel:`Distant Display` is 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.
+Customer display
+================
 
-Display a website on the screen
--------------------------------
+To use the screen as a :ref:`customer display <pos/hardware/display>`, :ref:`configure the POS must
+<pos/hardware/display-configuration>` to use a customer display.
 
-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.
+To display a specific website on the screen instead of the POS customer display, go to
+:menuselection:`IoT --> Devices`, click the screen's card, then enter the desired website's URL in
+the :guilabel:`Display URL` field.