Componentes

O LCD de caracteres 16x2

Duas linhas de dezesseis caracteres, em dezesseis pinos ou em quatro. O conjunto de comandos do HD44780, a flag de ocupado que pega todo mundo, e o backpack I2C.

O LCD de caracteres é o display presente em todo kit, e não é uma tela no sentido em que o OLED é. Não há framebuffer nem gráficos: o sketch envia caracteres para ele, e o controlador tem os desenhos deles numa ROM. Isso o torna a forma mais barata de colocar um número na frente de alguém, e é por isso que ele sobreviveu a várias gerações de displays mais bonitos.

O Mokxi tem ele duas vezes, porque as lojas vendem ele duas vezes.

Dois componentes, um controlador

O LCD de caracteres, 16x2 é o módulo nu: dezesseis pinos numa borda, e seu sketch controla o HD44780 diretamente. A ligação usual são seis fios da placa: RS, E e quatro linhas de dados, além da alimentação, um pino de contraste e a luz de fundo.

O LCD de caracteres com módulo I2C é o mesmo painel com uma pequena placa soldada atrás: um expansor de porta de oito bits PCF8574, um trimpot de contraste e um transistor para a luz de fundo. Ele expõe quatro pinos (GND, VCC, SDA, SCL), e é o que a maioria dos kits traz hoje.

Atrás deles há um único modelo (crates/parts/src/parts/hd44780.rs): a mesma decodificação de comandos, a mesma memória, o mesmo tempo de ocupado, os mesmos pixels. Só o modo como um byte chega é diferente.

O que o controlador faz

Tudo o que o datasheet diz, decodificado do bit mais alto definido do byte para baixo: clear, home, modo de entrada, liga e desliga de display, cursor e piscar, shift, function set, definir o endereço da CGRAM, definir o endereço da DDRAM.

Dois deles valem a pena conhecer.

A DDRAM tem oitenta bytes e a janela é de dezesseis. A linha 0 vai do endereço 0x00 a 0x27 e a linha 1 vai de 0x40 a 0x67, então cada linha tem na verdade quarenta caracteres e o painel é uma janela para dezesseis deles. Imprima além da coluna 16 e os caracteres vão para um lugar que ninguém consegue ver até você deslocar o display, que é a primeira surpresa.

A CGRAM tem oito caracteres seus. Escreva oito bytes de cinco bits cada e imprima o código de caractere 0 a 7 para recuperá-los. Eles são desenhados exatamente pelo mesmo código que desenha a fonte embutida, então um símbolo de graus personalizado ou um ícone de bateria parece pertencer ao conjunto.

O flag de ocupado, que é a coisa que dá errado

Uma escrita leva 37 microssegundos do controlador e um clear leva 1,52 milissegundos, e ele ignora o barramento completamente durante esse tempo. O Mokxi modela isso: um byte recebido enquanto o controlador está ocupado é descartado, exatamente como acontece na bancada.

Isso não é birra nossa. É o bug por trás de toda pergunta "meu LCD imprime lixo" em todo fórum: um driver sem esperas perde meio byte, a fase dos nibbles de quatro bits escorrega, e a partir daí todo caractere é lixo. Nosso próprio driver (firmware/lib/mokxi_hd44780.h) espera 50 microssegundos depois de um byte e 2 milissegundos depois de um clear, que é o que as bibliotecas do Arduino fazem.

Displays apagados, e qual dos dois você tem

Os dois módulos podem mostrar um display perfeitamente correto e perfeitamente invisível, mas por motivos diferentes.

No módulo nu, é o contraste. V0 é uma entrada analógica, e na tensão de alimentação os caracteres desaparecem por completo. É para isso que serve o potenciômetro azulzinho num de verdade, e é por isso que um primeiro LCD muitas vezes parece morto. A janela é estreita e fica na parte de baixo: em 5 V nada aparece com V0 acima de cerca de 1,5 V, então um potenciômetro no meio do curso dá um painel em branco, e o texto chega no último quinto da volta. Ligue V0 ao terra para contraste máximo; deixe sem ligar e o Mokxi trata como terra, que é como se comportam os módulos baratos com resistor fixo.

Nos dois, um módulo com alimentação e contraste que nunca foi inicializado mostra uma linha de blocos sólidos na primeira linha. Esse é o estado de reset de uma linha do controlador, e é o diagnóstico da própria bancada: blocos e nenhum texto significam que a inicialização nunca chegou (a ligação, o endereço I2C ou um begin() faltando), não que o painel está quebrado.

On the backpack the trimmer is a property rather than a pin, so contrast is not the problem. The backlight is. It is bit 3 of the port byte and nothing else, so a driver that never sets that bit leaves you with a working display in a dark window. init() or backlight() in LiquidCrystal_I2C.h turns it on; noBacklight() turns it off again, and the panel goes blank on the canvas when it does.

Uma linha de blocos

Alimentados e nunca inicializados, os dois módulos mostram a linha de cima como dezesseis blocos sólidos e a linha de baixo vazia (num 20x4, as linhas 1 e 3). Esse é o controlador saindo do reset, dirigindo seu painel como uma linha só, e é o que um LCD real mostra quando o sketch nunca chegou até ele: um endereço I2C errado (0x27 contra 0x3F), SDA e SCL trocados, os pinos errados, ou um código que não está rodando. O expansor do backpack liga com todos os pinos em nível alto, então a luz de fundo fica acesa sobre os blocos, como na bancada. O primeiro function set que uma biblioteca envia encerra isso.

O byte de porta do backpack

Não há nenhum protocolo de exibição no barramento I2C. O expansor tem um registrador (seus oito pinos de saída), e cada byte depois do endereço vai para eles. O backpack liga eles ao LCD numa ordem que toda biblioteca Arduino fixa no código, e o Mokxi faz o mesmo:

bit vai para
P0 RS
P1 RW
P2 E
P3 a luz de fundo
P4 a P7 D4 a D7

Então um caractere são seis escritas no expansor: o nibble alto com E em nível baixo, alto, baixo de novo, e depois as mesmas três para o nibble baixo. O controlador trava na borda de descida de E, exatamente como faz no módulo solto.

O endereço é 0x27 num módulo com PCF8574 e 0x3F num PCF8574A, e os dois são fisicamente idênticos. É a propriedade address (39, que é 0x27, por padrão), então você pode definir aquele que sua placa teria.

Escrevendo em um

Os dois módulos compilam as bibliotecas padrão como estão. O módulo solto usa LiquidCrystal.h em seis pinos:

#include <LiquidCrystal.h>

LiquidCrystal lcd(12, 11, 5, 4, 3, 2);   // RS, E, D4, D5, D6, D7

void setup() {
  lcd.begin(16, 2);
  lcd.print("Hello, world!");
}

void loop() {
  lcd.setCursor(0, 1);
  lcd.print(millis() / 1000);
}

O backpack usa LiquidCrystal_I2C.h:

#include <Wire.h>
#include <LiquidCrystal_I2C.h>

LiquidCrystal_I2C lcd(0x27, 16, 2);

void setup() {
  lcd.init();
  lcd.backlight();
  lcd.setCursor(0, 0);
  lcd.print("Hello, world!");
}

void loop() {}

Os dois cabeçalhos são do próprio Mokxi, escritos para as chamadas documentadas das bibliotecas. O backpack está nos pinos de Wire: A4 e A5 num Uno, os pinos I2C da própria placa nos demais casos (o artigo de ajuda de cada placa diz quais), ou onde Wire.begin(sda, scl) os colocou. O print é o da própria placa, então um float imprime com duas casas como faz no Serial. init() liga a luz de fundo, enquanto a biblioteca original deixa isso para backlight().

O Mokxi também traz dois drivers pequenos próprios, mokxi_lcd1602.h (Lcd1602 lcd(rs, e, d4, d5, d6, d7)) e mokxi_lcd1602_i2c.h (Lcd1602I2c lcd(scl, sda)), com printFixed para um número escalado por uma potência de dez e padLine para preencher com espaços o resto de uma linha. Alguns modelos os usam.

O que não é modelado

Leituras de qualquer tipo. O busy flag, o contador de endereço e a DDRAM não devolvem nada, então um driver que consulta o busy flag em vez de esperar vai travar. Espere; é o que toda biblioteca real faz de qualquer forma. Também não é modelado: a fonte 5x10 que um módulo de uma linha pode selecionar, e o ângulo de visão.

The busy timings are the datasheet's two typical numbers (37 microseconds for a write and 1.52 milliseconds for clear and home), used as exact values. A real HD44780's timing scales with whatever its internal oscillator happens to be running at, so those figures move by tens of percent between parts and with temperature, and the 4-bit nibble timing (the minimum E pulse width and the hold after it) is not checked here at all: a driver can clock E as fast as it likes.

Um byte que chega enquanto o controlador está ocupado é descartado. Essa é uma escolha do modelo para que a falha fique visível e reproduzível; num componente real o resultado é indefinido e, com mais frequência, um caractere corrompido do que um perdido.

No backpack, o PCF8574 nunca estica o clock e reconhece cada byte enviado a ele. Não há leitura da porta do expansor, nenhum NACK e nenhum erro de barramento de qualquer tipo, e o transistor da luz de fundo é o bit 3 e nada mais: sem corrente, sem brilho. O contraste no backpack é a propriedade contrast (0 a 1, 0,75 por padrão) em vez do divisor real do trimmer.

Veja: Termômetro num LCD I2C para o backpack, e Termômetro nos modelos para a ligação com seis fios.

Se um LCD I2C fica em branco, mostra blocos ou imprime sobras, Arduino I2C LCD not working percorre as causas por sintoma.