UM3088
STM32Cube kommandolinjeværktøjssæt hurtigstartvejledning
Brugermanual

Indledning

Dette dokument er en kort vejledning til brugere til hurtigt at komme i gang med STM32CubeCLT, STMicroelectronics kommandolinjeværktøjssæt til STM32 MCU'er.
STM32CubeCLT tilbyder alle STM32CubeIDE faciliteter pakket til kommandoprompt brug af tredjeparts IDE'er eller kontinuerlig integration og kontinuerlig udvikling (CD/CI).

Den strømlinede enkelt STM32CubeCLT-pakke inkluderer:

• CLI-versioner (kommandolinjegrænseflade) af ST-værktøjer som værktøjskæde, probeforbindelsesværktøj og flashhukommelsesprogrammeringsværktøj
• Opdateret system view deskriptor (SVD) files
• Alle andre IDE-relevante metadata STM32CubeCLT tillader:
• Opbygning af et program til STM32 MCU-enheder ved hjælp af en forbedret GNU-værktøjskæde til STM32
• Programmering af STM32 MCU interne hukommelser (flashhukommelse, RAM, OTP og andre) og eksterne hukommelser
• Verifikation af programmeringsindholdet (kontrolsum, verifikation under og efter programmering, sammenligning med file)
• Automatisering af STM32 MCU-programmering
• Fejlretning af applikationer gennem grænsefladen til STM32 MCU-produkter, som giver adgang til MCU interne ressourcer ved hjælp af grundlæggende fejlfindingsfunktioner

Generel information

STM32CubeCLT-kommandolinjeværktøjssættet til STM32 MCU'er giver værktøjer til at bygge, programmere, køre og fejlfinde applikationer rettet mod STM32-mikrocontrollere baseret på Arm® Cortex® ‑M-processoren.
Note:
Arm er et registreret varemærke tilhørende Arm Limited (eller dets datterselskaber) i USA og/eller andre steder.

Referencedokumenter

• Kommandolinjeværktøjssæt til STM32 MCU'er (DB4839), STM32CubeCLT-datakort
• STM32CubeCLT installationsvejledning (UM3089)
• STM32CubeCLT release note (RN0132)

Skærmbilleder i dette dokument
Skærmbillederne i sektion 2, sektion 3 og sektion 4 er kun examples af værktøjsbrugen fra en kommandoprompt.
Integrationen i tredjeparts IDE'er eller brugen i CD/CI-scripts er ikke illustreret i dette dokument.

Bygning

STM32CubeCLT-pakken indeholder GNU-værktøjerne til STM32-værktøjskæden til at bygge et program til en STM32-mikrocontroller. Et Windows®-konsolvindue f.eksample er vist i figur 1.

1. Åbn en konsol i projektmappen.
2. Udfør følgende kommando for at bygge projektet: > make -j8 all -C .\Debug

Note: Make-værktøjet kræver muligvis et separat installationstrin.

Board programmering

STM32CubeCLT-pakken indeholder STM32CubeProgrammer (STM32CubeProg), som bruges til at programmere den tidligere opnåede build ind i mål STM32-mikrocontrolleren.

1. Sørg for, at ST-LINK-forbindelsen er fundet
2. Vælg projektmappens placering i konsolvinduet
3. Slet eventuelt alt flashhukommelsesindholdet (se figur 2): > STM32_Programmer_CLI.exe -c port=SWD freq=4000 -e all
4. Upload programmet file til 0x08000000 flashhukommelsesadressen (se figur 3): > STM32_Programmer_CLI.exe -c port=SWD freq=4000 -w .\Debug\DIT_PROGRAM.elf 0x08000000

Fejlretning

Ud over GNU-værktøjerne til STM32-værktøjskæden, indeholder STM32CubeCLT-pakken også ST-LINK GDB-serveren. Begge er nødvendige for at starte en debugsession.

1. Start ST-LINK GDB-serveren i et andet Windows® PowerShell®-vindue (se figur 4): > ST-LINK_gdbserver.exe -d -v -t -cp C:\ST\STM32CubeCLT\STM32CubeProgrammer\bin
2. Brug GNU-værktøjerne til STM32-værktøjskæden til at starte GDB-klienten i PowerShell®-vinduet:
   > arm-none-eabi-gdb.exe
   > (gdb) mål ekstern localhost:port (brug den port, der er angivet i den åbnede GDB-serverforbindelse)
   Forbindelsen er etableret, og GDB-serversessionsmeddelelser vises som vist i figur 5. Det er derefter muligt at køre GDB-kommandoer i fejlretningssessionen, for eksempel at genindlæse et .elf-program ved hjælp af GDB: > (gdb) load DIT_PROGRAM.elf

Revisionshistorie

Tabel 1. Dokumentrevisionshistorik

Dato	Revision	Ændringer
16. februar 23	1	Første udgivelse.

VIGTIG MEDDELELSE – LÆS OMHYGGELIGT
STMicroelectronics NV og dets datterselskaber ("ST") forbeholder sig retten til at foretage ændringer, rettelser, forbedringer, modifikationer og forbedringer af ST-produkter og/eller dette dokument til enhver tid uden varsel. Købere bør indhente de seneste relevante oplysninger om ST-produkter, før de afgiver ordre. ST-produkter sælges i henhold til STs salgs- og salgsbetingelser på tidspunktet for ordrebekræftelse.
Købere er alene ansvarlige for valg, udvælgelse og brug af ST-produkter, og ST påtager sig intet ansvar for ansøgningsassistance eller design af købers produkter.
Ingen licens, hverken udtrykkelig eller underforstået, til nogen intellektuel ejendomsret er givet af ST heri.
Videresalg af ST-produkter med andre bestemmelser end de oplysninger, der er angivet heri, annullerer enhver garanti givet af ST for et sådant produkt.
ST og ST-logoet er varemærker tilhørende ST. For yderligere information om ST-varemærker, se www.st.com/varemærker. Alle andre produkt- eller tjenestenavne tilhører deres respektive ejere.
Oplysningerne i dette dokument erstatter og erstatter oplysninger, der tidligere er leveret i alle tidligere versioner af dette dokument.

UM3088 – Rev 1 – februar 2023
For yderligere information kontakt dit lokale STMicroelectronics salgskontor.
www.st.com
© 2023 STMicroelectronics – Alle rettigheder forbeholdes

Dokumenter/ressourcer

	ST STM32Cube kommandolinjeværktøjssæt [pdfBrugermanual UM3088, STM32Cube Command Line Toolset, STM32Cube, Command Line Toolset, Toolset
	ST STM32Cube kommandolinjeværktøjssæt [pdf] Brugermanual RN0132, STM32Cube Command Line Toolset, STM32Cube, Command Line Toolset, Line Toolset, Toolset

Referencer

• Brugermanual