qcom-tool

qcom-ptool contains various device partitioning utilities like ptool.py, gen_partitions.py and various sample partition configuration files needed for Qualcomm SoCs. Qualcomm Linux currently supports two reference Linux based OSes (Yocto with meta-qcom and Debian with qcom-deb-images) which uses this tool to generate partition table layouts. The partition GUIDs, names and size budgets are picked to support boot flows as follows:

• (preferred) "edk2/UEFI": PBL => XBL => edk2/UEFI => high-level OS (Linux)
• (legacy) "U-Boot/UEFI": PBL => XBL => ABL => U-Boot/UEFI => high-level OS (Linux)

Development

Dependencies

The scripts use only the Python standard library (Python 3.8+), so no runtime dependencies need to be installed.

For development, make lint invokes ruff and mypy directly from the command line. On Debian/Ubuntu, install them as follows (ruff is not packaged in apt on all releases/architectures, so we install it from snap):

sudo snap install ruff
sudo apt install mypy

Makefile targets

Target	Description
all	Generate partition XML and GPT binaries for all platforms
lint	Run ruff (linter) and mypy (type checker) on all scripts
integration	Build all platforms and verify generated files are present
check	Run both lint and integration
install	Install scripts to $(DESTDIR)$(PREFIX)/bin
clean	Remove generated XML and binary files from platforms/

Quick start

# install linters (Debian/Ubuntu)
sudo snap install ruff
sudo apt install mypy

# run linters
make lint

# build all platforms and run tests
make check

Code contributions

See CONTRIBUTING.md file for instructions on how to send code contributions to this project. You can also report an issue on GitHub.

Maintainer(s)

See CODEOWNERS.

License

This project is licensed under the BSD-3-clause License. See LICENSE for the full license text.