IoT system connection to Odoo¶
Förkunskapskrav¶
To connect the IoT system to an Odoo database, the following prerequisites must be met:
The Internet of Things (IoT) app must be installed.
The IoT system must be connected to the network.
The device connecting to Odoo must be on the same network as the IoT system.
Observera
It is recommended to connect the IoT system to a production instance, as other types of environments may cause issues (e.g., with HTTPS certificate generation).
Se även
Anslutning¶
To connect the IoT system to an Odoo database, open the IoT app and click 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 Connect. If no IoT system is detected automatically, try connecting it to the database using a pairing code or a connection token.
Tips
The IoT system’s name is composed of either the IoT box or the Windows computer’s motherboard serial number, followed by its pairing code.
Connection using a pairing code¶
Observera
The pairing code is valid for up to 2 hours after the IoT system powers on. If the code is no longer valid, restart the IoT box or restart the Windows virtual IoT service to display another pairing code. Alternatively, connect the IoT system to the database using a connection token.
The pairing code is not displayed if the IoT system is already connected to a database (e.g., a test database). If necessary, disconnect the IoT system from the database.
Retrieve the IoT system’s pairing code:
Connect the IoT box to an external monitor or a USB printer. If the IoT box was already plugged prior to this, restart it.
External monitor: The pairing code will be displayed on the screen after (re)starting the IoT box.
USB-connected printer: The pairing code should be printed automatically.
Tips
If no external monitor or printer is connected to the IoT box, access the IoT box’s homepage; the code is displayed in the Pairing Code section.
On the computer with the Windows virtual IoT installed, open the IoT system’s homepage in a web browser by navigating to the URL
http://localhost:8069. Then, scroll to the Pairing Code section.In Odoo, open the IoT app and click Connect.
In the Searching for an IoT Box popup that opens, click Use Pairing Code.
Enter the Pairing code and click Connect.
Connection using a connection token¶
In Odoo, open the IoT app and click Connect.
In the Searching for an IoT Box popup that opens, click Offline pairing.
In the Pair an IoT Box offline popup that opens, copy the Token.
Access the IoT box’s or Windows virtual IoT’s homepage.
In the Odoo database connected section, click Configure.
Paste the token into the Server Token field and click Connect.
Observera
Once the IoT system is connected to a database:
If the Point of Sale app is installed, a popup appears to select the POS the IoT system should be associated with.
If using an IoT box, wait a few minutes for it to update before using the connected devices.
The IoT system automatically requests an HTTPS certificate and its homepage is updated to a new HTTPS URL ending with
.odoo-iot.comwhen it becomes available.
Se även
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 card to access the IoT system’s form, which allows to access the IoT box’s or Windows virtual IoT’s homepage and view the list of devices connected to the IoT system.
Tips
Enable the developer mode to access the IoT system’s Technical Information, such as its Domain Address, Image Version, and SSL Certificate End Date. By default, drivers are automatically updated every time the IoT system is restarted. To disable automatic updates, uncheck the Automatic drivers update option.
Disconnecting an IoT system from a database¶
To disconnect the IoT system from a database, follow these steps:
Open the IoT app and click the relevant IoT system’s card.
Click the (Actions) icon, and select Delete.
Tips
Alternatively:
Access the IoT box’s or Windows virtual IoT’s homepage.
Click Configure in the Odoo database connected section.
Click Disconnect in the popup that opens.
HTTPS certificate¶
HTTPS is the secure, encrypted version of HTTP. It uses TLS (previously SSL) 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.
Observera
In this documentation and throughout Odoo, the term HTTPS certificate refers to a valid SSL certificate that allows an HTTPS connection.
When the IoT system is (re-)started and connected to a database, it automatically downloads the HTTPS certificate if the database meets the following eligibility criteria:
The database must be a production instance. The database instance should not be a copy, a duplicate, a staging, or a development environment.
The Odoo subscription must be ongoing (In Progress status).
When the certificate has been received:
The IoT system’s homepage address is updated to a new HTTPS URL ending with
.odoo-iot.com.The HTTPS certificate banner displays the certificate’s validity period. To view this information, click the (cogs) button at the top-right of the IoT system’s homepage.
