Error al subir código a Arduino: avrdude, puerto COM y drivers

¿Tu Arduino no sube el código y en la ventana de salida aparece un error rojo de avrdude? Tranquilo: casi nunca significa que la placa esté rota. Lo normal es que la culpa sea de un cable USB que solo carga, un driver CH340 que falta, la placa o el puerto equivocados, un módulo conectado a los pines 0 y 1 u otro programa que tiene ocupado el puerto. Si revisas las cosas en el orden correcto, casi siempre lo resolverás en pocos minutos; e incluso si la placa está realmente averiada, hay una forma sencilla de comprobarlo.

En esta guía verás primero qué pasa por dentro durante la carga y cómo leer el mensaje de error. Después acotaremos el problema paso a paso con una tabla de diagnóstico de síntoma, causa y solución. También tratamos el ajuste ATmega328P (Old Bootloader) del Arduino Nano, el Monitor Serie y otros programas que bloquean el puerto, el error Failed to connect del ESP32 y el botón BOOT, y el método BOOTSEL y UF2 de la Raspberry Pi Pico. Cada sección incluye un pequeño sketch de prueba para comprobar tu placa cuando hayas solucionado el problema.

Cómo funciona la carga: ¿error de compilación o error de subida?

Cuando pulsas Cargar ocurren dos cosas distintas. Primero el IDE compila tu código; si todo va bien, la ventana de salida muestra una línea con los bytes que ocupa el sketch (en la interfaz en inglés, Sketch uses 924 bytes). Después un programa llamado avrdude abre el puerto que elegiste, reinicia la placa con la señal DTR y establece contacto con el pequeño programa de carga que hay dentro de la placa, el bootloader. Tras un reinicio, el bootloader solo escucha durante un segundo aproximadamente; si no llegan datos, el programa antiguo sigue funcionando. El mensaje de error te dice qué eslabón de esta cadena se ha roto. Si el texto rojo aparece al compilar, el problema está en tu código y no tiene nada que ver con la placa ni con el cable.

Los errores de avrdude más frecuentes y qué significan

Tabla de diagnóstico paso a paso: síntoma, causa y solución

Lee la tabla de arriba abajo; las primeras filas son los problemas más frecuentes y los más fáciles de resolver. Vuelve a intentar la carga después de cada cambio. Si cambias varias cosas a la vez, nunca sabrás cuál lo solucionó y el mismo error volverá a sorprenderte la próxima vez.

Lista de comprobación rápida y sketch de prueba

1. Quita todo lo que haya en la placa: shields, módulos y los cables de los pines 0 y 1. Deja solo el cable USB conectado.
2. Conecta la placa directamente a un puerto USB de la parte trasera del ordenador; evita hubs, alargadores y los conectores del frontal de la caja.
3. Abre Herramientas > Puerto y mira la lista. Desconecta y vuelve a conectar la placa y fíjate en qué puerto desaparece y vuelve. Si la lista no cambia nunca, el problema está en el cable o en el driver.
4. Elige el modelo exacto de tu placa en Herramientas > Placa; si usas un Nano, elige además el bootloader correcto en Herramientas > Processor.
5. Asegúrate de que ningún otro programa ni una segunda ventana del IDE estén usando el puerto; si dudas, ciérralos todos.
6. Activa la salida detallada de la carga y sube el pequeño sketch de prueba de abajo. Probar con un código que sabes que no tiene errores descarta los problemas de compilación.
7. ¿Sigue sin funcionar? Pulsa el botón de reset: si el LED L parpadea rápido una o varias veces, el bootloader está vivo. Después pasa al test de loopback de más abajo.
8. Prueba en otro ordenador o con otra placa. Si el problema viaja con la placa, está en la placa; si se queda en el ordenador, está en el driver o en la configuración del sistema.

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}

Si la carga ha funcionado, el LED L parpadea brevemente y se queda apagado más tiempo, y el contador sube cuando abres el Monitor Serie a 9600 baudios. Para asegurarte de que el código nuevo ha llegado de verdad a la placa, cambia delay(200) por delay(50) y vuelve a subirlo: si el ritmo del parpadeo no cambia, sigue funcionando el programa antiguo. Si ves caracteres raros en el Monitor Serie, la velocidad elegida en el Monitor Serie no coincide con la del código; eso no es un error de carga.

El puerto COM no aparece: cable USB y drivers CH340 y CP2102

Si el menú de puertos está gris o vacío, el primer sospechoso es el cable. Muchos cables finos de los cargadores de móvil solo tienen los dos hilos de alimentación; los hilos de datos D+ y D- no existen. Con un cable así el LED de alimentación de la placa se enciende, lo que confunde, pero el ordenador no ve ningún dispositivo y ni siquiera suena el aviso de conexión. Comprueba tu cable pasando archivos a un móvil o con otra placa que sepas que funciona. El grueso cable tipo B del Uno rara vez tiene este problema; es muy habitual con el mini USB del Nano y con los cables micro USB o USB-C del ESP32 y la Pico.

Si el cable está bien, el segundo sospechoso es el driver. Lee el texto del chip que hay junto al conector USB: el Arduino Uno y la Mega originales usan un ATmega16U2, los clones de Uno y Nano casi siempre un CH340G o CH340C, y las placas de desarrollo ESP32 suelen llevar un CP2102 o un CH340. En Windows abre el Administrador de dispositivos: si la placa se reconoce, aparece en Puertos (COM y LPT). Si ves USB2.0-Serial con un signo de exclamación amarillo en Otros dispositivos, falta el driver CH340.

Windows 10 y 11 suelen instalar ellos mismos los drivers del CH340 y del CP2102 a través de Windows Update. Si no lo hacen, descarga de la web del fabricante del chip el driver CH341SER para el CH340 o el CP210x VCP para el CP2102, instálalo y vuelve a conectar la placa. Las versiones actuales de macOS ya traen drivers para los dos chips; instalar drivers antiguos de distintas fuentes uno encima de otro suele empeorar las cosas. En Linux los drivers ya están en el kernel, pero para usar el puerto tienes que añadir tu usuario al grupo dialout (sudo usermod -a -G dialout $USER) y cerrar y volver a abrir la sesión; si no, verás un error Permission denied. Si en Ubuntu 22.04 o posterior el puerto desaparece nada más conectar una placa con CH340, el culpable suele ser el paquete de lector de pantalla brltty; si no lo usas, elimínalo con sudo apt remove brltty.

Placa, procesador o puerto equivocados

En el Arduino IDE 2 eliges la placa y el puerto en la lista desplegable de la barra superior o en los menús Herramientas > Placa y Herramientas > Puerto. En Windows puede que veas COM1 o varios puertos virtuales de Bluetooth; la forma más fácil de dar con el correcto es desconectar la placa y ver qué puerto desaparece. Si en el menú de placas está elegido un modelo equivocado, como Mega en lugar de Uno o Leonardo en lugar de Nano, avrdude no recibe ninguna respuesta o ve un identificador de chip inesperado en la línea Device signature. Un detalle más: usa Ctrl+U para una carga normal. Sketch > Cargar usando el programador espera un programador ISP externo y, si funciona, borra el bootloader de la placa; a partir de ahí la placa ya no acepta cargas por USB.

Arduino Nano no sube el código: ATmega328P (Old Bootloader)

La mayoría de las placas Nano baratas del mercado son clones con CH340, y muchas de ellas siguen llevando el bootloader antiguo. A principios de 2018 Arduino sustituyó el bootloader del Nano por el Optiboot del Uno, más pequeño y rápido, y desde entonces la opción predeterminada ATmega328P del IDE se comunica a 115200 baudios. El bootloader antiguo espera 57600 baudios. Cuando las velocidades no coinciden, parece que la placa no responde y el error not in sync: resp=0x00 se repite durante diez intentos. La solución es un único ajuste de menú: Herramientas > Processor > ATmega328P (Old Bootloader). Como estas opciones vienen del paquete de la placa, en el Arduino IDE 2 el menú se llama Processor también con la interfaz en español (en el antiguo IDE 1.8, Procesador). Si no sabes cuál es la correcta, prueba las opciones una tras otra; elegir mal no daña la placa.

Los módulos en los pines 0 y 1 bloquean la carga

En el Uno y el Nano el chip USB-serie está conectado al ATmega328P mediante resistencias de 1 kΩ en los pines D0 (RX) y D1 (TX). Durante la carga esa línea pertenece al ordenador. Si hay un módulo serie conectado a esos pines, como un módulo Bluetooth HC-05, un GPS, un ESP-01 o un sensor de huellas, envía sus propios datos a la línea o la mantiene en un nivel fijo y rompe la sincronización del bootloader. El resultado vuelve a ser programmer is not responding o not in sync. Lo más rápido es desconectar los cables de D0 y D1 mientras subes el código; la solución definitiva es mover el módulo a otros pines con 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}

En este sketch el TX del HC-05 va a D10 y su RX a D11. La entrada RX del HC-05 trabaja a 3,3 V, así que pon entre ella y D11 un divisor de tensión con resistencias de 1 kΩ y 2 kΩ. Ahora puedes subir código con el módulo conectado y enviar a tu móvil lo que escribas en el Monitor Serie. Para ver el conexionado completo y el modo de comandos AT, consulta la guía del módulo Bluetooth HC-05. Con una Mega no necesitas SoftwareSerial: la placa tiene puertos serie por hardware adicionales como Serial1 (TX1 = D18, RX1 = D19).

El Monitor Serie y los programas que ocupan el puerto

Un puerto serie solo puede abrirlo un programa a la vez. Por eso Windows muestra Access is denied (en español, Acceso denegado) y macOS y Linux muestran Resource busy. El Arduino IDE suele pausar su propio Monitor Serie durante la carga, pero no funciona a la perfección en todas las versiones ni con todas las placas, sobre todo con el ESP32; si te sale el error, cierra primero la pestaña del Monitor Serie. Lo más habitual es que el puerto lo tenga otra cosa: una segunda ventana del IDE, el Plotter Serie abierto, PuTTY, programas de impresión 3D como Cura, el monitor de PlatformIO en VS Code o un script de Python en segundo plano. Ciérralos, desconecta y vuelve a conectar la placa e inténtalo de nuevo. En Linux puedes ver qué programa ocupa el puerto con sudo lsof /dev/ttyUSB0.

¿Está rota la placa? Test de loopback y grabar el bootloader

Si has probado todo lo anterior y sigue sin subir, tienes que averiguar si el problema está en la parte USB o en el procesador principal. El método clásico para el Uno y el Nano es el test de loopback (bucle): mantienes el procesador principal en reset y haces que el chip USB-serie hable consigo mismo. Para esta prueba no hace falta subir ningún código.

1. Quita todos los cables de la placa y deja solo el cable USB conectado.
2. Con un cable jumper une el pin RESET con GND; así el ATmega328P se queda en reset y no interfiere en la línea.
3. Con un segundo cable une los pines D0 y D1.
4. Elige el puerto de la placa en el IDE y abre el Monitor Serie; la velocidad no importa para esta prueba.
5. Escribe unas letras en la casilla y envíalas. Si el texto vuelve tal cual, el cable, el driver y el chip USB-serie están bien y el problema está en el procesador principal o en el bootloader. Si no vuelve nada, el problema está en la parte USB.
6. No olvides quitar los dos cables al terminar.

Si la placa pasa el test de loopback pero la carga sigue fallando, y el LED L no parpadea rápido al pulsar reset, puede que el bootloader se haya borrado o que se haya cambiado el chip. Puedes volver a grabar el bootloader con un segundo Uno. Sube Archivo > Ejemplos > 11.ArduinoISP > ArduinoISP al Uno que hará de programador. Después une el D10 del programador con el pin RESET de la placa de destino, D11, D12 y D13 con los pines del mismo número del destino, y 5V y GND entre sí. Coloca un condensador de 10 µF entre RESET y GND del Uno programador; así evitas que se reinicie solo. Por último elige Herramientas > Programador > Arduino as ISP, selecciona la placa de destino en el menú de placas y ejecuta Herramientas > Grabar Bootloader. Con este método también puedes darle a un clon de Nano el nuevo Optiboot.

El ESP32 no sube el código: Failed to connect y el botón BOOT

En el ESP32 la carga no la hace avrdude, sino esptool. En la salida aparece primero la línea Connecting........_____..... mientras esptool intenta poner la placa en modo de descarga. Si no lo consigue, verás un error que empieza por A fatal error occurred: Failed to connect to ESP32. En las versiones actuales de esptool, si la placa arrancó en modo normal, el mensaje sigue con Wrong boot mode detected (0x13)! The chip needs to be in download mode.; 0x13 indica que la placa arrancó en su modo normal en lugar del modo de descarga. Si la placa no responde en absoluto, el mensaje termina con No serial data received; las versiones antiguas lo escriben como Timed out waiting for packet header. Si la placa no entra sola en modo de descarga, lo haces tú a mano.

1. Pulsa Cargar en el IDE y vigila la ventana de salida.
2. En cuanto aparezca Connecting..., mantén pulsado el botón BOOT de la placa.
3. Si aun así no conecta, con BOOT pulsado da una pulsación corta a EN y suéltalo.
4. Suelta BOOT cuando en la salida empiecen a correr las líneas Writing at y el porcentaje de la carga.
5. La carga termina con Hard resetting via RTS pin.... Si el programa no arranca, pulsa EN una vez.

¿Por qué pasa esto? Para entrar en modo de descarga, el pin GPIO0 del ESP32 tiene que estar en LOW en el momento del arranque. El circuito de reinicio automático de dos transistores de las placas de desarrollo lo hace solo con las señales DTR y RTS del chip USB; en las placas baratas ese circuito puede fallar en la sincronización. Si te cansa pulsar BOOT cada vez, hay una solución permanente: conecta un condensador electrolítico de 10 µF entre el pin EN y GND de la placa (la pata negativa a GND). El condensador retrasa la subida de la línea EN y da tiempo al circuito de reinicio automático para mantener GPIO0 en 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: cargar con BOOTSEL y UF2

La Pico no tiene un chip USB-serie aparte; el RP2040 tiene su propio controlador USB y el bootloader está en la ROM del chip, que no se puede borrar. Por eso es casi imposible estropear una Pico por software. Si mantienes pulsado el botón BOOTSEL mientras conectas el cable USB, la Pico aparece en el ordenador como una unidad llamada RPI-RP2 (en la Pico 2 la unidad se llama RP2350). Cualquier archivo .uf2 que arrastres a esa unidad se graba en la placa, que luego se reinicia sola; así es también como se instala MicroPython.

Si programas la Pico con el Arduino IDE, en la primera carga todavía no hay puerto COM; conecta la placa con BOOTSEL pulsado y haz clic en Cargar. Después del primer sketch la placa abre un puerto serie y las cargas siguientes ya no necesitan BOOTSEL. Si tu código se cuelga o desactiva el USB, el puerto vuelve a desaparecer y aparece el error No drive to deploy; entonces vuelve al método BOOTSEL. Si usas MicroPython, en la esquina inferior derecha de Thonny debe estar seleccionado el intérprete MicroPython (Raspberry Pi Pico). Para conocer los pines y la configuración de la Pico, consulta la guía ¿Qué es la 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 pequeñas pero traicioneras que se pasan por alto

• Leonardo, Micro y Uno R4: En estas placas con USB nativo el puerto puede cambiar un instante durante la carga. Si la carga se queda colgada, haz clic en Cargar y pulsa el botón de reset una vez justo cuando termine la compilación y empiece la carga (en el Uno R4, dos veces rápido); la placa espera un rato en el bootloader y el código se sube en ese momento.
• Reinicio automático averiado: Si el reinicio automático no funciona en un Uno o un Nano, mantén pulsado reset, haz clic en Cargar y suéltalo justo cuando aparezca en la salida la línea con el tamaño del sketch.
• Shields y circuitos externos: Un shield de motores o un circuito que carga la línea de 5V puede hacer caer la tensión durante la carga y cortar la escritura a mitad.
• Puerto equivocado en macOS: /dev/cu.Bluetooth-Incoming-Port y /dev/cu.debug-console en la lista de puertos no son tu placa, sino puertos del sistema. El puerto de tu placa lleva usbmodem, usbserial o wchusbserial en el nombre; si dudas, desconecta y vuelve a conectar la placa y mira cuál desaparece.
• Caracteres especiales en el nombre de usuario: Si la carpeta de tu usuario de Windows contiene tildes, la ñ u otros caracteres especiales, las herramientas de compilación y carga de algunos paquetes de placas, sobre todo el del ESP32, pueden no encontrar los archivos. Mueve la carpeta de sketches a una ruta sin esos caracteres desde Preferencias; si el problema sigue, crea un usuario de Windows nuevo.
• Sketch demasiado grande: El aviso Sketch too big no es un error de carga; indica que tu código no cabe en los aproximadamente 31,5 KB de flash que le quedan al Uno después del bootloader. Recorta librerías y textos largos o pasa a una placa más grande.
• Puerto bloqueado tras la suspensión: Cuando el ordenador sale de la suspensión el puerto puede quedarse bloqueado; reiniciar el IDE o conectar la placa a otro puerto USB suele bastar.

La carga funciona: ¿y ahora qué?

• Primer circuito: Monta tu propio circuito Blink con un LED y una resistencia y después añade un pulsador para tu primer proyecto interactivo.
• Comunicación serie: Ahora que sabes cómo afectan los pines 0 y 1 a la carga, prueba a encender un LED desde el móvil con el módulo Bluetooth HC-05.
• Leer sensores: Con la guía de sensores para Arduino elige tus primeros proyectos para medir temperatura, distancia y luz.
• Pasarte a lo inalámbrico: Haz con el ESP32 un proyecto que se conecte al Wi-Fi y se controle desde el móvil; gracias a OTA, más adelante podrás subir el código también sin cables.
• Elegir la placa adecuada: Si dudas entre Uno, Nano y Mega, lee ¿Qué Arduino debo comprar?.

Los errores de carga son molestos la primera vez, pero cada uno tiene una causa lógica y casi todos se encuentran en el mismo orden: cable, driver, puerto, ajustes de placa, línea serie y, por último, el bootloader. Si tienes en mente este orden, resolverás el próximo error en minutos. En cuanto tu placa acepte código, en la app BlueGrays encontrarás muchos proyectos para Arduino, ESP32 y Raspberry Pi Pico, desde encender un LED hasta Wi-Fi y actualizaciones OTA inalámbricas, cada uno con su esquema de conexión paso a paso y su código listo, para poner tu placa a trabajar enseguida.