IoT box

To start using an IoT box:

  1. Connect your devices to the IoT box.

  2. Connect the IoT box to the network.

  3. Connect the IoT box to your Odoo database.

Network connection

The IoT box can be connected to the network via Ethernet or Wi-Fi.

Note

It is recommended to connect the IoT box to the same network as the devices connecting to it.

Important

Never make the IoT box accessible from the public Internet. IoT systems are designed to provide your database with access to devices on your local network. Exposing them to the public Internet would create a security risk.

Ethernet

Plug the Ethernet cable into the IoT box’s Ethernet port and an available port on your router, then connect the IoT box to a power source.

Wi-Fi

Make sure no Ethernet cable is connected to the IoT box and follow these steps:

  1. Connect the IoT box to a power source and wait a few minutes for it to power on.

  2. Access your computer’s Wi-Fi settings and select the IoT box’s network. The network name is in the format IoTBox-xxxxxxxxxxxx (where xxxxxxxxxxxx is a unique identifier).

  3. Connect to the IoT box’s Wi-Fi network and sign into it; your browser should automatically open and redirect to the IoT box’s homepage.

    Note

    Depending on your operating system, the browser might not open and redirect to the IoT box’s homepage. In this case, open your browser manually and navigate to http://10.11.12.1 or any URL starting with http (e.g., http://odoo.com).

  4. On the IoT box’s homepage, click Configure next to the Internet Status section.

    IoT box's WiFi hotspot
  5. Wait a few minutes for the available networks to be scanned, select the network, enter the Wi-Fi’s password, and click Connect.

Note

Once connected to the Wi-Fi network, the IoT box stops emitting its Wi-Fi signal, and the computer should automatically reconnect to its original network. If it does not, reconnect to it manually.

Tip

If the IoT box is connected to an external monitor, you can also scan the first QR code displayed on the screen to connect to the network, then scan the second QR code to access the IoT box’s homepage. On the homepage, click Configure in the Internet Status section, select the relevant Wi-Fi network, enter the password, and click Connect.

LED status

The IoT box features two LEDs, located to the right of the SD card slot, which show its status and help with troubleshooting when no display is connected. The LEDs can be interpreted as follows:

  • Red LED lit: The IoT box has no Internet connection. Ensure the Ethernet cable is properly connected or connect the IoT box via Wi-Fi.

  • Green LED flashing: The IoT box is awaiting connection to a database.

  • Green LED constantly lit: The IoT box is connected to a database; no further action is required.

IoT box homepage

To access the IoT box’s homepage, open a web browser on the same network as the IoT box and navigate to the IoT box’s IP address.

IoT box's homepage

The IoT box’s IP address can be retrieved by:

  • connecting the IoT box to an external monitor: the IP address is displayed on the screen.

    Status display with IoT box's IP address
  • connecting the IoT box to a supported receipt or label printer with a USB cable: the IP address is automatically printed.

  • accessing the administrator interface of the router to which the IoT box is connected or using third-party software to scan the network.

Tip

If the IoT box is connected to an external monitor or a printer, its homepage can also be accessed by scanning the displayed or printed QR code with a device connected to the same network as the IoT box.

Once the IoT box is connected to the Odoo database, its homepage can be accessed from the IoT app: click the relevant IoT box’s card, then click Homepage.

IoT box restart

To manually restart the IoT box, access its homepage, then click the (power off) button in the top-right corner.

Tip

You can also fully reboot the IoT box by unplugging and plugging it back in.