# IoT system updates

Due to the complexity of IoT systems, the term *updating* can refer to several processes, including:

- {ref}`Updating the IoT system's image and/or core code <iot/updating_iot/image-code>`;
- {ref}`Updating the handlers <iot_updating_iot/handlers>`, which include the interfaces and drivers.

(iot-updating-iot-image-code)=

## Image and core code update

```{eval-rst}
.. tabs::

   .. group-tab:: IoT box

      To check if the IoT box is up-to-date (and update it if needed), :ref:`access the IoT box's
      homepage <iot/iot-box/homepage>`, click the :icon:`fa-cogs` (:guilabel:`cogs`) button at the
      top-right, then :guilabel:`Update` in the :guilabel:`Version` section.

      .. tip::
         :ref:`Enable the developer mode <developer-mode>` to view the current versions of the IoT
         box's image and core code.

     **Image update**

      To update the IoT box's image, flash its SD card. Flashing can be performed using
      `balenaEtcher <https://etcher.balena.io>`_, a free and open-source tool for writing disk
      images to SD cards.

      .. note::
         - Updating the IoT system's image is often required after upgrading the Odoo database to a
           newer version.
         - A computer with a micro SD card reader/adapter is required to flash the micro SD card.
         - An alternative software for flashing the micro SD card is `Raspberry Pi Imager
           <https://www.raspberrypi.com/software/>`_.

      #. `Download balenaEtcher. <https://etcher.balena.io/#download-etcher>`_
      #. Insert the IoT box's micro SD card into the computer or adapter.
      #. Open balenaEtcher, click :guilabel:`Flash from URL`, and enter the following URL:
         `http://nightly.odoo.com/master/iotbox/iotbox-latest.zip`.
      #. Click :guilabel:`Select target` and select the SD card.
      #. Click :guilabel:`Flash` and wait for the process to finish.

      .. image:: updating_iot/etcher-flash.png
         :alt:  Flashing the SD card with balenaEtcher

     **Core code update**

      To update the IoT box's core code, click :guilabel:`Update` under :guilabel:`IoT Box Update`
      in the :guilabel:`Update` popup.

      .. danger::
         This process may take over 30 minutes. **Do not turn off or unplug the IoT box** during
         this time, as doing so could leave the device in an inconsistent state, requiring the IoT
         box to be reflashed with a new image.

   .. group-tab:: Windows virtual IoT

      To update the Windows virtual IoT's image and code, :ref:`uninstall the program
      <iot/windows_iot/uninstall>` and :ref:`reinstall <iot/windows-iot/installation>` the latest
      package.
```

(iot-updating-iot-handlers)=

## Handler (driver) update

To update the IoT system's handlers (i.e., drivers and interfaces) and synchronize them with the
configured server handler's code, for example, to resolve issues where {doc}`devices <../devices>`
are not functioning properly with the IoT system, proceed as follows:

1. Access the {ref}`IoT box's <iot/iot-box/homepage>` or {ref}`Windows virtual IoT's
   <iot/windows-iot/homepage>` homepage and click the {icon}`fa-cogs` ({guilabel}`cogs`) button at
   the top-right.
2. Click {guilabel}`Update` in the {guilabel}`Version` section.
3. In the {guilabel}`Update` popup that opens, click {guilabel}`Force Drivers Update`.

:::{important}
If you have an {doc}`on-premise </administration/on_premise>` or {doc}`Odoo.sh
</administration/odoo_sh/overview/introduction>` database, the configured server must be
up-to-date to ensure the handlers' code includes the latest fixes and patches.
:::

:::{note}
A handler update is also performed automatically every time the IoT system is restarted unless
the {guilabel}`Automatic drivers update` option is disabled in the {guilabel}`Technical
information` tab in the {ref}`IoT system's form <iot/connect/IoT-form>` in Odoo.
:::