UM3088
Guida introduttiva al set di strumenti della riga di comando STM32Cube
Manuale d'uso

Introduzione

Questo documento è una breve guida per gli utenti per iniziare rapidamente con STM32CubeCLT, il set di strumenti della riga di comando di STMicroelectronics per MCU STM32.
STM32CubeCLT offre tutte le funzionalità di STM32CubeIDE confezionate per l'uso del prompt dei comandi da parte di IDE di terze parti o per l'integrazione continua e lo sviluppo continuo (CD/CI).

Il singolo pacchetto semplificato STM32CubeCLT include:

• Versioni CLI (interfaccia della riga di comando) di strumenti ST come toolchain, utilità di connessione sonda e utilità di programmazione della memoria flash
• Sistema aggiornato view descrittore (SVD) files
• Qualsiasi altro metadato rilevante per l'IDE STM32CubeCLT consente:
• Creazione di un programma per dispositivi MCU STM32 utilizzando una toolchain GNU avanzata per STM32
• Programmazione delle memorie interne dell'MCU STM32 (memoria flash, RAM, OTP e altre) e delle memorie esterne
• Verifica del contenuto della programmazione (checksum, verifica durante e dopo la programmazione, confronto con file)
• Automatizzazione della programmazione MCU STM32
• Debug delle applicazioni tramite l'interfaccia dei prodotti MCU STM32, che fornisce l'accesso alle risorse interne MCU utilizzando le funzionalità di debug di base

informazioni generali

Il set di strumenti della riga di comando STM32CubeCLT per MCU STM32 fornisce strumenti per creare, programmare, eseguire ed eseguire il debug di applicazioni destinate ai microcontroller STM32 basati sul processore Arm® Cortex® ‑M.
Nota:
Arm è un marchio registrato di Arm Limited (o delle sue consociate) negli Stati Uniti e/o altrove.

Documenti di riferimento

• Set di strumenti della riga di comando per MCU STM32 (DB4839), sintesi dei dati STM32CubeCLT
• Guida all'installazione di STM32CubeCLT (UM3089)
• Nota sulla versione di STM32CubeCLT (RN0132)

Screenshot in questo documento
Gli screenshot forniti nella Sezione 2, Sezione 3 e Sezione 4 sono solo esample dell'utilizzo dello strumento da un prompt dei comandi.
L'integrazione in IDE di terze parti o l'uso in script CD/CI non è illustrata in questo documento.

Edificio

Il pacchetto STM32CubeCLT contiene gli strumenti GNU per la toolchain STM32 per creare un programma per un microcontrollore STM32. Una finestra della console Windows® esample è mostrato in Figura 1.

1. Apri una console nella cartella del progetto.
2. Eseguire il seguente comando per compilare il progetto: > make -j8 all -C .\Debug

Nota: L'utility make potrebbe richiedere un passaggio di installazione separato.

Programmazione della scheda

Il pacchetto STM32CubeCLT contiene STM32CubeProgrammer (STM32CubeProg), che viene utilizzato per programmare la build ottenuta in precedenza nel microcontrollore STM32 di destinazione.

1. Assicurarsi che la connessione ST-LINK venga rilevata
2. Seleziona il percorso della cartella del progetto nella finestra della console
3. Facoltativamente, cancellare tutto il contenuto della memoria flash (fare riferimento alla Figura 2): > STM32_Programmer_CLI.exe -c port=SWD freq=4000 -e all
4. Carica il programma file all'indirizzo di memoria flash 0x08000000 (fare riferimento alla Figura 3): > STM32_Programmer_CLI.exe -c port=SWD freq=4000 -w .\Debug\YOUR_PROGRAM.elf 0x08000000

Debug

Oltre agli strumenti GNU per la toolchain STM32, il pacchetto STM32CubeCLT contiene anche il server GDB ST-LINK. Entrambi sono necessari per avviare una sessione di debug.

1. Avviare il server GDB ST-LINK in un'altra finestra di Windows® PowerShell® (fare riferimento alla Figura 4): > ST-LINK_gdbserver.exe -d -v -t -cp C:\ST\STM32CubeCLT\STM32CubeProgrammer\bin
2. Utilizza gli strumenti GNU per la toolchain STM32 per avviare il client GDB nella finestra di PowerShell®:
   > arm-none-eabi-gdb.exe
   > (gdb) target remote localhost:port (usa la porta indicata nella connessione aperta al server GDB)
   La connessione viene stabilita e i messaggi della sessione del server GDB vengono visualizzati come mostrato nella Figura 5. È quindi possibile eseguire i comandi GDB nella sessione di debug, ad esempio per ricaricare un programma .elf utilizzando GDB: > (gdb) load YOUR_PROGRAM.elf

Cronologia delle revisioni

Tabella 1. Cronologia delle revisioni del documento

Data	Revisione	Cambiamenti
16-feb-23	1	Versione iniziale.

AVVISO IMPORTANTE – LEGGERE ATTENTAMENTE
STMicroelectronics NV e le sue consociate ("ST") si riservano il diritto di apportare modifiche, correzioni, miglioramenti, migliorie e migliorie ai prodotti ST e/o al presente documento in qualsiasi momento e senza preavviso. Gli acquirenti devono ottenere le ultime informazioni rilevanti sui prodotti ST prima di effettuare ordini. I prodotti ST sono venduti in conformità ai termini e alle condizioni di vendita di ST in vigore al momento della conferma dell'ordine.
Gli acquirenti sono gli unici responsabili della scelta, della selezione e dell'uso dei prodotti ST e ST non si assume alcuna responsabilità per l'assistenza applicativa o la progettazione dei prodotti degli acquirenti.
Nel presente documento ST non concede alcuna licenza, espressa o implicita, su alcun diritto di proprietà intellettuale.
La rivendita di prodotti ST con disposizioni diverse dalle informazioni qui stabilite invaliderà qualsiasi garanzia concessa da ST per tale prodotto.
ST e il logo ST sono marchi di ST. Per ulteriori informazioni sui marchi ST, fare riferimento a www.st.com/trademarksTutti gli altri nomi di prodotti o servizi sono di proprietà dei rispettivi proprietari.
Le informazioni contenute nel presente documento annullano e sostituiscono le informazioni fornite in precedenza in qualsiasi versione precedente del documento.

UM3088 – Rev 1 – Febbraio 2023
Per ulteriori informazioni contattare l'ufficio vendite locale di STMicroelectronics.
www.st.com
© 2023 STMicroelectronics – Tutti i diritti riservati

Documenti / Risorse

	Set di strumenti della riga di comando ST STM32Cube [pdf] Manuale d'uso UM3088, set di strumenti della riga di comando STM32Cube, STM32Cube, set di strumenti della riga di comando, set di strumenti
	Set di strumenti della riga di comando ST STM32Cube [pdf] Manuale del proprietario RN0132, Set di strumenti della riga di comando STM32Cube, STM32Cube, Set di strumenti della riga di comando, Set di strumenti della riga, Set di strumenti

Riferimenti

• Manuale d'uso