Desenhe num OLED SSD1306 com um Arduino
Intermediário
- 526componentes na bancada
- 46placas rodando agora
- 1.00xtempo real, em todas as placas
O OLED SSD1306 de 0,96 polegada é a telinha de todo kit de hobby: 128 por 64 pixels, quatro pinos, branco nítido sobre preto. O circuito acima é um num Arduino Uno, desenhando um título, algumas formas, um contador e uma bola quicando numa caixa. Ele roda num Uno simulado, e o display é decodificado do tráfego I2C real nos dois fios, bit por bit, em vez de ser desenhado por um atalho.
Abra no editor para mudar o código de desenho e rodar de novo. A compilação leva um ou dois segundos, no navegador.
O que você precisa
- Um Arduino Uno
- Um módulo OLED SSD1306 128x64, versão I2C
- Quatro fios jumper
Ligação
| Componente e pino | Vai para | Nota |
|---|---|---|
| OLED SDA | A4 | |
| OLED SCL | A5 | |
| OLED VCC | 5 V | A maioria dos módulos aceita 3,3 V ou 5 V |
| OLED GND | GND |
O código da Adafruit
O sketch do tutorial SSD1306 da Adafruit compila aqui como está, em todas as placas, exceto no ATtiny85. Os cabeçalhos são do próprio Mokxi, escritos sobre o driver de display dele, e mantêm as chamadas que os tutoriais usam: clearDisplay(), display(), drawPixel(), linhas, retângulos, retângulos arredondados, círculos e triângulos, bitmaps, setTextSize(), setCursor(), print(), setRotation() e invertDisplay().
Vale saber, antes de começar, duas diferenças em relação à biblioteca original. A fonte é a própria do Mokxi, de 5 por 7, com maiúsculas, dígitos e pontuação, então letras minúsculas são impressas como maiúsculas. E begin() deixa o painel em branco, enquanto a biblioteca original desenha seu logo.
#include <Wire.h>
#include <Adafruit_GFX.h>
#include <Adafruit_SSD1306.h>
Adafruit_SSD1306 display(128, 64, &Wire, -1);
void setup() {
if (!display.begin(SSD1306_SWITCHCAPVCC, 0x3C)) for (;;);
display.clearDisplay();
display.setTextSize(1);
display.setTextColor(SSD1306_WHITE);
display.setCursor(0, 0);
display.println("Hello, world!");
display.drawRect(0, 20, 40, 20, SSD1306_WHITE);
display.display();
}
void loop() {}Abrir este sketch no editorSó o código: o editor posiciona a placa e os componentes que ele consegue ler do sketch.
Por que nada aparece até display()
O painel não pode ser lido de volta. Então um driver que quer mudar um pixel precisa lembrar os outros 1023 bytes do quadro, e guarda essa cópia na memória da própria placa. Toda chamada de desenho escreve nessa cópia; display() é o que a envia para o painel. Esqueça display() e você terá desenhado uma imagem perfeita na RAM que ninguém jamais verá.
That copy is 1 KB, which is half the Uno’s entire 2 KB of SRAM. It is the real cost of a pixel display on an ATmega328P, and the reason big sketches with an OLED run out of memory. The built-in example also shows a way to go faster: it sends only the 8-column blocks of the screen that changed, so a moving ball is a few dozen bytes on the bus rather than a full kilobyte. Over the Uno’s software I2C a full 1 KB frame takes about a third of a second, which is the difference between two frames a second and the twenty-five this sketch manages.
Experimente no editor
Abra o circuito no editor e selecione o display. Mude o endereço dele de 0x3C para 0x3D e rode de novo. O monitor serial diz que nenhum OLED respondeu, e o painel fica apagado, que é o defeito mais comum nesses módulos.
Depois substitua o exemplo pelo sketch da Adafruit acima, adicione mais algumas chamadas de desenho, um círculo, um triângulo preenchido, uma linha de texto grande com setTextSize(2), e rode. Cada compilação leva um instante no navegador e o painel mostra exatamente o que o código desenhou.
Para uma imagem em movimento, redesenhe dentro de loop() e chame display() uma vez por quadro. A bola quicando do exemplo mostra o truque de apagar apenas o que se moveu.
Erros comuns
O endereço errado. A maioria dos módulos responde em 0x3C; alguns vêm configurados para 0x3D. Nada aparece no endereço errado, e um sketch de scanner I2C diz qual é o certo.
Enviar o comando de ligar o display sem a bomba de carga. O painel precisa de cerca de 7,5 volts, gerados por uma bomba dentro do chip que começa desligada. Um driver escrito à mão que envia display-on e esquece de ligar a bomba recebe uma tela preta. O painel simulado modela a bomba, então esse defeito acontece aqui também. A biblioteca cuida disso para você.
Ficar sem memória num Uno. Com o buffer de quadro ocupando 1 KB, um sketch com arrays grandes ou strings longas na RAM pode travar de maneiras estranhas. Mantenha strings constantes na flash.
Esperar rolagem por hardware. Os comandos de rolagem do painel são aceitos e ignorados pelo display simulado, então uma faixa rolante fica parada aqui. Role redesenhando, em vez disso.
Abra este circuito no editor. Arduino Uno: OLED SSD1306, ligado como no topo desta página. Mude um componente ou um valor e rode de novo.
Abrir o circuitoPerguntas
Qual é o endereço I2C de um OLED SSD1306?
Normalmente 0x3C, às vezes 0x3D, definido por um jumper ou resistor na parte de trás do módulo. O simulado tem o endereço como uma propriedade.
Posso usar um OLED SSD1306 com um ESP32?
Sim, com as mesmas chamadas de biblioteca nos pinos I2C do próprio ESP32. Há exemplos prontos de ESP32 com OLED, incluindo esta mesma demonstração de texto e formas e um jogo de raquete num ESP32-C3.
Por que o texto do meu OLED está todo em maiúsculas?
Porque a biblioteca simulada usa a fonte de 5 por 7 do Mokxi, que tem só maiúsculas, dígitos e pontuação. Em hardware real a fonte da Adafruit tem minúsculas.
O display no simulador é uma imagem ou o protocolo de verdade?
O protocolo de verdade. O componente é um dispositivo I2C decodificado a partir das transições dos pinos, com o conjunto de comandos que as bibliotecas comuns enviam e seus próprios 1 KB de memória de display.
Continuar
Monte isto de verdade
Abra o editor, mude um valor e veja o número mudar junto. Nada para instalar, e não precisa de conta.