UM3088
STM32Cube kommandolinjeverktøysett hurtigstartveiledning
Brukerhåndbok

Introduksjon

Dette dokumentet er en kort veiledning for brukere for å komme raskt i gang med STM32CubeCLT, STMicroelectronics kommandolinjeverktøysett for STM32 MCUer.
STM32CubeCLT tilbyr alle STM32CubeIDE-fasilitetene pakket for kommandoprompt-bruk av tredjeparts IDE-er, eller kontinuerlig integrasjon og kontinuerlig utvikling (CD/CI).

Den strømlinjeformede enkelt STM32CubeCLT-pakken inkluderer:

• CLI-versjoner (kommandolinjegrensesnitt) av ST-verktøy som verktøykjede, sondetilkoblingsverktøy og flashminneprogrammeringsverktøy
• Oppdatert system view beskrivelse (SVD) files
• Alle andre IDE-relevante metadata STM32CubeCLT tillater:
• Bygge et program for STM32 MCU-enheter ved å bruke en forbedret GNU-verktøykjede for STM32
• Programmere STM32 MCU interne minner (flashminne, RAM, OTP og andre) og eksterne minner
• Verifisering av programmeringsinnholdet (sjekksum, verifisering under og etter programmering, sammenligning med file)
• Automatisering av STM32 MCU-programmering
• Feilsøking av applikasjoner gjennom grensesnittet til STM32 MCU-produkter, som gir tilgang til MCU interne ressurser ved å bruke grunnleggende feilsøkingsfunksjoner

Generell informasjon

STM32CubeCLT-kommandolinjeverktøysettet for STM32 MCUer gir verktøy for å bygge, programmere, kjøre og feilsøke applikasjoner rettet mot STM32-mikrokontrollere basert på Arm® Cortex®-M-prosessoren.
Note:
Arm er et registrert varemerke for Arm Limited (eller dets datterselskaper) i USA og/eller andre steder.

Referansedokumenter

• Kommandolinjeverktøysett for STM32 MCUer (DB4839), STM32CubeCLT dataoversikt
• STM32CubeCLT installasjonsveiledning (UM3089)
• STM32CubeCLT utgivelsesnotat (RN0132)

Skjermbilder i dette dokumentet
Skjermbildene gitt i seksjon 2, seksjon 3 og seksjon 4 er bare eksamples av verktøybruken fra en ledetekst.
Integrasjonen i tredjeparts IDE-er eller bruken i CD/CI-skript er ikke illustrert i dette dokumentet.

Bygning

STM32CubeCLT-pakken inneholder GNU-verktøyene for STM32-verktøykjeden for å bygge et program for en STM32-mikrokontroller. Et Windows®-konsollvindu f.eksample er vist i figur 1.

1. Åpne en konsoll i prosjektmappen.
2. Utfør følgende kommando for å bygge prosjektet: > make -j8 all -C .\Debug

Note: Make-verktøyet kan kreve et separat installasjonstrinn.

Styreprogrammering

STM32CubeCLT-pakken inneholder STM32CubeProgrammer (STM32CubeProg), som brukes til å programmere bygningen som er oppnådd tidligere, inn i mål STM32-mikrokontrolleren.

1. Kontroller at ST-LINK-tilkoblingen er oppdaget
2. Velg plasseringen av prosjektmappen i konsollvinduet
3. Slett eventuelt alt flashminneinnholdet (se figur 2): > STM32_Programmer_CLI.exe -c port=SWD freq=4000 -e all
4. Last opp programmet file til 0x08000000 flashminneadressen (se figur 3): > STM32_Programmer_CLI.exe -c port=SWD freq=4000 -w .\Debug\DITT_PROGRAM.elf 0x08000000

Feilsøking

I tillegg til GNU-verktøyene for STM32-verktøykjeden, inneholder STM32CubeCLT-pakken også ST-LINK GDB-serveren. Begge er nødvendig for å starte en feilsøkingsøkt.

1. Start ST-LINK GDB-serveren i et annet Windows® PowerShell®-vindu (se figur 4): > ST-LINK_gdbserver.exe -d -v -t -cp C:\ST\STM32CubeCLT\STM32CubeProgrammer\bin
2. Bruk GNU-verktøyene for STM32-verktøykjeden for å starte GDB-klienten i PowerShell®-vinduet:
   > arm-none-eabi-gdb.exe
   > (gdb) mål ekstern localhost:port (bruk porten som er angitt i GDB-serveren åpnet tilkobling)
   Forbindelsen er opprettet og GDB-serversesjonsmeldinger vises som vist i figur 5. Det er da mulig å kjøre GDB-kommandoer i feilsøkingsøkten, for eksempel å laste et .elf-program på nytt ved å bruke GDB: > (gdb) load YOUR_PROGRAM.elf

Revisjonshistorikk

Tabell 1. Dokumentrevisjonshistorikk

Dato	Revisjon	Endringer
16-23 februar	1	Første utgivelse.

VIKTIG MERKNAD – LES NØYE
STMicroelectronics NV og dets datterselskaper ("ST") forbeholder seg retten til å gjøre endringer, rettelser, forbedringer, modifikasjoner og forbedringer av ST-produkter og/eller dette dokumentet når som helst uten varsel. Kjøpere bør innhente den nyeste relevante informasjonen om ST-produkter før de legger inn bestillinger. ST-produkter selges i henhold til STs salgsvilkår som er på plass på tidspunktet for ordrebekreftelse.
Kjøpere er alene ansvarlige for valg, valg og bruk av ST-produkter og ST påtar seg intet ansvar for søknadshjelp eller utforming av kjøpers produkter.
Ingen lisens, uttrykt eller underforstått, til noen immaterielle rettigheter er gitt av ST heri.
Videresalg av ST-produkter med andre bestemmelser enn informasjonen som er angitt her, vil ugyldiggjøre enhver garanti gitt av ST for slikt produkt.
ST og ST-logoen er varemerker for ST. For ytterligere informasjon om ST-varemerker, se www.st.com/trademarks. Alle andre produkt- eller tjenestenavn tilhører sine respektive eiere.
Informasjonen i dette dokumentet erstatter og erstatter informasjon som tidligere er gitt i tidligere versjoner av dette dokumentet.

UM3088 – Rev 1 – februar 2023
For mer informasjon kontakt ditt lokale STMicroelectronics salgskontor.
www.st.com
© 2023 STMicroelectronics – Alle rettigheter forbeholdt

Dokumenter / Ressurser

	ST STM32Cube kommandolinjeverktøysett [pdfBrukerhåndbok UM3088, STM32Cube Command Line Toolset, STM32Cube, Command Line Toolset, Toolset
	ST STM32Cube kommandolinjeverktøysett [pdf] Brukerhåndbok RN0132, STM32Cube Command Line Toolset, STM32Cube, Command Line Toolset, Line Toolset, Toolset

Referanser

• Brukerhåndbok