Como funciona
Escreva sua própria biblioteca de Arduino é um curso intermediário em C++ num Arduino Uno. Cada aula roda no dispositivo do fim do mundo da galeria: um display de quatro dígitos TM1637 em A0 (CLK) e A1 (DIO), três botões nos pinos 6, 7 e 8, e três lâmpadas nos pinos 2, 3 e 4.
A primeira aula abre uma aba. Da segunda em diante, a placa abre com três: TinyDigits.h, TinyDigits.cpp e o sketch, como uma biblioteca de verdade e o sketch que a usa. Você roda, depois muda a biblioteca e roda de novo. Algumas verificações leem o monitor serial, e outras contam os segmentos acesos do display, então um passo sobre desenhar 01:30 só é aprovado quando 01:30 está realmente no vidro.
As aulas
- Cabeçalho e .cpp: um driver bit-banged a partir do datasheet (start, stop, oito bits LSB primeiro e um ACK no nono clock), dividido entre um cabeçalho que diz o que faz e um .cpp que diz como. Include guards,
staticpara o privado, eexternpara a regra de definição única. - Design de classe: TinyDigits como uma classe. Um construtor que não toca em hardware,
begin()que informa se um chip respondeu, métodos que recusam o que não conseguem fazer, um método novo, um argumento padrão e um segundo display em pinos sem nada ligado. - Exemplos: uma demonstração que fazia tudo substituída por três exemplos que ensinam uma coisa cada: HelloDigits, um Countdown com botão e um SelfTest.
- Docs e palavras-chave: comentários de documentação que declaram faixas e falhas, ajuda impressa a partir das constantes da própria biblioteca, uma doc que prometia -9999 quando quatro dígitos param em -999, e
keywords.txtpara a 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 e compartilhamento: o layout de biblioteca do Arduino,
library.propertiesimpresso a partir do header para que a versão fique em um só lugar, uma checagem de lançamento que se recusa a enviar, e o zip instalado com + Add library no Mokxi e Add .ZIP Library na IDE do Arduino.
O projeto: um relógio de missão
Uma contagem regressiva de lançamento sobre a biblioteca pronta, com botões START, HOLD e RESET, lâmpadas para contagem, decolagem e espera, e um pulso de millis() que nunca desvia. Você adiciona showText() à biblioteca como um lançamento menor (2.1.0), faz o relógio mostrar GO na decolagem e depois o torna seu: uma contagem de minutos com os dois pontos, os últimos três segundos pulsando, ou um segundo display.
O que o Uno faz de diferente
- Uma aba de sketch ganha os nomes do Arduino de graça; uma aba
.cppprecisa começar com#include <Arduino.h>, como na IDE do Arduino. - O TM1637 não é I2C, então o driver usa dois pinos comuns. A0 e A1 funcionam como pinos digitais 14 e 15.
- A biblioteca usa os pull-ups do próprio chip (
INPUT_PULLUP) para deixar as linhas flutuando em nível alto, então um pino sem nada conectado lê alto ebegin()não vê ACK. - Um
inttem 16 bits no Uno, entãoshowNumberguarda seus dígitos em umunsigned inte sua faixa dentro de -999 a 9999.
Antes e depois
C++ para programas de verdade cobre as classes, referências e headers em que este curso se apoia. A biblioteca pronta funciona em qualquer projeto: adicione o zip em Libraries e inclua com colchetes angulares.