UM3088
STM32Cube kommandoradsverktygsuppsättning snabbstartguide
Användarmanual
Introduktion
Det här dokumentet är en kort guide för användare att snabbt komma igång med STM32CubeCLT, STMicroelectronics kommandoradsverktyg för STM32 MCU.
STM32CubeCLT erbjuder alla STM32CubeIDE-faciliteter paketerade för kommandoprompt-användning av tredje parts IDE, eller kontinuerlig integration och kontinuerlig utveckling (CD/CI).
Det strömlinjeformade enda STM32CubeCLT-paketet inkluderar:
- CLI-versioner (kommandolinjegränssnitt) av ST-verktyg som verktygskedja, probeanslutningsverktyg och flashminnesprogrammeringsverktyg
- Uppdaterat system view deskriptor (SVD) files
- Alla andra IDE-relevanta metadata STM32CubeCLT tillåter:
- Bygga ett program för STM32 MCU-enheter med hjälp av en förbättrad GNU-verktygskedja för STM32
- Programmering av STM32 MCU interna minnen (flashminne, RAM, OTP och andra) och externa minnen
- Verifiera programmeringsinnehållet (kontrollsumma, verifiering under och efter programmering, jämförelse med file)
- Automatisera STM32 MCU-programmering
- Felsökning av applikationer genom gränssnittet för STM32 MCU-produkter, vilket ger tillgång till MCU interna resurser med hjälp av grundläggande felsökningsfunktioner
Allmän information
Kommandoradsverktygsuppsättningen STM32CubeCLT för STM32 MCU:er tillhandahåller verktyg för att bygga, programmera, köra och felsöka applikationer som riktar sig till STM32-mikrokontroller baserade på Arm® Cortex® -M-processorn.
Notera:
Arm är ett registrerat varumärke som tillhör Arm Limited (eller dess dotterbolag) i USA och/eller någon annanstans.
Referensdokument
- Kommandoradsverktygsuppsättning för STM32 MCU:er (DB4839), STM32CubeCLT dataöversikt
- STM32CubeCLT installationsguide (UM3089)
- STM32CubeCLT release note (RN0132)
Skärmdumpar i detta dokument
Skärmdumparna i avsnitt 2, avsnitt 3 och avsnitt 4 är endast exampfiler av verktygsanvändningen från en kommandotolk.
Integrationen i IDE från tredje part eller användningen i CD/CI-skript illustreras inte i detta dokument.
Byggnad
STM32CubeCLT-paketet innehåller GNU-verktygen för STM32-verktygskedjan för att bygga ett program för en STM32-mikrokontroller. Ett Windows®-konsolfönster example visas i figur 1.
- Öppna en konsol i projektmappen.
- Utför följande kommando för att bygga projektet: > make -j8 all -C .\Debug
Notera: Verktyget make kan kräva ett separat installationssteg.
Styrelsens programmering
STM32CubeCLT-paketet innehåller STM32CubeProgrammer (STM32CubeProg), som används för att programmera byggnaden som erhölls tidigare i mål STM32-mikrokontrollern.
- Se till att ST-LINK-anslutningen detekteras
- Välj projektmappens plats i konsolfönstret
- Om du vill kan du radera allt flashminnesinnehåll (se figur 2): > STM32_Programmer_CLI.exe -c port=SWD freq=4000 -e all
- Ladda upp programmet file till 0x08000000 flashminnesadress (se figur 3): > STM32_Programmer_CLI.exe -c port=SWD freq=4000 -w .\Debug\DITT_PROGRAM.elf 0x08000000
Felsökning
Förutom GNU-verktygen för STM32-verktygskedjan innehåller STM32CubeCLT-paketet även ST-LINK GDB-servern. Båda behövs för att starta en felsökningssession.
- Starta ST-LINK GDB-servern i ett annat Windows® PowerShell®-fönster (se figur 4): > ST-LINK_gdbserver.exe -d -v -t -cp C:\ST\STM32CubeCLT\STM32CubeProgrammer\bin
- Använd GNU-verktygen för STM32-verktygskedjan för att starta GDB-klienten i PowerShell®-fönstret:
> arm-none-eabi-gdb.exe
> (gdb) target remote localhost:port (använd porten som anges i den öppnade GDB-serverns anslutning)
Anslutningen upprättas och GDB-serversessionsmeddelanden visas som visas i figur 5. Det är sedan möjligt att köra GDB-kommandon i felsökningssessionen, till exempel för att ladda om ett .elf-program med hjälp av GDB: > (gdb) ladda DIT_PROGRAM.elf
Revisionshistorik
Tabell 1. Dokumentrevisionshistorik
| Datum | Revision | Ändringar |
| 16-23 februari | 1 | Initial release. |
VIKTIGT MEDDELANDE – LÄS NOGGRANT
STMicroelectronics NV och dess dotterbolag (“ST”) förbehåller sig rätten att göra ändringar, korrigeringar, förbättringar, modifieringar och förbättringar av ST-produkter och/eller av detta dokument när som helst utan föregående meddelande. Köpare bör skaffa den senaste relevanta informationen om ST-produkter innan de lägger beställningar. ST-produkter säljs i enlighet med ST:s försäljningsvillkor som gäller vid tidpunkten för ordererkännande.
Köparen är ensam ansvarig för val, urval och användning av ST-produkter och ST tar inget ansvar för applikationshjälp eller design av köparens produkter.
Ingen licens, uttrycklig eller underförstådd, till någon immateriell rättighet beviljas av ST häri.
Återförsäljning av ST-produkter med bestämmelser som skiljer sig från den information som anges häri upphäver all garanti som beviljats av ST för sådan produkt.
ST och ST-logotypen är varumärken som tillhör ST. För ytterligare information om ST-varumärken, se www.st.com/trademarks. Alla andra produkt- eller tjänstnamn tillhör sina respektive ägare.
Informationen i detta dokument ersätter och ersätter information som tidigare tillhandahållits i tidigare versioner av detta dokument.
UM3088 – Rev 1 – februari 2023
För ytterligare information kontakta ditt lokala STMicroelectronics försäljningskontor.
www.st.com
© 2023 STMicroelectronics – Alla rättigheter reserverade
Dokument/resurser
 |
ST STM32Cube Command Line Toolset [pdf] Användarmanual UM3088, STM32Cube Command Line Toolset, STM32Cube, Command Line Toolset, Toolset |
 |
ST STM32Cube Command Line Toolset [pdf] Ägarmanual RN0132, STM32Cube Command Line Toolset, STM32Cube, Command Line Toolset, Line Toolset, Toolset |
