`ssd1306` — Driver OLED#

Este módulo fornece um driver para displays OLED baseados no SSD1306. Há suporte a duas variantes de transporte: I2C (SSD1306_I2C) e SPI (SSD1306_SPI). Ambas herdam a API de desenho de SSD1306, que encapsula um framebuf.FrameBuffer1.

Exemplo:

from machine import I2C
import ssd1306

i2c = I2C(2)
oled = ssd1306.SSD1306_I2C(128, 64, i2c)
oled.fill(0)
oled.text("Hello", 0, 0)
oled.show()

Classes#

class ssd1306.SSD1306(width: int, height: int, external_vcc: bool)#

Classe base para displays OLED SSD1306. As subclasses devem inicializar self.framebuf e fornecer os métodos write_cmd, write_data, write_framebuf e poweron.

Argumentos:

width – Largura do display em pixels.
height – Altura do display em pixels (deve ser múltiplo de 8).
external_vcc – True se uma fonte VCC externa for utilizada, False para habilitar a bomba de carga interna.

Atributos de instância:

width – Largura do display em pixels.
height – Altura do display em pixels.
external_vcc – Flag de VCC externo.
pages – Número de páginas de 8 pixels de altura (height // 8).

init_display() → None#: Envia a sequência de comandos de inicialização ao display, limpa o framebuffer e atualiza-o. Chamado automaticamente por __init__.

poweroff() → None#: Desliga o display (modo de suspensão).

contrast(contrast: int) → None#

Define o contraste do display.

contrast – Valor de contraste na faixa de 0 a 255.

invert(invert: int) → None#

Inverte as cores do display.

invert – 0 para saída normal, 1 para saída invertida. Apenas o bit menos significativo é utilizado.

show() → None#: Descarrega o framebuffer interno para o display.

fill(col: int) → None#

Preenche todo o framebuffer com uma única cor.

col – Valor de cor (0 para apagado, 1 para aceso).

pixel(x: int, y: int, col: int) → None#

Define a cor de um único pixel.

x – Coordenada da coluna.
y – Coordenada da linha.
col – Valor de cor (0 ou 1).

scroll(dx: int, dy: int) → None#

Desloca o conteúdo do framebuffer pelos deslocamentos informados. Os pixels deslocados para fora dos limites são perdidos; os pixels desocupados permanecem inalterados.

dx – Deslocamento horizontal em pixels.
dy – Deslocamento vertical em pixels.

text(string: str, x: int, y: int, col: int = 1) → None#

Desenha uma string usando a fonte 8x8 embutida.

string – Texto a desenhar.
x – Coordenada inicial da coluna.
y – Coordenada inicial da linha.
col – Cor de primeiro plano (padrão 1).

class ssd1306.SSD1306_I2C(width: int, height: int, i2c: machine.I2C, addr: int = 0x3C, external_vcc: bool = False)#

Driver SSD1306 conectado via I2C. Herda de SSD1306.

Argumentos:

width – Largura do display em pixels.
height – Altura do display em pixels.
i2c – Um objeto machine.I2C (ou compatível) já inicializado.
addr – Endereço I2C do dispositivo de 7 bits (padrão 0x3C).
external_vcc – True para VCC externo, False para usar a bomba de carga interna.

write_cmd(cmd: int) → None#: Envia um único byte de comando ao display via I2C.

write_data(buf: bytes) → None#: Envia um buffer de dados de pixels ao display via I2C.

class ssd1306.SSD1306_SPI(width: int, height: int, spi: machine.SPI, dc: machine.Pin, res: machine.Pin, cs: machine.Pin, external_vcc: bool = False)#

Driver SSD1306 conectado via SPI. Herda de SSD1306. Usa uma taxa de clock SPI fixa de 10 MHz.

Argumentos:

width – Largura do display em pixels.
height – Altura do display em pixels.
spi – Um objeto pyb.SPI (ou compatível).
dc – Pino de seleção de dados/comando.
res – Pino de reset.
cs – Pino de chip-select.
external_vcc – True para VCC externo, False para usar a bomba de carga interna.

write_cmd(cmd: int) → None#: Envia um único byte de comando ao display via SPI.

write_framebuf() → None#: Transmite todo o framebuffer ao display via SPI.

poweron() → None#: Alterna a linha de reset para ligar o display.

Constantes#

ssd1306.SET_CONTRAST: int#: Comando 0x81 – define o contraste do display.

ssd1306.SET_ENTIRE_ON: int#: Comando 0xA4 – retoma o display a partir do conteúdo da RAM.

ssd1306.SET_NORM_INV: int#: Comando 0xA6 – seleção de display normal/inverso.

ssd1306.SET_DISP: int#: Comando 0xAE – liga/desliga o display.

ssd1306.SET_MEM_ADDR: int#: Comando 0x20 – modo de endereçamento de memória.

ssd1306.SET_COL_ADDR: int#: Comando 0x21 – faixa de endereços de coluna.

ssd1306.SET_PAGE_ADDR: int#: Comando 0x22 – faixa de endereços de página.

ssd1306.SET_DISP_START_LINE: int#: Comando 0x40 – linha inicial do display.

ssd1306.SET_SEG_REMAP: int#: Comando 0xA0 – remapeamento de segmento.

ssd1306.SET_MUX_RATIO: int#: Comando 0xA8 – razão de multiplexação.

ssd1306.SET_COM_OUT_DIR: int#: Comando 0xC0 – direção de varredura da saída COM.

ssd1306.SET_DISP_OFFSET: int#: Comando 0xD3 – deslocamento do display.

ssd1306.SET_COM_PIN_CFG: int#: Comando 0xDA – configuração de hardware dos pinos COM.

ssd1306.SET_DISP_CLK_DIV: int#: Comando 0xD5 – razão de divisão do clock do display / frequência do oscilador.

ssd1306.SET_PRECHARGE: int#: Comando 0xD9 – período de pré-carga.

ssd1306.SET_VCOM_DESEL: int#: Comando 0xDB – nível de deseleção VCOMH.

ssd1306.SET_CHARGE_PUMP: int#: Comando 0x8D – configuração da bomba de carga.

ssd1306 — Driver OLED#

Classes#

Constantes#

`ssd1306` — Driver OLED#