Verbindung des IoT-Systems mit Odoo

Voraussetzungen

Um das IoT-System mit einer Odoo-Datenbank zu verbinden, müssen folgende Voraussetzungen erfüllt sein:

  • Die IoT-App muss installiert sein.

  • Das IoT-System muss mit dem Netzwerk verbunden sein.

  • The device connecting to Odoo must be on the same network as the IoT system.

Bemerkung

Es wird empfohlen, das IoT-System mit einer Produktionsinstanz zu verbinden, da andere Umgebungstypen Probleme verursachen können (z. B. bei der HTTPS-Zertifikatsgenerierung).

Verbindung

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.

Tipp

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.

Verknüpfung über Kopplungscode

Bemerkung

  1. 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.

    Tipp

    Wenn kein externer Monitor oder Drucker an die IoT-Box angeschlossen ist, rufen Sie die Startseite der IoT-Box auf. Der Code wird im Abschnitt Pairing Code (Kopplungscode) angezeigt.

  2. Öffnen Sie in Odoo die IoT-App und klicken Sie auf Verbinden.

  3. In the Searching for an IoT Box popup that opens, click Use Pairing Code.

  4. Enter the Pairing code and click Connect.

Verbindung über einen Verbindungstoken

  1. Enable the developer mode.

  2. Öffnen Sie in Odoo die IoT-App und klicken Sie auf Verbinden.

  3. In the Searching for an IoT Box popup that opens, click Offline pairing.

  4. In the Pair an IoT Box offline popup that opens, copy the Token.

  5. Rufen Sie die Startseite der IoT-Box oder des virtuellen Windows-IoT auf.

  6. In the Odoo database connected section, click Configure.

  7. Fügen Sie das Token in das Feld Servertoken ein und klicken Sie auf Verbinden.

Bemerkung

Once the IoT system is connected to a database:

Siehe auch

Fehlerbehebung

Formular des IoT-Systems

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.

Tipp

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:

  1. Open the IoT app and click the relevant IoT system’s card.

  2. Click the (Actions) icon, and select Delete.

Tipp

Alternatively:

  1. Rufen Sie die Startseite der IoT-Box oder des virtuellen Windows-IoT auf.

  2. Click Configure in the Odoo database connected section.

  3. 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.

Bemerkung

In dieser Dokumentation und in Odoo bezieht sich der Begriff HTTPS-Zertifikat auf ein gültiges SSL-Zertifikat, das eine HTTPS-Verbindung ermöglicht.

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:

  • Die Datenbank muss eine Produktionsinstanz sein. Bei der Datenbankinstanz sollte es sich nicht um eine Kopie, ein Duplikat, eine Staging- oder eine Entwicklungsumgebung handeln.

  • The Odoo subscription must be ongoing (In Progress status).

Wenn das Zertifikat empfangen wurde:

  • 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.

    Startseite der IoT-Box mit dem Gültigkeitsdatum des HTTPS-Zertifikats.