Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Gang Flasher-ST CLI(command line interface) allow to programming STM32 MCUs with using only command line. The following sections describe how to use the GangFlasher-ST from the command line , describle posible commands arguments and show in exaples how to use it.

Table of Contents
minLevel1
maxLevel7

List of supported commands

...

There are two types of command arguments - required argument( always needed to perform any operation) and optional arguments needed olny in specific situation.

Syntax:
GangFlasher-CLI [Optional Settings] -target_cfg <setup filepath> or

GangFlasher-CLI -target_cfg <setup filepath> [Optional Settings]

Below is description of all possible command arguments.

...

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

Example usage

In the following sections shown in examples how to use GangFlasher-ST command line interface.

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 MCUs 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. (general report for all targets) and Figure 6.(detailed report for one of all targets).

Command arguments:

  • target_cfg <setup filepath>: - path to setup file created in GUI that has the target parameters and other information;

  • usb_cfg <usb setup filepath>: Path path to USB configuration file created in GUI(Figure 3.) that specifies a fixed USB PORT/HUB allocation;

  • cmd 1 - : selected F_AutoProgram() operation.

Load OS(STM32MP1 olny)

GangFlasher-CLI -target_cfg setup_mp1.cfg -cmd 3

Description: Install necessary to program memory, ST Linux OS on the STM32MP1 board. Output from command line shown in Figure 7.

Command arguments:

  • target_cfg <setup filepath>: path to setup file created in GUI that has the target parameters and other information;

  • cmd 3: selected F_Load_OS() operation.

...

Autoprogram STM32MP1

GangFlasher-CLI -target_cfg setup_mp1.cfg -tsv<tsv filepath> -cmd 1 or

GangFlasher-CLI -target_cfg setup_mp1.cfg -cmd 1

Description: Program the content of the specified binary files into device memory. The programing operation is preceded by the erase and patrication operation before the device memory is programmed. After programing memory is verify. Target MCUs set in setup_mp1.cfg file. TSV file set by -tsv command, instead that TSV file can be set in setup file and skip that argument. Output from command line shown in Figure 8.

Command arguments:

  • target_cfg <setup filepath>: path to setup file created in GUI that has the target parameters and other information;

  • tsv <tsv filepath>: path to TSV file from ST that has the list of partitions to be created and file to be programmed

  • cmd 1: selected F_AutoProgram() operation.

...