stlink

Versão de código aberto das ferramentas STMicroelectronics STLINK

Novos recursos e correções de bugs recentes podem ser encontrados no Changelog deste projeto de software.

Licença

A biblioteca e as ferramentas stlink são licenciadas sob a licença BSD-3 .

Introdução

stlink é um conjunto de ferramentas de código aberto para programar e depurar dispositivos e placas STM32 fabricados pela STMicroelectronics. Ele suporta várias placas programadoras chamadas STLINK (e seus clones) que usam um chip microcontrolador para traduzir comandos de USB para JTAG/SWD. Existem quatro gerações disponíveis no mercado, todas suportadas por este conjunto de ferramentas:

• STLINK/V1 [obsoleto em 21/11/2019, suporte contínuo por este conjunto de ferramentas]
  • camada de transporte: comandos SCSI passthru via USB
  • programador autônomo
  • integrado nas placas Discovery STM32VL
• STLINK/V2
  • camada de transporte: comandos USB brutos
  • programador autônomo
  • integrado nas placas STM32L Discovery e STM32 Nucleo
• STLINK/V2-1
  • camada de transporte: comandos USB brutos
  • integrado em algumas placas STM32 Nucleo
• STLINK-V3
  • camada de transporte: comandos USB brutos
  • programador autônomo (STLINK-V3SET, STLINK-V3MINI, STLINK-V3MODS)
  • integrado em algumas placas STM32 Nucleo (STLINK-V3E)

No nível do usuário não há diferença no manuseio ou operação entre essas diferentes revisões.

O conjunto de ferramentas STlink inclui:

• st-info - uma ferramenta de informação para programadores e chips
• st-flash - uma ferramenta de manipulação de flash
• st-trace - uma ferramenta de log para registrar informações sobre execução
• st-util - um servidor GDB (suportado no Visual Studio Code/VSCodium por meio do plugin Cortex-Debug)
• stlink-lib - uma biblioteca de comunicação
• stlink-gui - uma interface GUI [opcional]

Sistemas operacionais e combinações de hardware compatíveis

Os alvos MCU em funcionamento atualmente conhecidos estão listados em support_devices.md.

Uma lista de operações suportadas pode ser encontrada em version_support.md.

Tutorial e COMO FAZER

Nosso tutorial pode ajudá-lo com algumas tarefas avançadas e informações adicionais.

Instalação

Janelas :

A partir da versão v1.6.1, os binários autônomos do Windows são disponibilizados (novamente) na página de lançamento do projeto. Certifique-se de selecionar a versão correta para o seu sistema (i686 ou x86_64). O arquivo compactado pode ser descompactado em qualquer local desejado, pois não contém nenhum caminho codificado. No entanto, sugerimos mover a pasta do aplicativo descompactado para C:Program Files em sistemas de 32 bits e para C:Program Files (x86) em sistemas de 64 bits (o conjunto de ferramentas é de 32 bits).

Alternativamente, pode-se compilar e instalar a partir do código-fonte, conforme descrito em nosso manual de compilação.

Linux/Unix :

Recomendamos instalar stlink-tools do repositório de pacotes da distribuição usada:

Nota: Como os pacotes distribuídos através dos repositórios Debian e Ubuntu diferem do nosso pacote deb automantido, recomendamos usar o último (veja o link abaixo). Ele oferece a oportunidade de lidar e corrigir problemas de pacotes relatados pelo usuário diretamente no projeto e não é redundante a quaisquer limitações decorrentes de diretrizes de manutenção externas.

• Debian Linux: (Link)
• UbuntuLinux: (Link)
• Arch Linux: (Link)
• Alpine Linux: (Link)
• Fedora: (Link)
• FreeBSD: os usuários podem instalar a partir do Freshports

macOS :

O suporte para macOS foi eliminado com a v1.8.0.

Use a versão 1.7.0, mas observe que esta versão não é mais mantida e suportada!

Instalação a partir da fonte (usuários avançados)

Quando não há nenhum executável disponível para sua plataforma ou você precisa da versão mais recente (possivelmente instável), você mesmo precisa compilar o conjunto de ferramentas. Este procedimento é explicado no manual de compilação.

Contribuição e versionamento

• O esquema de versionamento semântico é usado. Leia mais em semver.org
• Antes de criar uma solicitação pull, SEMPRE abra um novo problema para a discussão dos novos recursos pretendidos. As correções de bugs não requerem discussão por meio de um ticket. No entanto, devem sempre ser descritos em poucas palavras, assim que pareçam ajudar também os outros.
• Colaboradores e/ou mantenedores podem enviar comentários ou solicitar alterações em propostas de patch e/ou solicitações pull.
• ATENÇÃO: NUNCA use o caractere '#' para contar pontos únicos em uma listagem, pois '#' é reservado exclusivamente para fazer referência a problemas e solicitações pull do GitHub. Caso contrário, você acidentalmente introduzirá referências cruzadas falsas no projeto.
• Inicie novos forks a partir do branch de desenvolvimento, pois as solicitações pull também irão para esse branch.

Consulte também nossas Diretrizes de Contribuição.

Avaliações de usuários

Espero que não esteja fora de questão, mas estou tão frustrado com coisas relacionadas ao AVR no OpenBSD que o fato de o stlink ter sido construído imediatamente sem a necessidade de tocar em nada foi tão aliviante. Literalmente tornou todo o meu fim de semana melhor! Acredito que seja um agradecimento ao @Crest e também à equipe stlink-org (@ Nightwalker-87 e @ xor-gate, ao que parece) por terem criado um software que não é hostil aos sistemas operacionais "marginais". Obrigado <3" - nbonfils, 11/12/2021