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.
Related
- A página do componente LCD 16x2 I2C, com seu pinout
- A página do componente LCD 16x2, com seu pinout
- O LCD 16x2 solto
- O LCD 20x4
- Dois fios, vários chips: I2C