List Firmware Images¶
The highdra images list command is a small utility to display available firmware images: both those that are
statically bundled with the highdra CLI, and those that are downloaded from the GitHub repository.
Usage¶
As with most commands, the (most accurate1) help can be accessed with the --help flag:
> highdra images list --help
Usage: highdra images list [OPTIONS]
List firmware images.
This command can list available firmware images, both those statically
bundled with the highdra CLI, and those that are downloaded from the GitHub
repository.
[...]
┌─ Options ──────────────────────────────────────────────────────────────────┐
│ --app TEXT Application name (e.g. │
│ com.starcopter.highdra.bms_selftest). │
│ --target TEXT Hardware target name (e.g. │
│ com.starcopter.highdra.bms). │
│ --hardware TEXT Hardware target version (e.g. 4.2). │
│ --version TEXT PEP 440 version specifier (e.g. >=1.0, ==0.10.*). │
│ --pre Force include pre-release versions. │
│ --help Show this message and exit. │
└────────────────────────────────────────────────────────────────────────────┘
Without any options, it will print all available images:
> highdra images list
Software Collection (11 images)
┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━┳━━━━━━━━━┳━━━━━━━━━━┳━━━━━━━━━┳━━━━━━━━━━━┳━━━━━━━━━━━━┓
┃ Application ┃ HW ┃ Version ┃ CRC ┃ Git ┃ Size ┃ Date ┃
┡━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━╇━━━━━━━━━╇━━━━━━━━━━╇━━━━━━━━━╇━━━━━━━━━━━╇━━━━━━━━━━━━┩
│ com.starcopter.highdra.bms_selftest │ 4.2 │ v0.10.1 │ 355efc10 │ 381a008 │ 195.0 KiB │ 2025-10-01 │
│ com.starcopter.highdra.bms_selftest │ 4.2 │ v0.10.0 │ aca79d1d │ bcb7b57 │ 194.9 KiB │ 2025-09-17 │
│ com.starcopter.highdra.bms_selftest │ 4.1 │ v0.10.1 │ 7526f013 │ 381a008 │ 195.0 KiB │ 2025-10-01 │
│ com.starcopter.highdra.bms_selftest │ 4.1 │ v0.10.0 │ f1b2b742 │ bcb7b57 │ 194.9 KiB │ 2025-09-17 │
│ com.starcopter.highdra.bms │ 4.2 │ v0.10.1 │ 09eb5b97 │ 381a008 │ 175.2 KiB │ 2025-10-01 │
│ com.starcopter.highdra.bms │ 4.2 │ v0.10.0 │ f0156760 │ bcb7b57 │ 178.9 KiB │ 2025-09-17 │
│ com.starcopter.highdra.bms │ 4.1 │ v0.10.1 │ 22083672 │ 381a008 │ 175.2 KiB │ 2025-10-01 │
│ com.starcopter.highdra.bms │ 4.1 │ v0.10.0 │ 1dc0ab77 │ bcb7b57 │ 178.9 KiB │ 2025-09-17 │
│ com.starcopter.aeric.mmb │ 4.1 │ v2.1.0 │ 454a1a3e │ 7b44999 │ 46.4 KiB │ 2025-05-20 │
│ com.starcopter.aeric.gear-controller │ 2.1 │ v1.1.0 │ ebb79682 │ c26da96 │ 50.3 KiB │ 2025-09-23 │
│ com.starcopter.aeric.gear-controller │ 1.1 │ v1.1.0 │ ebb79682 │ c26da96 │ 50.3 KiB │ 2025-09-23 │
└──────────────────────────────────────┴─────┴─────────┴──────────┴─────────┴───────────┴────────────┘
11 out of 35 available images shown
The --app, --target and --hardware options can be used to filter the images for a specific application,
hardware target or version. These options do not support wildcards, glob patterns or range expressions, only exact
matches are supported.
To display only images for the com.starcopter.highdra.bms hardware platform in hardware revision 4.2 (D.2), at or above firmware version 0.10.1, including pre-release versions, you can run:
> highdra images list --target com.starcopter.highdra.bms --hardware 4.2 --version ">=0.10.1" --pre
Software Collection (14 images)
┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━┳━━━━━━━━━━━┳━━━━━━━━━━┳━━━━━━━━━┳━━━━━━━━━━━┳━━━━━━━━━━━━┓
┃ Application ┃ HW ┃ Version ┃ CRC ┃ Git ┃ Size ┃ Date ┃
┡━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━╇━━━━━━━━━━━╇━━━━━━━━━━╇━━━━━━━━━╇━━━━━━━━━━━╇━━━━━━━━━━━━┩
│ com.starcopter.highdra.bms_selftest │ 4.2 │ v0.11.0b1 │ 93cacba3 │ f23ec87 │ 196.8 KiB │ 2025-09-30 │
│ com.starcopter.highdra.bms_selftest │ 4.2 │ v0.11.0a5 │ 5ffd7767 │ f23ec87 │ 196.8 KiB │ 2025-09-26 │
│ com.starcopter.highdra.bms_selftest │ 4.2 │ v0.11.0a4 │ b42b3579 │ 8ad2b48 │ 196.8 KiB │ 2025-09-19 │
│ com.starcopter.highdra.bms_selftest │ 4.2 │ v0.11.0a3 │ 785d8383 │ 3e7428b │ 196.8 KiB │ 2025-09-19 │
│ com.starcopter.highdra.bms_selftest │ 4.2 │ v0.11.0a2 │ a77ecd97 │ 1aa3c8e │ 196.3 KiB │ 2025-09-18 │
│ com.starcopter.highdra.bms_selftest │ 4.2 │ v0.11.0a1 │ 3f02da45 │ 40d4b97 │ 196.3 KiB │ 2025-09-18 │
│ com.starcopter.highdra.bms_selftest │ 4.2 │ v0.10.1 │ 355efc10 │ 381a008 │ 195.0 KiB │ 2025-10-01 │
│ com.starcopter.highdra.bms │ 4.2 │ v0.11.0b1 │ 53ec628f │ f23ec87 │ 192.2 KiB │ 2025-09-30 │
│ com.starcopter.highdra.bms │ 4.2 │ v0.11.0a5 │ 0c66a2de │ f23ec87 │ 192.2 KiB │ 2025-09-26 │
│ com.starcopter.highdra.bms │ 4.2 │ v0.11.0a4 │ 131c7746 │ 8ad2b48 │ 192.0 KiB │ 2025-09-19 │
│ com.starcopter.highdra.bms │ 4.2 │ v0.11.0a3 │ c4f2e65c │ 3e7428b │ 192.0 KiB │ 2025-09-19 │
│ com.starcopter.highdra.bms │ 4.2 │ v0.11.0a2 │ 8fc5204c │ 1aa3c8e │ 193.0 KiB │ 2025-09-18 │
│ com.starcopter.highdra.bms │ 4.2 │ v0.11.0a1 │ bd25114c │ 40d4b97 │ 193.5 KiB │ 2025-09-18 │
│ com.starcopter.highdra.bms │ 4.2 │ v0.10.1 │ 09eb5b97 │ 381a008 │ 175.2 KiB │ 2025-10-01 │
└─────────────────────────────────────┴─────┴───────────┴──────────┴─────────┴───────────┴────────────┘
14 out of 35 available images shown
Tip
When using special characters in the version specifier, you might need to quote the argument.
The argument to the --version option is a PEP 440 version specifier, which does support range expressions.
By default, pre-release versions are excluded, unless the version specifier includes pre-release versions.
Some valid examples are:
>=0.10.1: at or above version 0.10.1==0.10.*: any 0.10.x version>=0.11.0a3: at or above version 0.11.0a3, including matching pre-release versions>=0.10.1,<0.11.0: at or above version 0.10.1, but below version 0.11.0
This default behavior can be overridden by using the --pre flag:
--version ">=0.10.1": at or above version 0.10.1, excluding all pre-release versions--version ">=0.10.1" --pre: at or above version 0.10.1, including matching pre-release versions--version ">=0.11dev": any 0.11.x version or larger, including all pre-release versions
-
This online documentation is written and managed separately from the code. Should documentation and implementation diverge, the
--helpflag output will be more accurate, as it is generated from the code. ↩