Repository navigation
Releases
Releases · qualcomm/qdl
v2.9.1
Windows-only fix release with no changes to qdl itself: the v2.9 Windows
binaries report v2.9-dirty in qdl --version although they are clean builds
of the tag. The Linux and macOS binaries are unchanged from v2.9.
What's Changed
- github: set autocrlf before meson setup on Windows by Igor Opaniuk (@igoropaniuk) in #350,
backported in #356
Full Changelog: v2.9...v2.9.1
v2.9
Highlights
- Standalone
qdl resetsubcommand: kicks a board out of EDL or crash mode over Sahara without uploading a programmer, falling back to a
Firehose power reset when one is already running (#307) qdl ksno longer needs a device node: it uses the standard usb/qud backends, so kickstart works over libusb and on Windows and can
replace QSaharaServer on flashless boards (#300)- New
create-sahara-archivesubcommand to build a Sahara programmer archive from acontents.xmlor a list of images
(#303) - UFS provisioning fixes: the commit step gets a longer timeout and a device that resets right after committing the configuration descriptor
is reported as success (#314, #322) - NAND program tags carry the partition label, so programmers that resolve partitions by name apply the bad-block adjusted offset
(#306) - Sahara end-of-image and done status codes are decoded into human-readable descriptions (#336)
- Millisecond timestamps on
--debugdiagnostics to spot stalls and correlate host and device activity (#321) - Second hardening batch across parsers, backends and the build (#302)
- USB backend fixes: zero-length packet reads are deferred to the next real transfer, so Firehose no longer stalls on xHCI controllers
that complete the speculative read early (ASMedia ASM2142/3142);--serialfalls back toiSerialNumberwheniProductcarries
no serial, retries transient string descriptor reads right after enumeration and matches case-insensitively
(#346, #348) - Readable output:
--color[=auto|always|never],ERR:/WARN:prefixes, uppercase subsystem tags, result lines with size and rate,
a single run summary line and-q/--quietfor CI and production lines (#341) - Linux udev rules are installed with qdl, granting local users access to EDL and crashdump devices without running as root
(#342) - Leaner builds: zip container support is a meson feature option (
-Dzip-container=disabled) and the meson floor is lowered to 0.56 so qdl
can be packaged for EL9 (#299, #333) - Document official packages: qdl is in Debian, Ubuntu, Fedora and EPEL, and an official Homebrew formula
is available in homebrew-core (brew install qdl) (#338) - The HIL suite runs unattended on self-hosted Linux and macOS runners with real boards, including VIP end to end
(#296, #340) - Documentation refreshed and split into per-topic guides under
docs/(#329,
#317)
What's Changed
- qdl: let kickstart use the standard device backends by Igor Opaniuk (@igoropaniuk) in #300
- meson: make zip container support optional by Igor Opaniuk (@igoropaniuk) in #299
- For linux msm/create sahara archive by quic-bjorande in #303
- qdl: add a standalone reset subcommand by Igor Opaniuk (@igoropaniuk) in #307
- Harden error paths across parsers, backends and the build by Igor Opaniuk (@igoropaniuk) in #302
- Run the HIL suite unattended on self-hosted runners by Igor Opaniuk (@igoropaniuk) in #296
- firehose: deduplicate the chunk-streaming loop by Igor Opaniuk (@igoropaniuk) in #308
- ufs: replace module globals with a caller-owned context by Igor Opaniuk (@igoropaniuk) in #309
- firehose: send the partition label in NAND program tags by franciscojsfc in #306
- README: document installer package creation by quic-bjorande in #317
- commitlint: recognize Closes as a footer trailer by Igor Opaniuk (@igoropaniuk) in #319
- firehose: give the UFS provisioning commit a longer timeout by Igor Opaniuk (@igoropaniuk) in #314
- qdl: decouple helper modules from the CLI front-end by Igor Opaniuk (@igoropaniuk) in #313
- Add missing stdint.h include by Ali Erdinc Koroglu (@aekoroglu) in #324
- github: build on ubuntu 26.04 runners by Igor Opaniuk (@igoropaniuk) in #327
- github: drop macos-14 and build on macos-15 and macos-26 runners by Igor Opaniuk (@igoropaniuk) in #328
- README: refresh and split into docs/ by Igor Opaniuk (@igoropaniuk) in #329
- ux: add consistent timestamps to debug diagnostics by Igor Opaniuk (@igoropaniuk) in #321
- meson: lower the required meson version to 0.56 by Igor Opaniuk (@igoropaniuk) in #333
- firehose: treat -ENODEV on commit=1 as success after UFS provisioning by JohnSagaQuic in #322
- qdl: split the flashing front-end from the CLI plumbing by Igor Opaniuk (@igoropaniuk) in #323
- sahara: describe status codes in end-of-image and done packets by bveera (@bhavyaVeera) in #336
- github: prepare CI for the move to the Qualcomm GitHub organization by Igor Opaniuk (@igoropaniuk) in #335
- README: document distribution packages and Homebrew by Igor Opaniuk (@igoropaniuk) in #338
- github: run the HIL suite on the macOS runner by Igor Opaniuk (@igoropaniuk) in #340
- ux: colored output, level and subsystem prefixes, run summary and --quiet by Igor Opaniuk (@igoropaniuk) in #341
- udev: install rules for EDL device access by Loïc Minier (@lool) in #342
- usb: defer ZLP reads to real transfers by agumarcolin in #346
- usb: fall back to iSerialNumber and retry transient string reads by Igor Opaniuk (@igoropaniuk) in #348
New Contributors
- franciscojsfc made their first contribution in #306
- Ali Erdinc Koroglu (@aekoroglu) made their first contribution in #324
- JohnSagaQuic made their first contribution in #322
- bveera (@bhavyaVeera) made their first contribution in #336
- Loïc Minier (@lool) made their first contribution in #342
- agumarcolin made their first contribution in #346
Testing credits
Thanks to everyone who helped test v2.9-rc1 in #345:
- Igor Opaniuk (@igoropaniuk) tested on RB3Gen2 (secure) and Uno Q across Linux and Windows
- JohnSagaQuic tested on Kaanapali, RB3, Hawi and NordAU (SA8797P)
Full Changelog: v2.8...v2.9
v2.8
Highlights
- One
qdlbinary: the separateqdl-ksandqdl-ramdumptools are folded in as subcommands (#250) - New
chipinfoandresetverbs for reading chip identity and resetting the device without flashing (#280,
#281) - nbdkit plugin exposing a device LUN as a block device (#283)
- Faster, leaner skipblock flashing: short/offset files can be skipped, digest memory is bounded, progress is reported
(#256, #264, #265) - Hardening sweep across firehose, sahara, GPT and program parsing of device-controlled data (#284,
#270) - Improved crash-mode/ramdump device detection (#274, #286)
- EDL devices are identified by their vendor-specific interface signature instead of a product-id allowlist, so the libusb and Windows QUD backends
now share one notion of an EDL device (#287, #289)
Breaking changes
qdl-ksandqdl-ramdumpno longer exist as standalone binaries; scripts
and packaging must switch toqdl ks .../ the ramdump verb
(#250)- Mixing input XML files with command verbs on one invocation is now
rejected instead of silently accepted
(#282)
What's Changed
- firehose: zero-pad local digest so short/offset files can be skipped by Igor Opaniuk (@igoropaniuk) in #256
- meson: don't require git when overriding the version by Christopher Obbard (@obbardc) in #257
- firehose: report progress through the skipblock fast-path by Igor Opaniuk (@igoropaniuk) in #264
- [RFC] github: request reviews from qdl-maintainers via CODEOWNERS by Igor Opaniuk (@igoropaniuk) in #266
- tree: move sources under src/ and consolidate on a single qdl binary by Igor Opaniuk (@igoropaniuk) in #250
- README: describe how to use QDL from WSL2 on Windows by Bartosz Gołaszewski (@brgl) in #267
- README: mark WSL2 support as unreliable by Bartosz Gołaszewski (@brgl) in #273
- src/firehose: fix type error in flash log by Shoudi Li (@shoudil) in #275
- tests: fix test_contents_selectors link failure at -O0 by Igor Opaniuk (@igoropaniuk) in #272
- tests: add a hardware-in-the-loop (HIL) test suite by Igor Opaniuk (@igoropaniuk) in #271
- ramdump: create the output directory if it does not exist by Igor Opaniuk (@igoropaniuk) in #269
- README: use consistent dash bullets for unordered lists by Igor Opaniuk (@igoropaniuk) in #276
- firehose: tolerate zero-length packets while reading sector data by Igor Opaniuk (@igoropaniuk) in #270
- For linux msm/flashmap multi layout by quic-bjorande in #263
- firehose: chunk skipblock digest into bounded sub-regions by Igor Opaniuk (@igoropaniuk) in #265
- github: package self-contained binaries on Linux and macOS by Igor Opaniuk (@igoropaniuk) in #277
- doc: restructure and enrich the README by Igor Opaniuk (@igoropaniuk) in #268
- doc: add RELEASING.md describing the release process by Igor Opaniuk (@igoropaniuk) in #278
- [RFC] doc: add AGENTS.md guide for automation agents by Igor Opaniuk (@igoropaniuk) in #279
- usb: recognize 0x90db as an EDL ramdump product ID by Walter H. YANG (@yangh) in #274
- qdl: Add reset verb for device reset by edsj-sony in #281
- sahara: add chipinfo command to read chip identity by Igor Opaniuk (@igoropaniuk) in #280
- [RFC] usb: decouple open/list paths and share EDL device identity across backends by Igor Opaniuk (@igoropaniuk) in #287
- tests: extend HIL test suite by Igor Opaniuk (@igoropaniuk) in #285
- Fix critical correctness issues (silent failures, crashes, OOB accesses) by Igor Opaniuk (@igoropaniuk) in #284
- [RFC] qdl: reject mixing input XML files with command verbs by Igor Opaniuk (@igoropaniuk) in #282
- Enhance crash mode device detection by ykaire-qti in #286
- nbdkit: expose a device LUN as a block device by Igor Opaniuk (@igoropaniuk) in #283
- vip: open signed tables in binary mode on Windows by Igor Opaniuk (@igoropaniuk) in #288
- Lint all markdown files and extend the release documentation by Igor Opaniuk (@igoropaniuk) in #292
- Address oscompat warnings on Windows by Igor Opaniuk (@igoropaniuk) in #291
- qdl: drop the EDL product id allowlist and match the EDL interface signature when enumerating by Igor Opaniuk (@igoropaniuk) in #289
- firehose: do not probe sector size when storage init is skipped by Igor Opaniuk (@igoropaniuk) in #297
New Contributors
- Bartosz Gołaszewski (@brgl) made their first contribution in #267
- Shoudi Li (@shoudil) made their first contribution in #275
- Walter H. YANG (@yangh) made their first contribution in #274
- edsj-sony made their first contribution in #281
Testing credits
Thanks to everyone who helped test v2.8-rc1 in #293:
- Igor Opaniuk (@igoropaniuk) tested on RB3Gen2 (open and secure), Uno Q and Radxa Q8B (SC8280XP) across Linux, Windows and macOS
- Eric0039 tested on IQ-9075
- Christopher Obbard (@obbardc) tested on RB3Gen2 (Debian Unstable amd64)
- shawngsc tested on IQ10 RRD (Windows)
- Pankaj (@pankaj-qcom) tested on Glymur CRD (Ubuntu 24.04.4 LTS)
- Ananthu C V (@WeepingClown13) tested on Hamoa CRD (Ubuntu 24.04.4 LTS)
- Shoudi Li (@shoudil) tested on Hamoa/Purwa IoT EVK (Ubuntu 24.04.4 LTS)
Full Changelog: v2.7...v2.8
v2.7.1
What's Changed
- usb: Accept 0x9060 as USB PID for ramdump by quic-bjorande in #290
Full Changelog: v2.7...v2.7.1
v2.7
What's Changed
- [RFC] meson: replace GNU Make-based build system with Meson by Igor Opaniuk (@igoropaniuk) in #150
- tests: replace monolithic test wrapper with per-suite Meson tests by Igor Opaniuk (@igoropaniuk) in #208
- meson: rename ks to qdl-ks by Christopher Obbard (@obbardc) in #211
- Update ks/ramdump description by Igor Opaniuk (@igoropaniuk) in #212
- sahara: increase MAPPING_SZ to 128 by Mukesh Ojha (@mukeshojha-linux) in #215
- For linux msm/flashmap support by Bjorn Andersson (@andersson) in #210
- Unify markdown-lint and checkpatch checks by Igor Opaniuk (@igoropaniuk) in #222
- tests: stop fixture generation from timing out CI on slow runners by Igor Opaniuk (@igoropaniuk) in #230
- tests: give each integration test its own fixture directory by Igor Opaniuk (@igoropaniuk) in #231
- commitlint: Recognize kernel-style trailers as footer items by Igor Opaniuk (@igoropaniuk) in #229
- [RFC] ux: Route libxml2 parser diagnostics through ux_err() by Igor Opaniuk (@igoropaniuk) in #227
- usb: Allow devices with no serial number to show in the usb list by Nick Hunn (@Zephyrus29) in #213
- qdl: fix list/ramdump subcommands ignored when flags precede them by Mukesh Ojha (@mukeshojha-linux) in #217
- meson: avoid duplicate library entries on executable link lines by Igor Opaniuk (@igoropaniuk) in #228
- For linux msm/program search relative xml by quic-bjorande in #223
- Add --skip-reset and auto-skip Sahara when programmer is already running by Igor Opaniuk (@igoropaniuk) in #232
- qdl: Drop alloca definition by quic-bjorande in #236
- For linux msm/contents xml flashing by quic-bjorande in #225
- qdl: add QUD backend so on Windows flashing via the official QDLoader 9008 driver works by Igor Opaniuk (@igoropaniuk) in #233
- [RFC] qdl: add sha256 subcommand by Igor Opaniuk (@igoropaniuk) in #239
- github: Include missing build artifacts in Windows build by quic-bjorande in #240
- qdl: add --skipblock=sha256 to skip programs already on flash by Igor Opaniuk (@igoropaniuk) in #242
- For linux msm/erase all by quic-bjorande in #244
- contents: Look for OS-specific path tag by quic-bjorande in #245
- sahara: Deal with QUD discarding the HELLO request by quic-bjorande in #246
- firehose: detect VIP mode mismatch from programmer startup logs by Igor Opaniuk (@igoropaniuk) in #252
- program: Cast away const when freeing start_sector in erase by Igor Opaniuk (@igoropaniuk) in #253
- tree: drop unused .gitreview by Igor Opaniuk (@igoropaniuk) in #251
- sahara: auto-assemble minidump ELF after ramdump download by Mukesh Ojha (@mukeshojha-linux) in #243
New Contributors
- Mukesh Ojha (@mukeshojha-linux) made their first contribution in #215
- Nick Hunn (@Zephyrus29) made their first contribution in #213
Full Changelog: v2.6...v2.7
v2.6
What's Changed
- Documentation improvements by Igor Opaniuk (@igoropaniuk) in #194
- Address VIP mode regressions by Igor Opaniuk (@igoropaniuk) in #189
- A collection of bug fixes and a small refactor across vip/usb/firehose by Igor Opaniuk (@igoropaniuk) in #195
- usb: reinitialise libusb on each poll iteration in usb_open by Igor Opaniuk (@igoropaniuk) in #199
- A second batch of bug fixes and code quality improvements by Igor Opaniuk (@igoropaniuk) in #196
- qdl: fix absolute image_path handling in sahara_config by Oleksandr Suvorov (@MrCry0) in #198
- program: Add erase command by Jacob Creedon (@jcreedon) in #190
- [RFC] ci: enforce commit message formatting in PRs by Igor Opaniuk (@igoropaniuk) in #203
- Add qdl-ramdump usage documentation and fix segment filter matching by Igor Opaniuk (@igoropaniuk) in #202
- sahara, usb: improve robustness and user feedback by Igor Opaniuk (@igoropaniuk) in #204
- [RFC] sim: implement proper Firehose protocol state machine by Igor Opaniuk (@igoropaniuk) in #192
- [RFC] sim: validate VIP digest tables and chunk hashes in dry-run mode by Igor Opaniuk (@igoropaniuk) in #205
New Contributors
- Oleksandr Suvorov (@MrCry0) made their first contribution in #198
Full Changelog: v2.5...v2.6
v2.5
What's Changed
- makefile: Allow cross-building by Christopher Obbard (@obbardc) in #174
- qdl: Allow absolute paths in Windows again by Bjorn Andersson (@andersson) in #179
- sahara: Unbreak ramdump by making images optional again by Bjorn Andersson (@andersson) in #180
- firehose: Increase reset delay after flashing by ykaire-qti in #175
- firehose: Increase timeout for read of program-ack by Bjorn Andersson (@andersson) in #182
- usb: add --list flag for list devices by Luca Rinaldi (@lucarin91) in #176
- For linux msm/drop single image hack by Bjorn Andersson (@andersson) in #181
- For linux msm/ramdump subcmd by Bjorn Andersson (@andersson) in #183
- qdl: Propagate the success of decode_sahara_config() by Bjorn Andersson (@andersson) in #185
- firehose: ensure we properly set skip_storage_init in provision by Casey Connolly (@kcxt) in #186
- Address memory leaks/mitigate buffer overflows by Igor Opaniuk (@igoropaniuk) in #161
New Contributors
- Luca Rinaldi (@lucarin91) made their first contribution in #176
- Casey Connolly (@kcxt) made their first contribution in #186
Full Changelog: v2.4...v2.5
v2.4
What's Changed
- For linux msm/read write gpt by Bjorn Andersson (@andersson) in #130
- For linux msm/missing files early and list h by Bjorn Andersson (@andersson) in #128
- checkpatch: Skip list.h by quic-bjorande in #138
- firehose: Provide progress bar on read as well by quic-bjorande in #142
- For linux msm/db410c timeout and improvements by quic-bjorande in #139
- sahara: Print an error when device isn't reachable by quic-bjorande in #140
- patch: Don't spam the log when no patch file was loaded by quic-bjorande in #141
- gpt: gpt_load_table_from_partition: fix off-by-one error for num_sectors by Michael Scott (@mike-scott) in #143
- Add build instructions for MacPorts by Amit Kucheria (@idlethread) in #144
- usb: increase bulk transfer timeout for firehose raw write by Loic Poulain (@loicpoulain) in #145
- Misc fixes by Igor Opaniuk (@igoropaniuk) in #147
- For linux msm/spinor by Bjorn Andersson (@andersson) in #146
- github: Bump macos runner versions by Bjorn Andersson (@andersson) in #151
- Add -h/--help support to ks and ramdump by Roger Shimizu (@rogers0) in #136
- github: Two improvements for --version on CI build by Luca Weiss (@z3ntu) in #152
- Suppress unused var warnings by Igor Opaniuk (@igoropaniuk) in #153
- Move __unused macro after variable definitions by Igor Opaniuk (@igoropaniuk) in #155
- Add manpages generated by help2man by Roger Shimizu (@rogers0) in #137
- For linux msm/multi programmer by quic-bjorande in #154
- README/CI updates/improvements by Igor Opaniuk (@igoropaniuk) in #157
- [housekeeping] Integer-related compiler warnings by Igor Opaniuk (@igoropaniuk) in #159
- Address more -Wsign-compare issues by Igor Opaniuk (@igoropaniuk) in #160
- firehose: Add slot flag by Jacob Creedon (@jcreedon) in #158
- Check for empty patch filenames. by ykaire-qti in #156
- firehose/usb: Explicitly handle ZLP on USB read transfers by Loic Poulain (@loicpoulain) in #162
- github: Resolve liblzma-related failure in Windows builds by Bjorn Andersson (@andersson) in #165
- firehose: Increase image write timeout to 60 seconds by Bjorn Andersson (@andersson) in #166
- usb: Fix checkpatch warning about unnecessary parenthesis by Bjorn Andersson (@andersson) in #167
- vip: Fix integer underflow in digest count by Jerry Zhang (@jerry-skydio) in #172
New Contributors
- Michael Scott (@mike-scott) made their first contribution in #143
- Amit Kucheria (@idlethread) made their first contribution in #144
- Loic Poulain (@loicpoulain) made their first contribution in #145
- Roger Shimizu (@rogers0) made their first contribution in #136
- Jacob Creedon (@jcreedon) made their first contribution in #158
- ykaire-qti made their first contribution in #156
- Jerry Zhang (@jerry-skydio) made their first contribution in #172
Full Changelog: v2.2...v2.4