[IMP] iot: 19.0 updates

task-5108135

Author: auva-odoo

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
-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>`_
@@ -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
@@ -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,24 @@ 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>`.
+
+.. tip::
+   The :doc:`IoT box <iot_box>`'s name is composed of the IoT box's serial number and
+   :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 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 +72,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 +97,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 +156,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/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,40 @@
 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 box <../iot_box>` can be connected to a screen, e.g. to ease the IoT box's setup
+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.
 
 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>`).
-
-   .. 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.
-
-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.
+Connect the screen to the IoT box using a micro-HDMI cable.
 
 .. 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:
+   Avoid using micro-HDMI adapters, as they can cause display issues such as a blank or black
+   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.
+If the connection was successful, the external monitor displays the :guilabel:`Status display`
+screen.
 
-.. image:: screen/screen-pos-screen-config.png
-   :align: center
-   :alt: Connect the screen display to the Point of Sale app.
+.. image:: screen/screen-status-display.png
+   :alt: Default Status Display screen
 
-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.
+The screen also appears in the IoT box's list of devices:
 
-.. 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.
+- on the :ref:`IoT box's form <iot/connect/IoT-form>`;
+- on the :ref:`IoT box's homepage <iot/iot-box/homepage>`;
+- in the IoT app, under the menu :menuselection:`IoT --> Devices`.
 
-The screen will automatically show the :abbr:`PoS (Point of Sale)` orders and update when changes
-are made to the order.
+.. tip::
+   If the screen is not detected, try rebooting the IoT box.
 
-.. 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
+accordingly <pos/hardware/display-configuration>`.
 
-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.