Primer proyecto Arduino paso a paso: guía en 4 pasos en el móvil

Si quieres hacer tu primer proyecto Arduino paso a paso sin saber nada todavía, el móvil puede guiarte: abre la página de un proyecto en BlueGrays y toca Hazlo paso a paso. El modo guiado, llamado Hagámoslo juntos, divide el proyecto en cuatro pasos: Prepara los componentes, Monta el circuito, Sube el código y Ejecuta y prueba. En cada paso solo ves lo que necesitas en ese momento, la pantalla del móvil no se apaga mientras conectas cables y, si lo dejas a medias, el botón de la página del proyecto muestra el paso en el que te quedaste. Solo necesitas un Arduino Uno, unas pocas piezas baratas y un ordenador para subir el código a la placa.

En este artículo no nos limitamos a describir el modo, lo usamos con un proyecto real de principio a fin: montamos en cuatro pasos el proyecto gratuito Semáforo de la app. Aquí tienes la tabla de piezas, qué cable va a cada pin, cómo elegir placa y puerto en el Arduino IDE, el resultado esperado, dónde mirar si te atascas, un plan de 45–60 minutos y tres pequeños experimentos para después. Si quieres saber para qué sirve cada sección de la página de un proyecto, lo explicamos en la guía de la página del proyecto; aquí nos centramos solo en el flujo del modo guiado.

¿Qué es el modo guiado y dónde se encuentra?

Al abrir un proyecto, el botón principal de la página, Hazlo paso a paso, está debajo del título, la valoración y la descripción breve; la línea pequeña que lo acompaña resume las cuatro paradas: Piezas · Circuito · Código · Prueba. Al tocarlo se abre, en lugar de la página del proyecto, una pantalla sencilla que muestra un paso cada vez. Arriba aparecen La pantalla se mantiene encendida y el contador Paso 1 / 4; abajo, los botones Atrás y Siguiente paso. Se guardan el paso en el que estás y las piezas que has marcado; si cierras la app y vuelves al día siguiente, el botón dice algo como Continuar · Paso 2 / 4 y sigues donde lo dejaste. En los proyectos gratuitos todos los pasos de la guía están abiertos; en los proyectos Premium la guía, igual que el proyecto, se abre con Premium.

Proyecto de ejemplo: ¿por qué el Semáforo?

El Semáforo es uno de los proyectos gratuitos de nivel Principiante de BlueGrays: el LED rojo se enciende dos segundos, el amarillo destella un instante, el verde se enciende dos segundos y luego se vuelve al rojo pasando por el amarillo, en un ciclo que nunca se detiene. Es un buen primer proyecto porque va un paso más allá de hacer parpadear un solo LED sin pedir ningún concepto nuevo: repites los mismos tres comandos (pinMode, digitalWrite, delay) para tres pines. Todo el mundo sabe cómo es un semáforo, así que notas enseguida si funciona, y las piezas vienen en cualquier kit de inicio. Si quieres empezar aún más fácil, el proyecto Parpadeo de LED recorre los mismos cuatro pasos con un LED y dos cables. Las versiones con botón para peatones, cruce y millis() están en el artículo del semáforo con Arduino; allí se usan otros pines, así que sigue las conexiones de aquí tal como aparecen en el proyecto de la app.

Paso 1: Prepara los componentes

La primera pantalla muestra 1. Prepara los componentes y la nota "Marca lo que tienes. Así detectas ahora lo que falta." Debajo aparecen las piezas del proyecto con su cantidad; busca cada pieza en la mesa, tócala en la lista para marcarla y la barra de arriba se llena, por ejemplo "3 / 5 piezas listas". Si usas Premium y has guardado tus piezas en Mi Taller, las que tienes en cantidad suficiente aparecen ya marcadas con la etiqueta En tu taller. No te saltes este paso: descubrir a mitad del montaje que falta la tercera resistencia es mucho más molesto que darte cuenta antes de empezar.

Si te falta una pieza, casi nunca tienes que abandonar. Puedes usar resistencias de 220 Ω en lugar de 330 Ω; el LED brilla un poco más y ambos valores son seguros. Si no sabes el valor de una resistencia, introduce sus bandas en la calculadora de código de colores: 330 Ω se lee naranja-naranja-marrón, 220 Ω rojo-rojo-marrón, y la cuarta banda dorada es la tolerancia. Para otro LED, la calculadora de resistencia para LED te da el valor adecuado. Si tus LED son de otros colores (tres rojos, por ejemplo), el proyecto funciona igual, solo pierdes el aspecto de semáforo. Si aún no tienes placa, prueba antes el circuito en una simulación de Tinkercad y consulta la guía del kit de inicio de Arduino antes de comprar.

Paso 2: Monta el circuito

Si nunca has usado una protoboard, basta con una regla: los cinco orificios de una columna numerada (A–E o F–J) están conectados por dentro y la ranura central separa las dos mitades. Las filas largas de los bordes son las líneas de alimentación; la de la raya roja es para el positivo, la de la raya azul para el negativo (GND), y recorren toda la placa, aunque en algunas protoboards largas están cortadas por la mitad. En el esquema del Semáforo, las dos patas de cada LED van en dos columnas vecinas, una resistencia salta sobre la ranura y lleva una pata del LED a la mitad inferior, y el cable hacia el pin del Arduino entra en la columna donde está el extremo inferior de la resistencia. Las otras patas de los LED van cada una con un cable a la línea azul, y la línea azul va con un solo cable al pin GND del Arduino. Más detalles en el artículo qué es una protoboard.

Un LED solo funciona en un sentido y no se enciende si está al revés. La pata larga es el ánodo (+), la corta es el cátodo (-), y en el lado de la pata corta la cápsula tiene un borde ligeramente plano. En este proyecto la pata larga va al pin del Arduino a través de la resistencia y la corta a GND. La resistencia limita la corriente: el pin da 5 V, un LED rojo consume unos 2 V y los 3 V restantes sobre 330 Ω dan unos 9 mA (3 / 330). Con 220 Ω la corriente sube a unos 14 mA; ambos valores son cómodos para el LED y para el pin del Arduino. Un LED sin resistencia puede estropearse pronto y fuerza el pin. Si quieres profundizar, consulta los artículos qué es un LED y qué es una resistencia.

1. Con el cable USB desconectado, empieza por GND: conecta un cable desde el pin GND del Arduino hasta la línea de la raya azul de la protoboard.
2. Coloca los tres LED en la mitad superior de la protoboard, de izquierda a derecha verde, amarillo y rojo; las dos patas de cada LED en columnas distintas y todas las patas largas del mismo lado.
3. Desde la columna de la pata larga de cada LED, pon una resistencia de 330 Ω que cruce la ranura hasta la mitad inferior.
4. Lleva un cable desde la columna de la pata corta de cada LED hasta la línea azul de GND.
5. Lleva cables desde las columnas de los extremos inferiores de las resistencias hasta el Arduino: la resistencia del rojo al pin 2, la del amarillo al pin 3, la del verde al pin 4.
6. Al terminar, recorre cada camino con el dedo: pin, cable, resistencia, pata larga, LED, pata corta, GND. No debe haber huecos ni dos extremos en la misma columna.
7. Toca el esquema en la guía para ampliarlo y compáralo con tu circuito; si todo coincide, conecta el cable USB y pasa a Siguiente paso.

Paso 3: Sube el código

En este paso ves el código fuente del proyecto, el interruptor Ver en bloques en los proyectos que tienen bloques y la sección Entender el código, que explica el código paso a paso. El código lo sube a la placa el ordenador, no el móvil, así que primero tienes que instalar el Arduino IDE. En resumen: descarga la versión de Arduino IDE 2 para tu sistema desde la web oficial de Arduino, instálala y acepta los avisos de drivers durante la instalación; suele llevar unos 10 minutos. La guía completa está en el artículo de instalación del Arduino IDE. Hay dos formas de llevar el código al ordenador: con Copiar y enviándotelo en un mensaje, o con Copiar enlace, que te da un enlace para abrir el código en el ordenador.

1. Abre el Arduino IDE, crea un sketch nuevo desde el menú Archivo, borra todo lo que contiene y pega el código del proyecto.
2. Conecta el Arduino Uno al ordenador con el cable USB; el LED ON de la placa debe encenderse.
3. En Herramientas > Placa, elige Arduino Uno dentro de Arduino AVR Boards.
4. En Herramientas > Puerto, elige el puerto al que está conectada la placa: en Windows algo como COM3, en macOS un nombre que empieza por /dev/cu.usbmodem o /dev/cu.usbserial, en Linux algo como /dev/ttyACM0.
5. Primero compila con el icono de la marca de verificación de la izquierda (Verificar); si no hay errores, pulsa la flecha de al lado (Subir).
6. Durante la carga parpadean los pequeños LED TX y RX de la placa; cuando el panel de salida de abajo indique que la carga ha terminado, pasa a Siguiente paso en la guía.

1// Trafik Lambası / Traffic Light
2void setup() {
3  pinMode(2, OUTPUT);   // Kırmızı LED / Red LED
4  pinMode(3, OUTPUT);   // Sarı LED / Yellow LED
5  pinMode(4, OUTPUT);   // Yeşil LED / Green LED
6}
7
8void loop() {
9  // Kırmızı yanar, 2 sn / Red on, 2 s
10  digitalWrite(2, HIGH);
11  digitalWrite(3, LOW);
12  digitalWrite(4, LOW);
13  delay(2000);
14  // Sarı yanar, 0,3 sn / Yellow on, 0.3 s
15  digitalWrite(2, LOW);
16  digitalWrite(3, HIGH);
17  digitalWrite(4, LOW);
18  delay(300);
19  // Yeşil yanar, 2 sn / Green on, 2 s
20  digitalWrite(2, LOW);
21  digitalWrite(3, LOW);
22  digitalWrite(4, HIGH);
23  delay(2000);
24  // Sarı yanar, sonra başa döner / Yellow on, then back to red
25  digitalWrite(2, LOW);
26  digitalWrite(3, HIGH);
27  digitalWrite(4, LOW);
28  delay(300);
29}
30

Paso 4: Ejecuta y prueba

En el último paso la guía dice "Debería funcionar así:" y muestra el vídeo del proyecto. Tu circuito empieza a funcionar en cuanto se sube el código: el rojo se enciende 2 segundos, el amarillo da un destello corto de 0,3 segundos, el verde se enciende 2 segundos y después llega otro amarillo breve y de nuevo el rojo. Un ciclo completo dura unos 4,6 segundos y nunca hay dos LED encendidos a la vez. Que el amarillo dure tan poco no es un fallo, viene de la línea delay(300) del código; si se te escapa, fíjate en el LED amarillo durante varios ciclos. Compara tu circuito con el vídeo con tres preguntas: ¿los colores van en el orden correcto?, ¿los tiempos se parecen a los del vídeo?, ¿cada LED brilla lo suficiente? Si respondes que sí a las tres, el proyecto funciona.

Entonces toca ¡Funciona!. El proyecto se marca como completado y, tras una breve celebración, se abre la pantalla ¡Funciona, enhorabuena!. Ahí puedes darle de 1 a 5 estrellas (Valora el proyecto), seguir con la tarjeta NUESTRA SIGUIENTE SUGERENCIA o volver con Volver al proyecto. Si usas Premium y las piezas del proyecto no están guardadas en Mi Taller, la app pregunta antes ¿Añadimos las piezas a tu taller?; si eliges Añadir y completar, se añaden las piezas que faltan y el proyecto queda completado, de modo que Mi Taller muestre bien la próxima vez qué proyectos puedes hacer.

Si te atascas: Me he atascado, Entender el código y el foro

• Me he atascado: está junto al botón ¡Funciona! en el paso 4 y abre en la misma pantalla las comprobaciones preparadas del proyecto. El Semáforo tiene 10 comprobaciones sobre alimentación, puerto, números de pin, protoboard, GND, sentido del LED y valor de la resistencia. En los proyectos sin consejos preparados te indica que puedes escribirnos desde Perfil › Soporte.
• Entender el código: debajo del código en el paso 3. Empieza con el resumen "¿Qué hace este código?", explica el código paso a paso y termina con una pequeña tarea Pruébalo tú. Si el código funciona pero no sabes por qué, sigue por aquí; cómo usarlo está en la guía de Entender el código.
• Foro: en Aprende › Foro abre un tema nuevo en la categoría Pregunta y comparte una foto nítida de tu circuito (hasta 5 imágenes) y el código que subiste con Añadir código. Si explicas en tres frases qué proyecto hiciste, qué esperabas y qué pasó, las respuestas llegan con más facilidad. Ohmi, la mascota de BlueGrays, también responde preguntas en el foro.
• Antes de pedir ayuda: desconecta el USB, compara el circuito con el esquema una última vez y vuelve a subir el código. La mayoría de los problemas de los primeros proyectos vienen de un LED al revés o de un solo cable en la columna equivocada.

Plan de tiempo para tu primer proyecto Arduino

Para alguien que empieza de cero, el Semáforo lleva entre 45 y 60 minutos, contando la instalación en el ordenador. No hace falta correr; lo que más tiempo lleva es montar y revisar el circuito. En el segundo proyecto el Arduino IDE, la placa y el puerto ya están listos, así que el mismo flujo baja a 25–30 minutos.

Un orden para tus 5 primeros proyectos

Después del Semáforo, añadir un solo concepto nuevo en cada proyecto es la forma más tranquila de aprender. Los cinco proyectos de abajo son gratuitos en BlueGrays, con esquema, lista de piezas, código, bloques y Entender el código abiertos. Haces cada uno con el modo guiado en los mismos cuatro pasos y cada uno añade como mucho una o dos piezas nuevas.

Si prefieres salirte de este camino, el Buscador de proyectos de la app te propone proyectos adecuados y un proyecto gratuito de calentamiento con las mismas piezas cuando eliges Será mi primer proyecto en la pregunta "¿Cuánta experiencia tienes?". Si quieres planificar día a día qué hacer después de estos cinco, la hoja de ruta de Arduino en 30 días te lleva a la segunda y tercera semana.

Después del primer proyecto: 3 pequeños experimentos

1. Cambia los tiempos. Cambia el delay(2000) del rojo por delay(5000), los dos delay(300) del amarillo por delay(1000) y vuelve a subir el código. El ciclo pasa de 4,6 a 9 segundos y se parece más a un semáforo real. Este experimento muestra que el número del código es directamente el comportamiento del circuito.
2. Añade un segundo LED verde para peatones. Toma otro LED, una resistencia de 330 Ω y dos cables, monta la misma conexión en el pin 5, que está libre, y añade pinMode(5, OUTPUT) en setup(). Escribe digitalWrite(5, HIGH) en el bloque en que está encendido el rojo y digitalWrite(5, LOW) en los otros tres. Los peatones ven verde mientras los coches esperan en rojo; ver qué líneas cambian para añadir un LED refuerza la idea de pines y salidas.
3. Haz parpadear el amarillo. Sustituye el bloque amarillo que va después del verde por tres repeticiones que encienden el amarillo 300 ms y lo apagan 300 ms. Primero copia las líneas tres veces a mano y después haz lo mismo con un bucle for (int i = 0; i < 3; i++). Es una entrada natural a la idea principal del siguiente proyecto, Luces de policía LED.

Lo que de verdad ganas con tu primer proyecto Arduino no son tres LED encendidos, sino el propio flujo de cuatro pasos: conocer las piezas, montar el circuito a partir de un esquema, subir el código y comparar el resultado con el comportamiento esperado. Ese flujo es el mismo en el Semáforo y en un proyecto con sensores que harás dentro de unos meses. Cuando abras BlueGrays en el móvil y toques Hazlo paso a paso en el Semáforo, todos los pasos de este artículo te estarán esperando en la pantalla.