Skip to content

Revise flashing instructions #70

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
abinjose-qualcomm merged 2 commits into from
Mar 10, 2026
Merged

Revise flashing instructions #70

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
acb2377
fix incorrect commands in flashing instructions
abinjose-qualcomm Mar 9, 2026
86cdfb0
clarify system support for QDL and PCAT
abinjose-qualcomm Mar 10, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
138 changes: 30 additions & 108 deletions topic/k2c-qli-build-ga/flash_images.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -32,12 +32,8 @@ On build completion, flashable images can be obtained from the following paths:

::

untar tar.gz
cd <Base_Workspace_Path>/build/tmp/deploy/images/<MACHINE>/
tar -xvf <IMAGE>-<MACHINE>.rootfs.qcomflash.tar.gz

# Command to flash
<Base_Workspace_Path>/build/tmp/deploy/images/<MACHINE>/<IMAGE>-<MACHINE>

Flash instructions
-------------------
Expand All @@ -48,13 +44,14 @@ Follow these steps to flash the software images:

1. Update the ``udev`` rules (one-time prerequisite).
#. Force the device into emergency download (EDL) mode.
#. Install QDL
#. Provision UFS (one-time prerequisite).
#. Flash SAIL (one-time prerequisite).
#. Choose CDT based on reference kit.
#. Flash the software:

- Using QDL
- Using PCAT
- Using QDL (supported on Linux and macOS)
- Using PCAT (supported on Windows, Linux and macOS)

.. _update_udev_rules:

Expand Down Expand Up @@ -323,30 +320,12 @@ Manual

.. note:: Dip switch S2-8 must be turned off after the flashing is complete.

.. _provision_ufs:

Provision UFS
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Universal flash storage (UFS) provisioning helps to divide the storage into many LUNs, which stores different types of data separately. This improves access efficiency and system organization.

UFS is provisioned by default. If there are any changes in LUNs, UFS must be re-provisioned. To download the provision XML file and to check the applicability of UFS provisioning for different SoCs, see the table *UFS Provision* in `Release Specific Information <https://docs.qualcomm.com/doc/80-80020-300/topic/release_specific_information.html>`__.

1. Download the provision file.
.. _setup_qdl:

Based on the required SoC, download the respective ‘provision’ from the *UFS Provision* table of the `Release Notes <https://docs.qualcomm.com/doc/80-80020-300/topic/release_specific_information.html>`__.
Install QDL
^^^^^^^^^^^^^^

.. container:: nohighlight

::

mkdir <provision_download_path>
cd <provision_download_path>
wget <provision_download_link>
# Example, wget https://artifacts.codelinaro.org/artifactory/codelinaro-le/Qualcomm_Linux/QCS6490/provision.zip
unzip <downloaded_zip_file>
# Example, unzip provision.zip

#. Download the Qualcomm Device Loader (QDL). QDL is a software tool that communicates with the Qualcomm USB devices to upload a flash loader and flash software images. Acquire the latest version of the QDL tool using one of the following methods:
1. Download the Qualcomm Device Loader (QDL). QDL is a software tool that communicates with the Qualcomm USB devices to upload a flash loader and flash software images. Acquire the latest version of the QDL tool using one of the following methods:

- Download the tool from https://softwarecenter.qualcomm.com/#/catalog/item/Qualcomm_Device_Loader.
- Download the latest QDL using CLI based on the required operating system and architecture type:
Expand All @@ -359,10 +338,6 @@ UFS is provisioned by default. If there are any changes in LUNs, UFS must be re-
wget https://softwarecenter.qualcomm.com/api/download/software/tools/Qualcomm_Device_Loader/Linux/Debian/latest.zip
# Linux ARM64
wget https://softwarecenter.qualcomm.com/api/download/software/tools/Qualcomm_Device_Loader/Linux/ARM64/Debian/latest.zip
# Windows X64
wget https://softwarecenter.qualcomm.com/api/download/software/tools/Qualcomm_Device_Loader/Windows/latest.zip
# Windows ARM64
wget https://softwarecenter.qualcomm.com/api/download/software/tools/Qualcomm_Device_Loader/Windows/ARM64/latest.zip
# macOS X64
wget https://softwarecenter.qualcomm.com/api/download/software/tools/Qualcomm_Device_Loader/macOS/latest.zip
# macOS ARM64
Expand All @@ -384,6 +359,29 @@ UFS is provisioned by default. If there are any changes in LUNs, UFS must be re-

chmod -R 777 <qdl_download_path>

.. _provision_ufs:

Provision UFS
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Universal flash storage (UFS) provisioning helps to divide the storage into many LUNs, which stores different types of data separately. This improves access efficiency and system organization.

UFS is provisioned by default. If there are any changes in LUNs, UFS must be re-provisioned. To download the provision XML file and to check the applicability of UFS provisioning for different SoCs, see the table *UFS Provision* in `Release Specific Information <https://docs.qualcomm.com/doc/80-80020-300/topic/release_specific_information.html>`__.

1. Download the provision file.

Based on the required SoC, download the respective ‘provision’ from the *UFS Provision* table of the `Release Notes <https://docs.qualcomm.com/doc/80-80020-300/topic/release_specific_information.html>`__.

.. container:: nohighlight

::

mkdir <provision_download_path>
cd <provision_download_path>
wget <provision_download_link>
# Example, wget https://artifacts.codelinaro.org/artifactory/codelinaro-le/Qualcomm_Linux/QCS6490/provision.zip
unzip <downloaded_zip_file>
# Example, unzip provision.zip

#. Provision UFS:

.. container:: nohighlight
Expand All @@ -400,44 +398,6 @@ Flash SAIL
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Safety Island (SAIL) is applicable only for the Qualcomm Dragonwing™ IQ-9075 and the Qualcomm Dragonwing™ IQ-8275 development kits. If you're not using one of these development kits, skip to :ref:`Flash CDT <flash_cdt>`.

1. Download the QDL tool. QDL is a software tool that communicates with the Qualcomm USB devices to upload a flash loader and flash software images. Acquire the latest version of the QDL tool using one of the following methods:

- Download the tool from https://softwarecenter.qualcomm.com/#/catalog/item/Qualcomm_Device_Loader.
- Download the latest QDL using CLI based on the required operating system and architecture type:

.. container:: nohighlight

::

# Linux X64
wget https://softwarecenter.qualcomm.com/api/download/software/tools/Qualcomm_Device_Loader/Linux/Debian/latest.zip
# Linux ARM64
wget https://softwarecenter.qualcomm.com/api/download/software/tools/Qualcomm_Device_Loader/Linux/ARM64/Debian/latest.zip
# Windows X64
wget https://softwarecenter.qualcomm.com/api/download/software/tools/Qualcomm_Device_Loader/Windows/latest.zip
# Windows ARM64
wget https://softwarecenter.qualcomm.com/api/download/software/tools/Qualcomm_Device_Loader/Windows/ARM64/latest.zip
# macOS X64
wget https://softwarecenter.qualcomm.com/api/download/software/tools/Qualcomm_Device_Loader/macOS/latest.zip
# macOS ARM64
wget https://softwarecenter.qualcomm.com/api/download/software/tools/Qualcomm_Device_Loader/macOS/ARM64/latest.zip

#. Unzip QDL:

.. container:: nohighlight

::

unzip <qdl_downloaded_file>.zip

#. Run the following command to provide executable permission to QDL:

.. container:: nohighlight

::

chmod -R 777 <qdl_download_path>

#. Flash the SAIL:

.. container:: nohighlight
Expand Down Expand Up @@ -490,44 +450,6 @@ Flash software using QDL

If you need the ModemManager, you can restart it after the flashing is complete.

#. Download the QDL tool. QDL is a software tool that communicates with Qualcomm USB devices to upload a flash loader and flash software images. Acquire the latest version of the QDL tool using one of the following methods:

- Download the tool from https://softwarecenter.qualcomm.com/#/catalog/item/Qualcomm_Device_Loader.
- Download the latest QDL using CLI based on the required operating system and architecture type:

.. container:: nohighlight

::

# Linux X64
wget https://softwarecenter.qualcomm.com/api/download/software/tools/Qualcomm_Device_Loader/Linux/Debian/latest.zip
# Linux ARM64
wget https://softwarecenter.qualcomm.com/api/download/software/tools/Qualcomm_Device_Loader/Linux/ARM64/Debian/latest.zip
# Windows X64
wget https://softwarecenter.qualcomm.com/api/download/software/tools/Qualcomm_Device_Loader/Windows/latest.zip
# Windows ARM64
wget https://softwarecenter.qualcomm.com/api/download/software/tools/Qualcomm_Device_Loader/Windows/ARM64/latest.zip
# macOS X64
wget https://softwarecenter.qualcomm.com/api/download/software/tools/Qualcomm_Device_Loader/macOS/latest.zip
# macOS ARM64
wget https://softwarecenter.qualcomm.com/api/download/software/tools/Qualcomm_Device_Loader/macOS/ARM64/latest.zip

#. Unzip QDL:

.. container:: nohighlight

::

unzip <qdl_downloaded_file>.zip

#. Provide executable permission to QDL:

.. container:: nohighlight

::

chmod -R 777 <qdl_download_path>

#. Flash the images:

.. container:: nohighlight
Expand Down
Loading