UM3088
Guía de inicio rápido do conxunto de ferramentas de liña de comandos STM32Cube
Manual de usuario

Introdución

Este documento é unha breve guía para que os usuarios poidan comezar rapidamente con STM32CubeCLT, o conxunto de ferramentas de liña de comandos de STMicroelectronics para MCU STM32.
STM32CubeCLT ofrece todas as instalacións STM32CubeIDE empaquetadas para o uso do símbolo do sistema por parte de IDE de terceiros, ou a integración continua e o desenvolvemento continuo (CD/CI).

O paquete único STM32CubeCLT simplificado inclúe:

• Versións CLI (interface de liña de comandos) de ferramentas ST como a cadea de ferramentas, a utilidade de conexión de sonda e a utilidade de programación de memoria flash
• Sistema actualizado view descriptor (SVD) files
• Calquera outro metadato relevante de IDE STM32CubeCLT permite:
• Creación dun programa para dispositivos MCU STM32 utilizando unha cadea de ferramentas GNU mellorada para STM32
• Programación de memorias internas STM32 MCU (memoria flash, RAM, OTP e outras) e memorias externas
• Verificación do contido da programación (checksum, verificación durante e despois da programación, comparación con file)
• Automatización da programación da MCU STM32
• Aplicacións de depuración a través da interface dos produtos STM32 MCU, que proporciona acceso aos recursos internos do MCU mediante funcións básicas de depuración

Información xeral

O conxunto de ferramentas de liña de comandos STM32CubeCLT para MCU STM32 ofrece ferramentas para construír, programar, executar e depurar aplicacións dirixidas aos microcontroladores STM32 baseados no procesador Arm® Cortex® ‑M.
Nota:
Arm é unha marca rexistrada de Arm Limited (ou das súas filiais) nos EUA e/ou noutros lugares.

Documentos de referencia

• Conxunto de ferramentas de liña de comandos para MCU STM32 (DB4839), resumo de datos STM32CubeCLT
• Guía de instalación de STM32CubeCLT (UM3089)
• Nota de publicación de STM32CubeCLT (RN0132)

Capturas de pantalla neste documento
As capturas de pantalla proporcionadas na Sección 2, Sección 3 e Sección 4 só son exampficheiros do uso da ferramenta desde un símbolo do sistema.
Neste documento non se ilustra a integración en IDE de terceiros nin o uso en scripts de CD/CI.

Edificio

O paquete STM32CubeCLT contén as ferramentas GNU para a cadea de ferramentas STM32 para construír un programa para un microcontrolador STM32. Unha xanela da consola Windows® example móstrase na Figura 1.

1. Abre unha consola no cartafol do proxecto.
2. Execute o seguinte comando para construír o proxecto: > make -j8 all -C .\Debug

Nota: A utilidade make pode requirir un paso de instalación separado.

Programación da mesa

O paquete STM32CubeCLT contén o STM32CubeProgrammer (STM32CubeProg), que se usa para programar a compilación obtida anteriormente no microcontrolador STM32 de destino.

1. Asegúrese de que se detecta a conexión ST-LINK
2. Seleccione a localización do cartafol do proxecto na xanela da consola
3. Opcionalmente, borre todo o contido da memoria flash (consulte a Figura 2): > STM32_Programmer_CLI.exe -c port=SWD freq=4000 -e all
4. Carga o programa file ao enderezo da memoria flash 0x08000000 (consulte a Figura 3): > STM32_Programmer_CLI.exe -c port=SWD freq=4000 -w .\Debug\YOUR_PROGRAM.elf 0x08000000

Depuración

Ademais das ferramentas GNU para a cadea de ferramentas STM32, o paquete STM32CubeCLT contén tamén o servidor ST-LINK GDB. Ambos son necesarios para iniciar unha sesión de depuración.

1. Inicie o servidor ST-LINK GDB noutra xanela de Windows® PowerShell® (consulte a Figura 4): > ST-LINK_gdbserver.exe -d -v -t -cp C:\ST\STM32CubeCLT\STM32CubeProgrammer\bin
2. Use as ferramentas GNU para a cadea de ferramentas STM32 para iniciar o cliente GDB na xanela de PowerShell®:
   > arm-none-eabi-gdb.exe
   > (gdb) destino remoto localhost:port (use o porto indicado na conexión aberta do servidor GDB)
   Establécese a conexión e móstranse as mensaxes da sesión do servidor GDB como se mostra na Figura 5. Despois é posible executar comandos GDB na sesión de depuración, por exemplo, para volver cargar un programa .elf usando GDB: > (gdb) load YOUR_PROGRAM.elf

Historial de revisións

Táboa 1. Historial de revisións de documentos

Data	Revisión	Cambios
16-Feb-23	1	Lanzamento inicial.

AVISO IMPORTANTE - LEA ATENTAMENTE
STMicroelectronics NV e as súas subsidiarias (“ST”) resérvanse o dereito de realizar cambios, correccións, melloras, modificacións e melloras nos produtos ST e/ou neste documento en calquera momento sen previo aviso. Os compradores deben obter a información relevante máis recente sobre produtos ST antes de facer pedidos. Os produtos ST véndense de acordo cos termos e condicións de venda de ST existentes no momento do recoñecemento da orde.
Os compradores son os únicos responsables da elección, selección e uso dos produtos ST e ST non asume ningunha responsabilidade pola asistencia á aplicación ou o deseño dos produtos dos compradores.
ST non concede ningunha licenza, expresa ou implícita, a ningún dereito de propiedade intelectual.
A revenda de produtos ST con disposicións diferentes da información aquí establecida anulará calquera garantía concedida por ST para tal produto.
ST e o logotipo de ST son marcas comerciais de ST. Para obter información adicional sobre as marcas rexistradas ST, consulte www.st.com/trademarks. Todos os outros nomes de produtos ou servizos son propiedade dos seus respectivos propietarios.
A información deste documento substitúe e substitúe a información proporcionada anteriormente en calquera versión anterior deste documento.

UM3088 – Rev 1 – febreiro de 2023
Para obter máis información, póñase en contacto coa oficina local de vendas de STMicroelectronics.
www.st.com
© 2023 STMicroelectronics – Todos os dereitos reservados

Documentos/Recursos

	Conxunto de ferramentas de liña de comandos ST STM32Cube [pdfManual do usuario UM3088, STM32Cube Conxunto de ferramentas de liña de comandos, STM32Cube, Conxunto de ferramentas de liña de comandos, Conxunto de ferramentas
	Conxunto de ferramentas de liña de comandos ST STM32Cube [pdfManual do propietario RN0132, STM32Cube Conxunto de ferramentas de liña de comandos, STM32Cube, Conxunto de ferramentas de liña de comandos, Conxunto de ferramentas de liña, Conxunto de ferramentas

Referencias

• Manual de usuario