.. include:: ../urls.rst

.. meta::
   :keywords: bm818 firmware flash flashing modem

.. _l5_modem_reflash:

Reflashing modem firmware
=========================


.. _l5_modem_reflash_bm818:

BroadMobi BM818
---------------


.. _l5_modem_reflash_bm818_pkg_dependencies:

1. Install required packages
~~~~~~~~~~~~~~~~~~~~~~~~~~~~

#. Download the following BM818 firmware packages. These files are controlled by a third-party and are not publicly accessible. `Contact Purism Support <docs_contact_purism_>`_ to request these files for a firmware update:
    #. ``firmware-bm818-nonfree_0.6pureos1+librem5ci83034.2dcae67_arm64.deb``
    #. ``qdl_0.2pureos1+librem5ci77119.0103259_arm64.deb``
#. Open a terminal emulator
#. Run the following commands to install the pre-requisite packages and the BM818 tools

   .. code:: bash

      sudo apt install ./qdl_0.2pureos1+librem5ci77119.0103259_arm64.deb \
                       ./firmware-bm818-nonfree_0.6pureos1+librem5ci83034.2dcae67_arm64.deb \
                       bm818-tools

#. Type your password if prompted, and press **Enter**.
   Your password will not be printed to the screen when you type, for security purposes.
#. If prompted to confirm the changes, type **y** and press **Enter**
#. After these packages are installed, you will see an application called **BM818-Flash** in the app drawer.

   .. image:: ../_files/bm818-tools/bm818-tools-icon.png
      :scale: 50%
      :alt: BM818-Flash icon
      :class: no-scaled-link

#. Tap the icon and you will see a terminal window prompting you for your password.
   Type your password and press **Enter**.

   .. image:: ../_files/bm818-tools/bm818-tools-password-prompt.png
      :scale: 50%
      :alt: BM818-Flash icon
      :class: no-scaled-link

#. After you typed your password, the application will back up the current settings of the modem and power cycle the modem. 
   You will see some terminal output that should end with the phrase; Backup NV OK


.. _l5_modem_reflash_bm818_select_fw_version:

2. Choose the modem firmware version
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

#. After the NV Backup, a new window will appear, asking you to select the modem firmware version that you want to install. 
   Choose the :ref:`appropriate modem model for your region <l5_cellular_networks_supported_networks_modems>`.
#. Press the file chooser tab highlighted in red.

   .. image:: ../_files/bm818-tools/bm818-tools-choose-firmware-button.png
      :scale: 50%
      :alt: "Choose firmware" button
      :class: no-scaled-link

#. Select the version option and press **OK**.

   .. image:: ../_files/bm818-tools/bm818-tools-choose-firmware-dropdown.png
      :scale: 50%
      :alt: "Choose firmware" dropdown
      :class: no-scaled-link

#. The application will begin flashing the modem.


.. _l5_modem_reflash_bm818_restore_nv_backup:

3. Restore NV backup
~~~~~~~~~~~~~~~~~~~~

As a final step in the reflashing process, the application will restore the NV backup and will prompt you to select the backup file from which to restore. 

#. Tap the file chooser field to select the file that starts with ``backup_m100`` and then press **OK**.

   .. image:: ../_files/bm818-tools/bm818-tools-backup-file-selection.png
      :scale: 50%
      :alt: NV backup file selection
      :class: no-scaled-link

The modem firmware reflash procedure is complete.
The application should close automatically.

You may need to reboot the device for the modem to reappear.
See the next pages to re-eanable VoLTE


.. _l5_modem_reflash_bm818_enable_volte:

4. Re-enable VoLTE
~~~~~~~~~~~~~~~~~~~

VoLTE must be re-enabled as the modem firmware was reflashed to a factory state.

#. Open the **BM818-VoLTE** application in the application drawer.

   .. image:: ../_files/bm818-tools/bm818-volte-icon.png
      :scale: 50%
      :alt: BM818-VoLTE application icon
      :class: no-scaled-link

#. If the application shows VoLTE as enabled, disable it and press **OK**. 
   Reopen the application, enable VoLTE again, then press **OK**. 

   .. image:: ../_files/bm818-tools/bm818-volte-configuration.png
      :scale: 50%
      :alt: BM818-VoLTE configuration screen
      :class: no-scaled-link

You may need to reboot the modem for these changes to take effect.