UM 3088
STM32Cube guida di partenza rapida di u set di strumenti di linea di cummanda
Manuale d'usu

Introduzione

Stu documentu hè una breve guida per l'utilizatori per inizià rapidamente cù STM32CubeCLT, u set di strumenti di linea di cumanda STMicroelectronics per STM32 MCU.
STM32CubeCLT offre tutte e facilità STM32CubeIDE imballate per l'usu di prompt di cumanda da IDE di terzu, o integrazione cuntinua è sviluppu cuntinuu (CD / CI).

U pacchettu unicu STM32CubeCLT simplificatu include:

• Versioni CLI (interfaccia di linea di cummanda) di strumenti ST cum'è toolchain, utilità di cunnessione di sonda è utilità di prugrammazione di memoria flash
• Sistema à l'aghjurnamentu view descrittore (SVD) files
• Ogni altra metadata pertinenti à l'IDE STM32CubeCLT permette:
• Custruisce un prugramma per i dispositi MCU STM32 utilizendu una catena di strumenti GNU rinfurzata per STM32
• Programmazione di memorie interne STM32 MCU (memoria flash, RAM, OTP, è altri) è memorie esterne
• Verificà u cuntenutu di prugrammazione (checksum, verificazione durante è dopu a prugrammazione, paraguni cù file)
• Automatizà a prugrammazione STM32 MCU
• Applicazioni di debugging attraversu l'interfaccia di i prudutti STM32 MCU, chì furnisce l'accessu à e risorse interne MCU utilizendu funzioni di debug di basa

infurmazione generale

U set di strumenti di linea di cummanda STM32CubeCLT per i MCU STM32 furnisce strumenti per custruisce, programà, eseguisce è debug applicazioni destinate à i microcontrollers STM32 basati nantu à u processore Arm® Cortex® ‑M.
Nota:
Arm hè una marca registrata di Arm Limited (o i so filiali) in i Stati Uniti è / o in altrò.

Documenti di riferimentu

• Set di strumenti di linea di comando per STM32 MCU (DB4839), STM32CubeCLT data brief
• Guida di installazione di STM32CubeCLT (UM3089)
• Nota di liberazione STM32CubeCLT (RN0132)

Screenshots in stu documentu
I screenshots furniti in a Sezione 2, a Sezione 3 è a Sezione 4 sò solu examples di l'usu di l'uttellu da un prompt di cumanda.
L'integrazione in IDE di terzu o l'usu in script CD/CI ùn hè micca illustratu in stu documentu.

Edificiu

U pacchettu STM32CubeCLT cuntene i strumenti GNU per a catena di strumenti STM32 per custruisce un prugramma per un microcontroller STM32. Una finestra di cunsola Windows® example hè indicatu in Figura 1.

1. Aprite una cunsola in u cartulare di u prughjettu.
2. Eseguite u cumandimu seguitu per custruisce u prugettu: > make -j8 all -C .\Debug

Nota: L'utilità di creazione pò esse bisognu di un passu d'installazione separatu.

Prugrammazione di bordu

U pacchettu STM32CubeCLT cuntene u STM32CubeProgrammer (STM32CubeProg), chì hè utilizatu per programà a custruzione ottenuta prima in u microcontroller STM32 di destinazione.

1. Assicuratevi chì a cunnessione ST-LINK hè rilevata
2. Selezziunate u locu di u cartulare di u prughjettu in a finestra di a cunsola
3. Opzionalmente, sguassate tuttu u cuntenutu di a memoria flash (consultate a Figura 2): > STM32_Programmer_CLI.exe -c port=SWD freq=4000 -e all
4. Caricate u prugramma file à l'indirizzu di memoria flash 0x08000000 (consultate a Figura 3): > STM32_Programmer_CLI.exe -c port=SWD freq=4000 -w .\Debug\YOUR_PROGRAM.elf 0x08000000

Debugging

In più di l'arnesi GNU per a catena di strumenti STM32, u pacchettu STM32CubeCLT cuntene ancu u servitore ST-LINK GDB. Tutti dui sò necessarii per inizià una sessione di debug.

1. Avviate u servitore ST-LINK GDB in una altra finestra di Windows® PowerShell® (consultate a Figura 4): > ST-LINK_gdbserver.exe -d -v -t -cp C:\ST\STM32CubeCLT\STM32CubeProgrammer\bin
2. Aduprate l'arnesi GNU per a catena di strumenti STM32 per inizià u cliente GDB in a finestra PowerShell®:
   > arm-none-eabi-gdb.exe
   > (gdb) target remote localhost:port (utilizate u portu indicatu in a cunnessione aperta di u servitore GDB)
   A cunnessione hè stabilita è i missaghji di sessione di u servitore GDB sò visualizati cum'è mostra in a Figura 5. Hè tandu pussibule di eseguisce cumandamenti GDB in a sessione di debug, per esempiu per ricaricà un prugramma .elf cù GDB: > (gdb) load YOUR_PROGRAM.elf

Storia di rivisione

Table 1. Storia di rivisione di documenti

Data	Revisione	Cambiamenti
16-Feb-23	1	Liberazione iniziale.

AVVISU IMPORTANTE - LEGGIU ATTENTAMENTE
STMicroelectronics NV è e so filiali ("ST") si riservanu u dirittu di fà cambiamenti, correzioni, miglioramenti, mudificazioni è migliure à i prudutti ST è / o à stu documentu in ogni mumentu senza avvisu. I cumpratori anu da ottene l'ultime informazioni pertinenti nantu à i prudutti ST prima di fà ordini. I prudutti ST sò venduti in cunfurmità cù i termini è e cundizioni di vendita di ST in vigore à u mumentu di a ricunniscenza di l'ordine.
I cumpratori sò solu rispunsevuli di a scelta, a selezzione è l'usu di i prudutti ST è ST ùn assume micca responsabilità per l'assistenza di l'applicazione o u disignu di i prudutti di l'acquirente.
Nisuna licenza, espressa o implicita, à qualsiasi dirittu di pruprietà intellettuale hè cuncessa da ST quì.
A rivendita di i prudutti ST cù disposizioni diverse da l'infurmazioni stabilite quì annullerà ogni garanzia accordata da ST per tali pruduttu.
ST è u logo ST sò marchi di ST. Per infurmazioni supplementari nantu à i marchi ST, riferite à www.st.com/trademarks. Tutti l'altri prudutti o nomi di serviziu sò a pruprietà di i so rispettivi pruprietarii.
L'infurmazioni in stu documentu rimpiazzanu è rimpiazzanu l'infurmazioni furnite prima in qualsiasi versione precedente di stu documentu.

UM3088 - Rev 1 - ferraghju 2023
Per più infurmazione cuntattate u vostru uffiziu di vendita STMicroelectronics locale.
www.st.com
© 2023 STMicroelectronics - Tutti i diritti riservati

Documenti / Risorse

	ST STM32Cube Command Line Toolset [pdfManuale d'usu UM3088, STM32Cube Command Line Toolset, STM32Cube, Command Line Toolset, Toolset
	ST STM32Cube Command Line Toolset [pdfManuale di u pruprietariu RN0132, STM32Cube Command Line Toolset, STM32Cube, Command Line Toolset, Line Toolset, Toolset

Referenze

• Manuale d'usu