UM3088
Snelstartgids voor STM32Cube-opdrachtregeltools
Gebruiksaanwijzing

Invoering

Dit document is een korte handleiding voor gebruikers om snel aan de slag te gaan met STM32CubeCLT, de opdrachtregeltoolset van STMicroelectronics voor STM32 MCU's.
STM32CubeCLT biedt alle STM32CubeIDE-faciliteiten verpakt voor opdrachtprompt gebruik door IDE's van derden, of continue integratie en continue ontwikkeling (CD/CI).

Het gestroomlijnde enkele STM32CubeCLT-pakket omvat:

• CLI-versies (opdrachtregelinterface) van ST-tools zoals toolchain, probe-verbindingshulpprogramma en flash-geheugenprogrammeerhulpprogramma
• Actueel systeem view descriptor (SVD) files
• Elke andere IDE relevante metadata STM32CubeCLT staat toe:
• Een programma bouwen voor STM32 MCU-apparaten met behulp van een verbeterde GNU-toolchain voor STM32
• Programmering van STM32 MCU interne geheugens (flashgeheugen, RAM, OTP en andere) en externe geheugens
• Verificatie van de inhoud van de programmering (checksum, verificatie tijdens en na programmering, vergelijking met file)
• Automatisering van de STM32 MCU-programmering
• Toepassingen debuggen via de interface van STM32 MCU-producten, die toegang biedt tot interne bronnen van de MCU met behulp van basisfuncties voor foutopsporing

Algemene informatie

De STM32CubeCLT-opdrachtregeltoolset voor STM32 MCU's biedt tools voor het bouwen, programmeren, uitvoeren en debuggen van toepassingen gericht op STM32-microcontrollers op basis van de Arm® Cortex® -M-processor.
Opmerking:
Arm is een geregistreerd handelsmerk van Arm Limited (of haar dochterondernemingen) in de VS en/of elders.

Referentiedocumenten

• Opdrachtregeltoolset voor STM32 MCU's (DB4839), STM32CubeCLT-gegevensoverzicht
• STM32CubeCLT installatiehandleiding (UM3089)
• STM32CubeCLT release-opmerking (RN0132)

Schermafbeeldingen in dit document
De schermafbeeldingen in Sectie 2, Sectie 3 en Sectie 4 zijn alleen examples van het gereedschapsgebruik vanaf een opdrachtprompt.
De integratie in IDE's van derden of het gebruik in CD/CI-scripts wordt in dit document niet geïllustreerd.

Gebouw

Het STM32CubeCLT-pakket bevat de GNU-tools voor STM32-toolchain om een ​​programma voor een STM32-microcontroller te bouwen. Een Windows®-consolevenster, bijvample wordt getoond in figuur 1.

1. Open een console in de projectmap.
2. Voer de volgende opdracht uit om het project te bouwen: > make -j8 all -C .\Debug

Opmerking: Het make-hulpprogramma vereist mogelijk een afzonderlijke installatiestap.

Bord programmeren

Het STM32CubeCLT-pakket bevat de STM32CubeProgrammer (STM32CubeProg), die wordt gebruikt om de eerder verkregen build in de beoogde STM32-microcontroller te programmeren.

1. Zorg ervoor dat de ST-LINK-verbinding wordt gedetecteerd
2. Selecteer de locatie van de projectmap in het consolevenster
3. Wis eventueel alle inhoud van het flashgeheugen (zie afbeelding 2): > STM32_Programmer_CLI.exe -c port=SWD freq=4000 -e all
4. Upload het programma file naar het 0x08000000 flash-geheugenadres (zie afbeelding 3): > STM32_Programmer_CLI.exe -c port=SWD freq=4000 -w .\Debug\YOUR_PROGRAM.elf 0x08000000

Fouten opsporen

Naast de GNU-tools voor de STM32-toolchain bevat het STM32CubeCLT-pakket ook de ST-LINK GDB-server. Beide zijn nodig om een ​​foutopsporingssessie te starten.

1. Start de ST-LINK GDB-server in een ander Windows® PowerShell®-venster (zie Afbeelding 4): > ST-LINK_gdbserver.exe -d -v -t -cp C:\ST\STM32CubeCLT\STM32CubeProgrammer\bin
2. Gebruik de GNU-tools voor STM32-toolchain om de GDB-client in het PowerShell®-venster te starten:
   > arm-none-eabi-gdb.exe
   > (gdb) target remote localhost:port (gebruik de poort aangegeven in de GDB-server geopende verbinding)
   De verbinding wordt tot stand gebracht en GDB-serversessieberichten worden weergegeven zoals weergegeven in afbeelding 5. Het is dan mogelijk om GDB-commando's uit te voeren in de foutopsporingssessie, bijvoorbeeld om een ​​.elf-programma opnieuw te laden met behulp van GDB: > (gdb) laad UW_PROGRAMMA.elf

Revisiegeschiedenis

Tabel 1. Document revisiegeschiedenis

Datum	Herziening	Wijzigingen
16-feb-23	1	Eerste release.

BELANGRIJKE MEDEDELING – LEES ZORGVULDIG
STMicroelectronics NV en haar dochterondernemingen ("ST") behouden zich het recht voor om op elk moment zonder kennisgeving wijzigingen, correcties, verbeteringen, aanpassingen en aanpassingen aan te brengen in ST-producten en/of in dit document. Kopers dienen de laatste relevante informatie over ST-producten te verkrijgen voordat ze een bestelling plaatsen. ST-producten worden verkocht overeenkomstig de verkoopvoorwaarden van ST die van kracht zijn op het moment van orderbevestiging.
Kopers zijn als enige verantwoordelijk voor de keuze, selectie en het gebruik van ST-producten. ST aanvaardt geen aansprakelijkheid voor hulp bij de toepassing of het ontwerp van de producten van kopers.
ST verleent hierbij geen enkele licentie, expliciet of impliciet, op enig intellectueel eigendomsrecht.
Bij wederverkoop van ST-producten met bepalingen die afwijken van de hierin vermelde informatie, vervalt de garantie die ST op dat product verleent.
ST en het ST-logo zijn handelsmerken van ST. Voor aanvullende informatie over ST-handelsmerken, zie www.st.com/trademarksAlle andere product- of servicenamen zijn eigendom van hun respectievelijke eigenaren.
De informatie in dit document vervangt de informatie die eerder in eerdere versies van dit document is verstrekt.

UM3088 – Rev 1 – februari 2023
Neem voor meer informatie contact op met uw plaatselijke STMicroelectronics-verkoopkantoor.
www.st.com
© 2023 STMicroelectronics – Alle rechten voorbehouden

Documenten / Bronnen

	ST STM32Cube opdrachtregel-toolset [pdf] Gebruikershandleiding UM3088, STM32Cube opdrachtregel-toolset, STM32Cube, opdrachtregel-toolset, toolset
	ST STM32Cube opdrachtregel-toolset [pdf] Handleiding van de eigenaar RN0132, STM32Cube Command Line Toolset, STM32Cube, Command Line Toolset, Line Toolset, Toolset

Referenties

• Gebruiksaanwijzing