Failed uploading: no upload port provided? Como resolver o erro de carregamento no Arduino

O código não carrega no Arduino e aparece um erro vermelho do avrdude na janela de saída? Calma: quase nenhum desses problemas significa placa queimada. Eles vêm de um cabo USB que só carrega, um driver CH340 faltando, a placa ou a porta errada, um módulo ligado nos pinos 0 e 1, ou outro programa ocupando a porta. Confira as coisas na ordem certa e normalmente você resolve em poucos minutos; e mesmo que a placa esteja mesmo com defeito, existe um jeito simples de provar isso.

Neste guia, você vai ver primeiro o que acontece nos bastidores durante um carregamento e como ler a mensagem de erro. Depois, estreitamos o problema passo a passo com uma tabela de diagnóstico de sintoma, causa e solução. Também tratamos da configuração ATmega328P (Old Bootloader) no Arduino Nano, do Monitor Serial e de outros programas que travam a porta, do erro Failed to connect do ESP32 e o botão BOOT, e do método BOOTSEL e UF2 no Raspberry Pi Pico. Cada seção tem um sketch de teste curto para você conferir a placa depois que o problema for resolvido.

Como o carregamento funciona: erro de compilação ou erro de carregamento?

Quando você clica em Carregar, acontecem duas coisas separadas. Primeiro a IDE compila o seu código; se der certo, a janela de saída mostra uma linha dizendo quantos bytes o sketch usa (Sketch uses 924 bytes). Depois, um programa chamado avrdude abre a porta que você selecionou, reinicia a placa com o sinal DTR e faz o aperto de mão (handshake) com o pequeno programa carregador que fica dentro da placa, o bootloader. Depois de um reset, o bootloader escuta por apenas cerca de um segundo; se nenhum dado chegar, o programa antigo da placa continua rodando. A mensagem de erro diz qual elo dessa corrente se rompeu. Se o texto vermelho aparece durante a compilação, o problema está no seu código e não tem nada a ver com a placa ou com o cabo.

Os erros mais comuns do avrdude e o que significam

Tabela de diagnóstico passo a passo: sintoma, causa, solução

Leia a tabela de cima para baixo; as primeiras linhas são os problemas mais comuns e os mais fáceis de resolver. Tente carregar de novo depois de cada mudança. Se você mudar várias coisas de uma vez, nunca vai saber qual delas resolveu, e o mesmo erro vai pegar você de novo na próxima vez.

Checklist rápido e sketch de teste de carregamento

1. Tire tudo da placa: shields, módulos e os fios dos pinos 0 e 1. Deixe só o cabo USB conectado.
2. Conecte a placa direto em uma porta USB na parte de trás do computador; evite hubs, extensões e as portas do painel frontal.
3. Abra Ferramentas > Porta e olhe a lista. Desconecte e reconecte a placa e anote qual porta some e volta. Se a lista nunca muda, o problema é o cabo ou o driver.
4. Selecione o modelo exato da sua placa em Ferramentas > Placa; em um Nano, escolha também o bootloader certo em Ferramentas > Processador.
5. Garanta que nenhum outro programa ou segunda janela da IDE esteja usando a porta; na dúvida, feche todos.
6. Ative a saída detalhada do carregamento e carregue o pequeno sketch de teste abaixo. Testar com um código que você sabe que não tem erro descarta problemas de compilação.
7. Continua falhando? Aperte o botão de reset: se o LED L piscar rápido uma ou algumas vezes, o bootloader está vivo. Então passe para o teste de loopback abaixo.
8. Experimente outro computador ou outra placa. Se o problema acompanha a placa, ele está na placa; se fica no computador, está no driver ou nas configurações do sistema operacional.

1// Yükleme testi: LED yanıp söner, sayaç yazılır / Upload test: blinks the LED, prints a counter
2unsigned long sayac = 0;   // çalışma sayacı / run counter
3
4void setup() {
5  pinMode(LED_BUILTIN, OUTPUT);   // Uno ve Nano'da pin 13 / pin 13 on Uno and Nano
6  Serial.begin(9600);
7  Serial.println("Yukleme basarili / Upload OK");
8}
9
10void loop() {
11  digitalWrite(LED_BUILTIN, HIGH);
12  delay(200);                     // yanma süresi: değiştirip tekrar yükle / on time: change it and re-upload
13  digitalWrite(LED_BUILTIN, LOW);
14  delay(800);
15  Serial.println(sayac++);        // Seri Monitör 9600 baud / Serial Monitor at 9600 baud
16}

Se o carregamento deu certo, o LED L pisca rapidinho e fica apagado por mais tempo, e o contador sobe quando você abre o Monitor Serial em 9600 baud. Para ter certeza de que o código novo chegou mesmo à placa, mude delay(200) para delay(50) e carregue de novo: se o ritmo da piscada não mudar, o programa antigo ainda está rodando. Se você vir caracteres estranhos no Monitor Serial, o baud rate do Monitor Serial não bate com o do código; isso não é um erro de carregamento.

A porta COM não aparece: cabo USB e drivers CH340 e CP2102

Se o menu de portas está cinza ou vazio, o cabo é o primeiro suspeito. Muitos cabos finos que vêm com carregadores de celular só têm os dois fios de energia; os fios de dados D+ e D- simplesmente não existem. Com um cabo assim, o LED de energia da placa acende, o que engana, mas o computador não vê nenhum dispositivo e nem toca o som de conexão. Teste o cabo transferindo arquivos para um celular ou com outra placa que você sabe que funciona. O cabo grosso tipo B do Uno raramente tem esse problema; ele é muito comum com o mini USB do Nano e com os cabos micro USB ou USB-C das placas ESP32 e Pico.

Se o cabo está bom, o driver é o segundo suspeito. Leia o texto do chip ao lado do conector USB: as placas Arduino Uno e Mega originais usam um ATmega16U2, as placas Uno e Nano clone, na maioria, um CH340G ou CH340C, e as placas de desenvolvimento ESP32 normalmente um CP2102 ou CH340. No Windows, abra o Gerenciador de Dispositivos: se a placa for reconhecida, ela aparece em Portas (COM e LPT). Se você vir USB2.0-Serial com um ponto de exclamação amarelo em Outros dispositivos, está faltando o driver CH340.

O Windows 10 e o 11 normalmente instalam sozinhos os drivers CH340 e CP2102 pelo Windows Update. Se não instalarem, baixe o driver CH341SER para o CH340 ou o driver CP210x VCP para o CP2102 no site do fabricante do chip, instale e depois desconecte e reconecte a placa. As versões atuais do macOS já trazem drivers para os dois chips; empilhar drivers antigos de fontes diferentes costuma piorar as coisas. No Linux, os drivers já estão no kernel, mas para usar a porta você precisa adicionar o seu usuário ao grupo dialout (sudo usermod -a -G dialout $USER) e sair e entrar de novo na sessão; senão, aparece o erro Permission denied. Se a porta some logo depois de conectar uma placa CH340 no Ubuntu 22.04 ou mais novo, o culpado normalmente é o pacote leitor de tela brltty; se você não usa, remova-o com sudo apt remove brltty.

Placa, processador ou porta errados

Na Arduino IDE 2, você seleciona a placa e a porta na lista suspensa da barra superior ou nos menus Ferramentas > Placa e Ferramentas > Porta. No Windows, você pode ver na lista a COM1 ou algumas portas Bluetooth virtuais; o jeito mais fácil de achar a certa é desconectar a placa e ver qual porta some. Se o modelo errado estiver selecionado no menu de placas, como Mega em vez de Uno ou Leonardo em vez de Nano, o avrdude ou não recebe resposta nenhuma ou vê um ID de chip inesperado na linha Device signature. Mais uma coisa: use Ctrl+U para um carregamento normal. Sketch > Carregar usando programador espera um programador ISP externo e, se der certo, apaga o bootloader da placa; depois disso, a placa não aceita mais carregamentos pela USB.

Arduino Nano não carrega: ATmega328P (Old Bootloader)

A maioria das placas Nano baratas no mercado são clones com CH340, e muitas delas ainda têm o bootloader antigo. No início de 2018, a Arduino trocou o bootloader do Nano pelo Optiboot, menor e mais rápido, usado no Uno, e desde então a opção padrão ATmega328P da IDE conversa a 115200 baud. O bootloader antigo espera 57600 baud. Quando as velocidades não batem, a placa parece não responder e o erro not in sync: resp=0x00 se repete por dez tentativas. A solução é uma única configuração de menu: Ferramentas > Processador > ATmega328P (Old Bootloader). Se você não tem certeza de qual é a certa, teste as opções uma depois da outra; uma escolha errada não faz mal nenhum à placa.

Módulos nos pinos 0 e 1 bloqueiam o carregamento

No Uno e no Nano, o chip USB-serial é ligado ao ATmega328P através de resistores de 1 kΩ nos pinos D0 (RX) e D1 (TX). Durante um carregamento, essa linha pertence ao computador. Se um módulo serial, como um módulo Bluetooth HC-05, um GPS, um ESP-01 ou um sensor de impressão digital, estiver ligado nesses pinos, ele ou manda os próprios dados para a linha ou a segura em um nível fixo, e atrapalha o handshake do bootloader. O resultado é de novo programmer is not responding ou not in sync. A solução mais rápida é desconectar os fios do D0 e do D1 durante o carregamento; a solução definitiva é passar o módulo para outros pinos com SoftwareSerial:

1#include <SoftwareSerial.h>
2
3// HC-05 TX -> D10, HC-05 RX <- D11 (gerilim bölücüyle / through a voltage divider)
4SoftwareSerial bt(10, 11);   // RX, TX pinleri / RX, TX pins
5
6void setup() {
7  Serial.begin(9600);        // USB: Seri Monitör / USB: Serial Monitor
8  bt.begin(9600);            // HC-05 veri modu hızı / HC-05 data mode baud rate
9  Serial.println("Hazir / Ready");
10}
11
12void loop() {
13  if (bt.available()) Serial.write(bt.read());      // telefondan bilgisayara / phone to PC
14  if (Serial.available()) bt.write(Serial.read());  // bilgisayardan telefona / PC to phone
15}

Neste sketch, o TX do HC-05 vai no D10 e o RX no D11. A entrada RX do HC-05 funciona com 3,3 V, então coloque um divisor de tensão feito com resistores de 1 kΩ e 2 kΩ entre ela e o D11. Agora você pode carregar com o módulo conectado e enviar para o celular o que digitar no Monitor Serial. Para a ligação completa e o modo de comandos AT, veja o guia do módulo Bluetooth HC-05. Em um Mega, você não precisa de SoftwareSerial: a placa tem portas seriais de hardware extras, como a Serial1 (TX1 = D18, RX1 = D19).

O Monitor Serial e os programas que ocupam a porta

Uma porta serial só pode ser aberta por um programa de cada vez. É por isso que o Windows mostra Access is denied e o macOS e o Linux mostram Resource busy. A Arduino IDE normalmente pausa o próprio Monitor Serial durante um carregamento, mas isso não funciona perfeitamente em todas as versões e com todas as placas, principalmente o ESP32; se aparecer o erro, feche primeiro a aba do Monitor Serial. Com mais frequência, a porta está presa em outra coisa: uma segunda janela da IDE, um Plotter Serial aberto, o PuTTY, um software de impressora 3D como o Cura, o monitor do PlatformIO no VS Code ou um script Python rodando em segundo plano. Feche-os, desconecte e reconecte a placa e tente de novo. No Linux, você vê qual programa está segurando a porta com sudo lsof /dev/ttyUSB0.

A placa está queimada? Teste de loopback e gravação do bootloader

Se você tentou tudo acima e ainda não carrega, precisa descobrir se o problema está no lado da USB ou no processador principal. O método clássico para o Uno e o Nano é o teste de loopback: você mantém o processador principal em reset e deixa o chip USB-serial conversar consigo mesmo. Você não precisa carregar nenhum código para esse teste.

1. Tire todos os fios da placa e deixe só o cabo USB conectado.
2. Use um jumper para ligar o pino RESET ao GND; isso mantém o ATmega328P em reset, fora da linha.
3. Use um segundo fio para ligar os pinos D0 e D1 entre si.
4. Selecione a porta da placa na IDE e abra o Monitor Serial; o baud rate não importa para esse teste.
5. Digite alguns caracteres na caixa e envie. Se o seu texto voltar na hora, o cabo, o driver e o chip USB-serial estão bons, e o problema está no processador principal ou no bootloader. Se nada voltar, o problema está no lado da USB.
6. Não se esqueça de tirar os dois fios quando terminar.

Se o teste de loopback passa, mas os carregamentos continuam falhando, e o LED L não pisca rapidinho quando você aperta o reset, o bootloader pode ter sido apagado ou o chip substituído. Você pode gravar o bootloader de novo com um segundo Uno. Carregue Arquivo > Exemplos > 11.ArduinoISP > ArduinoISP no Uno que vai funcionar como programador. Depois, ligue o D10 do programador ao pino RESET da placa de destino, o D11, o D12 e o D13 aos pinos de mesmo número da placa de destino, e o 5V e o GND um ao outro. Coloque um capacitor de 10 µF entre o RESET e o GND do Uno programador; isso impede que ele se reinicie sozinho. Por fim, selecione Ferramentas > Programador > Arduino as ISP, escolha a placa de destino no menu de placas e execute Ferramentas > Gravar bootloader. Você também pode usar esse método para colocar o Optiboot novo em um Nano clone.

ESP32 não carrega: Failed to connect e o botão BOOT

No ESP32, o carregamento é feito pelo esptool, e não pelo avrdude. A saída mostra primeiro uma linha Connecting........_____..... enquanto o esptool tenta colocar a placa no modo de download. Se não conseguir, aparece um erro que começa com A fatal error occurred: Failed to connect to ESP32. Nas versões atuais do esptool, se a placa iniciou normalmente, a mensagem continua com Wrong boot mode detected (0x13)! The chip needs to be in download mode.; 0x13 significa que a placa iniciou no modo de boot normal em vez do modo de download. Se a placa não responde nada, a mensagem termina com No serial data received; as versões antigas mostram isso como Timed out waiting for packet header. Se a placa não consegue entrar no modo de download sozinha, você faz isso à mão.

1. Clique em Carregar na IDE e observe a janela de saída.
2. Assim que aparecer Connecting..., aperte e segure o botão BOOT da placa.
3. Se ainda não conectar, aperte e solte rapidamente o EN uma vez enquanto segura o BOOT.
4. Solte o BOOT quando as linhas que começam com Writing at e a porcentagem do carregamento começarem a rolar na saída.
5. O carregamento termina com Hard resetting via RTS pin.... Se o programa não iniciar, aperte o EN uma vez.

Por que isso acontece? Para entrar no modo de download, o pino GPIO0 do ESP32 precisa estar em LOW no momento em que ele inicia. O circuito de reset automático com dois transistores das placas de desenvolvimento faz isso sozinho com os sinais DTR e RTS do chip USB; em placas baratas, o circuito pode errar o tempo. Se você está cansado de apertar o BOOT toda vez, existe uma solução definitiva: ligue um capacitor eletrolítico de 10 µF entre o pino EN e o GND da placa (terminal negativo no GND). O capacitor deixa mais lenta a subida da linha EN e dá tempo para o circuito de reset automático segurar o GPIO0 em LOW.

1// ESP32 yükleme testi / ESP32 upload test
2const int LED_PIN = 2;   // birçok DevKit kartında dahili LED / onboard LED on many DevKit boards
3
4void setup() {
5  pinMode(LED_PIN, OUTPUT);
6  Serial.begin(115200);   // Seri Monitör 115200 baud / Serial Monitor at 115200 baud
7  delay(500);
8  Serial.print("Model: ");
9  Serial.println(ESP.getChipModel());                 // ör. ESP32-D0WD-V3 / e.g. ESP32-D0WD-V3
10  Serial.print("Flash (MB): ");
11  Serial.println(ESP.getFlashChipSize() / (1024 * 1024));
12  Serial.print("CPU (MHz): ");
13  Serial.println(getCpuFrequencyMhz());
14}
15
16void loop() {
17  digitalWrite(LED_PIN, !digitalRead(LED_PIN));   // LED'i tersle / toggle the LED
18  delay(500);
19}

Raspberry Pi Pico: carregando com BOOTSEL e UF2

O Pico não tem um chip USB-serial separado; o RP2040 tem o próprio controlador USB, e o bootloader fica na ROM do chip, que não pode ser apagada. Isso torna quase impossível "brickar" um Pico por software. Se você segurar o botão BOOTSEL enquanto conecta o cabo USB, o Pico aparece no computador como um pen drive chamado RPI-RP2 (no Pico 2, a unidade se chama RP2350). Qualquer arquivo .uf2 que você arrastar para essa unidade é gravado na placa, que depois reinicia sozinha; é assim também que você instala o MicroPython.

Se você programa o Pico com a Arduino IDE, ainda não existe porta COM no primeiro carregamento; conecte a placa segurando o BOOTSEL e clique em Carregar. Depois do primeiro sketch, a placa abre uma porta serial e os carregamentos seguintes não precisam do BOOTSEL. Se o seu código travar ou desligar a USB, a porta some de novo e aparece o erro No drive to deploy; aí volte para o método do BOOTSEL. Se você usa MicroPython, MicroPython (Raspberry Pi Pico) precisa estar selecionado como interpretador no canto inferior direito do Thonny. Para os pinos e a configuração do Pico, veja o guia O que é Raspberry Pi Pico?

1import time
2from machine import Pin
3
4time.sleep(3)   # açılışta 3 sn bekle, Thonny durdurabilsin / wait 3 s so Thonny can stop the script
5
6led = Pin("LED", Pin.OUT)   # Pico ve Pico W dahili LED / onboard LED on Pico and Pico W
7sayac = 0
8while True:
9    led.toggle()
10    print("Calisiyor / running", sayac)
11    sayac += 1
12    time.sleep(0.5)

Causas pequenas, mas traiçoeiras, fáceis de deixar passar

• Leonardo, Micro e Uno R4: nessas placas com USB nativa, a porta pode mudar por um instante durante o carregamento. Se o carregamento travar, clique em Carregar e aperte o botão de reset uma vez assim que a compilação terminar e a etapa de carregamento começar (duas vezes rápido no Uno R4); a placa espera um pouco no bootloader e o código é carregado nesse momento.
• Reset automático com defeito: se o reset automático não funciona em um Uno ou Nano, segure o botão de reset, clique em Carregar e solte assim que a linha com o tamanho do sketch aparecer na saída.
• Shields e circuitos externos: um shield de driver de motor ou um circuito que sobrecarrega a linha de 5V pode fazer a tensão de alimentação cair durante o carregamento e cortar a gravação no meio.
• Porta errada no macOS: /dev/cu.Bluetooth-Incoming-Port e /dev/cu.debug-console na lista de portas não são a sua placa, e sim portas do sistema. O nome da porta da sua placa contém usbmodem, usbserial ou wchusbserial; se não tiver certeza, desconecte e reconecte a placa e veja qual some.
• Caracteres não ASCII no nome de usuário: se a sua pasta de usuário do Windows tem letras acentuadas ou não latinas, as ferramentas de compilação e carregamento de alguns pacotes de placas, principalmente o do ESP32, podem não encontrar os arquivos. Mude o seu sketchbook para um caminho sem esses caracteres em Preferências; se o problema continuar, crie um novo usuário no Windows.
• Sketch grande demais: o aviso Sketch too big não é um erro de carregamento; ele diz que o seu código não cabe nos cerca de 31,5 KB de flash que sobram no Uno depois do bootloader. Enxugue bibliotecas e textos longos ou passe para uma placa maior.
• Porta travada depois da suspensão: depois que o computador sai da suspensão, a porta pode travar; reiniciar a IDE ou conectar a placa em outra porta USB costuma resolver.

O carregamento funciona: e agora?

• Primeiro circuito: monte o seu próprio circuito Blink com um LED e um resistor e depois acrescente um botão para o seu primeiro projeto interativo.
• Comunicação serial: agora que você sabe como os pinos 0 e 1 afetam o carregamento, experimente acender um LED pelo celular com o módulo Bluetooth HC-05.
• Lendo sensores: use o guia de sensores para Arduino para escolher os seus primeiros projetos que medem temperatura, distância e luz.
• Sem fio: monte com o ESP32 um projeto que se conecta ao Wi-Fi e é controlado pelo celular; graças ao OTA, depois você também pode carregar o código sem fio.
• Escolhendo a placa certa: se você não consegue decidir entre Uno, Nano e Mega, leia Qual Arduino comprar?.

Os erros de carregamento irritam na primeira vez que você os encontra, mas cada um tem uma causa lógica, e quase todos são achados na mesma ordem: cabo, driver, porta, configurações da placa, linha serial e, por fim, o bootloader. Guarde essa ordem e você vai resolver o próximo erro em minutos. Quando a sua placa aceitar código, o app BlueGrays tem muitos projetos para Arduino, ESP32 e Raspberry Pi Pico, de piscar um LED a Wi-Fi e atualizações OTA sem fio, cada um com esquema do circuito passo a passo e código pronto, para você colocar a placa para trabalhar na hora.