.. _palette_assisted:

Update With Palette
--------------------

The **Palette-Assisted Update** method allows you to update the DevKit firmware using the :ref:`MPK Tool`, which is included in the :ref:`Palette Development Environment <Palette installation>`. This method is recommended for:

- **DevKits running firmware version 1.4 or earlier** in PCIe mode.
- Developers who have Palette installed on their machine and prefer an integrated update process.


With Palette-Assisted upgrade, you still need to download the firmware separately. 

.. include:: ../blocks/download_mlsoc_firmware.rst

Once you downloaded the firmware you can uncompress the file ``simaai-image-palette-upgrade-davinci.swu`` to the folder where you can access from the Palette container.

.. tabs::

   .. tab:: Standalone Mode Update


        In standalone mode, connect to the DevKit from the MPK tool using its IP address and perform the firmware update:

        .. code-block:: console 

            sima-user@docker-image-id:/home# mpk device connect -t <BOARD_IP_ADDRESS> -u <USER> -d my_device
            sima-user@docker-image-id:/home# mpk firmware-upgrade -f /home/docker/sima-cli/simaai-image-palette-upgrade-davinci.swu -d my_device

   .. tab:: PCIe Mode Update

        .. note::

            - In the PCIe mode, ensure that the `host driver <../setup_pcie_mode.html#driver-installation>`_ is installed to the matching version of the firmware first. 


        In PCIe mode, connect to the DevKit from the MPK tool using the slot number (e.g. ``0``) and execute the firmware update:

        .. code-block:: console 

            sima-user@docker-image-id:/home# mpk device connect -s 0
            sima-user@docker-image-id:/home# mpk firmware-upgrade -f /home/docker/sima-cli/simaai-image-palette-upgrade-davinci.swu -d my_device

    For additional details, refer to the :ref:`mpk firmware-upgrade` command.