11 breaking releases

new 0.24.0 May 22, 2024
0.23.0 Feb 24, 2024
0.22.0 Jan 3, 2024
0.21.1 Oct 12, 2023
0.12.0 Nov 24, 2021

#39 in Embedded development

Download history 5/week @ 2024-02-16 151/week @ 2024-02-23 17/week @ 2024-03-01 7/week @ 2024-03-08 3/week @ 2024-03-15 12/week @ 2024-03-29 117/week @ 2024-04-05 11/week @ 2024-04-12 89/week @ 2024-05-17

89 downloads per month

MIT/Apache

5MB
52K SLoC

Contains (Zip file, 2.5MB) NordicSemiconductor.nRF_DeviceFamilyPack.8.32.1.pack

target-gen

target-gen is a helper tool for probe-rs, which can be used to extract flash algorithms and target descriptions for chips from ARM CMSIS-Packs. This will then allow you to flash the chip using probe-rs.

Usage with CMSIS-Pack

As a first step, you need to get an appropriate CMSIS-Pack for the chip you want to flash. By default, probe-rs will look for CMSIS-Packs at the following ARM website: https://developer.arm.com/tools-and-software/embedded/cmsis/cmsis-search.

To download and generate pack files, use the arm subcommand:

cargo run --release -- arm [OPTIONS] <OUTPUT>

Arguments: An output directory where all the generated .yaml files are put in.

Options:
-l, --list                  Optionally, list the names of all pack files available in <https://www.keil.com/pack/Keil.pidx>
-f, --filter <PACK_FILTER>  Optionally, filter the pack files that start with the specified name,
                            e.g. `STM32H7xx` or `LPC55S69_DFP`.
                            See `target-gen arm --list` for a list of available Pack files

If you already have a pack file, you use the pack submcommand:

cargo run --release -- pack [OPTIONS] <OUTPUT>

Arguments:
<INPUT>   A Pack file or the unziped Pack directory.
<OUTPUT>  An output directory where all the generated .yaml files are put in.

This wil generate YAML files containing the target descriptions, which can be used with probe-rs.

Usage with ELF files

The target-gen tool can also be used to create a target description based on an ELF file. This requires that the ELF file adhers to the ARM CMSIS standard for flash algorithms, which can be found at: https://arm-software.github.io/CMSIS_5/Pack/html/algorithmFunc.html

Running

cargo run --release -- elf <ELF FILE> target.yml

will create a target description containing the extracted flash algorithm. The values for the chip description itself have to be adjusted manually in the generated Yaml file.

Dependencies

~37–55MB
~824K SLoC