Entender el código para encender el LED

Como ya te comenté en la página anterior, lo que vamos a hacer ahora es entender el código que hemos utilizado para programar nuestro Arduino. El lenguaje de programación que empleamos para programar nuestro 33IoT (o cualquier otro Arduino o placa basada en Arduino que programemos con la IDE que acabamos de descargar) se llama Arduino y está basado en el lenguaje de programación C++. Diremos que es una versión simplificada de C++.

Es importante tener ciertas nociones de inglés para poder programar Arduino, ya que aunque sea un lenguaje basado en C++, C++ tiene como lenguaje natural de referencia el inglés.

Para entender el código que ha iluminado nuestro LED, lo que vamos a hacer es ir viéndolo párrafo a párrafo y así, explicaremos diferentes características que necesitaremos conocer para trabajar en nuestros propios proyectos.

¿Y por qué copiamos código en lugar de escribir el nuestro?

Esta pregunta puede venirnos a la cabeza y es normal. A la hora de comenzar a trabajar con Arduino, suelen seguirse los siguientes pasos:

1. Buscar ejemplos similares a lo que queremos hacer
2. Copiar el código
3. Realizar las modificaciones necesarias para adaptarlo a nuestro proyecto

¿Y por qué se suele hacer eso en lugar de escribir código desde cero?
Arduino se creó con la finalidad de que gente que no pertenece al mundo de la electrónica y la programación fuese capaz de programar y de realizar proyectos interactivos. Por ello, existe una amplia comunidad de creadores que comparten sus proyectos (tanto el hardware como el software) de manera libre, para que la gente pueda reutilizarlo y adaptarlo a sus necesidades. Muchos de los proyectos que queramos realizar, ya habrán sido realizados antes y además la gente que los comparte suele explicar detalladamente cómo replicarlos y por qué los han realizado de una manera determinada.

Aparte de facilitarnos el trabajo, reutilizar código nos puede enseñar funciones y características de Arduino que desconocíamos. Y por supuesto, siempre podremos decidir hacer las cosas de otra manera cuando tengamos los conocimientos suficientes. En algunas ocasiones es bueno intentar crear algo desde cero, pero en muchas ocasiones no es necesario tratar de reinventar la rueda.

¿No estamos plagiando/robando otros proyectos?
- No, los proyectos de Arduino que se comparten son de código abierto (open source) y eso significa que podemos reutilizarlos y adaptarlos a nuestras necesidades sin ningún problema.

Comencemos a entender el idioma de Arduino

Cuando programemos nuestro Arduino, tenemos que tener en mente que el código que escribimos, aparte de ser procesado por nuestro Arduino, es leído por nosotros y por cualquier otra persona que colabore en nuestro proyecto. Como ya se ha comentado, Arduino nació con la finalidad de aproximar la electrónica y la programación a cualquier persona que le interesase sin que sea necesario que tenga amplios conocimientos de programación. Por ello, el trabajo colaborativo y compartir el código es algo muy común. Para que eso se realice correctamente es necesario que nuestro código sea comprensible por nosotros y por cualquiera que pueda trabajar con nosotros en el proyecto.

Una manera de explicar y clarificar la finalidad de nuestro código es el uso de comentarios. Los comentarios son aquellas oraciones que no van destinadas a que las procese nuestro Arduino, si no que el destinatario somos nosotros mismo u otras personas. ¿Nosotros mismos? Sí. Imagina que estás trabajando en un proyecto de Arduino, pero que por alguna circunstancia tienes que dejar de trabajar en él y lo retomas un año después. Quizá después de tanto tiempo no recuerdas bien para qué habías escrito ese código... Los comentarios pueden ayudarte en esa tarea.

Échale un vistazo a este fragmento de código:

/*
  Blink

  Turns an LED on for one second, then off for one second, repeatedly.

  Most Arduinos have an on-board LED you can control. On the UNO, MEGA and ZERO
  it is attached to digital pin 13, on MKR1000 on pin 6. LED_BUILTIN is set to
  the correct LED pin independent of which board is used.
  If you want to know what pin the on-board LED is connected to on your Arduino
  model, check the Technical Specs of your board at:
  https://www.arduino.cc/en/Main/Products

  modified 8 May 2014
  by Scott Fitzgerald
  modified 2 Sep 2016
  by Arturo Guadalupi
  modified 8 Sep 2016
  by Colby Newman

  This example code is in the public domain.

  https://www.arduino.cc/en/Tutorial/BuiltInExamples/Blink
*/

Como puedes ver, se trata de un código separado en párrafos:

Blink: Lo primero que nos encontramos es el título del proyecto.
Descripción del proyecto: Breve descripción de la finalidad del código y explicación.
Modificaciones y autores: Fechas de modificación y los autores que lo han editado. Arduino se basa en compartir y reutilizar código, por ello es necesario indicar quién ha creado ese código y quién lo ha modificado. No debemos apropiarnos del código de otra persona sin mencionarlo.
Dominio público: cualquiera puede utilizar este código con los fines que prefiera, comerciales o no.
Web: Tutorial en el que se explica el proyecto.

Cuando nosotras creemos un proyecto, será necesario que escribamos algo parecido a esto al principio de nuestro código.

Y si te has fijado bien, al principio y al final encontramos /* y */ eso nos indica que lo que escribamos entre ambos símbolos es un comentario. Su función es evitar que Arduino lo lea y que cuando el código sea compilado, se obvie. Si Arduino intentase procesar ese texto escrito en inglés (los comentarios también podríamos hacerlos en español) daría error porque no está escrito en el lenguaje de Arduino.

Os invito a que abráis Arduino con el sketch Blink, lo guardéis con otro nombre y hagáis pruebas con el texto de los comentarios.

Guardar un archivo preexistente de Arduino

 

FUENTES:
Lenguaje Arduino: https://descubrearduino.com/lenguaje-arduino/
C++: https://es.wikipedia.org/wiki/C%2B%2B
Código abierto (open source): https://es.wikipedia.org/wiki/Sistema_de_c%C3%B3digo_abierto