Bei dem Projekt handelt es sich um eine Kombination aus einer Hardware (Eingabe-Ausgabe-Modul) bestehend aus zwei Tastern und drei LEDs sowie einer Python Bibliothek zur Ansteuerung der Hardware für den Raspberry Pi.
Informationen zur Hardware befinden sich auf der verlinkten Seite. An dieser Stelle wird die Bibliothek zur Ansteuerung des Moduls genauer beschrieben.
Das Modul befindet sich im Python-Package-Index (PyPi) unter dem Namen eapi. Es kann mit dem folgenden Befehl auf dem Raspberry Pi installiert werden:
sudo pip3 install eapi
Wenn die Installation nur lokal für einen User erfolgen soll, heißt der Befehl
pip3 install --user eapi
Wenn die Bibliothek bereits installiert ist aber nur in einer älteren Version vorliegt, kann sie mit dem folgenden Befehl auf den neuesten Stand gebracht werden.
sudo pip3 install --upgrade eapi
Die Quelltexte für das Paket liegen bei github und können auch direkt von dort installiert werden:
$ pip3 install git+https://github.com/tbs1-bo/ea_rpi_modul
Wer mit den Quelltexten arbeiten möchte, sollte das repository auschecken und darüber das Paket selbst installieren.
$ git clone https://github.com/tbs1-bo/ea_rpi_modul.git
$ cd ea_rpi_modul
$ python3 setup.py install
Wenn das Paket nur für den aktuellen Benutzer installiert werden soll, muss
die Option --user an install übergeben werden. Bei einer systemweiten
Installation muss der letzte Befehl mit sudo ausgeführt werden.
Die Klasse EAModul dient der Ansteuerung des Moduls. Mit ihr können die Taster ausgelesen und die LEDs an- oder bzw. ausgeschaltet werden.
Der folgende Quelltext demonstriert eine typische Verwendung der Klasse.
from eapi.hw import EAModul #0
ea = EAModul(29, 31, 33, 35, 37) #1
ea.schalte_led(EAModul.LED_ROT, 1) #2
ea.schalte_led(EAModul.LED_ROT, 0) #3
if ea.taster_gedrueckt(0): #4
print("Taster 0 gedrückt")
ea.cleanup() #5
#0 Aus dem Modul eapi.hw wird die Klasse EAModul importiert, damit sie
in den folgenden Anweisungen verwendet werden kann.
#1 Bei der Initialisierung müssen die auf dem RaspberryPi verwendeten PINs angegeben werden: zuerst die beiden Pins für die Taster (29 und 31), es folgen drei Pins für die LEDs (33, 35 und 37).
#2 Hier wird die rote LED erst ein-
#3 ... und dann wieder ausgeschaltet.
#4 Der Zustand des Tasters mit der Nummer 0 wird abgefragt. Die Taster sind nummeriert (beginnend bei 0).
#5 Mit der Methode cleanup() werden die Pins des Pi wieder auf den
Ausgangszustand zurückgesetzt.
In einem weiteren Beispiel können wir sehen, wie man auf das Drücken eines Tasters reagiert. Die rote und grüne LED blinken fortwährend im Wechsel. Wenn man während des Programmablaufes irgendwann auf den Taster 1 drückt, beendet sich das Programm. Über den Taster 0 kann die gelbe LED an- und beim Loslassen des Tasters wieder ausgeschaltet werden.
from eapi.hw import EAModul
import time
ea_modul = EAModul() #1
def taster0_gedrueckt(pin): #2
global ea_modul
ea_modul.schalte_led(EAModul.LED_GELB, ea_modul.taster_gedrueckt(0))
ea_modul.taster_event_registrieren(0, taster0_gedrueckt) #3
try:
while not ea_modul.taster_gedrueckt(1): #4
ea_modul.schalte_led(EAModul.LED_ROT, 1)
time.sleep(0.2)
ea_modul.schalte_led(EAModul.LED_ROT, 0)
time.sleep(0.2)
ea_modul.schalte_led(EAModul.LED_GRUEN, 1)
time.sleep(0.5)
ea_modul.schalte_led(EAModul.LED_GRUEN, 0)
time.sleep(0.2)
except KeyboardInterrupt:
ea_modul.cleanup()
finally:
ea_modul.cleanup()
#1 Das Modul wird mit der Standardbeschaltung initialisiert, wenn keine Werte für die Pins angegeben werden. Hierbei sind die PINs der Reihe nach an den Pins 29, 31, 33, 35 und 37 angeschlossen.
#2 Es wird eine Methode deklariert, die aufgerufen werden soll, sobald der Taster 0 gedrückt wird. Damit dies passiert, wird sie gleich dafür registriert.
#3 Die Methode wird für den Taster 0 registriert und aufgerufen, sobald der Taster gedrückt wird.
#4 Der Taster wird in einer Schleife immer wieder abgefragt. Solange der Taster zum Zeitpunkt der Abfrage nicht gedrückt ist, läuft die Schleife weiter.
Der Quelltext ist gut dokumentiert. Man kann sich die Hilfe der Klasse
EAModul innerhalb des Python Interpreters mit dem Befehl help(EAModul)
anzeigen lassen.
Auf der Kommandozeile unter Linux hilft der Befehl pydoc3 weiter. Mit
pydoc3 eapi.hw wird die Dokumentation für das Modul angezeigt.
Unter Windows ist der Befehl pydoc3 standardmäßig nicht vorhanden. Hier hilft
der Aufruf python3 -m pydoc eapi.hw weiter.
Eine HTML-Version der Dokumentation kann unter der Adresse http://pythonhosted.org/eapi/ abgerufen werden.
Die Bibliothek ist für die Verwendung mit dem Raspberry Pi konzipiert. Wenn jedoch kein Pi angeschlossen ist, wird eine Bibliothek mit Dummyfunktionen geladen. Diese gibt für die Eingänge (Taster) zufällige Werte zurück. Bei Ausgaben (LED) auf den Ausgängen erfolgt eine Textausgabe auf der Konsole.
Das EA-Modul ist netzwerkfähig und lässt sich über ein Netzwerk ansteuern. So
kann man die drei LEDs über einen UDP-Server im Netz leicht zugänglich
machen. Ein Erläuterung über das genaue Vorgehen befindet sich in der
Dokumentation des Moduls eapi.net. Sie kann mit pydoc3 eapi.net abgerufen
werden und ist
online
verfügbar.
Du hast einen Fehler oder Bug gefunden? Dann erstelle bitte einen Bugreport. Dafür musst du oben auf "Issues" und dann auf "New Issue" klicken. Danach kannst du alle Details angeben.