UM3088
Guia de início rápido do conjunto de ferramentas de linha de comando STM32Cube
Manual do usuário

Introdução

Este documento é um breve guia para os usuários começarem rapidamente a usar o STM32CubeCLT, o conjunto de ferramentas de linha de comando STMicroelectronics para MCUs STM32.
O STM32CubeCLT oferece todos os recursos do STM32CubeIDE empacotados para uso de prompt de comando por IDEs de terceiros ou integração contínua e desenvolvimento contínuo (CD/CI).

O pacote STM32CubeCLT simples simplificado inclui:

• Versões CLI (interface de linha de comando) de ferramentas ST como cadeia de ferramentas, utilitário de conexão de sonda e utilitário de programação de memória flash
• Sistema atualizado view descritor (SVD) files
• Qualquer outro metadado relevante do IDE STM32CubeCLT permite:
• Construindo um programa para dispositivos STM32 MCU usando uma cadeia de ferramentas GNU aprimorada para STM32
• Programação de memórias internas do STM32 MCU (memória flash, RAM, OTP e outras) e memórias externas
• Verificação do conteúdo da programação (checksum, verificação durante e após a programação, comparação com file)
• Automatizando a programação STM32 MCU
• Aplicativos de depuração por meio da interface dos produtos STM32 MCU, que fornece acesso aos recursos internos do MCU usando recursos básicos de depuração

informações gerais

O conjunto de ferramentas de linha de comando STM32CubeCLT para MCUs STM32 fornece ferramentas para construir, programar, executar e depurar aplicativos destinados a microcontroladores STM32 baseados no processador Arm® Cortex® ‑M.
Observação:
Arm é uma marca registrada da Arm Limited (ou de suas subsidiárias) nos Estados Unidos e / ou em outro lugar.

Documentos de referência

• Conjunto de ferramentas de linha de comando para MCUs STM32 (DB4839), resumo de dados STM32CubeCLT
• Guia de instalação do STM32CubeCLT (UM3089)
• Nota de lançamento do STM32CubeCLT (RN0132)

Capturas de tela neste documento
As capturas de tela fornecidas na Seção 2, Seção 3 e Seção 4 são apenas examparquivos de uso da ferramenta em um prompt de comando.
A integração em IDEs de terceiros ou o uso em scripts de CD/CI não é ilustrado neste documento.

Prédio

O pacote STM32CubeCLT contém as ferramentas GNU para a cadeia de ferramentas STM32 para construir um programa para um microcontrolador STM32. Uma janela de console do Windows® exampO arquivo é mostrado na Figura 1.

1. Abra um console na pasta do projeto.
2. Execute o seguinte comando para construir o projeto: > make -j8 all -C .\Debug

Observação: O utilitário make pode exigir uma etapa de instalação separada.

programação da placa

O pacote STM32CubeCLT contém o STM32CubeProgrammer (STM32CubeProg), que é usado para programar a compilação obtida anteriormente no microcontrolador STM32 de destino.

1. Certifique-se de que a conexão ST-LINK foi detectada
2. Selecione o local da pasta do projeto na janela do console
3. Opcionalmente, apague todo o conteúdo da memória flash (consulte a Figura 2): > STM32_Programmer_CLI.exe -c port=SWD freq=4000 -e all
4. Carregue o programa file para o endereço de memória flash 0x08000000 (consulte a Figura 3): > STM32_Programmer_CLI.exe -c port=SWD freq=4000 -w .\Debug\YOUR_PROGRAM.elf 0x08000000

Depuração

Além das ferramentas GNU para a cadeia de ferramentas STM32, o pacote STM32CubeCLT também contém o servidor ST-LINK GDB. Ambos são necessários para iniciar uma sessão de depuração.

1. Inicie o servidor ST-LINK GDB em outra janela do 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 cadeia de ferramentas STM32 para iniciar o cliente GDB na janela do PowerShell®:
   > arm-none-eabi-gdb.exe
   > (gdb) target remote localhost:port (use a porta indicada na conexão aberta do servidor GDB)
   A conexão é estabelecida e as mensagens de sessão do servidor GDB são exibidas conforme mostrado na Figura 5. É então possível executar comandos GDB na sessão de depuração, por exemplo, para recarregar um programa .elf usando GDB: > (gdb) load YOUR_PROGRAM.elf

Histórico de revisão

Tabela 1. Histórico de revisão do documento

AVISO IMPORTANTE – LEIA COM ATENÇÃO
A STMicroelectronics NV e suas subsidiárias (“ST”) reservam-se o direito de fazer alterações, correções, aprimoramentos, modificações e melhorias nos produtos ST e/ou neste documento a qualquer momento, sem aviso prévio. Os compradores devem obter as informações relevantes mais recentes sobre os produtos ST antes de fazer pedidos. Os produtos ST são vendidos de acordo com os termos e condições de venda da ST em vigor no momento do reconhecimento do pedido.
Os compradores são os únicos responsáveis ​​pela escolha, seleção e uso dos produtos ST e a ST não assume nenhuma responsabilidade pela assistência na aplicação ou pelo design dos produtos dos compradores.
Nenhuma licença, expressa ou implícita, para qualquer direito de propriedade intelectual é concedida pela ST aqui.
A revenda de produtos ST com disposições diferentes das informações aqui estabelecidas anulará qualquer garantia concedida pela ST para tal produto.
ST e o logotipo ST são marcas registradas da ST. Para obter informações adicionais sobre as marcas registradas da ST, consulte www.st.com/trademarks. Todos os outros nomes de produtos ou serviços são propriedade de seus respectivos proprietários.
As informações neste documento substituem e substituem informações fornecidas anteriormente em quaisquer versões anteriores deste documento.

UM3088 - Rev 1 - fevereiro de 2023
Para obter mais informações, entre em contato com o escritório de vendas local da STMicroelectronics.
www.st.com
© 2023 STMicroelectronics – Todos os direitos reservados

Documentos / Recursos

	Conjunto de ferramentas de linha de comando ST STM32Cube [pdf] Manual do Usuário UM3088, conjunto de ferramentas de linha de comando STM32Cube, STM32Cube, conjunto de ferramentas de linha de comando, conjunto de ferramentas
	Conjunto de ferramentas de linha de comando ST STM32Cube [pdf] Manual do Proprietário RN0132, Conjunto de ferramentas de linha de comando STM32Cube, STM32Cube, Conjunto de ferramentas de linha de comando, Conjunto de ferramentas de linha, Conjunto de ferramentas

Referências

• Manual do usuário