inky
Version 2.0.0
Biblioteca de Python para Inky Phat, Inky What and Inky Impression E-Paper pantallas para Raspberry Pi.
Inky Phat es una pantalla E-Paper de 250x122 píxeles, disponible en rojo/negro/blanco, amarillo/negro/blanco y negro/blanco. Es ideal para nombres y mostrar información de muy baja frecuencia, como un calendario diario o una descripción del clima.
Inky What es una pantalla de papel E de 400x300 píxeles disponible en rojo/negro/blanco, amarillo/negro/blanco y negro/blanco. Tiene toneladas de resolución para listas de tareas diarias detalladas, pronósticos meteorológicos de varios días, horarios de autobuses y más.
Inky Impress es nuestra línea de gloriosas pantallas Eink de 7 color, disponibles en sabores de 4 "(640 x 400 píxeles) 5.7" (600 x 448 píxeles) y 7.3 "(800 x 480 píxeles). Están llenos de colores fuertes y perfectos para mostrar gráficos sorprendentes o muchos datos.
Recomendamos usar esta biblioteca con Raspberry Pi OS Bookworm o posterior. Requiere pitón ≥3.7.
Hemos creado un script de instalación fácil que instalará todos los requisitos previos y lo pondrá en funcionamiento con esfuerzos mínimos. Para ejecutarlo, encienda la terminal que encontrará en el menú -> Accesorios -> Terminal en su escritorio Raspberry Pi, como se ilustra a continuación:
En la nueva ventana de terminal, escriba los comandos exactamente como aparece a continuación (verifique los errores tipográficos) y siga las instrucciones en pantalla:
git clone https://github.com/pimoroni/inky
cd inky
./install.shNota Las bibliotecas se instalarán en el entorno virtual "Pimoroni", deberá activarlo para ejecutar ejemplos:
source ~/.virtualenvs/pimoroni/bin/activate
Si desea contribuir, o le gusta vivir en el borde de su asiento teniendo el último código, puede instalar la versión de desarrollo de lo tanto:
git clone https://github.com/pimoroni/inky
cd inky
./install.sh --unstablepython3 -m venv --system-site-packages $HOME/.virtualenvs/pimoronisource ~/.virtualenvs/pimoroni/bin/activatepip install inkyEsto no hará ningún cambio de configuración, por lo que es posible que también deba habilitar:
sudo raspi-config nonint do_i2c 0sudo raspi-config nonint do_spi 0 Opcionalmente, puede ejecutar sudo raspi-config o la interfaz de usuario de configuración gráfica de Raspberry Pi para habilitar interfaces.
Además, es posible que deba deshabilitar el selecto de chips de SPI para evitar el error:
Woah there, some pins we need are in use!
️ Chip Select: (line 8, GPIO8) currently claimed by spi0 CS0
Esto requiere la adición de dtoverlay=spi0-0cs a /boot/firmware/config.txt .
La biblioteca debe ejecutarse con Python 3.
Inky puede intentar identificar automáticamente su tablero (desde la información almacenada en su EEPROM) y configurar en consecuencia. Esta es la forma más fácil de trabajar con pantallas de tinta recientes.
from inky . auto import auto
display = auto ()Luego puede obtener el color y la resolución del tablero:
display . colour
display . resolution Si tiene un tinto más antiguo sin un EEPROM, puede especificar el tipo manualmente. La biblioteca de la entrada contiene módulos tanto para el PHAT como para qué, cargue el phat de tinta de la siguiente manera:
from inky import InkyPHATLuego deberá elegir su color, uno de 'rojo', 'amarillo' o 'negro' e instanciar la clase:
display = InkyPHAT ( 'red' )Si está utilizando lo que necesitará para cargar la clase de la biblioteca de la entrada de Inky como así:
from inky import InkyWHAT
display = InkyWHAT ( 'red' )Una vez que haya inicializado a Inky, solo hay tres métodos que debe preocuparse:
Establezca una imagen PIL, una matriz o lista Numpy en el búfer interno de Inky. Las dimensiones de la imagen deben coincidir con las dimensiones del PHAT o lo que está utilizando.
display . set_image ( image ) Debe usar PIL para crear una imagen. PIL proporciona un módulo ImageDraw que le permite dibujar texto, líneas y formas sobre su imagen. Ver: https://pillow.readthedocs.io/en/stable/reference/imagedraw.html
Establezca el color del borde de usted o qué.
display . set_border ( colour ) colour debe ser uno de inky.RED , inky.YELLOW , inky.WHITE o inky.BLACK con colores disponibles según su tipo de pantalla.
Una vez que haya preparado y configurado su imagen, y haya elegido un color de borde, puede actualizar su pantalla de unión electrónica con:
display . show () Si está migrando código de la antigua biblioteca inkyphat , encontrará que gran parte de las funciones de dibujo y manipulación de imágenes se han eliminado de Inky. PIL siempre suministró estas funciones, y el enfoque recomendado es usar PIL para crear y preparar su imagen antes de configurarla en Inky con set_image() .
