Lecciones y el juego de aprendizaje

Escribe tu propia biblioteca de Arduino

Escribe TinyDigits, un driver de display TM1637, desde la hoja de datos, y publícalo como un zip que cualquiera pueda instalar.

Cómo funciona

Escribe tu propia biblioteca de Arduino es un curso intermedio de C++ en un Arduino Uno. Cada lección usa el dispositivo del fin del mundo de la galería: una pantalla de cuatro dígitos TM1637 en A0 (CLK) y A1 (DIO), tres botones en los pines 6, 7 y 8, y tres lámparas en los pines 2, 3 y 4.

La primera lección abre una pestaña. Desde la segunda en adelante, la placa abre con tres: TinyDigits.h, TinyDigits.cpp y el sketch, como una biblioteca real y el sketch que la usa. La ejecutas, luego cambias la biblioteca y ejecutas de nuevo. Algunas comprobaciones leen el monitor serie, y otras cuentan los segmentos encendidos de la pantalla, así que un paso sobre dibujar 01:30 solo se aprueba cuando 01:30 está realmente en el cristal.

Las lecciones

  1. Header y .cpp: un controlador bit-bang escrito a partir de la hoja de datos (start, stop, ocho bits LSB primero y un ACK en el noveno reloj), dividido en un header que dice qué hace y un .cpp que dice cómo. Guardas de inclusión, static para lo privado, y extern para la regla de una sola definición.
  2. Diseño de la clase: TinyDigits como clase. Un constructor que no toca hardware, begin() que reporta si un chip respondió, métodos que rechazan lo que no pueden hacer, un método nuevo, un argumento predeterminado, y un segundo display en pines sin nada conectado.
  3. Ejemplos: una demostración de todo en uno reemplazada por tres ejemplos que cada uno enseña una cosa: HelloDigits, un botón de cuenta regresiva y un SelfTest.
  4. Docs y palabras clave: comentarios de documentación que indican rangos y fallos, ayuda impresa desde las constantes propias de la biblioteca, un doc que prometía -9999 cuando cuatro dígitos se detienen en -999, y keywords.txt para el IDE.
  5. Versioning: MAJOR.MINOR.PATCH as numbers a sketch tests in #if, a patch for a tidy-up that blanked zero, and a breaking change to setBrightness that earns 2.0.0.
  6. Zip y compartir: la estructura de biblioteca de Arduino, library.properties impreso desde el header para que la versión viva en un solo lugar, una verificación de versión que se niega a publicar, y el zip instalado con + Add library en Mokxi y Add .ZIP Library en el Arduino IDE.

El proyecto: un reloj de misión

Una cuenta regresiva de lanzamiento con la biblioteca terminada, con botones de START, HOLD y RESET, lámparas para contar, despegue y espera, y un pulso de millis() que nunca se desfasa. Agregas showText() a la biblioteca como una versión menor (2.1.0), haces que el reloj diga GO al despegar, y luego lo haces tuyo: una cuenta de minutos con los dos puntos, los últimos tres segundos parpadeando, o un segundo display.

Lo que el Uno hace distinto

  • Una pestaña de sketch recibe los nombres de Arduino gratis; una pestaña .cpp debe empezar con #include <Arduino.h>, como en el Arduino IDE.
  • El TM1637 no es I2C, así que el driver usa dos pines ordinarios. A0 y A1 funcionan como pines digitales 14 y 15.
  • La biblioteca usa las pull-ups del propio chip (INPUT_PULLUP) para dejar que las líneas floten en alto, así que un pin sin nada conectado lee alto y begin() no ve ningún ACK.
  • Un int es de 16 bits en el Uno, así que showNumber guarda sus dígitos en un unsigned int y su rango dentro de -999 a 9999.

Antes y después

C++ para programas reales cubre las clases, referencias y headers en los que se basa este curso. La biblioteca terminada funciona en cualquier proyecto: agrega el zip en Libraries e inclúyela con paréntesis angulares.