{"type":"doc","content":[{"type":"paragraph","content":[{"text":"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.","type":"text"}]},{"type":"paragraph"},{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{"minLevel":{"value":"1"},"maxLevel":{"value":"7"}},"macroMetadata":{"macroId":{"value":"0f3e7c66e59d1d0f82df8f7b8209501a"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"741223a9-c56e-4a0a-89a9-91ca43c5340e"}},{"type":"heading","attrs":{"level":1},"content":[{"text":"List of supported commands","type":"text"}]},{"type":"paragraph","content":[{"text":"List of all available commands(with all options) are shown in ","type":"text"},{"text":"Figure 1","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":1405,"id":"ea4b1e0b-6db4-434f-baea-1b32943dea65","collection":"contentId-62488625","type":"file","height":460}},{"type":"caption","content":[{"text":"Figure 1","type":"text","marks":[{"type":"strong"}]},{"text":". GangFlasher-ST:avalilable commands.","type":"text"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Command description","type":"text"}]},{"type":"paragraph","content":[{"text":"There are two types of command arguments - required argument( always needed to perform any operation) and optional arguments needed olny in specific situation. ","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax: ","type":"text","marks":[{"type":"strong"}]},{"type":"hardBreak"},{"text":" ","type":"text"},{"text":"GangFlasher-CLI [Optional Settings] -target_cfg or","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":" ","type":"text"},{"text":"GangFlasher-CLI -target_cfg [Optional Settings]","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"Below is description of all possible command arguments.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Required argument","type":"text"}]},{"type":"paragraph","content":[{"text":"-","type":"text"},{"text":"target_cfg ","type":"text","marks":[{"type":"strong"}]},{"text":"Path to setup file created in GUI that has the target parameters and other information. How to save config file is shown in ","type":"text"},{"text":"Figure 2","type":"text","marks":[{"type":"strong"}]},{"text":".(File ->Save Setup as…).","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":1201,"id":"574890e3-e1c4-4c47-ab12-97e8b861b2d9","collection":"contentId-62488625","type":"file","height":751}},{"type":"caption","content":[{"text":"Figure 2.","type":"text","marks":[{"type":"strong"}]},{"text":" Save config file.","type":"text"}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Optional Settings","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"},{"text":"-usb_cfg ","type":"text","marks":[{"type":"strong"}]},{"text":" ","type":"text"},{"text":":","type":"text","marks":[{"type":"strong"}]},{"text":" 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 ","type":"text"},{"text":"Figure 3. ","type":"text","marks":[{"type":"strong"}]},{"text":"(File ->Save USB Configuration as…).","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":1197,"id":"f651f160-7329-4ad5-ad56-a54b0f3efcc2","collection":"contentId-62488625","type":"file","height":749}},{"type":"caption","content":[{"text":"Figure 3.","type":"text","marks":[{"type":"strong"}]},{"text":" Save USB configuration file.","type":"text"}]}]},{"type":"paragraph","content":[{"type":"hardBreak"},{"text":"-tsv : ","type":"text","marks":[{"type":"strong"}]},{"text":"Path to TSV file from ST that has the list of partitions to be created and file to be programmed - support olny STM32MP1.","type":"text"},{"type":"hardBreak"},{"text":"-otp ","type":"text","marks":[{"type":"strong"}]},{"text":": Path to OTP file. OTP programming must be turned on in the target_cfg file for this file to be used - support olny STM32MP1.","type":"text"},{"type":"hardBreak"},{"text":"-ssp : ","type":"text","marks":[{"type":"strong"}]},{"text":"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.","type":"text"},{"type":"hardBreak"},{"text":"-tfa_ssp :","type":"text","marks":[{"type":"strong"}]},{"text":" 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.","type":"text"},{"type":"hardBreak"},{"text":"-fsbl : ","type":"text","marks":[{"type":"strong"}]},{"text":"Path to first stage bootloader (TF-A) - support olny STM32MP1.","type":"text"},{"type":"hardBreak"},{"text":"-ssbl :","type":"text","marks":[{"type":"strong"}]},{"text":" Path to secondary stage bootloader (U-Boot) - support olny STM32MP1.","type":"text"},{"type":"hardBreak"},{"text":"-hsm :","type":"text","marks":[{"type":"strong"}]},{"text":" Read data from HSM Card.","type":"text"},{"type":"hardBreak"},{"text":"-cmd : ","type":"text","marks":[{"type":"strong"}]},{"text":"Command to perform (default: F_Connect()).","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"1 : F_AutoProgram()","type":"text"},{"type":"hardBreak"},{"text":"2 : F_Connect() - default","type":"text"},{"type":"hardBreak"},{"text":"3 : F_Load_OS() - support olny STM32MP1","type":"text"},{"type":"hardBreak"},{"text":"4 : F_Write()","type":"text"},{"type":"hardBreak"},{"text":"5 : F_Verify()","type":"text"},{"type":"hardBreak"},{"text":"6 : F_Read()","type":"text"},{"type":"hardBreak"},{"text":"7 : F_OTP_Write()","type":"text"},{"type":"hardBreak"},{"text":"8 : F_OTP_Verify()","type":"text"},{"type":"hardBreak"},{"text":"9 : F_OTP_Read()","type":"text"},{"type":"hardBreak"},{"text":"10 : F_TrustedWrite() - support olny STM32MP1","type":"text"},{"type":"hardBreak"},{"text":"11 : F_Read_HSM(slot_id)","type":"text"},{"type":"hardBreak"},{"text":"12 : F_Erase_All -not supported for STM32MP1","type":"text"},{"type":"hardBreak"},{"text":"13 : F_ClearProtRegs -not supported for STM32MP1","type":"text"}]},{"type":"paragraph","content":[{"text":"-of :","type":"text","marks":[{"type":"strong"}]},{"text":" send output to file with path .","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Example usage","type":"text"}]},{"type":"paragraph","content":[{"text":"In the following sections shown in examples how to use GangFlasher-ST command line interface.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Test connection","type":"text"}]},{"type":"paragraph","content":[{"text":"GangFlasher-CLI -target_cfg setup_file.cfg ","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"or GangFlasher-CLI -target_cfg setup_file.cfg -cmd 2","type":"text","marks":[{"type":"strong"}]},{"type":"hardBreak"}]},{"type":"paragraph","content":[{"text":"Description: ","type":"text","marks":[{"type":"strong"}]},{"text":"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 ","type":"text"},{"text":"Figure 4.","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"Command arguments:","type":"text","marks":[{"type":"strong"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"target_cfg :","type":"text","marks":[{"type":"strong"}]},{"text":" - path to setup file created in GUI that has the target parameters and other information;","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"cmd 2:","type":"text","marks":[{"type":"strong"}]},{"text":" optionaly agrument during connect operation(default cmd value is 2 - F_Connect()).","type":"text"}]}]}]},{"type":"mediaSingle","attrs":{"layout":"center","width":80.0},"content":[{"type":"media","attrs":{"width":653,"id":"bd2afb61-fb4a-4b14-a891-af1e917754ae","collection":"contentId-62488625","type":"file","height":723}},{"type":"caption","content":[{"text":"Figure 4.","type":"text","marks":[{"type":"strong"}]},{"text":" Connect one target operation.","type":"text"}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Autoprogram","type":"text"}]},{"type":"paragraph","content":[{"text":"GangFlasher-CLI -target_cfg setup_7targets.cfg -usb_cfg usb_loc.cfg -cmd 1","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"Description: ","type":"text","marks":[{"type":"strong"}]},{"text":"Program the content of the specified binary file into device memory. The","type":"text"},{"type":"hardBreak"},{"text":"programing operation is preceded by the erase operation before the Flash memory is","type":"text"},{"type":"hardBreak"},{"text":"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 ","type":"text"},{"text":"Figure 5. ","type":"text","marks":[{"type":"strong"}]},{"text":"(general report for all targets) and","type":"text"},{"text":" Figure 6.","type":"text","marks":[{"type":"strong"}]},{"text":"(detailed report for one of all targets).","type":"text"}]},{"type":"paragraph","content":[{"text":"Command arguments:","type":"text","marks":[{"type":"strong"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"target_cfg :","type":"text","marks":[{"type":"strong"}]},{"text":" path to setup file created in GUI that has the target parameters and other information;","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"usb_cfg :","type":"text","marks":[{"type":"strong"}]},{"text":" path to USB configuration file created in GUI(","type":"text"},{"text":"Figure 3.","type":"text","marks":[{"type":"strong"}]},{"text":") that specifies a fixed USB PORT/HUB allocation;","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"cmd 1:","type":"text","marks":[{"type":"strong"}]},{"text":" selected F_AutoProgram() operation.","type":"text"}]}]}]},{"type":"paragraph"},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":966,"id":"2ea23eae-6a7e-49f7-aac3-d1fb10c0f885","collection":"contentId-62488625","type":"file","height":340}},{"type":"caption","content":[{"text":"Figure 5.","type":"text","marks":[{"type":"strong"}]},{"text":"General report after autoprogram operation.","type":"text"}]}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":537,"id":"8b160e46-2fd5-4356-b3fb-4147e6ffed3e","collection":"contentId-62488625","type":"file","height":217}},{"type":"caption","content":[{"text":"Figure 6.","type":"text","marks":[{"type":"strong"}]},{"text":" Report for target 1 after autoprogram.","type":"text"}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Load OS(STM32MP1 olny)","type":"text"}]},{"type":"paragraph","content":[{"text":"GangFlasher-CLI -target_cfg setup_mp1.cfg -cmd 3","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"Description:","type":"text","marks":[{"type":"strong"}]},{"text":" Install necessary to program memory, ST Linux OS on the STM32MP1 board. Output from command line shown in","type":"text"},{"text":" Figure 7.","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"Command arguments:","type":"text","marks":[{"type":"strong"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"target_cfg :","type":"text","marks":[{"type":"strong"}]},{"text":" path to setup file created in GUI that has the target parameters and other information;","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"cmd 3:","type":"text","marks":[{"type":"strong"}]},{"text":" selected F_Load_OS() operation.","type":"text"}]}]}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":517,"id":"40f0ef32-976e-4dff-8288-61b987242abd","collection":"contentId-62488625","type":"file","height":663}},{"type":"caption","content":[{"text":"Figure 7.","type":"text","marks":[{"type":"strong"}]},{"text":" Load OS operation.","type":"text"}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Autoprogram STM32MP1","type":"text"}]},{"type":"paragraph","content":[{"text":"GangFlasher-CLI -target_cfg setup_mp1.cfg -tsv -cmd 1 or ","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"GangFlasher-CLI -target_cfg setup_mp1.cfg -cmd 1","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"Description: ","type":"text","marks":[{"type":"strong"}]},{"text":"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","type":"text"},{"text":" Figure 8.","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"Command arguments:","type":"text","marks":[{"type":"strong"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"target_cfg :","type":"text","marks":[{"type":"strong"}]},{"text":" path to setup file created in GUI that has the target parameters and other information;","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"tsv : ","type":"text","marks":[{"type":"strong"}]},{"text":"path to TSV file from ST that has the list of partitions to be created and file to be programmed","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"cmd 1:","type":"text","marks":[{"type":"strong"}]},{"text":" selected F_AutoProgram() operation.","type":"text"}]}]}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":933,"id":"1544cd39-1ce0-4fc8-925b-a3681447beef","collection":"contentId-62488625","type":"file","height":973}},{"type":"caption","content":[{"text":"Figure 8.","type":"text","marks":[{"type":"strong"}]},{"text":" Autoprogram STM32MP1","type":"text"}]}]},{"type":"paragraph"}],"version":1}

Browser not supported