The following sections describe how to use the GangFlasher-ST from the command line. Available commands are shown in Figure 1.

Required argument:

-target_cfg <setup filepath>Path to setup file created in GUI that has the target parameters and other information. How to save config file is shown in Figure 2.(File ->Save Setup as…).

Optional Settings:

-usb_cfg <usb setup filepath> : Path to USB configuration file created in GUI that specifies a fixed USB PORT/HUB allocation. With no usb assignment file, F_USBAutoScanAndAssign() will be called to auto assign boards for programming. How to save USB configuration is shown in Figure 3. (File ->Save USB Configuration as…).

-tsv <tsv filepath>: Path to TSV file from ST that has the list of partitions to be created and file to be programmed - support olny STM32MP1.
-otp <otp filepath>: Path to OTP file. OTP programming must be turned on in the target_cfg file for this file to be used - support olny STM32MP1.
-ssp <ssp filepath>: Path to SSP (Secret Secure Provisioning) for programming of OEM secrets into STM32MP1 one time programming(OTP) area in a secure way support olny STM32MP1.
-tfa_ssp <tfa_ssp filepath>: Path to TFA-SSP first stage bootloader for programming of OEM secrets into STM32MP1 one time programming(OTP) area in a secure way - support olny STM32MP1.
-fsbl <fsbl filepath>: Path to first stage bootloader (TF-A) - support olny STM32MP1.
-ssbl <ssbl filepath>: Path to secondary stage bootloader (U-Boot) - support olny STM32MP1.
-hsm <slot id>: Read data from HSM Card.
-cmd <index> : Command to perform (default: F_Connect()).

1 : F_AutoProgram()
2 : F_Connect() - default
3 : F_Load_OS() - support olny STM32MP1
4 : F_Write()
5 : F_Verify()
6 : F_Read()
7 : F_OTP_Write()
8 : F_OTP_Verify()
9 : F_OTP_Read()
10 : F_TrustedWrite() - support olny STM32MP1
11 : F_Read_HSM(slot_id)
12 : F_Erase_All -not supported for STM32MP1
13 : F_ClearProtRegs -not supported for STM32MP1

-of <filename> : send output to file with path <filename>.

Example usage:

Test connection:

GangFlasher-CLI.exe -target_cfg setup_file.cfg

or GangFlasher-CLI.exe -target_cfg setup_file.cfg -cmd 2

Description: Test connection via USB-dfu with MCU’s . Selected MCU’s is set in setup_file.cfg file. Output from command line interface is shown in Figure 4.

Command arguments:

target_cfg <setup filepath>: - path to setup file created in GUI that has the target parameters and other information;
cmd 2 -optionaly agrument during connect operation(default cmd value is 2 - F_Connect()).

Autoprogram:

GangFlasher-CLI.exe -target_cfg setup_7targets.cfg -usb_cfg usb_loc.cfg -cmd 1

Description: Program the content of the specified binary file into device memory. The
programing operation is preceded by the erase operation before the Flash memory is
programmed . After programing memory is verify. Binary file, target MCU’s and USB locations are set in setup_7targets.cfg file and usb_loc.cfg file. Output from command line interface are shown in Figure 5. (report for all targets) and Figure 6.(detailed report for one of all targets).