Aulas e o jogo de aprendizado

Escreva sua própria biblioteca de Arduino

Escreva o TinyDigits, um driver de display TM1637, a partir do datasheet, e distribua como um zip que qualquer pessoa pode instalar.

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

  1. 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, static para o privado, e extern para a regra de definição única.
  2. 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.
  3. 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.
  4. 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.txt para a 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 e compartilhamento: o layout de biblioteca do Arduino, library.properties impresso 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 .cpp precisa 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 e begin() não vê ACK.
  • Um int tem 16 bits no Uno, então showNumber guarda seus dígitos em um unsigned int e 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.