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
- 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,
staticpara lo privado, yexternpara la regla de una sola definición. - 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. - 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.
- 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.txtpara el IDE. - Versioning: MAJOR.MINOR.PATCH as numbers a sketch tests in
#if, a patch for a tidy-up that blanked zero, and a breaking change tosetBrightnessthat earns 2.0.0. - Zip y compartir: la estructura de biblioteca de Arduino,
library.propertiesimpreso 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
.cppdebe 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 ybegin()no ve ningún ACK. - Un
intes de 16 bits en el Uno, así queshowNumberguarda sus dígitos en ununsigned inty 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.