inky

Tinky

Python-Bibliothek für Inky Phat, Inky Was und Inky Impression E-Paper für Raspberry Pi.

Inky Phat

Inky Phat ist ein 250 x 122 Pixel-E-Papier-Display, das in Rot/Schwarz/Weiß, Gelb/Schwarz/Weiß und Schwarz/Weiß erhältlich ist. Es eignet sich hervorragend für Nametags und zeigt sehr niedrige Frequenzinformationen wie einen täglichen Kalender- oder Wetterüberblick.

Inky was

Inky Was ist ein 400 x 300 Pixel-E-Papier-Display in Rot/Schwarz/Weiß, Gelb/Schwarz/Weiß und Schwarz/Weiß. Es gibt unzählige Auflösung für detaillierte tägliche Aufgabenlisten, mehrtägige Wettervorhersagen, Busfahrpläne und vieles mehr.

Inky Eindruck

Inky Impression ist unsere glorreiche 7 Farb -Einink -Displays, die in 4 "(640 x 400 Pixel) 500 x 448 Pixel und 7,3" (800 x 480 Pixel) erhältlich sind. Sie sind mit starken Farben gepackt.

Installation

Wir empfehlen, diese Bibliothek mit Raspberry Pi OS -Bücherwurm oder später zu verwenden. Es erfordert Python ≥3,7.

Vollständige Installation (empfohlen):

Wir haben ein einfaches Installationsskript erstellt, das alle Voraussetzungen installiert und Sie mit minimalen Anstrengungen zum Laufen bringen. Um es auszuführen, starten Sie das Terminal, das Sie im Menü -> Zubehör -> Terminal auf Ihrem Raspberry Pi -Desktop finden, wie unten dargestellt:

Geben Sie im neuen Terminalfenster die Befehle genau so ein, wie sie unten angezeigt werden (nach Tippfehler prüfen) und befolgen Sie die Anweisungen auf dem Bildschirm:

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

Hinweis Bibliotheken werden in der virtuellen Umgebung "Pimoroni" installiert. Sie müssen es aktivieren, um Beispiele auszuführen:

 source ~/.virtualenvs/pimoroni/bin/activate

Entwicklung:

Wenn Sie einen Beitrag leisten möchten oder das Leben am Rande Ihres Sitzes durch den neuesten Code haben möchten, können Sie die Entwicklungsversion wie SO installieren:

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

Installieren Sie die stabile Bibliothek von PYPI und konfigurieren Sie manuell

• Richten Sie eine virtuelle Umgebung ein: python3 -m venv --system-site-packages $HOME/.virtualenvs/pimoroni
• Wechseln Sie zur virtuellen Umgebung: source ~/.virtualenvs/pimoroni/bin/activate
• Installieren Sie die Bibliothek: pip install inky

Dadurch werden keine Konfigurationsänderungen vorgenommen, sodass Sie möglicherweise auch aktivieren müssen:

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

Sie können sudo raspi-config optional oder die grafische Raspberry PI-Konfigurations-UI ausführen, um Schnittstellen zu aktivieren.

Darüber hinaus müssen Sie möglicherweise die Chip-Select von SPI deaktivieren, um den Fehler zu vermeiden:

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

Dies erfordert die Zugabe von dtoverlay=spi0-0cs zu /boot/firmware/config.txt .

Verwendung

Die Bibliothek sollte mit Python 3 ausgeführt werden.

Auto -Setup

Inky kann versuchen, Ihr Board automatisch zu identifizieren (aus den auf dem EEPROM gespeicherten Informationen) und entsprechend einrichten. Dies ist der einfachste Weg, um mit jüngsten tinky -Displays zu arbeiten.

 from inky . auto import auto
display = auto ()

Sie können dann die Farbe und Auflösung von der Tafel erhalten:

 display . colour
display . resolution 

Handbuch Setup

Wenn Sie ein älteres Inky ohne EEPROM haben, können Sie den Typ manuell angeben. Die Inky -Bibliothek enthält Module sowohl für den Phat als auch für was, laden Sie den Inky -Phat wie folgt:

 from inky import InkyPHAT

Sie müssen dann Ihre Farbe, eines von 'rot', 'gelb' oder 'schwarz', auswählen und die Klasse instanziieren:

 display = InkyPHAT ( 'red' )

Wenn Sie das verwenden, was Sie benötigen, um die Inkywhat -Klasse aus der Inky -Bibliothek zu laden, wie so:

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

Sobald Sie Inky initialisiert haben, gibt es nur drei Methoden, mit denen Sie sich befassen müssen:

Bild setzen

Legen Sie ein PIL -Bild, ein Numpy -Array oder eine Liste auf Inkys interner Puffer. Die Bildabmessungen sollten den Abmessungen des Phat oder dem, was Sie verwenden, übereinstimmen.

 display . set_image ( image )

Sie sollten PIL verwenden, um ein Bild zu erstellen. PIL stellt ein ImageDraw -Modul bereit, mit dem Sie Text, Zeilen und Formen über Ihr Bild zeichnen können. Siehe: https://pillow.readthedocs.io/en/stable/reference/imagedraw.html

Grenze festlegen

Stellen Sie die randliche Farbe von Ihnen Phat oder was.

 display . set_border ( colour )

colour sollte einer von inky.RED , inky.YELLOW , inky.WHITE oder inky.BLACK mit verfügbaren Farben sein, je nach Ihrem Anzeigentyp.

Aktualisieren Sie die Anzeige

Sobald Sie Ihr Bild vorbereitet und festgelegt und eine Grenzfarbe ausgewählt haben, können Sie Ihre E-Ink-Anzeige mit:

 display . show ()

Migrieren

Wenn Sie den Code aus der alten inkyphat -Bibliothek migrieren, werden Sie feststellen, dass ein Großteil der Zeichnungs- und Bildmanipulationsfunktionen von Inky entfernt wurde. Diese Funktionen wurden immer von PIL geliefert, und der empfohlene Ansatz besteht darin, PIL zum Erstellen und Vorbereiten Ihres Bildes zu verwenden, bevor Sie es mit set_image() auf Inky einstellen.