documentation/content/applications/productivity/iot/config/connect.rst
Antoine Vandevenne (anv) 250bc3ab21 [MOV] content/*: move resource files into their related page's directory
Since odoo/documentation#903, the guideline for the location of new
resource (images, downloadable files, RST includes...) files is to place
those inside the directory of the RST page that references them.

For example, if `doc1.rst` has a reference to `image.png` and to
`download.zip`, the file structure should look like this:

├── parent_doc/
│     └── doc1/
│     │     └── image.png
│     │     └── download.zip
│     └── doc1.rst
│     └── doc2.rst
├── parent_doc.rst

Before this commit, most of the resource files were still located inside
'media' directories holding all the resource files referenced by RST
pages located at the same level as these directories. In the example
above, a single 'media' directory would hold all the resource files
referenced by both `doc1.rst` and `doc2.rst`. Doing so prevented us from
figuring out easily which resource file was referenced by which RST page
and, thus, lead to unused resource files piling up in the repository. It
also made it more complicated to define codeowners regex rules because a
team could not simply be assigned to `/some_page.*` but needed to be
assigned to both `/some_page\.rst` and to the location of 'media'.

In order to help new content writers figure out the guideline when
taking examples from other RST pages, this commit retroactively applies
the guideline to existing resource files and 'media' directories. The
left-over resource files that are not referenced by any RST page are
removed.

task-2497965

Part-of: odoo/documentation#2066
2022-05-20 14:48:37 +02:00

82 lines
2.1 KiB
ReStructuredText

===================================
Connect an IoT Box to your database
===================================
Install the Internet of Things (IoT) App on your Odoo Database.
.. image:: connect/connect01.png
:align: center
Go in the IoT App and click on Connect on the IoT Boxes page.
.. image:: connect/connect02.png
:align: center
Follow the steps to connect your IoT Box.
.. image:: connect/connect03.png
:align: center
Ethernet Connection
~~~~~~~~~~~~~~~~~~~
1. Connect to the IoT Box all the devices that have to be connected with
cables (ethernet, usb devices, etc.).
2. Power on the IoT Box.
3. Read the Pairing Code from a screen or a receipt printer connected to the IoT Box.
.. image:: connect/connect04.png
4. Input the Pairing Code and click on the Pair button.
.. note::
Recent changes in modern web browsers forced us to modify the connection wizard.
If your screen is different from the screenshots, make sure that the
``iot_pairing`` module is installed.
WiFi Connection
~~~~~~~~~~~~~~~
1. Power on the IoT Box
2. Copy the token
.. image:: connect/connect05.png
3. Connect to the IoT Box WiFi Network (make sure there is no ethernet
cable plugged in your computer).
.. image:: connect/connect06.png
4. You will be redirected to the IoT Box Homepage (if it doesn't work,
connect to the IP address of the box). Give a name to your IoT Box (not
required) and paste the token, then click on next.
.. image:: connect/connect07.png
.. tip::
If you are on Runbot, do not forget to add the -all or -base in the
token (e.g. this token
**http://375228-saas-11-5-iot-f3f920.runbot16.odoo.com\|4957098401**
should become
**http://375228-saas-11-5-iot-f3f920-all.runbot16.odoo.com\|4957098401**).
5. Choose the WiFi network you want to connect with (enter the password
if there is one) and click on Submit. Wait a few seconds before being
redirected to your database.
.. image:: connect/connect08.png
You should now see the IoT Box.
.. image:: connect/connect09.png
:align: center
IoT Box Schema
~~~~~~~~~~~~~~
.. image:: connect/connect10.png
:align: center