UM2237 User manual STM32CubeProgrammer software description Introduction STM32CubeProgrammer (STM32CubeProg) provides an all-in-one software tool to program STM32 devices in any environment: multi-OS, graphical user interface or command line interface, support for a large choice of connections (JTAG, SWD, USB, UART, SPI, CAN, I2C), with manual operation or automation through scripting. This document details the hardware and software environment prerequisites, as well as the available STM32CubeProgrammer software features. July 2021 UM2237 Rev 16 1/125 www.st.com 1 Contents UM2237 Contents 1 Getting started . 9 1.1 System requirements . 9 1.2 Installing STM32CubeProgrammer . 9 1.2.1 Linux install . 9 1.2.2 Windows install . 10 1.2.3 macOS install . 10 1.2.4 DFU driver . 10 1.2.5 ST-LINK driver . 12 2 STM32CubeProgrammer user interface for MCUs . 13 2.1 Main window . 13 2.1.1 Main menu . 13 2.1.2 Log panel . 14 2.1.3 Progress bar . 14 2.1.4 Target configuration panel . 15 2.2 Memory and file edition . 23 2.2.1 Reading and displaying target memory . 23 2.2.2 Reading and displaying a file . 24 2.3 Memory programming and erasing . 25 2.3.1 Internal Flash memory programming . 25 2.3.2 External Flash memory programming . 26 2.3.3 Developing customized loaders for external memory . 28 2.4 Option bytes . 30 2.5 Automatic mode . 31 2.6 STM32WB OTA programming . 35 2.6.1 USB dongle configuration . 35 2.6.2 OTA update procedure . 36 2.7 In application programming (IAP) . 40 2.8 Flash the co-processor binary using graphical interface . 41 2.8.1 Using JTAG . 41 2.8.2 Using bootloader . 44 2.9 Serial wire viewer (SWV) . 44 2.10 DFU IAP with custom PID and VID . 46 2/125 UM2237 Rev 16 UM2237 Contents 2.11 SigFox™ credentials . 47 2.12 Register Viewer . 48 2.13 Hard Fault analyzer . 49 2.13.1 Description . 49 2.13.2 Example . 51 2.13.3 Fault Analyzer note . 51 2.13.4 Secure Fault Analyzer for Cortex-M33 . 52 2.14 Fill memory command . 53 2.15 Fill memory operation . 55 2.16 Blank check command . 56 2.17 Blank check operation . 57 2.18 Compare Flash memory with file . 61 2.19 Comparison between two files . 66 2.20 LiveUpdate feature . 71 3 STM32CubeProgrammer command line interface (CLI) for MCUs . 72 3.1 Command line usage . 72 3.2 Generic commands . 74 3.2.1 Connect command . 74 3.2.2 Erase command . 82 3.2.3 Download command . 83 3.2.4 Download 32-bit data command . 83 3.2.5 Download 64-bit data command . 84 3.2.6 Read command . 84 3.2.7 Start command . 85 3.2.8 Debug commands . 85 3.2.9 List command . 86 3.2.10 QuietMode command . 87 3.2.11 Verbosity command . 87 3.2.12 Log command . 88 3.2.13 External loader command . 89 3.2.14 External loader command with bootloader interface . 90 3.2.15 Read unprotect command . 91 3.2.16 TZ regression command . 91 3.2.17 Option bytes command . 91 3.2.18 Safety lib command . 91 UM2237 Rev 16 3/125 5 Contents UM2237 3.2.19 Secure programming SFI specific commands . 95 3.2.20 Secure programming SFIx specific commands . 95 3.2.21 HSM related commands . 97 3.2.22 STM32WB specific commands . 98 3.2.23 Serial wire viewer (SWV) command . 100 3.2.24 Specific commands for STM32WL . 101 3.2.25 SigFox credential commands . 103 3.2.26 Register Viewer . 105 3.2.27 Hard fault analyzer . 106 3.2.28 RDP regression with password . 107 4 STM32CubeProgrammer user interface for MPUs . 109 4.1 Main window . 109 4.2 Programming windows . .110 5 STM32CubeProgrammer CLI for MPUs . 111 5.1 Available commands for STM32MP1 . .111 5.1.1 Connect command . 111 5.1.2 GetPhase command . 112 5.1.3 Download command . 112 5.1.4 Flashing service . ..