¿Cómo instalar el software de Arduino y escribir tu primer programa?

El IDE de Arduino es el programa gratuito que usas para escribir, verificar y enviar código a tu placa Arduino desde tu computadora.

Qué es el IDE de Arduino

IDE significa Integrated Development Environment (Entorno de Desarrollo Integrado). Es el editor de texto y compilador oficial para Arduino. Puedes descargarlo gratis desde el sitio oficial de Arduino.

El IDE tiene tres funciones principales: escribir el código, verificar que no tenga errores y enviarlo a la placa. En este documento llamaremos sketch al programa que escribes para Arduino.

Cómo descargar e instalar el IDE

Paso 1 — Descarga el instalador

Entra a arduino.cc/en/software desde tu navegador. Verás dos versiones disponibles: IDE 1.x e IDE 2.x. Para principiantes, cualquiera funciona. Este curso usa la versión 2.x porque tiene autocompletado y es más visual.

Elige el instalador según tu sistema operativo:

El archivo pesa aproximadamente 200 MB. Si tu internet es lento, el IDE 1.x pesa menos de 100 MB y funciona igual para este curso.

Paso 2 — Instala el programa

En Windows: abre el archivo .exe descargado y sigue el asistente. Acepta todos los valores predeterminados. El instalador agrega automáticamente los drivers (controladores) necesarios para que tu computadora reconozca la placa Arduino.

En macOS: abre el archivo .dmg y arrastra el ícono de Arduino a la carpeta Aplicaciones. La primera vez que abras el IDE, macOS pedirá permiso para instalar drivers adicionales. Acepta.

En Linux: descarga el archivo AppImage, dale permisos de ejecución con el comando chmod +x y ejecútalo directamente.

Paso 3 — Conecta tu Arduino

Usa el cable USB que viene con la placa. Conecta el extremo cuadrado al Arduino y el extremo plano a tu computadora. El LED de encendido de la placa debe iluminarse.

Cómo configurar el IDE antes de escribir código

Abrir el IDE sin configurarlo primero es el error más común. Hay dos ajustes obligatorios:

Seleccionar la placa

En el menú superior ve a Tools → Board → Arduino AVR Boards → Arduino Uno. Si usas un Arduino Nano o Mega, selecciona el modelo correspondiente. Elegir la placa incorrecta hace que el IDE no pueda enviar el programa.

Seleccionar el puerto

Ve a Tools → Port. Verás una lista de puertos disponibles. En Windows aparece como COM3, COM4, etc. En macOS y Linux aparece como /dev/cu.usbmodem... o /dev/ttyUSB0. Selecciona el puerto donde está conectado tu Arduino. Si no sabes cuál es, desconecta el USB, fíjate qué puertos desaparecen de la lista y reconecta; el nuevo que aparece es tu Arduino.

La estructura básica de un sketch de Arduino

Todo sketch de Arduino tiene exactamente dos funciones obligatorias: setup() y loop().

void setup() {
  // Este bloque se ejecuta UNA sola vez al encender la placa
}

void loop() {
  // Este bloque se repite de forma infinita mientras la placa tenga energía
}

void setup() — Aquí configuras los pines y el hardware antes de que el programa principal comience. Se ejecuta solo una vez.

void loop() — Aquí va la lógica principal. Arduino repite este bloque sin parar hasta que lo desconectas.

Tu primer programa: Blink (el LED parpadea)

El programa Blink hace parpadear el LED integrado en el pin 13 de la placa. Es el "Hola Mundo" de Arduino. No necesitas ningún componente externo.

Código completo

void setup() {
  pinMode(13, OUTPUT); // Configura el pin 13 como salida
}

void loop() {
  digitalWrite(13, HIGH); // Enciende el LED
  delay(1000);             // Espera 1 segundo (1,000 milisegundos)
  digitalWrite(13, LOW);  // Apaga el LED
  delay(1000);             // Espera 1 segundo
}

Qué hace cada línea

Cómo enviar el programa a la placa

1. Escribe o pega el código en el editor del IDE.
2. Haz clic en el botón Verify (palomita ✓) para compilar. El IDE busca errores de escritura.
3. Si dice "Compilation complete" en la barra inferior, haz clic en Upload (flecha →).
4. El IDE envía el código. Verás los LEDs TX/RX de la placa parpadear durante la carga.
5. Cuando aparece "Done uploading", el LED del pin 13 ya debe parpadear cada segundo.

Ejemplo 2 — Cambiar la velocidad del parpadeo

Modifica el valor dentro de delay() para cambiar qué tan rápido parpadea el LED.

void setup() {
  pinMode(13, OUTPUT);
}

void loop() {
  digitalWrite(13, HIGH);
  delay(200);  // Parpadeo rápido: 200 ms encendido
  digitalWrite(13, LOW);
  delay(200);  // 200 ms apagado
}

Con delay(200) el LED parpadea cinco veces por segundo. Con delay(2000) parpadea cada dos segundos. Cambia ese número y sube el programa de nuevo para ver el efecto.

Ejemplo 3 — Agregar un segundo LED externo

Conecta un LED al pin 8 de tu Arduino usando el protoboard (como viste en la lección anterior). Pon una resistencia de 220 ohmios en serie para proteger el LED.

void setup() {
  pinMode(13, OUTPUT); // LED integrado
  pinMode(8, OUTPUT);  // LED externo en pin 8
}

void loop() {
  digitalWrite(13, HIGH);
  digitalWrite(8, LOW);
  delay(500);
  digitalWrite(13, LOW);
  digitalWrite(8, HIGH);
  delay(500);
}

Ahora los dos LEDs se alternan: cuando uno enciende, el otro apaga. Este patrón simula una señal de alerta, como las luces de emergencia en instalaciones de FEMSA o Bimbo.

Errores comunes al instalar y usar el IDE

Error 1 — No seleccionar el puerto correcto

Si el IDE muestra el mensaje "An error occurred while uploading the sketch", probablemente el puerto está mal. Ve a Tools → Port y elige el puerto correcto. Si no aparece ningún puerto, el driver no se instaló bien; reinstala el IDE.

Error 2 — Olvidar el punto y coma al final de cada instrucción

En C++ (el lenguaje de Arduino) cada instrucción termina con punto y coma (;). Escribir delay(1000) sin el ; genera un error de compilación. El IDE marca la línea con rojo para ayudarte a encontrarlo.

Error 3 — Confundir setup() con loop()

Poner pinMode() dentro de loop() no rompe el programa, pero lo hace ineficiente. Arduino ejecutará pinMode() miles de veces por segundo innecesariamente. Toda configuración inicial va en setup().

Error 4 — Usar mayúsculas incorrectas

Arduino distingue mayúsculas de minúsculas. DigitalWrite no es lo mismo que digitalWrite. Si el IDE no reconoce la instrucción, revisa que las mayúsculas sean exactas.

Referencia rápida de instrucciones básicas

Puntos clave de esta lección

• El IDE de Arduino se descarga gratis desde arduino.cc y pesa menos de 200 MB. Funciona en Windows, macOS y Linux.
• Antes de subir cualquier programa debes seleccionar la placa correcta y el puerto correcto en el menú Tools.
• Todo sketch tiene dos funciones obligatorias: setup() para la configuración inicial y loop() para la lógica que se repite.
• El programa Blink es el punto de partida: usa pinMode(), digitalWrite() y delay() para hacer parpadear el LED integrado del Arduino.
• Los errores más frecuentes son olvidar el punto y coma, escribir mal el nombre de una función y no seleccionar el puerto correcto antes de subir el código.