O ST-Link V2 é a sonda que grava e depura microcontroladores STM32 por quatro fios. Para ele funcionar você precisa de duas coisas — o driver USB oficial e o STM32CubeProgrammer —, e quase todo problema de “não detecta” nasce de instalar essas duas coisas na ordem errada.
Aqui estão os links oficiais, a instalação nos três sistemas, as ligações que a sonda precisa ver na placa e os cinco erros mais comuns, cada um com a fonte da correção. Última verificação: 15 de setembro de 2026.
O que é o ST-Link V2 e o que ele precisa para funcionar
O ST-Link V2 é um programador e depurador: conversa com o microcontrolador por SWD (dois fios de dados) ou JTAG, grava a flash, lê, apaga e ainda permite parar o processador para depurar o programa rodando — a ponte entre o seu computador e o chip, assunto de memórias da placa: BIOS, firmware, EEPROM e RAM.
Do lado do computador são dois pacotes distintos, e é aqui que mora a confusão: o STSW-LINK009, que é o driver USB e faz o Windows reconhecer a sonda, e o STM32CubeProgrammer, que é o programa que de fato grava o chip.
Há uma regra de ordem que a própria ST escreve no documento do driver e quase ninguém lê. No data brief DB2694 (revisão 5, janeiro de 2025), a frase é literal: “instalar o driver antes de conectar os dispositivos ST-LINK/V2 ou ST-LINK/V2-1 é obrigatório para uma enumeração bem-sucedida”. Para a sonda STLINK-V3 é opcional — serve só para personalizar o nome das portas COM virtuais. Ou seja: no V2, driver primeiro, cabo depois.
Download oficial: os quatro pacotes e onde baixar cada um
Todos os links abaixo apontam para a página do fabricante. Não hospedamos nenhum desses arquivos aqui — o software da ST é distribuído sob a licença SLA0048, com aceite obrigatório no download, e cópia em site de terceiros é por onde entra instalador adulterado.
| Pacote | Para que serve | Versão / data | Sistemas |
|---|---|---|---|
| STSW-LINK009 | Driver USB da sonda | 2.0.2 | Windows 10 e 11 |
| STM32CubeProgrammer | Gravar, ler, apagar e configurar option bytes | 2.23.0 — 1º/7/2026 | Windows, Linux, macOS |
| STSW-LINK007 | Atualizar o firmware da própria sonda | DB2647 rev 3 | Executável Windows + app Java |
| stlink (open source) | Gravar por linha de comando, fora do ecossistema ST | 1.8.0 — 1º/2/2024 | Linux, macOS, Windows |
A 2.23.0 foi anunciada pela ST em 1º de julho de 2026 no fórum oficial; a release note pública mais recente que consultamos, a RN0109 revisão 33 (fevereiro de 2026), ainda descreve a 2.22.0 — a documentação corre atrás do lançamento.
Como instalar, sistema por sistema
Um atalho antes dos passos: quem instala o CubeProgrammer não precisa baixar o driver separado. O manual do programa (UM2237, revisão 29, de novembro de 2025) diz que ele acompanha o pacote, na pasta Driver/stsw-link009_v3.
Windows 10 e 11
- Baixe o STM32CubeProgrammer na página oficial (é um .zip) e extraia.
- Antes de conectar o ST-Link, entre em
Driver/stsw-link009_v3e executestlink_winusb_install.batcomo administrador. - Execute o
SetupSTM32CubeProgrammer-vx.y.z.exe. - Agora sim conecte a sonda. No Gerenciador de Dispositivos deve aparecer o STMicroelectronics STLink dongle, sem triângulo amarelo.
Não é preciso instalar Java: desde a versão 2.6.0 o programa carrega o próprio ambiente embutido (a JRE Liberica 8.0.432, segundo o manual).
Linux
O manual lista como testados o Ubuntu 22.04 LTS, o 24.04 LTS e o Fedora 42. São três passos:
- Instale a libusb:
sudo apt-get install libusb-1.0-0-dev(no Fedora,sudo dnf install libusb1). A versão 1.0.12 ou superior é requisito. - Copie as regras de udev que vêm no pacote, na pasta
Driver/rules, para/etc/udev/rules.d/. Sem elas, a sonda não é acessível ao usuário comum. - Execute o
SetupSTM32CubeProgrammer-vx.y.z.linux.
macOS
Os sistemas declarados são macOS 15 (Sequoia) e macOS 26 (Tahoe), x86_64 e ARM — em Mac com chip Apple, o pacote x86_64 exige o Rosetta, que o próprio instalador resolve. Se o clique duplo no .app falhar, rode pelo terminal o executável dentro de Contents/MacOs.
As quatro ligações — e a que todo mundo esquece
Para gravar por SWD a ligação mínima é SWDIO, SWCLK, GND e VDD. O NRST é opcional, mas necessário para reset por hardware.
O fio que derruba a maioria dos iniciantes é o VDD. Ele não alimenta a placa: serve para a sonda confirmar que o alvo está energizado. Numa discussão do fórum oficial da ST resolvida em 19 de abril de 2024, o usuário tinha ligado RESET, SWCLK, SWDIO e GND e esquecido a referência de tensão. A resposta foi direta: “a função da conexão VAPP do ST-Link não é fornecer energia ao alvo, e sim permitir que o ST-Link detecte que o alvo está alimentado”. O desfecho do autor: “assim que tive a tensão do alvo em 3,79 V eu consegui conectar!”
Daí a regra prática: Target voltage em 0,00 V é problema elétrico — falta VDD, falta terra comum ou a placa não está ligada. Não adianta trocar de programa nem reinstalar driver; um multímetro nos 3,3 V resolve a dúvida em dez segundos.
A primeira conexão no CubeProgrammer
Abra o programa, escolha ST-LINK no seletor do canto superior direito e olhe o painel antes de clicar em Connect. Frequency vem em 4000 kHz no SWD e 9000 kHz no JTAG — cair para 1000 kHz ou menos resolve fiação longa e protoboard. Em Mode, o Normal reseta e para o chip, o Connect under reset captura o vetor de reset antes de qualquer instrução rodar e o Hot plug conecta sem parar o programa. E os dois campos de diagnóstico: Target voltage diz se a placa está viva, Firmware version traz o botão Firmware Upgrade da sonda.
Os cinco problemas mais comuns (e a correção)
1. “No ST-LINK detected” assim que você pluga. Na enorme maioria das vezes é a ordem invertida: o cabo entrou antes do driver. Rode o stlink_winusb_install.bat, desconecte e reconecte a sonda. É exatamente o cenário que o data brief da ST antecipa ao chamar a instalação prévia de obrigatória.
2. “Error: No STM32 target found!” com Target voltage em 0,00 V. É o caso do VDD descrito acima: falta a referência de tensão ou o terra comum. Confira também se a placa está mesmo alimentada — um cabo USB só de carga não entrega dados.
3. Conecta, cai logo em seguida, ou nem conecta com tudo ligado. Duas correções, nesta ordem: marque Connect under reset e baixe a frequência de SWD. Num tópico do fórum oficial de 30 de outubro de 2024, a recomendação de um moderador técnico da ST foi essa mesma — “garanta que está usando a versão mais recente do CubeProgrammer. Tente então conectar no modo ‘Connect Under Reset'”. O motivo está no manual: existe firmware que desabilita os pinos de depuração, e o único jeito de entrar é pegar o chip antes da primeira instrução.
4. No Linux a sonda não aparece, ou aparece só com sudo. Faltam as regras de udev de Driver/rules em /etc/udev/rules.d/ — o manual trata isso como parte da instalação, não como ajuste opcional.
5. O clone conecta no velho ST-Link Utility, mas não no CubeProgrammer. Esse é um caso à parte e merece a seção seguinte.
A parte que ninguém conta: o clone de vinte reais
A sonda azul de metal vendida por vinte e poucos reais grava um STM32 na maioria dos casos. Mas há um limite claro, e é melhor conhecê-lo antes de precisar dele.
A posição pública da ST é que seus recursos se dedicam a produtos genuínos e que ela não garante que clones funcionem com o firmware fornecido — e, como não existe binário oficial do firmware original distribuído avulso, um ST-Link clonado não tem caminho oficial de atualização. O botão Firmware Upgrade, que resolveria uma incompatibilidade com um chip novo, é justamente o que falta. Some-se a isso que o CubeProgrammer é mais rigoroso na validação que o antigo ST-Link Utility — daí o padrão relatado no fórum em outubro de 2024: funciona no programa velho, não no novo.
A saída barata e legítima não é comprar a sonda original de fábrica: toda placa STM32 Nucleo traz um ST-LINK/V2-1 verdadeiro embutido, separado do microcontrolador alvo por uma linha de corte. Você compra uma placa de desenvolvimento e leva junto uma sonda original, atualizável, com porta serial virtual inclusa.
Registro de honestidade: não temos relação comercial com a ST. A recomendação acima é só o que faríamos na nossa própria bancada.
Precisa de uma sonda ou de uma placa para começar?
As duas compras que cobrem os cenários deste guia:
Como Associados da Amazon, recebemos por compras qualificadas feitas pelos links acima — você não paga nada a mais por isso, e ajuda o site a continuar gratuito.
Perguntas frequentes
Preciso instalar Java para rodar o STM32CubeProgrammer? Não. Desde a versão 2.6.0 o programa usa um ambiente Java próprio, embutido no pacote, e ignora o que estiver instalado na máquina.
Instalei o CubeProgrammer. Ainda preciso baixar o STSW-LINK009? Não. O driver vem dentro do pacote, na pasta Driver/stsw-link009_v3. Baixe o avulso só se for usar a sonda com outro programa.
O driver funciona no Windows 7 ou 8? O data brief é honesto: o pacote traz os co-instaladores WinUSB para x86 e x64 do Windows 10 e 11 e registra que não foi testado no 7 nem no 8.
O ST-Link V2 grava memória serial 25xx, como o CH341A? Não — são mundos diferentes. O ST-Link fala SWD e JTAG com o microcontrolador; para flash SPI de BIOS e TV o instrumento é outro, como no guia do CH341A e no post sobre firmware de TV.
Vale a pena o clone, afinal? Para aprender e gravar projeto próprio, sim. Para trabalho profissional em que uma atualização de firmware da sonda pode ser necessária, não — e a Nucleo resolve pelo preço de uma placa.
Conclusão
Guarde as três regras que resolvem a maior parte dos chamados com ST-Link V2. Primeira: driver antes do cabo, porque a própria ST define a ordem como obrigatória. Segunda: Target voltage em 0,00 V é problema de fio, não de software. Terceira: quando conectar fica difícil, Connect under reset e frequência mais baixa antes de qualquer reinstalação.
No próximo guia seguimos pelo outro programador clássico do técnico brasileiro — o PICkit e o MPLAB IPE, do lado Microchip da prateleira.
Veja também
- Driver CH340: download e instalação no Windows — o conversor USB-serial mais comum das placas de desenvolvimento.
- CP210x: porta COM não aparece ou está “em uso” — o mesmo tipo de caça ao erro, do lado da porta serial.
- Clock, reset e enable: os sinais que acordam a placa — por que o reset é tão decisivo na hora de conectar uma sonda.
Se o seu interesse não é só gravar o chip, mas entender o que existe em volta dele numa placa desconhecida, o Mapa da Placa é o nosso material de leitura de placa — vale conhecer se você repara equipamento e quer parar de trocar peça no escuro.
