Add Qualcomm IQ9075 recovery support and improve sparse image handling by BakyarajM · Pull Request #94 · bootlin/snagboot

BakyarajM · 2026-07-10T13:08:37Z

snagrecover: qcom: Add IQ9075 support

Add support for Qualcomm IQ9075 devices in snagrecover.

Implement Qualcomm Sahara protocol support to communicate with
Qualcomm devices in EDL mode and perform device recovery.

Reference:
https://github.com/torvalds/linux/blob/master/drivers/accel

_Note:
The U-Boot changes required to support snagrecover are currently
under review. Therefore, the U-Boot image preparation section in
docs/snagrecover.md is marked as TBD.

The documentation will be updated and the TBD item resolved before
the final upstream submission._

snagflash: Improve sparse file handling

Handle sparse chunks larger than max-download-size and preserve
DONT_CARE prefix and suffix regions when splitting sparse images.

Ignore CRC32 chunks from the source sparse image during splitting,
as the original CRC32 is no longer valid once the image is split or
modified.

Fix fastboot flash argument parsing for UFS flash type by splitting
only on the first ':' character, preserving target identifiers in
the format : while maintaining compatibility with
other flash types.

Replace the existing split() implementation with the streaming-based
split_streaming() generator to enable more memory-efficient
processing of large sparse images.

_Future enhancements:

Generate and append a new CRC32 chunk for each split sparse image
based on its modified content.
Convert raw images to sparse format and flash them as multiple
sparse images when the image size exceeds the target's
max-download-size limit._

Reference:
https://android.googlesource.com/platform/system/core/+/refs/heads/main/libsparse/

Signed-off-by: Bakyaraj Moorthy bmoorthy@qti.qualcomm.com

Add support for Qualcomm IQ9075 in snagrecover. Implement Qualcomm Sahara protocol support to communicate with Qualcomm devices in EDL mode and perform device recovery. Reference: https://github.com/torvalds/linux/blob/master/drivers/accel/qaic/sahara.c Signed-off-by: Bakyaraj Moorthy <bmoorthy@qti.qualcomm.com>

Handle sparse chunks larger than max-download-size and preserve DONT_CARE prefix and suffix regions when splitting sparse images. Ignore CRC32 chunks from the source sparse image during splitting, as the original CRC32 is no longer valid once the image is split or modified. Fix fastboot flash argument parsing for UFS flash type by splitting only on the first ':' character, preserving target identifiers in the format <lun>:<partition> while maintaining compatibility with other flash types. Replace the existing split() implementation with the streaming-based split_streaming() generator to enable more memory-efficient processing of large sparse images. Future enhancements: - Generate and append a new CRC32 chunk for each split sparse image based on its modified content. - Convert raw images to sparse format and flash them as multiple sparse images when the image size exceeds the target's max-download-size limit. Reference: https://android.googlesource.com/platform/system/core/+/refs/heads/main/libsparse/ Signed-off-by: Bakyaraj Moorthy <bmoorthy@qti.qualcomm.com>

rgantois

Hi, thanks a lot for the contribution! I've requested a few modifications. For the changes in snagflash/android_sparse_file/utils.py, I'll do a more in depth review once you've implemented the formatting changes I've requested. For all other files, no further review should be required once the current requested changes are implemented.

rgantois · 2026-07-16T08:08:42Z


+### Qualcomm
+
+#### IQ9075


Since there is only one Qualcomm SoC family supported for now, you can save a title level and just do ### Qualcomm IQ9075

rgantois · 2026-07-16T08:10:37Z

+#### IQ9075
+
+To set up the board in recovery mode, refer to the section *"Force the device
+into Emergency Download mode"* in the reference [documentation](https://docs.qualcomm.com/doc/80-70023-261/topic/iq9-ug-update-the-sw.html#panel-0-VWJ1bnR1tab$force-the-device-into-emergency-download-mode)


Snagrecover is supposed to be SoC agnostic; of course it's completely fine to add a board-specific example, but you should specify that it's board-specific (in this case for the EVK).

rgantois · 2026-07-16T08:13:49Z

+
+### For Qualcomm devices
+
+#### IQ9075


Ditto, you can have a single title level here.

rgantois · 2026-07-16T08:16:27Z

+
+**xbl:** XBL is a Qualcomm proprietary image, which can be downloaded using the following steps:
+
+1. Download the [ZIP](https://softwarecenter.qualcomm.com/nexus/generic/product/chip/tech-package/QCS9100_bootbinaries.1.0/qcs9100_bootbinaries.1.0-test-device-public/00133/QCS9100_bootbinaries.zip) file


Is this binary identical for all boards using this SoC? If not, please specify that this binary only works with board xyz and provide a generic description of how to get the binary for other boards such as "request the binary from your board vendor".

rgantois · 2026-07-16T08:17:22Z

+configuration:
+  * path
+
+**u-boot:** TBD: U-Boot support for Snagboot recovery is currently under upstream review


Fine by me, but maybe provide a link to the patch series in question so that people can test it if they want to?

rgantois · 2026-07-16T09:09:31Z

 		if maxsize == 0:
 			raise FastbootError("Fastboot variable max-download-size is 0")
-		arg_list = args.split(":")
+		arg_list = args.split(":",1)


nit: space between function arguments.

rgantois · 2026-07-16T09:19:46Z

+
+				for split_file in split_streaming(fname, temppath, maxsize):
+					split_count += 1
+					logger.info(f"Processing split {split_count}: Downloading {split_file}")


It would be nice to also have the total number of slices for each log.

rgantois · 2026-07-16T09:25:34Z

 # SPDX-License-Identifier: GPL-2.0+
 #
 # Author: Arnaud Patard <arnaud.patard@collabora.com>
+#


Please add a Modified-by: line, similarly to what we did in other files in the codebase. This helps represent the timeline of modifications more accurately.

rgantois · 2026-07-16T09:34:06Z

+	# Reserve space for the trailing DONT_CARE suffix chunk header
+	_SUFFIX_RESERVE = SPARSE_CHUNKHEADER_LEN
+
+	def ensure_prefix_skip():


Please don't use inline function definitions, it adds unnecessary indentation levels and makes things harder to read IMO.

rgantois · 2026-07-16T09:35:22Z

+
+		return dest
+
+	try:


Please factor this part into multiple functions, currently it's quite hard to review.

BakyarajM added 2 commits July 10, 2026 17:01

rgantois requested changes Jul 16, 2026

View reviewed changes

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Add Qualcomm IQ9075 recovery support and improve sparse image handling#94

Add Qualcomm IQ9075 recovery support and improve sparse image handling#94
BakyarajM wants to merge 2 commits into
bootlin:mainfrom
BakyarajM:qcom-iq9075-upstream

BakyarajM commented Jul 10, 2026

Uh oh!

rgantois left a comment

Uh oh!

rgantois Jul 16, 2026

Uh oh!

rgantois Jul 16, 2026

Uh oh!

rgantois Jul 16, 2026

Uh oh!

rgantois Jul 16, 2026

Uh oh!

rgantois Jul 16, 2026

Uh oh!

rgantois Jul 16, 2026

Uh oh!

rgantois Jul 16, 2026

Uh oh!

rgantois Jul 16, 2026

Uh oh!

rgantois Jul 16, 2026

Uh oh!

rgantois Jul 16, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants


		xbl: XBL is a Qualcomm proprietary image, which can be downloaded using the following steps:

		1. Download the [ZIP](https://softwarecenter.qualcomm.com/nexus/generic/product/chip/tech-package/QCS9100_bootbinaries.1.0/qcs9100_bootbinaries.1.0-test-device-public/00133/QCS9100_bootbinaries.zip) file


		### Qualcomm

		#### IQ9075

Uh oh!

Conversation

BakyarajM commented Jul 10, 2026

Uh oh!

rgantois left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants