inky

Tinta

Biblioteca Python para Phat Inky, tinta O quê e exibições eletrônicas de impressão em tinta para Raspberry Pi.

Phat de tinta

O Inky Phat é uma tela eletrônica de 250x122 pixels, disponível em vermelho/preto/branco, amarelo/preto/branco e preto/branco. É ótimo para nametags e exibir informações de frequência muito baixa, como um calendário diário ou uma visão geral do tempo.

Tinta o quê

Inky O que é uma tela eletrônica de 400x300 pixels disponíveis em vermelho/preto/branco, amarelo/preto/branco e preto/branco. Tem toneladas de resolução para listas de tarefas diárias detalhadas, previsões meteorológicas de vários dias, horários de ônibus e muito mais.

Impressão em tinta

A impressão de tinta é a nossa linha de exibições gloriosas de 7 cores eink, disponíveis em sabores de 4 "(640 x 400 pixels) 5,7" (600 x 448 pixels) e 7,3 "(800 x 480 pixels).

Instalação

Recomendamos o uso desta biblioteca com o Raspberry Pi OS Bookworm ou posterior. Requer python ≥3,7.

Instalação completa (recomendado):

Criamos um script de instalação fácil que instalará todos os pré-requisitos e você em funcionamento com esforços mínimos. Para executá -lo, inicie o terminal que você encontrará no menu -> Acessórios -> Terminal na área de trabalho do Raspberry Pi, conforme ilustrado abaixo:

Na nova janela do terminal, digite os comandos exatamente como aparece abaixo (verifique os erros de digitação) e siga as instruções na tela:

git clone https://github.com/pimoroni/inky
cd inky
./install.sh

Note As bibliotecas serão instaladas no ambiente virtual "Pimoroni", você precisará ativá -lo para executar exemplos:

 source ~/.virtualenvs/pimoroni/bin/activate

Desenvolvimento:

Se você deseja contribuir ou como viver à beira do seu assento, tendo o código mais recente, você pode instalar a versão de desenvolvimento como assim:

git clone https://github.com/pimoroni/inky
cd inky
./install.sh --unstable

Instale a biblioteca estável da Pypi e configure manualmente

• Configurar um ambiente virtual: python3 -m venv --system-site-packages $HOME/.virtualenvs/pimoroni
• Mudar para o ambiente virtual: source ~/.virtualenvs/pimoroni/bin/activate
• Instale a biblioteca: pip install inky

Isso não fará nenhuma alteração de configuração; portanto, você também pode precisar ativar:

• i2c: sudo raspi-config nonint do_i2c 0
• SPI: sudo raspi-config nonint do_spi 0

Opcionalmente, você pode executar sudo raspi-config ou a interface da interface do Raspberry Pi para ativar interfaces.

Além disso, pode ser necessário desativar a seleção de chips da SPI para evitar o erro:

 Woah there, some pins we need are in use!
  ️   Chip Select: (line 8, GPIO8) currently claimed by spi0 CS0

Isso requer a adição de dtoverlay=spi0-0cs para /boot/firmware/config.txt .

Uso

A biblioteca deve ser executada com o Python 3.

Configuração automática

A Inky pode tentar identificar automaticamente sua placa (a partir das informações armazenadas em sua EEPROM) e configurar de acordo. Esta é a maneira mais fácil de trabalhar com telas recentes de tinta.

 from inky . auto import auto
display = auto ()

Você pode obter a cor e a resolução do quadro:

 display . colour
display . resolution 

Configuração manual

Se você tem uma tinta mais antiga sem uma EEPROM, poderá especificar o tipo manualmente. A biblioteca de tintas contém módulos para o phat e o quê, carregue o phat de tinta do seguinte:

 from inky import InkyPHAT

Você precisará escolher sua cor, um de 'vermelho', 'amarelo' ou 'preto' e instanciar a classe:

 display = InkyPHAT ( 'red' )

Se você estiver usando o que precisará para carregar a classe inkywhat da biblioteca da tinta como assim:

 from inky import InkyWHAT
display = InkyWHAT ( 'red' )

Depois de inicializar a tinta, há apenas três métodos para se preocupar::

Definir imagem

Defina uma imagem PIL, matriz ou listar como o buffer interno da Inky. As dimensões da imagem devem corresponder às dimensões do PHAT ou do que você está usando.

 display . set_image ( image )

Você deve usar PIL para criar uma imagem. PIL fornece um módulo ImageDraw que permite desenhar texto, linhas e formas sobre sua imagem. Veja: https://pillow.readthedocs.io/en/stable/reference/imagedraw.html

Defina a borda

Defina a cor da borda de você phat ou o quê.

 display . set_border ( colour )

colour deve ser uma das obras de inky.RED , inky.YELLOW , inky.WHITE ou inky.BLACK com cores disponíveis, dependendo do seu tipo de exibição.

Atualize a tela

Depois de preparar e definir sua imagem e escolher uma cor de borda, você pode atualizar sua tela de tinta eletrônica com:

 display . show ()

Migrando

Se você estiver migrando código da antiga biblioteca inkyphat , você encontrará que grande parte das funções de desenho e manipulação de imagens foram removidas de Inky. Essas funções sempre foram fornecidas pelo PIL, e a abordagem recomendada é usar o PIL para criar e preparar sua imagem antes de defini -la como inky com set_image() .