documentation/content/applications/general/iot/iot_advanced/updating_iot.md

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

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