UM3088
Guia d'inici ràpid del conjunt d'eines de línia d'ordres STM32Cube
Manual d'usuari

Introducció

Aquest document és una guia breu perquè els usuaris comencin ràpidament amb STM32CubeCLT, el conjunt d'eines de línia d'ordres de STMicroelectronics per a MCU STM32.
STM32CubeCLT ofereix totes les instal·lacions STM32CubeIDE empaquetades per a l'ús de l'indicador d'ordres per part d'IDE de tercers, o integració i desenvolupament continus (CD/CI).

El paquet únic STM32CubeCLT racionalitzat inclou:

• Versions CLI (interfície de línia d'ordres) d'eines ST com la cadena d'eines, la utilitat de connexió de sonda i la utilitat de programació de memòria flash
• Sistema actualitzat view descriptor (SVD) files
• Qualsevol altra metadada rellevant de l'IDE STM32CubeCLT permet:
• Creació d'un programa per a dispositius MCU STM32 mitjançant una cadena d'eines GNU millorada per a STM32
• Programació de memòries internes STM32 MCU (memòria flash, RAM, OTP i altres) i memòries externes
• Verificació del contingut de la programació (checksum, verificació durant i després de la programació, comparació amb file)
• Automatització de la programació de la MCU STM32
• Depuració d'aplicacions mitjançant la interfície dels productes STM32 MCU, que proporciona accés als recursos interns de l'MCU mitjançant funcions de depuració bàsiques

Informació general

El conjunt d'eines de línia d'ordres STM32CubeCLT per a MCU STM32 ofereix eines per crear, programar, executar i depurar aplicacions dirigides als microcontroladors STM32 basats en el processador Arm® Cortex® ‑M.
Nota:
Arm és una marca registrada d’Arm Limited (o de les seves filials) als Estats Units i / o en altres llocs.

Documents de referència

• Conjunt d'eines de línia d'ordres per a MCU STM32 (DB4839), breu de dades STM32CubeCLT
• Guia d'instal·lació de STM32CubeCLT (UM3089)
• Nota de versió de STM32CubeCLT (RN0132)

Captures de pantalla en aquest document
Les captures de pantalla proporcionades a la secció 2, la secció 3 i la secció 4 només són exampfitxers de l'ús de l'eina des d'un indicador d'ordres.
La integració en IDE de tercers o l'ús en scripts de CD/CI no s'il·lustra en aquest document.

Edifici

El paquet STM32CubeCLT conté les eines GNU per a la cadena d'eines STM32 per crear un programa per a un microcontrolador STM32. Una finestra de la consola Windows® exampes mostra a la figura 1.

1. Obriu una consola a la carpeta del projecte.
2. Executeu l'ordre següent per crear el projecte: > make -j8 all -C .\Debug

Nota: La utilitat make pot requerir un pas d'instal·lació independent.

Programació de la junta

El paquet STM32CubeCLT conté el STM32CubeProgrammer (STM32CubeProg), que s'utilitza per programar la compilació obtinguda prèviament al microcontrolador STM32 objectiu.

1. Assegureu-vos que s'ha detectat la connexió ST-LINK
2. Seleccioneu la ubicació de la carpeta del projecte a la finestra de la consola
3. Opcionalment, esborreu tot el contingut de la memòria flash (consulteu la figura 2): > STM32_Programmer_CLI.exe -c port=SWD freq=4000 -e all
4. Carregueu el programa file a l'adreça de memòria flash 0x08000000 (consulteu la figura 3): > STM32_Programmer_CLI.exe -c port=SWD freq=4000 -w .\Debug\YOUR_PROGRAM.elf 0x08000000

Depuració

A més de les eines GNU per a la cadena d'eines STM32, el paquet STM32CubeCLT també conté el servidor ST-LINK GDB. Tots dos són necessaris per iniciar una sessió de depuració.

1. Inicieu el servidor ST-LINK GDB en una altra finestra de Windows® PowerShell® (consulteu la figura 4): > ST-LINK_gdbserver.exe -d -v -t -cp C:\ST\STM32CubeCLT\STM32CubeProgrammer\bin
2. Utilitzeu les eines GNU per a la cadena d'eines STM32 per iniciar el client GDB a la finestra de PowerShell®:
   > arm-none-eabi-gdb.exe
   > (gdb) objectiu localhost remot:port (utilitza el port indicat a la connexió oberta del servidor GDB)
   S'estableix la connexió i es mostren els missatges de sessió del servidor GDB tal com es mostra a la figura 5. Aleshores és possible executar ordres GDB a la sessió de depuració, per exemple per tornar a carregar un programa .elf mitjançant GDB: > (gdb) load YOUR_PROGRAM.elf

Historial de revisions

Taula 1. Historial de revisions de documents

Data	Revisió	Canvis
16-feb-23	1	Alliberament inicial.

AVÍS IMPORTANT - LLEGIU ATENCIÓ
STMicroelectronics NV i les seves filials ("ST") es reserven el dret de fer canvis, correccions, millores, modificacions i millores als productes ST i/o a aquest document en qualsevol moment sense previ avís. Els compradors haurien d'obtenir la informació rellevant més recent sobre els productes ST abans de fer comandes. Els productes ST es venen d'acord amb els termes i condicions de venda de ST vigents en el moment del reconeixement de la comanda.
Els compradors són els únics responsables de l'elecció, selecció i ús dels productes ST i ST no assumeix cap responsabilitat per l'assistència a l'aplicació o el disseny dels productes dels compradors.
ST no concedeix cap llicència, expressa o implícita, a cap dret de propietat intel·lectual.
La revenda de productes ST amb disposicions diferents de la informació que s'estableix aquí anul·larà qualsevol garantia concedida per ST per a aquest producte.
ST i el logotip de ST són marques comercials de ST. Per obtenir informació addicional sobre les marques comercials ST, consulteu www.st.com/trademarks. Tots els altres noms de productes o serveis són propietat dels seus respectius propietaris.
La informació d'aquest document substitueix i substitueix la informació proporcionada anteriorment en qualsevol versió anterior d'aquest document.

UM3088 – Rev 1 – febrer de 2023
Per obtenir més informació, poseu-vos en contacte amb l'oficina de vendes local de STMicroelectronics.
www.st.com
© 2023 STMicroelectronics – Tots els drets reservats

Documents/Recursos

	Conjunt d'eines de línia d'ordres ST STM32Cube [pdfManual d'usuari UM3088, conjunt d'eines de línia d'ordres STM32Cube, STM32Cube, conjunt d'eines de línia d'ordres, conjunt d'eines
	Conjunt d'eines de línia d'ordres ST STM32Cube [pdfManual del propietari RN0132, conjunt d'eines de línia d'ordres STM32Cube, STM32Cube, conjunt d'eines de línia d'ordres, conjunt d'eines de línia, conjunt d'eines

Referències

• Manual d'usuari