Raspberry Pi: Unterschied zwischen den Versionen

Version vom 18. August 2022, 23:00 Uhr

Einführung

Der RasPi ist ein Mini-Computer, der meist unter Linux betrieben wird. Dies im Gegensatz zu einem Mikrokontroller wie etwa dem Arduino. Er kann in diversen Sprachen programmiert werden, wobei vielfach c oder Python verwendet wird. Er besitzt eine Steckleiste ähnlich dem Userport des Commodore 64. Diese Steckleiste wird GPIO genannt und bedeutet General Purpose Input Output. Dies heisst, dass an die Anschlüsse für eigene Bedürfnisse anpassen kann. Einige der Anschlüsse kann man auch verwenden, um spezifische Protokolle wie UART (seriell), I²C oder SPI zu benutzen.

Auch wenn es Bücher gibt, welche eine Einspeisung direkt über die GPIO-Pins empfehlen (etwa für den Batteriebetrieb), wird dringend davon abgeraten, da es dann keinen Spannungsschutz mehr gibt. Stattdessen sollte immer über den vorgesehenen Micro-USB eingespiesen werden, auch wenn man ein Batterie-Pack verwendet.

Betriebsystem

Es gibt spezifische Betriebsysteme, welche explizit auf die Bedürfnisse des RaspPi zugeschnitten sind wie kleiner Speicherverbrauch und Vorkompilierung der verwendeten Kernelmodule. Entsprechend eine Liste der Distributionen, wobei die Liste länger ist: RasPi Betriebsysteme im Kurzportrait

Betriebssystem	Eigenschaften	Erscheinungsjahr	SD-Karte
Raspberry Pi OS (Raspian)	Basiert auf Debian Grosse Community und Wikis Download: https://www.raspberrypi.com/software/ Einfacher Installer auf der Webseite. Nach dem Download installieren und starten. Danach kann man das gewünschte OS auswählen, die eingesteckte SD-Karte anklicken, wenn man will noch Optionen einstellen und danach starten. Dann wird das OS heruntergeladen und direkt auf der SD-Karte korrekt instslliert.	2012	4GB (8GB wenn GUI)
Pidora	Basiert auf Fedora Unterstützt den Headless-Modus Grosse Community und Wikis	2014	2GB
Windows 10 IoT Core	Windows 10 IoT Core stützt sich auf die hauseigene „Universal Windows Platform“-API (UWP) und wird über die Community-Edition von Microsoft Visual Studio bedient Bitlocker-Verschlüsselung und "Secure Boot"-Funktionen Braucht ein aktuelles Windows 10 zur Entwicklung Unterstützung von Pulsweitenmodulation (PWM) für Elektromotoren Community-Forum mit eigenem Raspberry-Pi-Bereich	2015	?
Ubuntu Core	minimalistische Abwandlung der Server-Edition jedes Softwarepaket ist eine einzelne Einheit ("Snap") -> soll mehr Sicherheit bringen Hilfe entweder direkt bei Canonical oder in den Community-Foren Braucht einen Ubuntu SSO-Account	2014	?
Risc OS	ausgerichtet auf ARM (seit den 1980er Jahren) setzt stark auf "drag'n'drop", so werden Dateien geöffnet, indem man diese ins Programm zieht	2014?	2GB
Arch Linux ARM	ausgerichtet auf Profis, daher eher aufwendig Rolling Release und daher vielfach kurze Testphasen	2015?	2GB
FreeBSD	Für den RaspPi angepasste Version von FreeBSD sicher und schnell grosse Community	2015?	?

Raspberry Pi OS

Das System braucht zum Aufstarten rund 1 Minute. Die meisten Betriebssysteme basieren auf Linux. Bei Raspberry Pi OS ist allerdings der root-User nicht vorhanden. Will man daher als su arbeiten, muss man dies zuerst einrichten. Dazu zuerst mit "sudo su" zu su wechseln und anschliessend mit "passwd" ein Passwort vergeben.

Gibt es beim Update des Systems Probleme, kann man dpkg auch manuell als su aufrufen mit "dpkg --configure -a".

Daten lokal speichern

Messwerte eines Sensors können für eine Auswertung lokal gespeichert werden.

# https://github.com/simonmonk/raspberrypi_cookbook_ed2/blob/master/temp_log.py
import os, glob, time, datetime

log_period = 10 # seconds 

logging_folder = glob.glob('/media/*')[0]
dt = datetime.datetime.now()
file_name = "temp_log_{:%Y_%m_%d}.csv".format(dt)
logging_file = logging_folder + '/' + file_name

os.system('modprobe w1-gpio')
os.system('modprobe w1-therm')

# Hier wird der 1-Wire-Temperatursensor definiert
base_dir = '/sys/bus/w1/devices/'
device_folder = glob.glob(base_dir + '28*')[0]
device_file = device_folder + '/w1_slave'
 
def read_temp_raw():
   f = open(device_file, 'r')
   lines = f.readlines()
   f.close()
   return lines
 
# Daten aus der generierten Datei extrahieren
def read_temp():
   lines = read_temp_raw()
   while lines[0].strip()[-3:] != 'YES':
       time.sleep(0.2)
       lines = read_temp_raw()
   equals_pos = lines[1].find('t=')
   if equals_pos != -1:
       temp_string = lines[1][equals_pos+2:]
       temp_c = float(temp_string) / 1000.0
       temp_f = temp_c * 9.0 / 5.0 + 32.0
       return temp_c, temp_f

# Temperaturwerte abspeichern
def log_temp():
   temp_c, temp_f = read_temp()
   dt = datetime.datetime.now()
   f = open(logging_file, 'a')
   f.write('\n"{:%H:%M:%S}",'.format(dt))
   f.write(str(temp_c))
   f.close()

print("Logging to: " + logging_file)
while True:
   log_temp()
   time.sleep(log_period) # Wert alle x Sekunden auslesen

GPIO verwenden

Je nach Revision und Gneration sind die Pins etwas anders. Daher unbedingt schauen, welche Version eingesetzt wird. Die Belegung ist zwar gleich, doch die Pins haben andere Nummern, so dass man dann evtl. den "falschen" Pin anspricht. Entsprechend hier die Revision B der neueren Boards.

Pinnummer	Funktion	-	Funktion	Pinnummer
-	3.3V	o o	5V	-
2	SDA	o o	5V	-
3	SCL	o o	GND	-
4	I/O	o o	TX	14
-	GND	o o	RX	15
17	I/O	o o	I/O	18
27	I/O	o o	GND	-
22	I/O	o o	I/O	23
-	3.3V	o o	I/O	24
10	MOSI	o o	GND	-
9	MISO	o o	I/O	25
11	SCKL	o o	I/O	8
-	3.3V	o o	I/O	7

Bedeutung der Bezeichnungen

3.3V -> stellt 3.3V mit max. 50mA zur Verfügung
5V -> stellt 5V mit max. 250mA zur Verfügung -> Darf nie an einen GPIO-Pin gelangen, da dieser sonst sofort zerstört wird!
GND -> Ground-Pins
I/O -> Reine Input/Output-Pins, welche nicht für andere Zwecke vorbelegt sind. Im Gegensatz zum Arduino sind keine analogen Ein-/Ausgänge vorhanden. Sollten nicht mehr als 3mA-Strom ziehen. Es geht zwar mehr (max. 16 mA), doch auf Kosten der Lebensdauer des Chips.
TX -> Send (transmit) der seriellen Schnittstelle (UART)
RX -> Empfang (receive) der seriellen Schnittstelle (UART)
SDA -> Daten? der I²C-Schnittstelle
SCL -> Clock der I²C-Schnittstelle
MOSI -> Master Out der SPI-Schnittstelle (Daten vom Server zu den Slaves) (Die Kabel werden nicht gekreuzt)
MISO ->Master In der SPI-Schnittstelle (Daten von den Slaves zum Server) (Die Kabel werden nicht gekreuzt)
SCKL -> Clock der SPI-Schnittstelle

Bei [Doktor Monk] gibt es eine Schablone zum Ausdrucken der Pinbelegung, damit man diese direkt auf dem RasPi sieht. Möchte man aber nicht immer Kabel manuell stecken, gibt es eine Adapterplatte mit Flachbandkabel; den Pi-Cobbler, den es in diversen Elektronik-Geschäften gibt. Etwas vergleichen, sonst kauft man ihn überteuert.

Spanungen wandeln (5V -> 3.3V)

Wenn man den RasPi mit anderen Geräten koppelt, kann es sein, dass diese mit 5V arbeiten. In diesem Fall muss die Spannung heruntergesetzt werden, damit der RasPi nicht beschädigt wird. Dies geschieht entweder mit einem Spannungsteiler oder mit einem Pegelwandler-Modul. Verwendet man Widerstände, so sollten diese im Verhältnis 1:2 sein, damit die Spannung den geforderten 3.3V entspricht. Dies erreicht man etwa mit einem 270 $\Omega$ und einem 470 $\Omega$ Widerstand. Da dies aber verhältnismässig viel Strom braucht, wäre es idealer, höhere Werte wie 2.7k $\Omega$ und 4.7k $\Omega$ zu verwenden. Falls es von der Signalstabilität her reicht, ginge entsprechend auch ein 27k $\Omega$ und ein 47k $\Omega$ Widerstand.

Ein Wandlermodul hingegen ist intern schon auf die gewünschten Potentiale aufgebaut und muss nur noch mit den gewünschten Spannungen angeschlossen werden. Die Wandler gibt es etwa mit 4 oder 8 Kanälen. Kostengünstiger ist es natürlich, wenn man nur wenige Potentiale wandeln muss, dies über Widerstände zu lösen, doch bei einer grösseren Menge lohnt sich der Einsatz von BOB-11978, BOB-12009 oder Adafruit 395.

GPIO ohne Root-Rechte nutzen

Für den Zugriff auf die GPIO braucht man normalerweise Root-Rechte. Während manche empfehlen, einfach das entsprechende Skript/Programm unter Sudo auszuführen, kann man mit nachfolgender Rule die I/O auch für normale Benutzer verfügbar machen und so auf Root zu verzichten.

Die Datei wird im Verzeichnis /etc/udev/rules.d abgelegt. Die Zahl im Dateinamen kann angepasst werden. Es soll nur sichergestellt werden, dass es eine eindeutige Zahl ist.

# /etc/udev/rules.d/88-gpio-without-root.rules - GPIO without root on Raspberry Pi  # <1>
# Copyright http://BotBook.com
#
# Gruppe dialout mit Besitzer root setzen.
SUBSYSTEM=="gpio", RUN+="/bin/chown -R root.dialout /sys/class/gpio/"
SUBSYSTEM=="gpio", RUN+="/bin/chown -R root.dialout /sys/devices/virtual/gpio/"
#
# Sticky-Bit, damit neue Dateien auch dieser Gruppe angehören.
SUBSYSTEM=="gpio", RUN+="/bin/chmod g+s /sys/class/gpio/" 
SUBSYSTEM=="gpio", RUN+="/bin/chmod g+s /sys/devices/virtual/gpio/" 
#
# Lese- und Schreibberechtigung setzen
SUBSYSTEM=="gpio", RUN+="/bin/chmod -R ug+rw /sys/class/gpio/" 
SUBSYSTEM=="gpio", RUN+="/bin/chmod -R ug+rw /sys/devices/virtual/gpio/"

Die Datei kann mit sudoedit Dateiname bearbeitet werden. Die Datei wird mit Ctrl-x -> y -> Enter gespeichert und geschlossen. Um die Regeln zu übernehmen wird entweder der Raspi neu gestartet oder man liest die Regeln neu ein:

sudo service udev restart
sudo udevadm trigger -subsystem-match=pgio

GPIO-Zugriff von der Konsole

Um etwa den Tasterzustand von GPIO3 zu lesen, wird folgendermassen vorgegangen:

$ echo 3|tee /sys/class/gpio/export # Datei gpio3 erzeugen
$ echo in|tee /sys/class/gpio/gpio3/direction # Den Pin als Input setzen
$ cat /sys/class/gpio/gpio3/value # Tasterzustand zurücklesen

Da der interne Pull-Up-Widerstand aktiv ist, liefert offen eine 1, während geschlossen eine 0 liefert.

Module freischalten

Entweder man schaltet das (Standard-)Modul übers GUI frei, wenn dies vom entsprechenden OS wie Raspi OS unterstützt wird, oder man macht es manuell wie hier aufgeführt.

Damit das entsprechende Modul vom Kernel geladen wird, muss man es folgendermassen einrichten:

Kontrolle, dass es nicht in der /etc/modprobe.d/raspi-blacklist.conf aktiv ist -> einfach mit einem # am Anfang auskommentieren
Das Modul in /etc/modules hinzufügen
Bibliotheken installieren, falls notwendig
udev-Regeln hinzufügen, für die Verwendung ohne Root
Den RaspPi neu starten

I²C

I²C wird für langsame Verbindungen (Standard 100kHz, max 5MHz) verwendet, benötigt aber nur 2 Leitungen. Die Verbindung wird immer vom Master eröffnet und dient daher nur zum Abfragen. Vorteilhaft für Peripheriegeräte, die nicht schnell zu sein brauchen wie Lautstärkeregler, Analog-Digital- oder Digital-Analog-Wandler mit niedriger Abtastrate, Echtzeituhren, kleine, nichtflüchtige Speicher oder bidirektionale Schalter und Multiplexer. Während des Betriebes können Chips zum Bus hinzugefügt oder entfernt werden (Hot-Plugging). Das Protokoll ist aber sehr anfällig auf Übersprechen, Rauschen oder EMV. Entsprechend kann es nur auf kurzen Distanzen eingesetzt werden und wenn man nicht Buchsen und Stecker verwenden muss, die das Signal stören können. Das Protokoll beinhaltet aber ein Kontroll-Bit, mit dem der Slave angeben kann, dass er die Daten verstanden hat.

Das freizuschaltende Modul heisst i2c-bcm2708. Zusätzlich sollte auch i2c-dev geladen werden. Für den Zugriff sollte man auch die i2c-tools installieren:

$ sudo apt-get install i2c-tools

Damit man I²C auch ohne Root-Rechte nutzen kann, sollte man im Verzeichnis /etc/udev/rules.d/ die Datei 99-i2c.rules anlegen, die nur eine Zeile enthält:

SUBSYSTEM=="i2c-dev", MODE="0666"

Beim Verwenden darauf achten, wie viel Strom die Geräte brauchen und diese sonst extern einspeisen. Hat man ein Gerät verbunden, kann man nun seine Adresse herausfinden. Jedes angeschlossene Gerät braucht eine eindeutige Adresse:

 $ sudo i2cdetect -y 1

Bei ganz alten Boards (schwarzer Lautsprecherausgang) muss der Bus mit 0 anstatt 1 angegeben werden. Das Tool listet die Adressen (hex) entsprechend auf. Will man mehrere Geräte anschliessen, sollte man immer eines nach dem anderen anschliessen und die Adresse dann entsprechend eindeutig gestalten.

Achtung: Beim Anschluss von Geräten beachten, ob diese Pull-Up-Widerstände verwenden und mit 5V gespiesen werden. In diesem Fall muss man entweder die Widerstände entfernen oder Pegelwandler einsetzen, da sonst der Raspi zerstört wird.

SPI

SPI (Serial Peripheral Interface) verwendet (mindestens) 3 (meistens 4 oder mehr) Leitungen und verwendet kein Kontroll-Bit. Das Protokoll ist sehr flexibel. So kann je nach Ausführung die Chipselect-Leitung pro Chip oder gemeinsam geführt werden. Unterschiedliche Taktfrequenzen bis in den MHz-Bereich sind zulässig. Da die Spezifikation für die Taktflanke, die Wortlänge oder die Übertragung (MSB oder LSB zuerst) nicht genau festgelegt sind, gibt es diverse Einstellungsmöglichkeiten. Trotzdem kann es sein, dass manche Kombinationen inkompatibel sind. Man sollte sich daher vor dem Kauf die Spezifiationen und Einstellungsmöglichkeiten der Chips anschauen. Wenn man mit nur 4 Leitungen auskommen möchte, wird Daisy-Chain verwendet, wie es im Artikel So funktioniert SPI erklärt wird. Da dabei die Daten von Slave zu Slave weitergereicht werden, sind bei längeren Ketten Bitlänge*Slave-Position Taktzyklen zur Verarbeitung notwendig. Bei 5 Slaves in einem 8-Bit-System wären dies für den letzten Slave 40 Taktzyklen. Dieses Prinzip der Weiterleitung beherrschen aber nicht alles Slaves. Sonst sind durch die hohe Taktfrequenz auch grössere Ketten möglich; auch für Geräte mit hohem Durchsatz/Abtastfrequenz.

Das freizuschaltende Modul heisst spi-bcm2708. Zusätzlich sollte auch spidev geladen werden.

Für den Zugriff mit Python auf SPI muss man je nachdem noch ein Git-Repository einbinden, auch wenn dies wohl meist unterdessen schon hinzugefügt wurde. Falls nicht, geht dies auf nachfolgende Art:

$ sudo apt-get install git
$ sudo apt-get install python-dev
$ git clone git://github.com/doceme/py-spidev
$ cd py-spidev/
$ sudo python setup.py install

Damit man SPI auch ohne Root-Rechte nutzen kann, sollte man im Verzeichnis /etc/udev/rules.d/ die Datei 99-spi.rules anlegen, die nur eine Zeile enthält:

SUBSYSTEM=="spidev", MODE="0666"

Nach einem Neustart kann SPI über Python angesprochen werden.

PiFace Digital Interface Board

Das PiFace erweitert den RasPi um zusätzliche Ein- und Ausgänge (8 Outputs, wovon 2 mit Relais, 8 Inputs, wovon 4 mit Taster). Es arbeitet über SPI, welches entsprechend freigeschaltet werden muss.

$ wget http://pi.cs.man.ac.uk/download/install.txt
$ bash install.txt
$ sudo reboot

Mit dem Treiber wird auch ein Emulator ausgeliefert, mit welchem man nicht nur den Zustand sehen, sondern auch Outputs schalten kann.

Die Programmierung mit Python geschieht etwa folgendermassen zum Ein- und Ausschalten des ersten Outputs:

$ python
>>> import piface.pfio as pfio
>>> pfio.init()
>>> pfio.digital_write(0,1)
>>> pfio.digital_write(0,0)

Möchte man den Taster am ersten Eingang abfragen, wird digital_read verwendet:

$ python
>>> import piface.pfio as pfio
>>> import time
>>> pfio.init()
>>> while True:
...    print(pfio.digital_read(0))
...    time.sleep(1)

Echtzeituhr (DS1307)

Die Uhr ist dann von Vorteil, wenn man den Raspi nicht am Internet hängen hat, da sonst der Zeitserver jeweils die korrekte Zeit (genauer) liefert.

Es gibt verschiedene Chips und man sollte schauen, dass das gewünschte Modul auch für 3.3V ausgelegt ist. Sonst gibt es auch die Möglichkeit, einen Arduino mit Echtzeitmodul (wenn vorhanden) anzuschliessen und von diesem die Zeit zu übernehmen. Das Modul wird meist über die I²C -Schnittstelle angesprochen, welche entsprechend freigeschaltet sein muss.

Wie man sieht, wird hier das Modul an 5V angeschlossen. Damit die Spannung auf den I²C-Pins nicht hochgezogen wird, darf man auf dem Modul keine Pull-Up-Widerstände verwenden.

Nach dem Anschluss und der Freigabe des I²C-Busses wird nun die Adresse des Moduls gesucht und danach der Treiber für den Kernel geladen:

$ sudo i2cdetect -y 1        # Alle i2c-Geräte ausgeben lassen
$ ...68...                   # Ausgabe der Adresse des Moduls
$ sudo modprobe rtc-ds1307   # Kernel-Modul versuchen zu laden
$ sudo bash
$ sudo echo ds1307 0x68 > /sys/class/i2c-adapter/i2c-1/new_device # Gerät mit der Adresse von oben hinzufügen
$ date                       # Kontrolle der Uhrzeit -> Wird hier die falsche Zeit ausgegeben, muss man die Uhrzeit erst korrekt (übers Internet) setzen
$ sudo hwclock -w            # Schreibt die aktuelle Uhrzeit ins HW-Modul
$ sudo hwclock -r            # Auslesen der gespeicherten Zeit zur Kontrolle

Um die Uhr beim Start einzulesen, müssen folgende Schritte durchgeführt werden:

/etc/modules um das neue Modul erweitern -> Auf der untersten Zeile folgendes hinzufügen: rtc-ds1307
/etc/rc.local erweitern, um das Modul einzulesen -> Zusatzzeilen vor dem abschliessenden "exit 0":

 echo ds1307 0x68 > /sys/class/i2c-adapter/i2c-1/new_device
 sudo hwclock -s

Gertboard

Das [Gertboard] ist eine Erweiterungsplatine, welche neben gepufferten digitalen I/O unter anderem A/D- (10 Bit) und D/A-Wandler (8, 10 oder 12 Bit) bietet und auch eine Motorsteuerung (Maximum 18V and 2A) enthält. Zusätzlich befindet sich noch eine ATmega328ATmega328 MCU (gleicher Chip wie auf dem Arduino Uno) auf dem Board, mit der man unabhängige Arduino Programme laufen lassen kann. Die gepufferten Eingänge schützen unter anderem die I/O des RasPi. Die Ausgänge können übrigens mit bis zu 50V mit 0.5A betrieben werden.

Für das Gertbourd gibt es Beispielprogramme, die man folgendermassen installiert:

$ wget http://raspi.tv/download/GB_Python.zip
$ unzip GB_Python.zip
$ cd GB_Python

Die Programme teilen beim Start mit, welche Jumper wie gesteckt werden müssen, damit die notwendigen Bereiche auf dem Board korrekt verbunden sind:

$ sudo python buttons-rg.py

RaspiRobot-Board

Das Board liefert Ausgänge mit denen man entweder einen Schrittmotor oder 2 Gleichstrommotoren antreiben kann. Dazu gibt es zwei Low-Power-Ausgänge und zwei digitale Eingänge. Das Board kann über die Standard-Bibliotheken bedient werden:

$ sudo apt-get install python-rpi.gpio
$ sudo apt-get install python-serial
$ wget https://github.com/simonmonk/raspirobotboard/archive/master.zip
$ unzip master.zip
$ cd raspirobotboard-master
$ sudo python setup.pi install

Nun ein Beispiel für einen Zugriff auf das Board:

$ sudo python
>>> from raspirobotboard import *
>>> rr = RaspiRobot()
>>> rr.set_led1(1) # Schaltet Led 1 ein
>>> rr.set_led1(0)
>>> rr.set_oc1(1)
>>> rr.set_oc1(0) # Schaltet Ausgang 1 aus
>>> print(rr.sw1_closed()) # Liest den Status des Drückers 1 ein.

Die Verwendung der Motoren (forward, reverse, left, right, stop) wird unter anderem auf der Projektseite von [RaspiRobot] beschrieben.

Prototyping-Boards (Humble Pi / Pi Plate / Paddle Board)

Diese Boards sind reine Entwicklungsplatten ohne Elektronik und dienen dazu, Schaltungen zu entwickeln. Sie besitzen einen Stecker für die GPIO und Lötpins, damit man eigene Schaltungen entwerfen kann. Fürs Prototyping kann natürlich auch ein Steckboard verwendet werden.

Humble Pi

Besitzt Aussparungen für die grossen Stecker des RasPi.
besondere Bereiche für Spannungsregler und Transistoren
Hersteller: [Ciseco]

Pi Plate

keine Aussparungen sondern höhere Sockel
Bereich für SDM und Schraubklemme
Schraubklemmen, welche direkt mit den GPIOs verbunden sind -> Alternative ist das Paddle-Board zum Klemmen der Drähte.

Paddle Board

Wird über ein Flachbandkabel angeschlossen
Alle GPIO-Verbindungen können einfach mittels Draht eingeführt werden, so dass keine Female-Adapter notwendig sind.
Mehr Platz als direkt auf dem Board
Alternative ist das Pi Plate, bei dem auch Litzen verwendet werden können, weil die Anschlüsse geschraubt werden.

Wichtige Bibliotheken

Wenn es um die System-Bibliotheken von Python geht, dann direkt im Artikel über Python nachschauen. Damit man auf die Hardware zugreifen kann, muss je nach Sprache und Anwendungsfall die entsprechende Bibliothek installiert werden. Die Bibliotheken abstrahieren auch den Zugriff auf die GPIO-Dateien, so dass man nicht mehr die Dateien abfragen muss, sondern direkt die Zustände abfragen kann. Hier ein Beispiel ohne GPIO-Bibliothek:

# led_hello.py - blink external LED to test GPIO pins
# (c) BotBook.com - Karvinen, Karvinen, Valtokari

import time, os

def writeFile(filename, contents):	# Funktion zum Schreiben in eine Datei
  with open(filename, 'w') as f:	# Dateihandle erstellen. Mit "with" wird sichergestellt, dass der Dateihandle am Schluss geschlossen wird.
    f.write(contents)                  # Inhalt schreiben

print("Blinking LED on GPIO 27 once...")

if not os.path.isfile("/sys/class/gpio/gpio27/direction"): # Testen ob es eine Datei für den Pin27 gibt.
  writeFile("/sys/class/gpio/export", "27")                # Datei erstellen

writeFile("/sys/class/gpio/gpio27/direction", "out")       # Pin als Output definieren
writeFile("/sys/class/gpio/gpio27/value", "1")             # Pin einschalten
time.sleep(2)
writeFile("/sys/class/gpio/gpio27/value", "0")

Nun das Gleiche mit der GPIO-Bibliothek:

import time, os, RPi.GPIO as GPIO

print("Blinking LED on GPIO 27 once...")

GPIO.setmode(GPIO.BCM)   # Pin im Broadcom-Modus ansprechen
GPIO.setup(27, GPIO.OUT) # Pin als Output definieren
GPIO.output(27, 1)       # Pin einschalten
time.sleep(2)
GPIO.output(27, 0)

Wie man sieht, ist es nicht nur kürzer, sondern auch aufs Wesentliche konzentriert.

gpiozero

Diese Bibliothek ist bei den meisten Distributionen schon vorinstalliert. Für eine Installation diese das nächste Kapitel RPi.GPIO. Beispiele zur Verwendung siehe im Artikel zu Python.

RPi.GPIO

Diese Bibliothek ist bei den meisten Distributionen schon vorinstalliert. Sollte dies nicht der Fall sein, muss diese mit dem Paketmanager installiert werden. Allgemeine Infos zum Umgang mit Linux im Artikel Allgemeine Daten zu Linux, Tipps und Tricks und Systemeinstellungen.

Ist apt im Einsatz, kann man die Bibliothek folgendermassen installieren:

$ sudo apt-get install python-dev
$ sudo apt-get install python-rpi.gpio

WiringPi

WiringPi ist eine Bibliothek, welche unter c / c++ verwendet wird, auf die man mit den entsprechenden Wrappern auch von anderen Sprachen aus zugreifen kann wie etwa über Python. Mit gpio kann direkt von der Shell aus auf die Pins zugegriffen werden und dies ermöglicht auch den Zugriff aus Shell-Skripten heraus.
Wie man der Entwickler-Webseite entnehmen kann, wird die Bibliothek nicht mehr weiter entwickelt und ist auch nicht für Anfänger gedacht, sondern für Leute, die sich auskennen.

$ sudo apt-get install wiringpi

Test der Installation:

$ gpio -v
$ gpio readall

PySerial

Notwendig, um die serielle Schnittstelle mit Python zu verwenden.

$ suto apt-get install python3-serial

Nicht vergessen, die serielle Konsole zu deaktivieren, falls diese aktiv ist. Je nach System ist diese nicht "aktiviert".

bottle (Webserver)

Mit Einbindung dieser Bibliothek können GPIOs über einen Webserver abgefragt (dargestellt) und gesetzt werden. Die Installation von bottle wird im Artikel Python -> bottle beschrieben.

from bottle import route, run
import RPi.GPIO as GPIO

hostIP = '192.168.1.199' # Die IP des Raspi entsprechend anpassen
portNr = 80              # Standard-http Port. https verwendet 443. Ohne Portangabe wartet der Webbrowser auf 8080.

GPIO.setmode(GPIO.BCM)   # BCM Nummerierungsschema verwenden
led_pins = [18, 23, 24]  # 3 LEDs werden auf den PINs angesteuert
led_states = [0, 0, 0]   # Status ist ausgeschaltet
switch_pin = 25          # 1 Taster auf diesem Pin einlesen

GPIO.setup(led_pins[0], GPIO.OUT)                          # Pin auf Output setzen
GPIO.setup(led_pins[1], GPIO.OUT)                          # Pin auf Output setzen
GPIO.setup(led_pins[2], GPIO.OUT)                          # Pin auf Output setzen
GPIO.setup(switch_pin, GPIO.IN, pull_up_down=GPIO.PUD_UP)  # Pin auf Input setzen und den internen  Pull-Up Widerstand aktivieren

def switch_status():              # Funktion zum Einlesen des Tasters
   state = GPIO.input(switch_pin) # Status des Tasters einlesen
   if state:                      # Wenn aktiv
       return 'Nicht gedrückt'    # Status zurückliefern. Durch den Pull-Up Widerstand muss man die Logik umkehren.
   else:                          # Wenn nicht aktiv
       return 'Gedrückt'          # entsprechend anderen Status liefern.

def html_for_led(led):            # Funktion zum Setzen der LEDs
   led = str(led)                 # Sicherstellen, dass die gewünschte LED als String ausgewertet wird
   result = " <input type='button' onClick='changed(" + led + ")' value='LED " + led + "'/>" # JavaScript-Routine aufrufen, um den Status-Button zum Schalten der LED zu verwenden
   return result                  # Den neuen Status der LED rückmelden.

def update_leds():                         # Funktion, um den Status der LED effektiv zu setzen
   for i, value in enumerate(led_states):  # LED-Feld einzeln auslesen
       GPIO.output(led_pins[i], value)     # Pins entsprechend ihres Werts setzen

@route('/')                                # Der Aufruf geschieht über localhst und man muss nicht eine Subadresse eingeben (http://localhost/subadresse), um die Webseite sehen zu können.
@route('/<led>')                           # Es werden noch Unterseiten für jede LED erstellt
def index(led = "n"):                      # Index-Seite erstellen. Je nachdem, welche Nummer übergeben wurde, wird diese dann im Skript ausgewertet. Ohne Angabe bekommt die Variable den Wert "n"
   print(led)                              # ?
   if led != "n":                          # Wurde in der URL die Nummer der LED mitgegeben (localhost/1), so wird diese ausgewertet -> Es gibt keine Prüfung auf zu grosse oder kleine Zahlen
       led_num = int(led)                  # sicherstellen, dass die Eingabe ein Int war
       led_states[led_num] = not led_states[led_num] # Status der gewählten LED invertieren
       update_leds()                       # Funktion zum Setzen des Status aufrufen
   response = "<script>"                   # JavaScript-Routine dynamisch erstellen
   response += "function changed(led)"
   response += "{"
   response += "  window.location.href='/' + led" # Es wird auf die Unterseite verzweigt, deren Button gedrückt wurde und dann wird der Code oben für diese LED ausgeführt
   response += "}"
   response += "</script>"
   
    response += "<h1>GPIO Control</h1>"     # Überschrift h1 generieren
    response += "<h2>Button=" + switch_status() + "</h2>" # Status des Tasters auslesen und als Überschrift h2 darstellen
    response += "<h2>LEDs</h2>"             # Überschrift h2
    response += html_for_led(0)             # Einbindung der ersten LED
    response += html_for_led(1)             # Einbindung der zweiten LED
    response += html_for_led(2)             # Einbindung der dritten LED
    return response                         # Darstellung der Webseite
  
run(host = hostIP, port = portNr, debug=True, reloader=True) # Starten des Scripts. Der Parameter debug ist optonal und sollte entfernt werden, wenn das Script produktiv ist.
                                                             # Dies gilt auch für reloader, der dafür sorgt, dass Änderungen an der Quelldatei ohne Neustart des Web-Servers übernommen werden

Das Programm stammt von Simon Monk und kann auf github heruntergeladen werden.

Serielle Schnittstelle

Der RasPi ist normalerweise so konfiguriert, dass er die Ein-/Ausgabe der Konsole parallel auch auf die Pins der seriellen Schnittstelle leitet. Dies ist zwar nützlich bei einer Analyse ohne Monitor, doch störend, wenn man mit einem externen Gerät "ungestört" kommunizieren möchte. Entsprechend muss man diese Weiterleitung in /etc/inittab auskommentieren.

$ sudo nano /etc/inittab
...
#T0:23:respawn:/sbin/getty -L ttyAMA0 115200 vt100

Speichern mit Ctrl-X gefolgt von Y. Danach den RasPi neu starten. Zum Einschalten muss die Zeile entsprechend wieder entkommentiert werden.

Um die serielle Schnittstelle über Python zu erreichen, wird die entsprechende Bibliothek installiert. Anschliessend kann man noch [minicom] installieren, um die Verbindung zu testen.

$ sudo apt-get install minicom
$ minicom -b 9600 -o -D /dev/ttyAMA0

Die Baudrate muss natürlich mit den Angaben der Gegenstelle übereinstimmen. Im minicom kann die Hilfe mit Ctrl-A und danach Z aufgerufen werden. Mit der Taste E wird das lokale Echo eingeschaltet, so dass man die eigenen Eingaben auch sieht.

externe Computerchips (ICs)

Externe Chips können entweder über die obigen Schnittstellen angeschlossen werden oder sie arbeiten unabhängig und brauchen nur direkt angeschlossene Steuerleitungen, um die gewünschten Funktionen auszuführen. Nachfolgend einige ICs, die in Verwendung mit dem RasPi nützlich sind.
Damit man weiss, welche PINs sich wo befinden, haben elle ICs entweder eine Einkerbung auf einer Seite oder einen Punkt über PIN 1. Normalerweise werden die Pins im Gegenuhrzeigersinn nummeriert, doch dies steht im entsprechenden Datenblatt.

Für die Anbindung braucht es meist noch elektronische Bauteile wie Transistoren, Widerstände oder Kondensatoren. Diese Bauteile werden auf der Seite Elektronik beschrieben.

A/D-Wandler MCP 300x oder MCP 320x

Diese Bausteine liefern je nach Serie eine andere Auflösung und entsprechende Eingänge. Die Anbindung geschieht über SPI. Die 300x-Serie liefert eine Auflösung von 10 Bit und die 320x eine von 12 Bit. Die letzte Ziffer bestimmt die Anzahl der möglichen Kanäle von 1 (3x01) bis 8 (3x08). Wie die Anbindung des Chips geschieht und dessen Auswertung läuft, ist im Abschnitt über den Potentiometer sichtbar.

AND-Gates MC14081BCP

Der MC14081BCP enthält vier 2-fach AND-Gates und arbeitet mit 5-15V. Bei 5V werden Werte unter 2.3V als Low und über 2.7 als High ausgewertet.

GPS-Modul

GPS-Module können fertig gekauft und ausgewertet werden. Der Anschluss an den Raspi geschieht entweder seriell oder über eine andere Schnittstelle. Um die Daten auszuwerten gibt es Dienste, welche auf dem Raspi installiert werden können. Ein Beispiel liefert das Rezept 11.10 im Raspi-Kochbuch.

Darlington-Treiber ULN280x

Diese Motortreiberbaustein-Reihe unterscheidet sich in der letzten Ziffer, welche die Eingangsspannung und damit den Einsatz beschreibt. 1 = PMOS-CMOS (allgemeiner Einsatz mit Widerstand zur Strombegrenzung), 2 = 14-25V PMOS (10.5k $\Omega$ mit Zener-Diode), 3 = 5V TTL/CMOS (mit 2.7k $\Omega$ ) und 4 = 6-15V CMOS/PMOS (10.5k $\Omega$ ).

Der Chip enthält neben dem Transistor eine Diode, um die Induktivitäten abzufangen.

Jeder Pin schaltet bis zu 50V und erlaubt 0.5A mit Peaks bis 0.6A. Die Outputs können parallel geschaltet werden, um grössere Ströme zu erlauben.

H-Brücke L293D

Der L293D-Chip kann 2 Motoren gleichzeitig ansteuern. Dabei darf er mit max. 600mA Dauerstrom belastet werden (pro Kanal) und er verträgt Spitzen bis 1A. Bei einer H-Brücke werden die Anschlüsse über Transistoren so geschaltet, dass die Richtung gedreht wird, ohne einen Kurzschluss zu verursachen. Wenn man den Chip betrachtet, so kann man ihn links und rechts teilen. Einzig die Anschlüsse für die Spannungen sind gemeinsam auszuführen. Entsprechend wird nur die "linke" Seite beschrieben.
Die Einspeisung für den Motor (3V-36V) geschieht über Vs (Pin 8). Die Speisung des IC (5-36V) geschieht über Vss (Pin 16). Damit der IC arbeitet, muss man den Enable-Pin (1) setzen. Die Geschwindigkeit kann man ensprechend mit PWM auf diesen Pin steuern. Die Drehrichtung wird über die zwei Input-Pins (2+7) gesteuert. Hierbei muss für Uhrzeigersinn der Input1 (Pin 2) aktiv sein und für Gegenuhrzeigersinn der Input2 (Pin 7). Der Motor selber wird an Output1 und Output2 angeschlossen. Ist die Drehrichtung verkehrt, müssen die Kabel hier getauscht werden.
Damit die Masse stimmt, wird das Minus der Einspeisung und ein GND-Pin des Raspi auf einen der GND des L293D geführt (Pin 4,5,12,13).
Der Chip kann entsprechend für die Richtungsumschaltung bei Gleichstrommotoren oder bei bipolaren Schrittmotoren verwendet werden.

H-Brücken-Motorsteuerungs-Modul

Es gibt von verschiedenen Herstellern Module zum Ansteuern von Motoren. Je nach Modul müssen diese anders verdrahtet werden, doch das Prinzip bleibt gleich. Entsprechend muss man das Beiblatt der Schaltung studieren, auch was die Belastbarkeit des Moduls angeht.

NAND-Gates MC14093B

Der MC14093B enthält vier 2-fach NAND-Gates und arbeitet mit 5-15V. Bei 5V werden Werte unter 1.9V als Low und über 2.9 als High ausgewertet. Die Pinbelegung ist gleich wie beim MC14081B 2-Fach AND-Gate.

Timerbaustein 555

Der CA555E, NE555 oder ähnliche Timer-Bausteine bieten die Möglichkeit, Ausgänge in definierten Zeitabständen zu schalten, eine Weile beibehalten oder nach Vorgabe umzuschalten.

Pin	Name	Bedeutung
1	GND	Masse
2	TRIG	Fällt der Pin unter 3V, so wird Pin 3 auf die Eingangsspannung gesetzt.
3	OUT	0V oder VCC. Je nach Zustand des IC.
4	RESET	Wenn auf High, wird das Zeitintervall nicht zurückgesetzt.
5	CTRL	?
6	THRES	Steigt die Sapnnung am Pin über 2/3 der Eingangsspannung, wird Pin3 auf 0V gesetzt.
7	Disc	?
8	VCC	Eingangsspannung (4.5-15V)

Zähler

(4-Bit) MC74HC193N

Der MC74HC193N ist ein setzbarer binärer 4-Bit Auf-/Abwärts-Zähler mit Reset-Möglichkeit. Er ist pinkompatibel mit dem LS193. Wie man der Info entnehmen kann, ist es möglich, den Zähler zu kaskadieren, um grössere Bereiche zu zählen.

Dekadenzähler MC14017BCP

Dieser Zähler repräsentiert an seinen Ausgängen jeweils die 10er-Zahl. So können entsprechend dezimale Anwendungen angesteuert werden.

Sensoren

Ein Sensor liefert Daten. Dies kann entweder digital erfolgen oder analog. Da der Raspi keine analogen Eingänge hat, müssen diese über einen A/D-Wandler eingelesen werden. Wenn die Werte nicht exakt sein müssen, können die Werte auch digital mittels eines Kondensators und der resultierenden Sprungantwort berechnet werden.
Die Pegel an den Pins sollten unter 0.8V für Low und mindestens 1.3V für High haben, um undefinierte Zustände zu vermeiden.

Sprungantwort (analoge Werte an digitalem Pin)

# https://github.com/simonmonk/raspberrypi_cookbook_ed2/blob/master/pot_step.py
import RPi.GPIO as GPIO
import time, math

C = 0.33 # uF
R1 = 1000 # Ohms

GPIO.setmode(GPIO.BCM)

# Pin a charges the capacitor through a fixed 1k resistor and the thermistor in series
# pin b discharges the capacitor through a fixed 1k resistor 
a_pin = 18
b_pin = 23 

# empty the capacitor ready to start filling it up
def discharge():
   GPIO.setup(a_pin, GPIO.IN)
   GPIO.setup(b_pin, GPIO.OUT)
   GPIO.output(b_pin, False)
   time.sleep(0.1)

# return the time taken (uS) for the voltage on the capacitor to count as a digital input HIGH
# than means around 1.65V
def charge_time():
   GPIO.setup(b_pin, GPIO.IN)
   GPIO.setup(a_pin, GPIO.OUT)
   GPIO.output(a_pin, True)
   t1 = time.time()
   while not GPIO.input(b_pin):
       pass
   t2 = time.time()
   return (t2 - t1) * 1000000

# Take an analog reading as the time taken to charge after first discharging the capacitor
def analog_read():
   discharge()
   t = charge_time()
   discharge()
   return t

# Convert the time taken to charge the cpacitor into a value of resistance
# To reduce errors, do it 100 times and take the average.
def read_resistance():
   n = 10
   total = 0;
   for i in range(1, n):
       total = total + analog_read()
   t = total / float(n)
   T = t * 0.632 * 3.3
   r = (T / C) - R1
   return r
try:
   while True:
       print(read_resistance())
       time.sleep(0.5)
finally:
   GPIO.cleanup()

Beschleunigung

Bewegung

Mit einem PIR (Passive Infrarot) Bewegungsmelder kann man erkennen, falls eine Bewegung im Umfeld des Sensors stattgefunden hat. Je nach Sensor kann man mit einem Potentiometer die Empfindlichkeit des Sensors einstellen, wenn man etwa ein Aquarium mit Fischen hat und nicht möchte, dass der Sensor deswegen auslöst. Es gibt auch Sensoren, bei denen man einstellen kann, wie lange das Ausgangssignal aktiv bleiben soll, wenn der Sensor ausgelöst hat.

Es gibt verschiedene Sensoren auf dem Markt. Entsprechend muss man schauen, ob diese eine Einspeisung von 3.3V/5V oder eine andere Einspeisung brauchen. Zusätzlich ist auch wichtig, welche Ausgangsspannung sie generieren. Ist diese höher als 3.3V, so muss man entsprechend einen Spannungsteiler einsetzen, um den Pin zu schützen.

import RPi.GPIO as GPIO
import time

GPIO.setmode(GPIO.BCM)
GPIO.setup(18, GPIO.IN, pull_up_down=GPIO.PUD_UP)

while True:
   input_state = GPIO.input(18)
   if input_state == False:
       print('Bewegung entdeckt')
   time.sleep(0.5)

CO₂

Drehung/Drehgeber

Um eine Drehung zu erfassen, gibt es mehrere Möglichkeiten. In diesem Abschnitt soll der Drehgeber betrachtet werden, welcher über ein Schaltmuster aufzeigt, in welche Richtung (und wie viel) er gedreht wird. Meist wird ein Quadratur-Verfahren verwendet mit zwei unterschiedlichen Spulen, so dass sich das Bewegungsmuster nach 4 Schritten wiederholt. Schlussendlich ergibt sich ein fixes 2-Bit-Muster mit definierten Übergängen, wodurch man erkennt, ob nach links oder rechts gedreht wurde. Damit keine Sprünge entstehen, muss man schneller einlesen, als der Drehgeber die übernächste Position erreicht hat. Im "schlimmsten" Fall detektiert man sonst einen Schritt nach links, obwohl man drei Schritte nach rechts (oder umgekehrt) gedreht hat. Zusätzlich sollte man aber auch beim Einlesen eine kurze Pause einlegen (von 1ms), damit bei Übergängen kein "Prellen" entsteht.

import RPi.GPIO as GPIO
import time

GPIO.setmode(GPIO.BCM)

input_A = 18
input_B = 23

GPIO.setup(input_A, GPIO.IN, pull_up_down=GPIO.PUD_UP)
GPIO.setup(input_B, GPIO.IN, pull_up_down=GPIO.PUD_UP)

old_a = True
old_b = True
x = 0

def get_encoder_turn():
   # return -1, 0, or +1
   global old_a, old_b                    # globale Variablen müssen in der Funktion gekennzeichnet werden, wenn man sie nicht nur lesen, sondern beschreiben will
   result = 0
   new_a = GPIO.input(input_A)
   new_b = GPIO.input(input_B)
   if new_a != old_a or new_b != old_b :  # Logik für die Auswertung, ob vorwärts oder rückwärts gedreht wurde
       if old_a == 0 and new_a == 1 :
           result = (old_b * 2 - 1)
       elif old_b == 0 and new_b == 1 :
           result = -(old_a * 2 - 1)
   old_a = new_a
   old_b = new_b
   time.sleep(0.001)                      # Verhindert "prellen"
   return result

while True:
   change = get_encoder_turn()
   if change != 0 :                       # Bei 0 wurde nichts geändert, daher nur zählen, wenn gedreht wurde
     x = x + change
     print(x)

Druck (Kraft)

Hier kann etwa der FlexiForce eingesetzt werden, welcher auf Druck reagiert. Auch wenn dieser Widerstand 3 Anschlüsse hat, muss man ihn je nachdem mit einem Spannungsteiler anschliessen. Weil der mittlere Anschluss je nachdem nicht belegt ist. Dies erfährt man im Datenblatt. Wie man den Spannungsteiler aufbaut, steht im Abschnitt Helligkeit und ein Programm zum Einlesen kann man beim Arduino nachschauen.

Entfernung

mit Infrarot

Hier gibt es zwei Varianten siehe beim Arduino. Die digitale schaltet, wenn etwas in den Bereich des Sensors kommt, während die analoge einen Wert für den Abstand liefert. Hier der Code für einen "Schalter".

import RPi.GPIO as GPIO
import time

def my_callback(channel): # selbst definierte Interrupt-Routine
  print('Gegenstand in der Nähe des Sensors!')

GPIO.setmode(GPIO.BCM)
GPIO.setup(18, GPIO.IN, pull_up_down = GPIO.PUD_UP)
GPIO.add_event_detect(18, GPIO.FALLING, callback = my_callback, bouncetime = 100) # Aufruf der Interruptroutine "my_callback", sobald am Pin 18 die Flanke abfällt. 
                                                                                  # Um Prellen zu vermeiden, wird 100ms gewartet

while True:
  i = i + 1
  print(i)
  time.sleep(1) # Dank dem Interrupt wird die Flanke auch "im Schlafen" detektiert.

Um die Signale sauber zu verarbeiten, wird hier mit einem Interrupt gearbeitet. Auf dem Bild aus dem Sensorbuch sieht man den Anschluss eines 5V-Sensors, der mittels eines Spannungsteilers angeschlossen wird. Da keine grossen Ströme fliessen sollen und der Raspi alles höher als 1.3V als HIGH erkennt, kann man 2 gleiche Widerstände verwenden, was die Spannung auf 2.5V halbiert. Damit die Verlustleistung nicht zu gross wird, kann man 1k $\Omega$ oder 2.2k $\Omega$ Widerstände der E-Reihe verwenden.

mit Schall

Hier kann etwa der Parallax PING (kostet 30$) oder der HC-SR04 eingesetzt werden, welcher wesentlich preisgünstiger ist. Je nach Sensor ist die Erkennung erschwert, wenn die Fläche abgewinkelt ist oder sehr weich/porös, so dass die Schallwellen verschluckt werden. Mögliche Anwendungen sind neben den Abstandserkennungen auch Füllstandssensoren, wenn der Sensor die Flüssigkeit detektiert. Beispiele für den Arduino finden sich auf der verlinkten Seite zum HC-SR04. Diese Sensoren senden kein analoges Signal mit der Entfernung, sondern man sendet einen Impuls, indem man die entsprechende Flanke auf den Trigger-Pin sendet und nachher schaut, wann das Modul den Echo-Pin aktiviert. Die entsprechend vergangene Zeit kann man dann für die Entfernungsberechnung verwenden. Beim Berechnen kann man entweder fixe Werte verwenden, oder man macht diese abhängig von der Höhe, der Temperatur und der Luftfeuchtigkeit, da diese die Schallgeschwindigkeit beeinflussen. Da die Werte für praktische Aufgaben und die Genauigkeit der Sensoren nicht relevant sind, kann man auch einfach eine entsprechende Konstante verwenden wie z.B. 58 $\mu$ s pro cm für den HC-SR04.
Beim Arduino ist auch ein Beispiel aufgeführt.

# https://github.com/simonmonk/raspberrypi_cookbook_ed2/blob/master/ranger.py
import RPi.GPIO as GPIO
import time

trigger_pin = 18  # Aktiviert das Echo
echo_pin = 23     # Liest das Echo ein

GPIO.setmode(GPIO.BCM)
GPIO.setup(trigger_pin, GPIO.OUT)
GPIO.setup(echo_pin, GPIO.IN)

def send_trigger_pulse():
   GPIO.output(trigger_pin, True)
   time.sleep(0.0001)              # Echo-Puls ganz kurz aktiviert lassen
   GPIO.output(trigger_pin, False)

def wait_for_echo(value, timeout): # Zähler starten für die Zeitberechnung
   count = timeout
   while GPIO.input(echo_pin) != value and count > 0: # Wenn die Zeit 0 ist, Zählung abbrechen (Echo wurde nicht empfangen)
       count = count - 1

def get_distance():
   send_trigger_pulse()
   wait_for_echo(True, 10000) # Die Länge der Distanz wird nicht mit Zeit Trigger bis Zeit Echo berechnet, sondern der Echo-Pin bleibt, je grösser die Distanz, umso länger aktiv
   start = time.time()
   wait_for_echo(False, 10000)
   finish = time.time()
   pulse_len = finish - start
   distance_cm = pulse_len / 0.000058 # Parameter fix aus Schallgeschwindigkeit. Beim Arduino wird gezeigt, wie der Parameter berechnet wird.
   return (distance_cm)
   
while True:
   print("cm=%f" % get_distance())
   time.sleep(1)

GPS

Helligkeit (Licht)

Hier kann ein Fotowiderstand verwendet werden. Bei den meisten verringert sich der Widerstand mit zunehmender Lichtmenge. Da der Widerstand analog arbeitet, wird er über einen A/D-Wandler angeschlossen. Beim Arduino findet sich dazu ein Beispielcode. Man muss einfach statt einem Poti einen Spannungsteiler (etwa 10k $\Omega$ bis 1M $\Omega$ ) mit dem Fotowiderstand bauen. Der Widerstand muss sich am Sensor orientieren, so dass der Teiler den ganzen Spektrumsbereich liefert. Beim Raspi ist es das gleiche und wird im Abschnitt vom Potentiometer gezeigt.

Möchte man auf den IC verzichten, so kann man die Bereiche (hell / dunkel) auch mit einem RC-Glied und der entsprechenden Sprungantwort auswerten.

Gas (CO2, Methan usw.)

Es gibt Sensoren, welche das Vorhandensein von entsprechenden Gasen (oder ähnlichen) detektieren können. Hierbei wird mit einem Heizelement und einem Katalysator der Widerstand an Hand des gewünschten Gases verändert. Sparkfun führt mehrere Gas-Sensoren. Die Sensoren können entsprechend je nach notwendiger Genauigkeit über ein A/D-Modul oder ein RC-Glied ausgewertet werden.

Infrarot-Bewegungssensor

Der Anschluss eines PIR (Passiver Infrarot Sensor) Modell HC-SR501 oder ähnlich (HC-SR505 Mini) ist denkbar einfach. Die 3 Pins werden folgendermassen angeschlossen: VCC kommt an 5V, GND and GND und Data an einen Pin. Da der Sensor dort ein 3.3V-Signal liefert ist ein Anschluss ohne Konverter möglich. Sobald der Sensor eine Bewegung eines warmen Körpers (Mensch / Tier) erfasst, wird das Data-Signal aktiviert.

Betriebsspannung: 5 ... 20 V DC
Level der Ausgangsspannung: 3,3V high / 0 V low
Verzögerungszeit einstellbar (0,3 ... 18 Sekunden)
Schaltzeit (einstellbar): 5 ... 200 Sekunden
Reichweite (einstellbar): 3 ... 7 Meter (Beim SR505 Mini sind es max. 3m)
Blockade-Zeit: 2,5 Sekunden -> Diese startet, wenn das Aktiv-Signal abfällt. Während dieser Zeit wird keine Bewegung detektiert.
Wiederholungstrigger einstellbar über Lötbrücke oder Jumper (je nach Ausführung)
Erfassungsbereich: 140°
Je nach Ausführung können optional auch noch Thermistoren und IR-Sensoren eingelötet werden, um auch bei wärmeren Temperaturen zu arbeiten oder automatisch nur im Dunkeln zu arbeiten (Lichtschalter): https://elektro.turanis.de/html/prj108/index.html

Infrarot-LED

Mit einer IR-Empfänger-LED wie dem TSOP 31238 kann man IR-Signale empfangen und verarbeiten. Wichtig ist natürlich, dass man die korrekte Frequez absorbiert, da der Infrarot-Bereich gross ist und die Frequenzen nicht genormt sind. Allerdings sollten 950nm für den Empfänger ein breites Spektrum der Geräte abdecken. Entsprechend gibt es auch Sender-LEDs in diesem Bereich wie etwa die Osram SFH4546, bei welcher die Kathode das längere Beinchen hat. Im Buch Roboter mit Raspberry Pi wird im Kapitel 4.8 "Roomba mit IR-Steuerung" beschrieben, wie man eine stabile Schaltung für Sender und Empfänger aufbaut und auch, wie man mit LIRC die Befehlscodes einer Fernsteuerung ausliest, um sie nachher bei anderen Projekten mit IR-Empfängern einsetzen zu können, wie etwa bei einem fahrbaren Roboter.

Kamera

Es lassen sich diverse Kameras und USB-Webcams anschliessen und verwenden. Natürlich wird die eigene "Pi Camera Module v2" nativ unterstützt, doch auch andere Kameras lassen sich einfach einbinden.

Systemkamera verwenden

Ab Version 11 (bullseye) -> less /etc/os-version ist die Kamera wegen eines Treiberwechsels nicht mehr wie bisher einfach übers GUI in den Einstellungen aufzufinden und es kann auch nicht mehr der bisherige Befehl raspistill verwendet werden, sondern man muss libcamera einsetzen. Siehe dazu den Artikel: https://gnulinux.ch/raspberry-pikamera-probleme-mit-raspberry-os-bullseye Die Kamera lässt sich aber über die Kommandozeile sudo raspi-config im Menü "Schnittstellen" als legacy einbinden. Mit dem Modul kann aber nur die Systemkamera eingebunden werden. Webcams werden damit nicht gefunden.

Bild aufnehmen

from picamera import PiCamera
camera = PiCamera()
camera.start_preview()

def stop_kamera():
   camera.stop_preview()
   exit()
   
def take_photo():
   camera.capture('image.png')
   print('Föteli!')
   
take_photo()
stop_kamera()

Video aufzeichnen

from picamera import PiCamera

camera = PiCamera()
camera.resolution = (640, 480)
camera.start_recording('video.h264')
camera.wait_recording(60)
camera.stop_recording()

Mit Webcam Bilder aufnehmen

Für das Aufnehmen von Fotos eignet sich etwa fswebcam, welches einfach installiert wird und welches dann eine vorhandene Webcam einbindet und entsprechend der übergebenen Parameter Photos schiesst.

sudo apt-get install fswebcam   # Sucht und installiert das Programm
cd /home/pi/Pictures            # Damit Bilder auch gespeichert werden können
fswebcam bild.png               # Sucht eine Webcam und speichert das Bild
fswebcam -r 1280x1010 bild.png  # Versucht ein Bild in der angegebenen Auflösung zu schiessen. Wenn dies nicht möglich ist, wird auf die wirkliche Auflösung skaliert

Je nach Einspeisung muss man schauen, ob der Raspi mit der Kamera auch stabil läuft, da die meisten Webcams ihren Strom direkt über den Raspi beziehen.

Mit Webcam Videos aufnehmen/streamen

Dazu gibt es eine gute Anleitung unter: https://tutorials-raspberrypi.de/raspberry-pi-ueberwachungskamera-livestream-einrichten/ Entsprechend werden hier nur die Befehle zusammengefasst.

sudo apt-get install motion -y  # Sucht und installiert das Programm. Je nach Konfiguration erscheinen Meldungen, dass das Verzechnis schon existiert usw. Die Meldungen kann man ignorieren.
lsusb                           # Damit werden die USB-Geräte aufgelistet, falls man nicht schon von fswebcam weiss, dass die Kamera korrekt gefunden wird.
v4l2-ctl -V                     # Listet die Parameter der aktuellen Kamera auf (/dev/video0). Hat man mehrere Kameras eingesteckt, sollte man mit "ls /dev/video*" kontrollieren, wo die gewünschte Kamera abgelegt wurde.
sudo nano /etc/motion/motion.conf # Nun müssen die gefundenen Parameter noch in die Konfigurationsdatei fürs Programm motion kopiert werden.
sudo nano /etc/default/motion   # Die Zeile start_motion_daemon=yes einfügen
sudo service motion start       # Den Dienst starten

Magnetismus (Hall-Sensor)

Dieser Sensor erkennt, wenn ein Magnet in seine Nähe kommt. Er schaltet dann den Ausgang um. Somit hat man einen digitalen Schalter, der etwa für eine Geschwindigkeitsmessung eingesetzt werden kann (Umdrehungen/Minute) oder als Einbruchsalarm (Fenster öffnet sich).

Bauteilbezeichnung: NJK-5002 A oder C. Der Unterschied besteht darin, dass schwarz bei A auf Plus und beim C auf Minus schaltet, wenn ein Magnet in die Nähe kommt. Sonst gibt es noch den braunen Anschluss für Plus und blau für Minus. Dieser Sensor besitzt eine eingebaute LED, welche dessen Funktion anzeigt.

Matrix-Tastatur (Pinpad/Code-Tastatur)

Diese Tastatur verfügen meist über ein 4x3 Eingabefeld für Zahlen und zwei Sonderzeichen, wobei dies nur eine mögliche Beschriftungsart darstellt da die Auswertung dem Programm überlassen wird, welches lediglich feststellt, welche Taste(n) gedrückt wurde(n). Da für die Erkennung der Spalte und Reihe die Pins korrekt angeschlossen sein müssen, damit man keinen Kurzschluss fabriziert, sollte man das Datenblatt genau lesen. Für die 4 Reihen und 3 Spalten braucht man gesamthaft 7 Pins. Hat die Tastatur einen I²C oder ähnlichen Anschluss, sollte man natürlich diesen verwenden, um Pins zu sparen.

Im nachfolgenden Programm werden die Pins auf Grund der Verdrahtung des SparkFun-Zehnerblocks eingesetzt, doch wie erwähnt, muss man die Pins zwingend aus dem Datenblatt herausfinden. Um keinen Tastendruck zu verpassen, empfiehlt es sich, diese mittels Interrupt einzulesen.

import RPi.GPIO as GPIO
import time

GPIO.setmode(GPIO.BCM)

rows = [17, 25, 24, 23]  # Pins für die Reihen
cols = [27, 18, 22]      # Pins für die Spalten
keys = [['1', '2', '3'], # Array für die einzulesenden Tasten
        ['4', '5', '6'],
        ['7', '8', '9'],
        ['*', '0', '#']]

for row_pin in rows:    # Die Reihen werden als Input definiert
   GPIO.setup(row_pin, GPIO.IN, pull_up_down=GPIO.PUD_DOWN)

for col_pin in cols:    # Die Spalten werden als Output definiert.
   GPIO.setup(col_pin, GPIO.OUT)

def get_key():
   key = 0
   for col_num, col_pin in enumerate(cols):     # Schlaufe durch die Spalten
       GPIO.output(col_pin, 1)                  # Spalte aktivieren
       for row_num, row_pin in enumerate(rows): # Schlaufe durch die Reihen
           if GPIO.input(row_pin):              # Kontrolle, ob "Durchgang"
               key = keys[row_num][col_num]     # Zeichen(Position) aus Array auslesen und speichern.
       GPIO.output(col_pin, 0)                  # Spalte deaktivieren
   return key

while True:
   key = get_key()   # Tastatur abfragen und Rückgabewert speichern.
   if key :          # Wenn key = 0, dann false und somit keine Auswertung.
       print(key)    # Zeichen ausgeben. Der Stringwert '0' ist etwas anderes als die Zahl 0.
   time.sleep(0.3)   # Programm verlangsamen -> Mit Interrupt verpasst man keine Tasten und kann trotzdem länger schlafen

(USB)-Maus

Mit der pygame-Bibliothek können auch Maus-Bewegungen und Klicks (MOUSEBUTTONDOWN/MOUSEBUTTONUP) ausgewertet werden. Dies allerdings nur auf der grafischen Oberfläche:

# https://github.com/simonmonk/raspberrypi_cookbook_ed2/blob/master/mouse_pygame.py
import pygame
import sys
from pygame.locals import *

pygame.init()
screen = pygame.display.set_mode((640, 480))
pygame.mouse.set_visible(0)

while True:
   for event in pygame.event.get():
       if event.type == QUIT:
           sys.exit()
       if event.type == MOUSEMOTION:
           print("Mouse: (%d, %d)" % event.pos)

Die Referenzseite der Bibliothek ist pygame doc

Neigung

Potentiometer

Dieser Drehwiderstand besitzt meist 3 Pins, wobei sich Links/Mitte und Mitte/Rechts ergänzend verhalten und Links/Rechts immer den maximalen Widerstand liefern. Ein Beispiel findet sich auch beim Arduino. Im Gegensatz zu diesem müssen wir beim Raspi einen AD-Wandler einsetzen wie etwa den MCP 3002. Damit dieser angesprochen werden kann, muss SPI freigschaltet sein.

# botbook_mcp3002.py - read analog values from mcp3002
# (c) BotBook.com - Karvinen, Karvinen, Valtokari

import spidev
import time

def readAnalog(device = 0, channel = 0): # Funktion, um Daten über SPI vom MCP 3002 auszulesen. Der channel ist der gewünschte Kanal. Der 3002 hat zwei Kanäle.
  assert device in (1, 0)                # Test, dass das device 0 oder 1 ist -> sonst Abbruch
  assert channel in (1, 0)               # Test auf den Kanal. Bei mehr Kanälen z.B. MCP 3008 müsste man erweitern
  spi = spidev.SpiDev()                  # spi-Objekt generieren
  spi.open(0, device)                    # spi-Verbindung öffnen
  command = [1, (2 + channel) << 6, 0]   # Es wird ein 3 * 8Bit Array gesendet. Im ersten Array kommt das Startbit (letzte Stelle). Im zweiten folgen die Modi für den Austausch.
                                         # Das erste Bit sagt, ob das Signal selber (1) oder die Differenz (0) gesendet werden soll. Das zweite Bit ist abhängig vom ausgelesen Kanal.
                                         # Danach könnte man noch sagen ob MSB oder LSB aktiv sein soll. Dies bleibt aber 0. Entsprechend
                                         # ergeben sich nach dem Shift um 6 Stellen und dem letzten Byte 0 -> 0000 0001 1x00 0000 0000 0000 (das x ist 0 oder 1 je nach Kanal).
  reply = spi.xfer2(command)             # Es wird ein 3 * 8Bit Array zurückgeliefert.
  value = reply[1] & 31                  # Das erste Paket (reply[0]) wird nicht verwendet. Beim zweiten Paket werden nur die hinteren 5 Bit verwendet (31 = 0000 0001 1111).
  value = value << 6                     # Nun werden die Bits um 6 Positionen nach vorne geschoben, damit diese nicht vom Inhalt
                                         # des dritten Paketes überschrieben werden (0000 000D DDDD << 6 = 0DDD DD00 0000).
  value = value + (reply[2] >> 2)        # Vom letzten Paket braucht es nur die höheren 6 Bits. Da die letzten 2 Bits nicht relevant sind (Der MCP 3002 liefert nur 10 Bits Auflösung),
                                         # schiebt man daher die Bits nach rechts (DDDD DDXX >> 2 = 00DD DDDD) und fügt diese dann an (0DDD DD00 0000 + 0000 00DD DDDD = 0DDD DDDD DDDD).
  spi.close()                            # spi-Verbindung schliessen
  return value

while(True):
  print(readAnalog(0, 0)
  time.sleep(0.5)

Weitere Beispiele für die Anbindung des Wandlers im Netz.

Schalter

Der Schalter behält im Gegensatz zum Taster seine Position. Je nach Ausführung gibt es Schalter mit 2 oder mit mehr Positionen. Manche Schalter haben auch eine "Tasterposition", welche man zwar anwählen kann, die dann aber wieder "zurückspringt", so dass diese Position nicht dauerhaft beibehalten wird.
Je nach Einsatz besitzen Schalter statt 2 3 Pins, wodurch eine Umschaltung erreicht wird, wenn etwa mehrere Schalter in Reihe einen Gesamtzustand schalten sollen (Licht im Treppenhaus mit mehreren Schaltern).
Je nach Ausführung kann der Schalter eine gewisse Spannung und Leistung schalten, die man aus dem Datenblatt entnimmt. Die Überwachung eines Schalters geschieht programmtechnisch gleich wie beim Taster.

(USB)-Tastatur

Um Tastendrücke einzulesen gibt es die Systemfunktion sys.stdin.read() oder die grafische Bibliothek pygame.

import sys, tty, termios
       
def read_ch():
   fd = sys.stdin.fileno()
   old_settings = termios.tcgetattr(fd)
   try:
       tty.setraw(sys.stdin.fileno())
       ch = sys.stdin.read(1)
   finally:
       termios.tcsetattr(fd, termios.TCSADRAIN, old_settings)
   return ch

while True:
   ch = read_ch()
   if ch == 'x':
       break
   print("Taste: " + ch)

Die grafische Ausgabe mit pygame. In diesem Programm werden nur ASCII-Zeichen ausgegeben. Steuerzeichen werden entsprechend nicht ausgegeben.

import pygame
import sys
from pygame.locals import *

pygame.init()
screen = pygame.display.set_mode((640, 480))
pygame.mouse.set_visible(0)

while True:
   for event in pygame.event.get():
       if event.type == QUIT:
           sys.exit()
       if event.type == KEYDOWN:
           print("Code: " + str(event.key) + " Zeichen: " + chr(event.key))

Taster

Im Gegensatz zum Schalter verbleibt der Taster nicht in seiner geschalteten Position, sondern kehrt selbständig wieder in seine Ruheposition zurück. Normalerweise besitzt ein Taster nur 2 Postionen, wobei auch hier mehrere Positionen möglich sind.

Damit der Raspi sauber entscheiden kann, ob der Taster gedrückt ist oder nicht, braucht es einen Widerstand, welcher das Signal bei einer ungedrückten Taste entweder nach +5V oder GND zieht. Dafür besitzt der Raspi interne Pull-Widerstände, welche man bei der Pin-Definition mitgeben kann. So braucht es keinen externen Widerstand, um das Signal sauber zu halten. Je nach Leitungslänge ist ein solcher trotzdem notwendig, da die internen Widerstände relativ hoch sind (etwa 40k $\Omega \rightarrow$ dies ergibt einen Strom von nur 82 $\mu$ A). Falls es aber mehr Strom braucht, so kann man einfach einen externen Widerstand verwenden. Bei einem 100 $\Omega$ Widerstand fliessen 33mA, was noch innerhalb der erlaubten 50mA pro Pin liegt, doch sollte man nach Möglichkeit den Verluststrom so tief als möglich halten.

import RPi.GPIO as GPIO
import time

GPIO.setmode(GPIO.BCM)
GPIO.setup(18, GPIO.IN, pull_up_down=GPIO.PUD_UP) # Den Widerstand als "Pull up" definieren. Dies, damit möglichst kleine Verlustströme auftreten.

while True:
   input_state = GPIO.input(18)
   if input_state == False:                       # "Pull up" zieht im nicht gedrückten Zustand nach High, so dass gedrückt == False bedeutet.
       print('Button Pressed')
       time.sleep(0.2)                            # In einem richtigen Programm sollte zur Überwachung statt einer "Schlafroutine" ein Interrupt verwendet werden.

Temperatur (1-Wire-Anbindung)

Für die Temperaturmessung gibt es den LM35 oder TMP36 im Transistorgehäuse, der sich direkt als analoger Sensor anschliessen lässt und nicht einmal einen Pull-Up Widerstand braucht. Der gelesene Wert kann direkt mittels gelesene Spannung * 100°C/V umgerechnet werden.

Wenn man ihn von vorne anschaut (flache Seite), so befinden sich links die Referenzspannung (5V (4-30V)) und rechts GND, während die Mitte an den analogen Anschluss geführt wird. Da der LM35 macx. 155°C messen kann und dabei 1.5V abgibt, ist dessen Verwendung problemlos. Es gibt auch Sensoren, welche direkt für 3.3V ausgelegt sind, wie den TMP36. Ein Programm zum Verarbeiten der Werte gibt es beim Arduino. Für den Raspi nur die folgenden Zeilen zum umrechnen der Werte in eine Temperatur, da das Programm fürs einlesen gleich ist wie beim Potentiometer.

percent = data / 1023.0
volts = percent * 3.3
celsius = 100.0 * volts

Es gibt natürlich auch genauere Sensoren wie den DS18B20 oder den DHT22(AM2302), der über eine 1-Wire-Schnittstelle angebunden wird.

# https://github.com/simonmonk/raspberrypi_cookbook_ed2/blob/master/temp_DS18B20.py
import glob, time

base_dir = '/sys/bus/w1/devices/'              # Der Eindraht-Bus verwendet zur Kommunikation Dateien
device_folder = glob.glob(base_dir + '28*')[0] # Alle Sensoren befinden sich immer in diesem Unterverzeichnis
device_file = device_folder + '/w1_slave'      # Das Programm setzt voraus, dass es nur einen Slave gibt. Hier müsste man entsprechend konfigurieren bei mehreren Sensoren.

def read_temp_raw():                           # Die Datei einlesen
   f = open(device_file, 'r')
   lines = f.readlines()
   f.close()
   return lines

def read_temp():                               # Die Datei auswerten und dabei die Temperatur extrahieren
   lines = read_temp_raw()
   while lines[0].strip()[-3:] != 'YES':
     time.sleep(0.2)
     lines = read_temp_raw()
   equals_pos = lines[1].find('t=')
   if equals_pos != -1:
     temp_string = lines[1][equals_pos+2:]
     temp_c = float(temp_string) / 1000.0
     temp_f = temp_c * 9.0 / 5.0 + 32.0
     return temp_c, temp_f

while True:
  print("temp C=%f\ttemp F=%f" % read_temp())	# Die Temperatur in C und F ausgeben
  time.sleep(1)

Man kann auch die Adafruit-Bibliothek einbinden, dann ist das Ganze einfacher anzusprechen. Wie man die Bibliothek einbindet ist im OLED-Abschnitt beschrieben.

# Die Bibliothek mit "git clone https://github.com/adafruit/Adafruit_Python_DHT.git" einbinden

import Adafruit_DHT
import time

sensor = Adafruit_DHT.DHT22 # Angabe des Typs. Man kann auch den DHT11 oder AM2302 angeben.
sensor_pin = 4              # Anschlusspin für die Daten
running = True

# Daten in Datei speichern
file = open('sensor_werte.txt', 'w') # Datei zum Schreiben öffnen -> Wenn nicht vorhanden, wird sie angelegt 
                                     # -> Hier müsste man noch prüfen, ob es Probleme wie Schreibschutz usw. gibt
                                     # Wichtig: Eine vorhandene Datei wird so immer überschrieben. Siehe Umgang_mit_Dateien
file.write('Zeit und Datum, Temperatur, Rel. Luftfeuchtigkeit\n') # Titel mit Zeilenumbruch

while running:
  try:
    humidity, temperature = Adafruit_DHT.read_retry(sensor, sensor_pin) # Beim Aufruf werden gleich beide Variablen abgefüllt
    if humidity is not None and temperature is not None:
      print('Temperature = ' + str(temperature) + ', ' + 'Luftfeuchtigkeit = ' + str(humidity))
      file.write(time.sfrtime('%H:%M:%S %d.%m.%Y') + ', ' + str(temperature) + ', ' + str(humidity) + '\n')
    else:
      print('Werte konnten nicht gelesen werden. Bitte nochmals versuchen')
    time.sleep(10) # 10 Sekunden mit erneuter Auslesung warten

  except KeyboardInterrupt: # Reagiert nur auf CTRL-C
    print('Programm gestoppt')
    file.close()
    running = false

Wireless-Modul (Sender-Empfänger)

Im Buch Raspberry Pi Projects wird im Kapitel 13 ein Wireless-Sender mit Empfänger vorgestellt, welcher verwendet werden kann, um Signale zu senden, welche das Empfängerodul an einen GPIO-Pin weiterleitet, so dass man dies anschliessend auswerten kann. Je nach Modul kann man verschiedene Knöpfe programmieren und diese dann unterschiedlich einlesen. Es gibt bei diesen Sendern mit mehreren Knöpfen aber auch mehrere Arten, wie diese das Drücken verarbeiten. Es gibt solche, welche das Signal so lange weiterleiten, wie man den Knopf drückt, dann solche, die sicherstellen, dass immer nur ein Knopf aufs Mal gesendet wird. Solange man also noch Knopf A drückt, wird das Drücken von Knopf B ignoriert und dann solche, welche umschalten, sobald man den anderen Knopf drückt. Natürlich können diese Verhaltensweisen auch kombiniert werden, so dass man im Datenblatt nachschauen muss, wenn man ein bestimmtes Verhalten haben möchte oder man passt den Abfragecode an, so dass er die Signale entsprechend verarbeitet.

Je nach Signallevel muss man eine Anpassungsschaltung aufbauen, damit die Pins nicht überlastet werden (5V->3.3V). Ein Beispiel ist im Buch auf Seite 327 aufgezeigt.

Aktoren

Lautsprecher / Piezo-Summer

Kleine Summer können direkt an einen Pin angeschlossen werden. Wenn man nicht sicher ist, ob nicht doch zu viel Strom fliesst, kann wie bei einer LED ein 470 $\Omega$ Widerstand angeschlossen werden.

import RPi.GPIO as GPIO
import time

buzzer_pin = 18

GPIO.setmode(GPIO.BCM)
GPIO.setup(buzzer_pin, GPIO.OUT)

dev buzz(pitch, duration): # pitch = Tonhöhe, duration = Tonlänge
    period = 1.0 / pitch
    delay = period / 2
    cycles = int(duration * pitch)
    for i in range(cycles):
        GPIO.output(buzzer_pin, True)
        time.sleep(delay)
        GPIO.output(buzzer_pin, False)
        time.sleep(delay)

   while True:
        pitch_s = input("Tonhöhe eingeben (200 bis 2000 Hz): ")
        pitch = float(pitch_s)
        duration_s = input("Tonlänge eingeben (in Sekunden): ")
        duration = float(duration_s)
        buzz(pitch, duration)

Diese Summer haben keine gute Tonqualität und auch die Tonhöhe ist nur relativ. Das Programm dient daher nur zu Demonstationszwecken und kann keinen Lautsprecher ersetzen. Es stammt von Simon Monk und kann auf [github heruntergeladen werden.

LC-Display

Hier gibt es verschiedene Anbieter und Chips. Auch ist die Darstellung unterschiedlich. Die meisten stellen nur Zeichen auf 1 oder mehr Zeilen dar, während andere auch Grafiken erlauben. Beim Modul von Adafruit kann man nach dem Herunterladen der Bibliothek (Python-Code) folgendes kleines Programm starten:

import Adafruit_CharLCD as LCD
from time import sleep

# Pins definieren für die Kommunikation
lcd_rs = 27 # Display zurücksetzen
lcd_en = 22 # Display aktivieren
lcd_d4 = 25 # Datenpin -> Die Pins 0-3 werden hier nicht verwendet
lcd_d5 = 24
lcd_d6 = 23
lcd_d7 = 18
lcd_backlight = 4

# Grösse des Displays festlegen (könnte man auch bei der Instanzierung mitgeben -> lcd.begin(16,2))
lcd_columns = 16 # 16 Zeichen
lcd_rows = 2     # 2 Reiehen

lcd = LCD.Adafruit_CharLCD(lcd_rs, lcd_en, lcd_d4, lcd_d5, lcd_d6, lcd_d7, lcd_columns, lcd_rows, lcd_backlight) # Instanz generieren
i = 0

while True:
  lcd.clear()
  lcd.message("It works\nCounting: " + str(i)) # Ausgabe auf 2 Zeilen
  sleep(1)
  i = i + 1

Im Buch 20 easy Raspberry PiProjects wird im Kapitel "Project 6" ein Beispiel mit Verdrahtung gezeigt. Dort werden auch noch die anderen Funktionen der Bibliothek aufgeführt.

LED

LED anschliessen

Um die LED und den RasPi zu schützen, muss jeweils ein [Vorwiderstand] angeschlossen werden. Im Link steht, wie man die [Farbcodes] liest, wenn man kein Multimeter zur Verfügung hat. Je nach Leuchtstärke und [Farbe der LED] ergeben sich sich folgende Werte:

LED-Farbe	Widerstand	Stromfluss (mA)
rot	470 $\Omega$	2.7-3.5
rot	680 $\Omega$	1.9-2.2
rot	1 k $\Omega$	1.3-1.5
orange / gelb / grün	470 $\Omega$	2
orange / gelb / grün	1 k $\Omega$	1
blau / weiss	470 $\Omega$	3
blau / weiss	1 k $\Omega$	1

Im oben verlinkten Artikel zum Vorwiderstand wird auf die Vorwärtsspannung der LED hingewiesen, welche dem Datenblatt entnommen werden muss, da die LED bauartbedingt unterschiedliche Spannungen haben und damit auch unterschiedliche Widerstandswerte brauchen. Die Widerstandswerte sind der [E6-Widerstandsreihe] entnommen.

Da LEDs Dioden sind, besitzen sie eine Sperr- und eine Durchgangsrichtung. In Sperrrichtung vertragen sie eine Spannung von 25V bis zu 30V. Somit geschieht bei Experimenten mit dem RasPi nichts, wenn man diese falsch gepolt einsetzt. Damit sie leuchtet, muss die Anode am Plus und die Kathode am GND angeschlossen werden. Die Kathodenseite ist normalerweise abgeflacht, kürzer und manchmal auch "abgeknickt".

LED blinken lassen

Das folgende Python-Programm verwendet die RPi.GPIO Bibliothek. Hier wird mit sleep gearbeitet, was man in einem "richtigen" Programm vermeiden sollte, da etwa Tastendrücke damit nicht eingelesen werden. Hier sollten besser Interrupts eingesetzt werden.

import RPi.GPIO as GPIO
import time

GPIO.setmode(GPIO.BPM)     # Die Nummerierung der Pins nach dem BPM-Schema verwenden
GPIO.setup(18, GPIO.OUT)   # Pin 18 als Output definieren

while(True):
    GPIO.output(18, True)  # Pin einschalten
    time.sleep(0.5)        # 1/2 Sekunde warten
    GPIO.output(18, False) # Pin ausschalten
    time.sleep(0.5)

Es ist auch möglich, die LED manuell über ein GUI mit tkinter anzusteuern. Das Programm stammt von Simon Monk und kann auf [github heruntergeladen werden.

LED dimmen

Durch Pulsweitenmodulation lässt man eine LED in hoher Frequenz ein- und ausschalten, so dass es für das Auge aussieht, als sei die LED dunkler oder heller. Bei der [PWM] wird ein Puls nur zu % Prozenz der Pulslänge aktiviert.

import RPi.GPIO as GPIO

GPIO.setmode(GPIO.BPM)     # Die Nummerierung der Pins nach dem BPM-Schema verwenden
GPIO.setup(18, GPIO.OUT)   # Pin 18 als Output definieren

pwm_led = GPIO.PWM(18, 500)# PWM-Frequenz vom Pin 18 auf 500 Hertz setzen
pwm_led.start(100)         # mit 100% starten?

while(True):
    arg = input("Helligkeit in %:") # Wert einlesen
    arg = int(arg)         # nach int konvertieren
    pwm_led.ChangeDutyCycle(arg) # Prozentwert übergeben
    time.sleep(0.5)

Das Programm stammt von Simon Monk und kann auf github heruntergeladen werden.

Je nach Chip und Frequenz weicht die effektive Frequenz von der übergebenen Frequenz ab. Je schneller die gewünschte Freq. umso grösser ist der Abstand. Bei 10kHz kann es sein, dass es effektiv nur 4.4kHz sein. Dies könnte mit einem [Oszilloskop] gemessen werden. Im tieferen Frequentbereich wie bei 500 Hz sind es etwa 470 Hz, was völlig ausreichend ist. Wenn man die entsprechende Abweichungskurve kennt, kann man dieser natürlich entgegenwirken, indem man die Vorgabe entsprechend erhöht.

Im Kapitel Timerbaustein 555 sieht man eine alternative Möglichkeit der Dimmung mit einem Transistor.

Wenn man PWM grafisch einsetzen möchte, kann man dies auch mit tkinter umsetzen.

Hochleistungs-LED-Feld

Um grössere Leistungen schalten zu können, wie etwa ein ganzes LED-Feld mit Hochleistungs-LEDs genügt der maximale Strom eines GPIO-Pins nicht mehr. Hier braucht es einen Transistor, welcher die Leistung durchlässt und mit dem Ausgang des GPIO geschaltet wird. Für die Einspeisung der LED muss je nach Leistung eine externe Spannungsquelle (5V / 12V) verwendet werden.

Die programmtechnische Ansteuerung (Ein/Aus, Dimmung) geschieht genau gleich wie bei einer einzelnen LED.
Als Transistor wird ein MOSFET wie der FQP30N06 verwendet, der bis zu 30 Ampere durchschalten kann.
Als Vorwiderstand für die Basis genügt ein 1k $\Omega$ Widerstand.

Mit dieser Anordnung können auch andere Niederspannungsgeräte angesteuert werden. Ausnahmen sind Relais und Motoren, die auf Grund von Spannungsspitzen und/oder spezieller Ansteuerung gesondert angesteuert werden müssen.

7-Segment-LED-Display

Diese Anzeigen können direkt angesteuert werden. Meist verwendet man aber eine serielle Schnittstelle wie I²C, was natürlich entsprechend eingerichtet sein muss. Für die Ansteuerung der Anzeige von Adafruit gibt es eine Bibliothek. Beispiele und das Projekt finden sich auf der Homepage von Adafruit.

RGB-LED

Eine RGB-LED besteht aus einzelnen LEDs und braucht daher 3 PINs, welche dann kombiniert werden. Um mehr als nur die Grundfarben zu kombinieren, kann man mit PWM auch Zwischenfarben und Farbverläufe erziehlen. Im Artikel zu Python ist ein Beispielprogramm mit Schiebereglern zu finden.
Bei einer RGB-LED verwendet man die gleichen Vorwiderstände (1k $\Omega$ ) wie bei einer normalen LED. Bei gemeinsamer Kathode schliesst man diese an GND und die Anoden über die Widerstände an die jeweiligen PINs. Die Belegung der LED ist dem Datenblatt zu entnehmen. Wenn die Beinchen nicht gekürzt wurden, ist die Kathode etwas länger als die Anoden.

Motor

Gleichstrommotor

Diese Motorart kann man entweder digital (Ein/Aus) ansteuern oder man bestimmt die Geschwindigkeit über PWM. Hierbei muss man aber berücksichtigen, dass sich die Leistung nicht linear verhält. Vielfach werden die kleinen Motoren daher mit einem Getriebe untersetzt. Um die Elektronik vor Stromspitzen beim Abschalten des Motors durch die Induktion zu schützen, wird eine Freilauf-Diode (1N4001) zwischengeschaltet, welche auf den Motor abgestimmt sein sollte. Zusätzlich wird auch der Pin des Raspi über einen Widerstand (1k $\Omega$ ) angeschlossen, so dass nicht zu viel Strom fliesst.
Je nach Motor kann dieser direkt über den Raspi eingespeist werden. Zieht er zu viel Strom, so dass dieser abstürzt oder sonstwie unstabil wird, muss er extern gespiesen werden. Als Steuerungstransistor kann der 2N3904 oder einer mit ähnlicher Spezifikation verwendet werden. Wichtig ist hier vor allem die Hitze-Entwicklung, da der Strom des Motors auch durch den Transistor fliesst.

Richtung steuern mit H-Brücken-Modul (L293D-Chip)

Die Drehrichtung wird über den Anschluss gesteuert. Je nachdem, wie + und GND angeschlossen werden, dreht der Motor nach links oder nach rechts. Da die hardwaremässige Umverdrahtung natürlich nicht gewünscht ist, wurden entsprechende Module entwickelt, welche auf entsprechenden Steuerimpuls die Richtung umschalten. Die Ansteuerung der Geschwindigkeit geschieht weiterhin transparent über PWM. Ein entsprechender Baustein ist der L293D.

import RPi.GPIO as GPIO
import time

enable_pin = 18 # Aktiviert den Chip. Durch PWM auf diesem Pin wird auch die Geschwindigkeit festgelegt
in1_pin = 23    # Drehrichtung Uhrzeigersinn
in2_pin =24     # Drehrichtung Gegenuhrzeigersinn

GPIO.setmode(GPIO.BCM)
GPIO.setup(enable_pin, GPIO.OUT)
GPIO.setup(in1_pin, GPIO.OUT)
GPIO.setup(in2_pin, GPIO.OUT) 

pwm = GPIO.PWM(enable_pin, 500) # PWM auf 500 Hz setzen
pwm.start(0)

def clockwise():
   GPIO.output(in1_pin, True)    
   GPIO.output(in2_pin, False)

def counter_clockwise():
   GPIO.output(in1_pin, False)
   GPIO.output(in2_pin, True)

while True:
   cmd = input("Befehl (vorwärts(v), rückwärts(r), Geschwindigkeit 0-9 -> r7 oder v3:") # Richtung und Geschwindikeit einlesen
   direction = cmd[0]          # Das erste Zeichen ist die Richtung
   if direction == "v":        # Nur bei v geht es vorwärts
       clockwise()
   else: 
       counter_clockwise()     # Bei einer richtigen Auswertung müsste man natürlich auch auf r prüfen und sonst den Motor anhalten
   speed = int(cmd[1]) * 11    # Berechnet zu wieviel Prozent der Motor angesteuert werden soll
   pwm.ChangeDutyCycle(speed)  # Geschwindigkeit setzen
                               # Bei einem richtigen Programm müssten bei einem Abbruch noch alle Pins rückgesetzt werden

Schrittmotor

Schrittmotoren haben mehrere Wicklungen. Die Art der Magnetisierung dieser Wicklungen bestimmt, ob es sich um einen unipolaren oder bipolaren Schrittmotor handelt. Die folgenden Links zeigen detailliert die Ansteuerung und Unterschiede auf:

Beide Motorarten können mit PWM angesteuert werden, doch Halb- und Viertelschritt beherrscht nur der bipolare Schrittmotor. Vielfach werden 2-phasige Schrittmotoren verwendet, wobei es aber auch 3- oder 5-phasige gibt, welche entsprechend genauere Positionen erlauben (Schrittwinkel tiefer). Durch elektonische Beeinflussung des Ansteuerungssignals sind neben Halb- und Viertelschritt auch Mikroschritte möglich. Dies geht soweit, dass man mit einem Drehfeld arbeitet und so einen Drehstrommotor simuliert. Hierbei ist zwar die Laufruhe extrem gross, doch die Positionsmessung ohne externe Rückmeldung ist nicht mehr einfach möglich.

unipolar

Die Ansteuerung dieser Variante ist einfacher und wird daher häufig im Niedrigpreis-Segment verwendet. Unipolare Schrittmotoren haben 5 oder 6 Kabel für den Anschluss. Beim 5 kabligen Anschluss wurden die Mittelabgriffe zusammengefasst. Entsprechend kann dieser Motor nur unipolar betrieben werden. Beim Motor mit einer geraden Anzahl Kabel (4, 6, 8) kann man die Ansteuerung auch bipolar gestalten. Durch die Art der Ansteuerung wird immer nur die eine Hälfte der Wicklungen bestromt, wodurch der Wirkungsgrad bei tiefer Drehzahl viel tiefer ist als bei bipolaren Motoren. Bei der Ansteuerung wird der Mittelteil der Spulen an die Bestriebsspannung angeschlossen und anschliessend werden abwechselnd die Enden der Spulen auf Masse geschaltet, so dass das Magnetfeld sich bewegt und sich der Motor in die entsprechende Richtung bewegt. Dadurch, dass nur die halbe Spule verwendet wird, ist aber bei hohen Drehzahlen ein grösseres Moment möglich.

Mit einem Multimeter lassen sich die Anschlüsse (Mittelabgriff, Spulenenden) schnell bestimmen, wenn kein Datenblatt vorhanden ist. Die Ansteuerung kann mit einem Darlington-Chip erfolgen. Der Chip ist für die Ansteuerung von 2 Motoren ausgelegt oder man kann ihn für einen grösseren Strombedarf parallel schalten.

import RPi.GPIO as GPIO
import time
 
GPIO.setmode(GPIO.BCM)
 
coil_A_1_pin = 18
coil_A_2_pin = 23
coil_B_1_pin = 24
coil_B_2_pin = 17
 
GPIO.setup(coil_A_1_pin, GPIO.OUT)
GPIO.setup(coil_A_2_pin, GPIO.OUT)
GPIO.setup(coil_B_1_pin, GPIO.OUT)
GPIO.setup(coil_B_2_pin, GPIO.OUT) 

forward_seq = ['1010', '0110', '0101', '1001'] # Ansteuerungsreihenfolge der Spulen für einen Vollschritt
reverse_seq = list(forward_seq)                # Liste kopieren
reverse_seq.reverse()                          # Dreht die Reiehenfolge der Ansteuerung um
 
def forward(delay, steps):  
  for i in range(steps):
    for step in forward_seq:
      set_step(step)                           # Schritt ausführen -> wie viele Schritte es für eine Umdrehung braucht, ist von der Verzahnung abhängig
      time.sleep(delay)                        # Wartezeit (sollte je nach Motor um die 2 ms betragen. Wenn zu klein dreht sich der Motor nicht.)

def backwards(delay, steps):  
  for i in range(steps):
    for step in reverse_seq:
      set_step(step)
      time.sleep(delay)

 
def set_step(step):
 GPIO.output(coil_A_1_pin, step[0] == '1')
 GPIO.output(coil_A_2_pin, step[1] == '1')
 GPIO.output(coil_B_1_pin, step[2] == '1')
 GPIO.output(coil_B_2_pin, step[3] == '1')

while True:
 set_step('0000')                              # Spulen ausschalten, damit kein Strom fliesst
 delay = input("Wartezeit zwischen den Schritten in ms?")
 steps = input("Wie viele Schritte vorwärts? ")
 forward(int(delay) / 1000.0, int(steps))
 set_step('0000')
 steps = input("Wie viele Schritte rückwärts? ")
 backwards(int(delay) / 1000.0, int(steps))
 set_step('0000')

bipolar

Hier werden die Spulen abwechselnd nicht nur ein- und ausgeschaltet, sondern die Ansteuerung wird auch noch umgedreht. Dadurch wird vor allem bei tiefer Drehzahl ein hohes Drehmoment ermöglicht. Weil aber die ganze Spule eingesetzt wird, ist auch die Impendanz höher, was sich bei hoher Drehzahl auswirkt, weil dann die Magnetisierung nicht mehr komplett abgebaut werden kann und so die Leistung abnimmt. Durch Nutzung der ganzen Wicklung, kann aber eine höhere Leistung bei gleicher Baugrösse oder eine kleine Baugrösse bei gleicher Leistung erreicht werden. Um eine möglichst hohe Effizienz zu erreichen, wird wenn möglich mit Konstantstrom gearbeitet, was aber eine entsprechende Logik voraussetzt, da hierbei gemessen werden muss, wie viel Strom fliesst und diesen dann rechtzeitig abzustellen, um ihn nachher wieder anzustellen, sobald dies auf Grund der Motoreigenschaften wieder notwendig ist. Diese Art der Ansteuerung wird von Motortreiber-Bausteinen übernommen, wodurch die Komplexität der Schaltung gekapselt wird, wobei man "von aussen" nur noch die Signale für die Drehrichtung und die Geschwindigkeit einspeisen muss.
Um die Ansteuerung umzukehren, werden H-Brücken eingesetzt. Der maximale Strom wird meist für den unipolaren Betrieb angegeben (wenn nicht explizit vermerkt) und muss für den bipolaren Betrieb um den Faktor $1/{\sqrt {2}}$ (0.7) verringert werden.
Um Halb- und Viertelschritt zu erreichen, werden neben den unterschiedlichen Ansteuerungen beim Vollschritt noch Zwischenschritte eingebaut, bei denen jeweils nur eine Spule angesteuert wird. Durch die Zwischenschritte ergeben sich zwar genauere Positionen, doch dies wird mit einem kleineren möglichen Drehmoment erkauft. Da die Leistung je nach Ansteuerung der Stulen unterschiedlich ist, ergibt sich bei niedriger Drehzahl ein unruhiger Lauf, der durch gute Motorsteuerungen mit entsprechendem Anstieg des Stromes automatisch kompensiert wird.

Ohne Datenblatt kann man die Kabel ausmessen, um die Spulen zu bestimmen. Hat der Motor 8 Anschlüsse, so sind 2 Spulenpaare vorhanden, welche je nach gewünschter Eigenschaft in Reihe oder parallel angeschlossen werden können. Beim Parallelbetrieb ergibt sich mehr Drehmoment im oberen Drehzahlbereich, doch dafür muss der Stromregler höheren Anforderungen gerecht werden.

Für die Ansteuerung kann durch die Verwendung des L293D das gleiche Programm wie beim unipolaren Motor verwendet werden. Möchte man Halb- oder Viertelschritt implementieren, so muss man die Schrittsequenz verfeinern. Die notwendigen Tabellen finden sich in den Links zum Schrittmotor.

Für die Ansteuerung von bipolaren Schrittmotoren kann auch das RasPi Robot Board verwendet werden. Wichtig ist dort, dass man nur das Robot-Board einspeist und nicht zusätzlich den Raspi, damit keine Ausgleichsströme fliessen, welche die Elektronik zerstören könnten. Bei Verwendung des Boards muss man das Programm etwas modifizieren, da der Chip etwas anders verdrahtet wird. Auf der Webseite ist es das Programm stepper_rrb.py.

Stellmotor / Servo

Diese Motorart beschreibt eine Motoranwendung. Daher ist sie nicht an einen bestimmten Motortyp gebunden, sondern kann aus verschiedenen Motortypen gebildet werden. Wichtig ist dabei nur, dass die Ansteuerung über PWM geschieht und die Motorstellung über eine Messeinrichtung kontrolliert wird. Entsprechend kann der gewünschte Stellwinkel über das PWM-Signal definiert werden. Dies bedeutet aber auch, dass der Motor nicht mehrere (unendliche) Umdrehungen macht, sondern sich nur im Bereich seines Endanschlags bewegt (z.B. 0°-180°). Es gibt aber auch Möglichkeiten, die Servo-Einheit zu modifizieren, so dass er sich wie ein Getriebemotor verhält: Servomodifikation.

Für den Anschluss an den Raspi sollte man eine externe Stromquelle verwenden, um den Raspi nicht zu überlasten. Um Spannungsspitzen beim Anlauf zu vermeiden, sollte der Steuer-Pin mit einem 1k $\Omega$ Widerstand geschützt werden. Die Verdrahtung selbst ist simpel, da der Motor nur 3 Anschlüssel hat. 1 wird für die Einspeisung verwendet und der andere für GND und der dritte wird über den Widerstand an den gewünschten GPIO-Pin angeschlossen, welcher das PWM-Signal liefert. Beim Raspi ist dies der Pin 18. Das Programm kann natürlich auch ohne GUI eingesetzt werden.

from tkinter import *     # grafische Bibliothek tkinter laden
import RPi.GPIO as GPIO   # RPi-Bibliothek laden
import time               # Zeit-Bibliothek laden

GPIO.setmode(GPIO.BCM)    # BCM-Modus einschalten
GPIO.setup(18, GPIO.OUT)  # Pin 18 als Output definieren
pwm = GPIO.PWM(18, 100)   # Frequenz auf 100 Hz setzen
pwm.start(5)              # Startstellung ist bei 5%?

class App:                # Klasse definieren

   def __init__(self, master)  : # Konstruktor generieren
       frame = Frame(master)     # Vaterklasse aufrufen
       frame.pack()              # Layoutmanager pack verwenden
       scale = Scale(frame, start = 0, end = 180, orient = HORIZONTAL, command = self.update) # Schieberegler definieren
       scale.grid(row=0)         # Schieberegler positionieren

   def update(self, winkel):     # Funktion zur Anpassung des Winkels erstellen
       position = float(winkel) / 10.0 + 2.5 # PWM-Signal aus Position berechnen
       pwm.ChangeDutyCycle(position) # Neues Signal an den Pin übergeben

root = Tk()                      # Fenster generieren 
root.wm_title('Servo Control')   # Titel setzen
app = App(root)                  # App-Abjekt aus der Klasse erstellen
root.geometry("200x50+0+0")      # Fenstergrösse festlegen
root.mainloop()                  # Start der Routine

Das Programm stammt von Simon Monk und kann auf github heruntergeladen werden.

mehrere Stellmotoren ansteuern

Für die genaue Ansteuerung von (mehreren) Servo-Motoren gibt es von Adafruit ein entsprechendes Modul, das über I²C angesprochen wird.

OLED

Im Gegensatz zu LEDs werden OLED für einfache Displays eingesetzt, welche wenig Strom verbrauchen und im Gegensatz zu LCD keine Hintergrundbeleuchtung benötigen. Entsprechend ist aber auch ihre Leuchtkraft geringer. Das Display verbraucht nur für angeschaltete Pixel Strom. Die Ansteuerung kann auf verschiedene Arten geschehen. Hier ein Beispiel mit einer Ansteuerung über I²C.

Neben der Aktivierung von I²C muss in diesem Fall zuerst noch die Bibliothek von Adafruit eingebunden werden. Dies geschieht mit einbindung des Moduls von der git-Webseite. Damit die Dateien nicht "verstreut" auf dem System sind, sollte man zuerst in einen entsprechend erstellten Bibliotheksordner wechseln, den man am besten systemweit zur Verfügung stellt. Dazu bietet sich natürlich usr/lib an. Dort erstellt man den Unterordner python-module:

sudo mkdir python-module

Damit man nicht mit sudo arbeiten muss, kann man den Unterordner natürlich auch direkt unter /home/pi anlegen, doch da man die Module später mit sudo installieren muss, empfehle ich, die gesamten Schritte direkt mit sudo in einem allgemeinen Verzeichnis durchzuführen, doch dies ist natürlich "Geschmacksache". Nun wird ins Verzeichnis gewechselt:

cd python-module

Jetzt wird das Modul heruntergeladen und ins erstellte Verzeichnis gewechselt. Den Namen des Verzeichnisses muss man entsprechend im Internet oder in Git heraussuchen. Es kann direkt das "Hauptverzeichnis" verwendet werden.

git clone https://github.com/adafruit/Adafruit_Python_SSD1306.git
cd Adafruit_Python_SSD1306

Nun wird das Modul erstellt (je nach Modul kann dieser Schritt auch entfallen, doch es schadet nichts, wenn man ihn "vergebens" aufruft).

python setup.py build

Anschliessend kann das Modul installiert werden:

sudo python3 setup.py install

Danach kann das Modul ganz normal eingebunden und verwendet werden.

import Adafruit_SSD1306
from PIL import Image       # Der Adafruit-Treiber stellt alles als Grafik dar. Entsprechend braucht es diese Bibliotheken
from PIL import ImageDraw
from PIL import ImageFont

# Display vorbereiten
RST = 24 # Reset-Pin definieren (falls gebraucht)
disp = Adafruit_SSD1306.SSD1306_128_64(rst=RST) # Display mit 128 Reihen und 64 Zeilen -> anpassen an Displaygrösse
disp.begin()   # Gerätkommunikation initialisieren
disp.clear()   # Display löschen
disp.display() # Display initialisieren
width = disp.width
height = disp.height
image = Image.new('1', (width, height)) # ein 1-Pixelfarbe Bild in der Displaygrösse erstellen
draw = ImageDraw.Draw(image) # leeres Bild darstellen
draw.rectangle ((0, 0, width, height), outline = 0, fill = 0) # schwarzes Rechteck zeichnen, um das Bild zu löschen

# Darstellung vorbereiten
padding = 2 # Rahmengrösse
top = padding # Abstand oben
x = padding # Abstand für Startposition des Textes
font = ImageFont.load_default() # Standard-Zeichensatz bereitstellen

# Text zusammenstellen
draw.text((x, top), "Das ist der Text", font = font, fill = 255)
draw.text((x, top+10), "Das ist die nächste Zeile", font = font, fill = 255)

# Text als Bild ausgeben
disp.image(image)
disp.display()

Relais

Da beim Relais beim Ausschalten eine hohe Spannungsspitze entsteht, muss diese mit einer Diode abgefangen werden, da sonst die gekoppelten elektronischen Bauteile zerstört werden. Da Relais mechanische Bauteile sind, unterliegen sie einer entsprechenden Abnutzung und können auch nicht für hochfrequente Schaltvorgänge benutzt werden. Der Vorteil liegt in getrennten Stromkreisen, so dass man auch eine Wechselspannung (230V) schalten kann, ohne dass diese mit der Schaltung gekoppelt würde. Für grosse Leistungen werden hingegen die verwandten Schütze verwendet. Im Gegensatz zu einem Schalter arbeiten Relais wie Taster, das heisst, sie sind monostabil, wobei es auch bistabile Relais mit zwei Spulen gibt. Da ein Relais rund 50mA Strom benötigt, um den Schalter zu schliessen, muss ein Transistor den Ausgang des Raspi unterstützen.

Für den Schutz des GPIO-Pins wird ein 1k $\Omega$ Widerstand eingesetzt.
Als Schalter genügt ein 2N3904 Transistor ( 200mA, 40V, 625mW).
Als Diode wird eine 1N4001 eingesetzt, welche 1A bei bis 50V verträgt. Die letzte Ziffer bestimmt hier die Sperrspannung, welche bei der 1N4007 1000V beträgt.
Als Relais kann ein beliebiges 5V Exemplar verwendet werden. Je nach Belegung muss der Aufbau auf dem Steckbrett angepasst werden. Bei der gezeigten Schaltung ist +5V oben links und GND unten links, während sich der geschaltete Ausgang unten rechts und mittig links befindet.
Als Ansteuerung kann das gleiche Programm wie bei "LED blinken" verwendet werden. PWM ist wegen der Mechanik aber nicht möglich.

Für den Einsatz gibt es auch fertige Module wie das HL-52S-Modul, welches bei Bedarf eine eigene Spannungsversorgung und den Anschluss über Optokoppler ermöglicht. Das Modul kann aber auch direkt am Raspi angeschlossen werden, wenn der Jumper JD-VCC und VCC geschlossen wird. In diesem Fall wird das Relais direkt vom Raspi gespeist. Ein Beispiel für den Arduino gibt es auf der Seite: https://howtomechatronics.com/tutorials/arduino/control-high-voltage-devices-arduino-relay-tutorial/ und sonst im Buch 20 easy Raspberry PiProjects im Kapitel "Project 16".

Wechselspannung schalten

Um gefahrlos Wechselspannung zu schalten, gibt es Bausätze oder fertige Elemente, welche ein Relais mit einem Optokoppler verwenden, so dass man den GPIO-Pin direkt ans Gerät anschliessen kann. Solche Produkte und/oder Bausätze sind unter der Bezeichnung "Powerswitch tail" oder "IoT Power Relay" zu finden.

Audio / Sound

Der Raspi kann Sound über den Klinkenausgang oder über HDMI ausgeben und ist auch dafür konfiguriert. Möchte man daher Sounds in eigene Projekte einbinden, so muss man nur schauen, dass diese in einem Format vorliegen, welches man auch abspielen kann. Ist dies nicht der Fall, so muss man die Sounds vorher konvertieren. Die Sounds in /opt/sonic-pi/etc/samples liegen etwa als flac vor und müssen je nach Projekt, etwa beim Einsatz mit Python, nach wav gewandelt werden. Dazu kann man die benötigten Dateien in ein eigenes Verzeichnis kopieren und folgendermassen kopieren. Falls noch nicht gemacht, das Tool avconv installieren.

sudo apt install libav-tools

Anschliessend ins gewählte Verzeichnis wechseln und mit dem Tool die wav-Dateien erstellen. Die originalen Dateien bleiben dabei bestehen.

for f in *.flac; do aconv -i "$f" "${f%.flac}.wav"; done

Möchte man anschliessend die flac-Dateien entfernen so macht man dies mit einem einfachen "rm *.flac".

Der code>omxplayer, welcher standardmässig installiert ist, kann dann die Dateien zum Test abspielen.

omxplayer drum.wav

Programmierung

Grafische Programmierung mit Scratch

Installation

Scratch ist eine eventgesteuerte, grafische Programmierumgebung. Im Scratch Wiki gibt es viele Artikel zum Thema. Die Version 3 ist komplett in JavaScript implementiert. Man kann sie direkt im Internet anwenden oder auch auf einem eigenen Computer ausführen. Entsprechend steht das Programm auch für den Raspi zur Verfügung und es gibt auch einen Ableger für Arduino. Steht Scratch nicht zur Auswahl, kann man die Version 3 (oder auch die alte Version 1) über die Paketauswahl (Empfohlene Pakete -> Programmierung) installieren. Die Version 2 steht nicht mehr zur Verfügung, da sie auf Flash aufbaute. Nach der Installation sollte Scratch 3 im Startmenü zur Verfügung stehen.

Bei der Verwendung mit einem (älteren) Raspi muss man sich aber bewusst sein, dass die Umgebung viel Leistung einfordert und viele Vorgänge vor allem während der Programmierung entsprechend langsam sind. Vor allem das Scrollen der Ereignisse und Drag'n'Drop kann zu einer Geduldsprobe werden. Natürlich kann man die Programme auch auf einem anderen Computer entwickeln und anschliessend einfach importieren und ausführen.

Oberfläche

Nach dem Start dauert es eine Weile, bis der Desktop aufgebaut wurde. Bei der Frage, ob man helfen möchte bei der weiteren Entwicklung steht es einem frei, dem zuzustimmen oder nicht. Anschliessend sieht man das Programmierfenster mit allen notwendigen Elementen. Das Programm selber wird mit der grünen Flagge oben gestartet und mit dem roten Kreis gestoppt. Links unten sind alle Sprites (bewegliche grafische Elemente) aufgeführt. In der Mitte befindet sich die Auswahlbox für die Programmierelemente. Die Farben werden im Wikipedia-Artikel erklärt. Rechts wird das Programm zusammengeklickt. Mit den Tabs oben in der Mitte kann man zur Gestaltung der Figuren (Sprites) wechseln oder auch zu den Klängen, die man auch selber aufnehmen kann.

Ganz oben ist das Menü, in dem man die Sprache wählen oder Projekte aden/speichern kann. Wichtig sind auch die Tutorials, welche einem als kleine Programme verschiedene Schritte aufzeigen. Daneben befindet sich der Projektname, den man anpassen kann.

Wie bei jedem Programm muss man sich vor dem Start überlegen, was man genau möchte, wie der Ablauf aussehen soll und wie auf Events reagiert werden soll. Nachdem dies geklärt ist, kann man sich an die Programmierung machen. Am besten wählt man zuerst den Hintergrund aus (man kann auch eigene gestalten und einbinden und online zur Verfügung stellen) und wählt seine Sprites oder gestaltet selber welche und bindet auch diese ein. Die Grösse und das Aussehen kann mit den Hilfsmitteln angepasst werden. Die Grösse der Sprites kann auch im Programm variert werden, wie etwa der Pilz, der Supermario wachsen lässt.

Über die Erweiterungen kann man auch die I/O von Raspi oder Arduino einbinden, wenn das Modul zur Verfügung steht.

Die Positionierung der Sprites usw. kann im Programmcode wie im Beispiel über Variablen festgelegt werden. Wie es sich für eine einfache Sprache gehört, wird keine Typisierung verlangt, sondern man gibt die Werte einfach ein, doch auch hier muss man Wissen, wie das Programm aufgebaut sein soll und wie man Dinge verknüpft oder dass die Zustände von Inputs je nachdem invertiert abgefragt werden müssen.

Die Programm-Umgebung bietet eine intuitive Parallelität, indem verschiedene Ereignisse einfach nebeneinander platziert und mit der grünen Flagge gestartet werden. So beginnen die Threads unabhängig zu laufen. Auch geklonte Ereignisse sind so möglich. Natürlich kann man auch Ereignisse starten, wenn andere Ereignisse geschehen, etwa wenn sich Sprites berühren oder ein Sprite eine bestimmte Position erreicht.

Hintergrund und Grafiken

Die Umgebung erlaubt den Wechsel zwischen mehrenen Hintergründen und auch das Scrollen ist möglich, doch am Anfang sollte man sich auf einen Hintergrund beschränken. Dieser wird unten rechts beim Fenster "Bühne" ausgewählt. Es gibt viele abgespeicherte Bilder, doch man kann natürlich auch eigene Fotos oder Zeichnungen verwenden. Sobald man auf ein Bühnenbild klickt, verändert sich der Tab oben und man kann das Bildbearbeiten. Möchte man wieder ein Sprite bearbeiten, so wählt man einfach eines an und der Tab oben wechselt wieder zu "Kostüme", wo man editieren kann. Die Position ist am Anfang nicht relevant, da man im Programmcode eingibt, wo sich die Sprites Anfangs befinden sollen. Die Grösse kann man entsprechend der Eigenschaften fix festlegen, oder diese auch beim Spielstart oder bei einem Ereignis ändern.

Hardware hinzufügen

Damit man mit den In- und Outputs des Raspi interagieren kann, muss man diesen zuerst zu den Blöcken hinzufügen. Dazu klickt man links unten bei den Blöcken auf das Icon "Erweiterung hinzufügen", worauf sich eine neue Seite öffnet, welche unter anderem "Raspberry Pi GPIO" anbietet, welches man anklicken kann, worauf es zu den anderen Modulen hinzugefügt wird. Ab sofort kann man die Taster einlesen, um damit Aktionen zu generieren oder auch bei bestimmten Schritten LEDs oder andere Komponenten anzusteuern. Es gibt auch Vorlagen für Zusatzmodule wie den den Raspi HAT.

Programmierung / Skripte erstellen

Nun erfolgt die wirkliche Programmierung. Von den Skriptblöcken werden diejenigen ausgewählt, die man fürs Programm benötigt. Die Farben sind beschriftet und zeigen entsprechend, welcher Art die zu erwartenden Befehle sind. Je nach Block erwarten einem mehr oder weniger viele Optionen. Bei den Ereignissen sind dies eine Menge, da hier alle Programmoptionen abgefangen werden müssen.

Wichtig ist hier, dass sich die Skripte immer auf das ausgewählte Sprite beziehen. Hat man also die falsche Figur ausgewählt, dann wird die Aktion von der falschen Figur ausgeführt.

@@ Zeile 1: / Zeile 1: @@
 == Einführung ==
-Der RasPi ist ein Mini-Computer, der meist unter Linux betrieben wird. Dies im Gegensatz zu einem Mikrokontroller wie etwa dem [[Arduino]]. Er kann in diversen Sprachen programmiert werden, wobei vielfach [[c und c++|c]] oder [[Python]] verwendet wird. Er besitzt eine Steckleiste ähnlich dem Userport des Commodore 64. Diese Steckleiste wird GPIO genannt und bedeutet '''G'''eneral '''P'''urpose '''I'''nput '''O'''utput. Dies heisst, dass an die Anschlüsse für eigene Bedürfnisse anpassen kann. Einige der Anschlüsse kann man auch verwenden, um spezifische Protokolle wie UART (seriell), <math>I^2C</math> oder SPI zu benutzen.
+Der RasPi ist ein [[IoT-Anwendungen|Mini-Computer]], der meist unter Linux betrieben wird. Dies im Gegensatz zu einem Mikrokontroller wie etwa dem [[Arduino]]. Er kann in diversen Sprachen programmiert werden, wobei vielfach [[c und c++|c]] oder [[Python]] verwendet wird. Er besitzt eine Steckleiste ähnlich dem Userport des Commodore 64. Diese Steckleiste wird GPIO genannt und bedeutet '''G'''eneral '''P'''urpose '''I'''nput '''O'''utput. Dies heisst, dass an die Anschlüsse für eigene Bedürfnisse anpassen kann. Einige der Anschlüsse kann man auch verwenden, um spezifische Protokolle wie UART (seriell), I<sup>2</sup>C oder SPI zu benutzen.
 Auch wenn es Bücher gibt, welche eine Einspeisung direkt über die GPIO-Pins empfehlen (etwa für den Batteriebetrieb), wird dringend davon abgeraten, da es dann keinen Spannungsschutz mehr gibt. Stattdessen sollte immer über den vorgesehenen Micro-USB eingespiesen werden, auch wenn man ein Batterie-Pack verwendet.
@@ Zeile 11: / Zeile 11: @@
 ! Betriebssystem !! Eigenschaften !! Erscheinungsjahr !! SD-Karte
 |-
-| Raspian ||
+| Raspberry Pi OS (Raspian) ||
 * Basiert auf Debian
 * Grosse Community und Wikis
+* Download: https://www.raspberrypi.com/software/
+* Einfacher Installer auf der Webseite. Nach dem Download installieren und starten. Danach kann man das gewünschte OS auswählen, die eingesteckte SD-Karte anklicken, wenn man will noch Optionen einstellen und danach starten. Dann wird das OS heruntergeladen und direkt auf der SD-Karte korrekt instslliert.
 || 2012 || 4GB (8GB wenn GUI)
 |-
@@ Zeile 53: / Zeile 55: @@
 || 2015? || ?
 |}
+=== Raspberry Pi OS ===
+Das System braucht zum Aufstarten rund 1 Minute.
+Die meisten Betriebssysteme basieren auf [[Allgemeine_Daten_zu_Linux,_Tipps_und_Tricks_und_Systemeinstellungen|Linux]]. Bei Raspberry Pi OS ist allerdings der root-User nicht vorhanden. Will man daher als su arbeiten, muss man dies zuerst einrichten. Dazu zuerst mit "sudo su" zu su wechseln und anschliessend mit "passwd" ein Passwort vergeben.
+Gibt es beim Update des Systems Probleme, kann man dpkg auch manuell als su aufrufen mit "dpkg --configure -a".
 === Daten lokal speichern ===
@@ Zeile 152: / Zeile 161: @@
 * TX -> Send (transmit) der seriellen Schnittstelle (UART)
 * RX -> Empfang (receive) der seriellen Schnittstelle (UART)
-* SDA -> Daten? der I<math>^2</math>C-Schnittstelle
+* SDA -> Daten? der I<sup>2</sup>C-Schnittstelle
-* SCL -> Clock der I<math>^2</math>C-Schnittstelle
+* SCL -> Clock der I<sup>2</sup>C-Schnittstelle
 * MOSI -> Master Out der SPI-Schnittstelle (Daten vom Server zu den Slaves) (Die Kabel werden nicht gekreuzt)
 * MISO ->Master In der SPI-Schnittstelle (Daten von den Slaves zum Server) (Die Kabel werden nicht gekreuzt)
@@ Zeile 203: / Zeile 212: @@
 == Module freischalten ==
+Entweder man schaltet das (Standard-)Modul übers GUI frei, wenn dies vom entsprechenden OS wie [[Raspberry_Pi#Raspberry_Pi_OS|Raspi OS]] unterstützt wird, oder man macht es manuell wie hier aufgeführt.
 Damit das entsprechende Modul vom Kernel geladen wird, muss man es folgendermassen einrichten:
@@ Zeile 219: / Zeile 230: @@
   $ sudo apt-get install i2c-tools
-Damit man I<math>^2</math>C auch ohne Root-Rechte nutzen kann, sollte man im Verzeichnis <code>/etc/udev/rules.d/</code> die Datei <code>99-i2c.rules</code> anlegen, die nur eine Zeile enthält:
+Damit man I<sup>2</sup>C auch ohne Root-Rechte nutzen kann, sollte man im Verzeichnis <code>/etc/udev/rules.d/</code> die Datei <code>99-i2c.rules</code> anlegen, die nur eine Zeile enthält:
   SUBSYSTEM=="i2c-dev", MODE="0666"
@@ Zeile 227: / Zeile 238: @@
    $ sudo i2cdetect -y 1
-Bei ganz alten Boards muss der Bus mit 0 anstatt 1 angegeben werden. Das Tool listet die Adressen (hex) entsprechend auf. Will man mehrere Geräte anschliessen, sollte man immer eines nach dem anderen anschliessen und die Adresse dann entsprechend eindeutig gestalten.
+Bei ganz alten Boards (schwarzer Lautsprecherausgang) muss der Bus mit 0 anstatt 1 angegeben werden. Das Tool listet die Adressen (hex) entsprechend auf. Will man mehrere Geräte anschliessen, sollte man immer eines nach dem anderen anschliessen und die Adresse dann entsprechend eindeutig gestalten.
+<b>Achtung:</b> Beim Anschluss von Geräten beachten, ob diese Pull-Up-Widerstände verwenden und mit 5V gespiesen werden. In diesem Fall muss man entweder die Widerstände entfernen oder Pegelwandler einsetzen, da sonst der Raspi zerstört wird.
 === SPI ===
@@ Zeile 283: / Zeile 296: @@
 Die Uhr ist dann von Vorteil, wenn man den Raspi nicht am Internet hängen hat, da sonst der Zeitserver jeweils die korrekte Zeit (genauer) liefert.
-Es gibt verschiedene Chips und man sollte schauen, dass das gewünschte Modul auch für 3.3V ausgelegt ist. Sonst gibt es auch die Möglichkeit, einen [[Arduino]] mit Echtzeitmodul (wenn vorhanden) anzuschliessen und von diesem die Zeit zu übernehmen. Das Modul wird meist über die [[Raspberry_Pi#I.7F.27.22.60UNIQ--postMath-0000000A-QINU.60.22.27.7FC|I<sup>2</sup>]C]
+Es gibt verschiedene Chips und man sollte schauen, dass das gewünschte Modul auch für 3.3V ausgelegt ist. Sonst gibt es auch die Möglichkeit, einen [[Arduino]] mit Echtzeitmodul (wenn vorhanden) anzuschliessen und von diesem die Zeit zu übernehmen. Das Modul wird meist über die [[Raspberry_Pi#I2C|I<sup>2</sup>C]]
 -Schnittstelle angesprochen, welche entsprechend freigeschaltet sein muss.
@@ Zeile 371: / Zeile 384: @@
 == Wichtige Bibliotheken ==
+Wenn es um die System-Bibliotheken von Python geht, dann direkt im Artikel über [[Python]] nachschauen.
 Damit man auf die Hardware zugreifen kann, muss je nach Sprache und Anwendungsfall die entsprechende Bibliothek installiert werden. Die Bibliotheken abstrahieren auch den Zugriff auf die GPIO-Dateien, so dass man nicht mehr die Dateien abfragen muss, sondern direkt die Zustände abfragen kann. Hier ein Beispiel ohne GPIO-Bibliothek:
@@ Zeile 405: / Zeile 419: @@
 Wie man sieht, ist es nicht nur kürzer, sondern auch aufs Wesentliche konzentriert.
+=== gpiozero ===
+Diese Bibliothek ist bei den meisten Distributionen schon vorinstalliert. Für eine Installation diese das nächste Kapitel [[Raspberry_Pi#RPi.GPIO|RPi.GPIO]]. Beispiele zur Verwendung siehe im Artikel zu [[Python#Zugriff_auf_Hardware|Python]].
 === RPi.GPIO ===
@@ Zeile 431: / Zeile 449: @@
 Notwendig, um die serielle Schnittstelle mit Python zu verwenden.
-  $ suto apt-get install python-serial
+  $ suto apt-get install python3-serial
-Nicht vergessen, die [[Raspberry Pi#Serielle Schnittstelle|serielle Konsole zu deaktivieren]].
+Nicht vergessen, die [[Raspberry Pi#Serielle Schnittstelle|serielle Konsole zu deaktivieren]], falls diese aktiv ist. Je nach System ist diese nicht "aktiviert".
 === bottle (Webserver) ===
@@ Zeile 523: / Zeile 541: @@
 Für die Anbindung braucht es meist noch elektronische Bauteile wie Transistoren, Widerstände oder Kondensatoren. Diese Bauteile werden auf der Seite [[Elektronik]] beschrieben.
-=== A/D-Wandler MCP 300x oder MCP 320x ===
+=== A/D-Wandler [[Elektronik#IC|MCP 300x oder MCP 320x]] ===
 Diese Bausteine liefern je nach Serie eine andere Auflösung und entsprechende Eingänge. Die Anbindung geschieht über SPI. Die 300x-Serie liefert eine Auflösung von 10 Bit und die 320x eine von 12 Bit. Die letzte Ziffer bestimmt die Anzahl der möglichen Kanäle von 1 (3x01) bis 8 (3x08). Wie die Anbindung des Chips geschieht und dessen Auswertung läuft, ist im Abschnitt über den [[Raspberry_Pi#Potentiometer|Potentiometer]] sichtbar.
@@ Zeile 746: / Zeile 764: @@
 === Druck (Kraft) ===
-Hier kann etwa der FlexiForce eingesetzt werden, welcher auf Druck reagiert. Auch wenn dieser WIderstand 3 Anschlüsse hat, muss man ihn je nachdem mit einem Spannungsteiler anschliessen. Weil der mittlere Anschluss je nachdem nicht belegt ist. Dies erfährt man im Datenblatt. Wie man den Spannungsteiler aufbaut, steht im Abschnitt [[Raspberry_Pi#Helligkeit_(Licht)|Helligkeit]] und ein Programm zum Einlesen kann man beim [[Arduino#Potentiometer|Arduino]] nachschauen.
+Hier kann etwa der FlexiForce eingesetzt werden, welcher auf Druck reagiert. Auch wenn dieser Widerstand 3 Anschlüsse hat, muss man ihn je nachdem mit einem Spannungsteiler anschliessen. Weil der mittlere Anschluss je nachdem nicht belegt ist. Dies erfährt man im Datenblatt. Wie man den Spannungsteiler aufbaut, steht im Abschnitt [[Raspberry_Pi#Helligkeit_(Licht)|Helligkeit]] und ein Programm zum Einlesen kann man beim [[Arduino#Potentiometer|Arduino]] nachschauen.
 === Entfernung ===
@@ Zeile 833: / Zeile 851: @@
 Es gibt Sensoren, welche das Vorhandensein von entsprechenden Gasen (oder ähnlichen) detektieren können. Hierbei wird mit einem Heizelement und einem Katalysator der Widerstand an Hand des gewünschten Gases verändert. [https://www.sparkfun.com/categories/146 Sparkfun] führt mehrere Gas-Sensoren. Die Sensoren können entsprechend je nach notwendiger Genauigkeit über ein [[Raspberry_Pi#Potentiometer|A/D-Modul]] oder ein [[Raspberry_Pi#Sprungantwort_.28analoge_Werte_an_digitalem_Pin.29|RC-Glied]] ausgewertet werden.
+=== Infrarot-Bewegungssensor ===
+[[Datei:PIR.png|200px|thumb|left|Infrarot-Sensor]]
+Der Anschluss eines PIR (Passiver Infrarot Sensor) Modell HC-SR501 oder ähnlich (HC-SR505 Mini) ist denkbar einfach. Die 3 Pins werden folgendermassen angeschlossen: <code>VCC</code> kommt an 5V, <code>GND</code> and GND und <code>Data</code> an einen Pin. Da der Sensor dort ein 3.3V-Signal liefert ist ein Anschluss ohne Konverter möglich. Sobald der Sensor eine Bewegung eines warmen Körpers (Mensch / Tier) erfasst, wird das Data-Signal aktiviert.
+* Betriebsspannung: 5 ... 20 V DC
+* Level der Ausgangsspannung: 3,3V high / 0 V low
+* Verzögerungszeit einstellbar (0,3 ... 18 Sekunden)
+* Schaltzeit (einstellbar): 5 ... 200 Sekunden
+* Reichweite (einstellbar): 3 ... 7 Meter (Beim SR505 Mini sind es max. 3m)
+* Blockade-Zeit: 2,5 Sekunden -> Diese startet, wenn das Aktiv-Signal abfällt. Während dieser Zeit wird keine Bewegung detektiert.
+* Wiederholungstrigger einstellbar über Lötbrücke oder Jumper (je nach Ausführung)
+* Erfassungsbereich: 140°
+* Je nach Ausführung können optional auch noch Thermistoren und IR-Sensoren eingelötet werden, um auch bei wärmeren Temperaturen zu arbeiten oder automatisch nur im Dunkeln zu arbeiten (Lichtschalter): https://elektro.turanis.de/html/prj108/index.html
+<div style="clear: both"></div>
+=== Infrarot-LED ===
+Mit einer IR-Empfänger-LED wie dem [https://www.alldatasheet.com/datasheet-pdf/pdf/252282/VISHAY/TSOP31238.html TSOP 31238] kann man IR-Signale empfangen und verarbeiten. Wichtig ist natürlich, dass man die korrekte Frequez absorbiert, da der Infrarot-Bereich gross ist und die Frequenzen nicht genormt sind. Allerdings sollten 950nm für den Empfänger ein breites Spektrum der Geräte abdecken. Entsprechend gibt es auch Sender-LEDs in diesem Bereich wie etwa die Osram [https://www.alldatasheet.com/datasheet-pdf/pdf/896582/OSRAM/SFH4546.html SFH4546], bei welcher die Kathode das längere Beinchen hat.
+Im Buch [[Links_und_Bücher|Roboter mit Raspberry Pi]] wird im Kapitel 4.8 "Roomba mit IR-Steuerung" beschrieben, wie man eine stabile Schaltung für Sender und Empfänger aufbaut und auch, wie man mit LIRC die Befehlscodes einer Fernsteuerung ausliest, um sie nachher bei anderen Projekten mit IR-Empfängern einsetzen zu können, wie etwa bei einem [[IoT#.28fahrbaren.29_Roboter_per_WiFi_.C3.BCber_eine_Webseite_steuern|fahrbaren Roboter]].
 === Kamera ===
+Es lassen sich diverse Kameras und USB-Webcams anschliessen und verwenden. Natürlich wird die eigene "Pi Camera Module v2" nativ unterstützt, doch auch andere Kameras lassen sich einfach einbinden.
+==== Systemkamera verwenden ====
+Ab Version 11 (bullseye) -> <code>less /etc/os-version</code> ist die Kamera wegen eines Treiberwechsels nicht mehr wie bisher einfach übers GUI in den Einstellungen aufzufinden und es kann auch nicht mehr der bisherige Befehl <code>raspistill</code> verwendet werden, sondern man muss <code>libcamera</code> einsetzen. Siehe dazu den Artikel: https://gnulinux.ch/raspberry-pikamera-probleme-mit-raspberry-os-bullseye
+Die Kamera lässt sich aber über die Kommandozeile <code>sudo raspi-config</code> im Menü "Schnittstellen" als legacy einbinden. Mit dem Modul kann aber nur die Systemkamera eingebunden werden. Webcams werden damit nicht gefunden.
+===== Bild aufnehmen =====
+ from picamera import PiCamera
+ camera = PiCamera()
+ camera.start_preview()
+ def stop_kamera():
+    camera.stop_preview()
+    exit()
+ def take_photo():
+    camera.capture('image.png')
+    print('Föteli!')
+ take_photo()
+ stop_kamera()
+===== Video aufzeichnen =====
+ from picamera import PiCamera
+ camera = PiCamera()
+ camera.resolution = (640, 480)
+ camera.start_recording('video.h264')
+ camera.wait_recording(60)
+ camera.stop_recording()
+==== Mit Webcam Bilder aufnehmen ====
+Für das Aufnehmen von Fotos eignet sich etwa <code>[https://www.computerhilfen.de/info/usb-webcam-an-raspberry-pi-anschliessen.html fswebcam]</code>, welches einfach installiert wird und welches dann eine vorhandene Webcam einbindet und entsprechend der übergebenen Parameter Photos schiesst.
+ sudo apt-get install fswebcam   # Sucht und installiert das Programm
+ cd /home/pi/Pictures            # Damit Bilder auch gespeichert werden können
+ fswebcam bild.png               # Sucht eine Webcam und speichert das Bild
+ fswebcam -r 1280x1010 bild.png  # Versucht ein Bild in der angegebenen Auflösung zu schiessen. Wenn dies nicht möglich ist, wird auf die wirkliche Auflösung skaliert
+Je nach Einspeisung muss man schauen, ob der Raspi mit der Kamera auch stabil läuft, da die meisten Webcams ihren Strom direkt über den Raspi beziehen.
+==== Mit Webcam Videos aufnehmen/streamen ====
+Dazu gibt es eine gute Anleitung unter: https://tutorials-raspberrypi.de/raspberry-pi-ueberwachungskamera-livestream-einrichten/ Entsprechend werden hier nur die Befehle zusammengefasst.
+ sudo apt-get install motion -y  # Sucht und installiert das Programm. Je nach Konfiguration erscheinen Meldungen, dass das Verzechnis schon existiert usw. Die Meldungen kann man ignorieren.
+ lsusb                           # Damit werden die USB-Geräte aufgelistet, falls man nicht schon von fswebcam weiss, dass die Kamera korrekt gefunden wird.
+ v4l2-ctl -V                     # Listet die Parameter der aktuellen Kamera auf (/dev/video0). Hat man mehrere Kameras eingesteckt, sollte man mit "ls /dev/video*" kontrollieren, wo die gewünschte Kamera abgelegt wurde.
+ sudo nano /etc/motion/motion.conf # Nun müssen die gefundenen Parameter noch in die Konfigurationsdatei fürs Programm motion kopiert werden.
+ sudo nano /etc/default/motion   # Die Zeile start_motion_daemon=yes einfügen
+ sudo service motion start       # Den Dienst starten
 === Magnetismus (Hall-Sensor) ===
@@ Zeile 844: / Zeile 939: @@
 === Matrix-Tastatur (Pinpad/Code-Tastatur) ===
-Diese Tastatur verfügen meist über ein 4x3 Eingabefeld für Zahlen und zwei Sonderzeichen, wobei dies nur eine mögliche Beschriftungsart darstellt da die Auswertung dem Programm überlassen wird, welches lediglich feststellt, welche Taste(n) gedrückt wurde(n). Da für die Erkennung der Spalte und Reihe die Pins korrekt angeschlossen sein müssen, damit man keinen Kurzschluss fabriziert, sollte man das Datenblatt genau lesen. Für die 4 Reihen und 3 Spalten braucht man gesamthaft 7 Pins. Hat die Tastatur einen I<math>^2</math>C oder ähnlichen Anschluss, sollte man natürlich diesen verwenden, um Pins zu sparen.
+Diese Tastatur verfügen meist über ein 4x3 Eingabefeld für Zahlen und zwei Sonderzeichen, wobei dies nur eine mögliche Beschriftungsart darstellt da die Auswertung dem Programm überlassen wird, welches lediglich feststellt, welche Taste(n) gedrückt wurde(n). Da für die Erkennung der Spalte und Reihe die Pins korrekt angeschlossen sein müssen, damit man keinen Kurzschluss fabriziert, sollte man das Datenblatt genau lesen. Für die 4 Reihen und 3 Spalten braucht man gesamthaft 7 Pins. Hat die Tastatur einen I<sup>2</sup>C oder ähnlichen Anschluss, sollte man natürlich diesen verwenden, um Pins zu sparen.
 Im nachfolgenden Programm werden die Pins auf Grund der Verdrahtung des SparkFun-Zehnerblocks eingesetzt, doch wie erwähnt, muss man die Pins <b>zwingend</b> aus dem <b>Datenblatt</b> herausfinden. Um keinen Tastendruck zu verpassen, empfiehlt es sich, diese mittels [[Python#Interrupts|Interrupt]] einzulesen.
@@ Zeile 1.016: / Zeile 1.111: @@
   celsius = 100.0 * volts
-Es gibt natürlich auch genauere Sensoren wie den [https://de.farnell.com/search?st=Maxim%20DS18B20&CMP=KNC-GDE-GEN-SKU-FPN-MAXIM-TEST-701A-160720&mckv=swgpxacFh_dc|pcrid|496781832157|kword|ds18b20|match|b|plid||slid||product||pgrid|108310096687|ptaid|kwd-41644847|&gclid=Cj0KCQjw7MGJBhD-ARIsAMZ0eetGRRdXLSRtK8DeZu3sKrl5Q4NXDrfZQMaqDA3PolcJk5mSfURrB6IaAiDgEALw_wcB DS18B20], der über eine [https://de.wikipedia.org/wiki/1-Wire 1-Wire-Schnittstelle] angebunden wird.
+Es gibt natürlich auch genauere Sensoren wie den [https://de.farnell.com/search?st=Maxim%20DS18B20&CMP=KNC-GDE-GEN-SKU-FPN-MAXIM-TEST-701A-160720&mckv=swgpxacFh_dc|pcrid|496781832157|kword|ds18b20|match|b|plid||slid||product||pgrid|108310096687|ptaid|kwd-41644847|&gclid=Cj0KCQjw7MGJBhD-ARIsAMZ0eetGRRdXLSRtK8DeZu3sKrl5Q4NXDrfZQMaqDA3PolcJk5mSfURrB6IaAiDgEALw_wcB DS18B20] oder den [https://www.alldatasheet.com/view.jsp?Searchword=Dht22%20datasheet&gclid=Cj0KCQjw-NaJBhDsARIsAAja6dPIzCw6yp62GuW66QQiOgl3jXq_yuJZBWnslCCrWkoLyBrexoxpj0UaAu6EEALw_wcB DHT22(AM2302)], der über eine [https://de.wikipedia.org/wiki/1-Wire 1-Wire-Schnittstelle] angebunden wird.
   # https://github.com/simonmonk/raspberrypi_cookbook_ed2/blob/master/temp_DS18B20.py
@@ Zeile 1.046: / Zeile 1.141: @@
     print("temp C=%f\ttemp F=%f" % read_temp())	# Die Temperatur in C und F ausgeben
     time.sleep(1)
+Man kann auch die Adafruit-Bibliothek einbinden, dann ist das Ganze einfacher anzusprechen. Wie man die Bibliothek einbindet ist im [[Raspberry_Pi#OLED|OLED]]-Abschnitt beschrieben.
+ # Die Bibliothek mit "git clone https://github.com/adafruit/Adafruit_Python_DHT.git" einbinden
+ import Adafruit_DHT
+ import time
+ sensor = Adafruit_DHT.DHT22 # Angabe des Typs. Man kann auch den DHT11 oder AM2302 angeben.
+ sensor_pin = 4              # Anschlusspin für die Daten
+ running = True
+ # Daten in Datei speichern
+ file = open('sensor_werte.txt', 'w') # Datei zum Schreiben öffnen -> Wenn nicht vorhanden, wird sie angelegt
+                                      # -> Hier müsste man noch prüfen, ob es Probleme wie Schreibschutz usw. gibt
+                                      # Wichtig: Eine vorhandene Datei wird so immer überschrieben. Siehe [[Python#Umgang_mit_Dateien|Umgang_mit_Dateien]]
+ file.write('Zeit und Datum, Temperatur, Rel. Luftfeuchtigkeit\n') # Titel mit Zeilenumbruch
+ while running:
+   try:
+     humidity, temperature = Adafruit_DHT.read_retry(sensor, sensor_pin) # Beim Aufruf werden gleich beide Variablen abgefüllt
+     if humidity is not None and temperature is not None:
+       print('Temperature = ' + str(temperature) + ', ' + 'Luftfeuchtigkeit = ' + str(humidity))
+       file.write(time.sfrtime('%H:%M:%S %d.%m.%Y') + ', ' + str(temperature) + ', ' + str(humidity) + '\n')
+     else:
+       print('Werte konnten nicht gelesen werden. Bitte nochmals versuchen')
+     time.sleep(10) # 10 Sekunden mit erneuter Auslesung warten
+   except KeyboardInterrupt: # Reagiert nur auf CTRL-C
+     print('Programm gestoppt')
+     file.close()
+     running = false
+=== Wireless-Modul (Sender-Empfänger) ===
+Im Buch [[Links_und_Bücher#Computer|Raspberry Pi Projects]] wird im Kapitel 13 ein Wireless-Sender mit Empfänger vorgestellt, welcher verwendet werden kann, um Signale zu senden, welche das Empfängerodul an einen GPIO-Pin weiterleitet, so dass man dies anschliessend auswerten kann. Je nach Modul kann man verschiedene Knöpfe programmieren und diese dann unterschiedlich einlesen. Es gibt bei diesen Sendern mit mehreren Knöpfen aber auch mehrere Arten, wie diese das Drücken verarbeiten. Es gibt solche, welche das Signal so lange weiterleiten, wie man den Knopf drückt, dann solche, die sicherstellen, dass immer nur ein Knopf aufs Mal gesendet wird. Solange man also noch Knopf A drückt, wird das Drücken von Knopf B ignoriert und dann solche, welche umschalten, sobald man den anderen Knopf drückt. Natürlich können diese Verhaltensweisen auch kombiniert werden, so dass man im Datenblatt nachschauen muss, wenn man ein bestimmtes Verhalten haben möchte oder man passt den Abfragecode an, so dass er die Signale entsprechend verarbeitet.
+Je nach Signallevel muss man eine Anpassungsschaltung aufbauen, damit die Pins nicht überlastet werden (5V->3.3V). Ein Beispiel ist im Buch auf Seite 327 aufgezeigt.
 == Aktoren ==
@@ Zeile 1.079: / Zeile 1.212: @@
 Diese Summer haben keine gute Tonqualität und auch die Tonhöhe ist nur relativ. Das Programm dient daher nur zu Demonstationszwecken und kann keinen Lautsprecher ersetzen. Es stammt von [http://simonmonk.org/ Simon Monk] und kann auf [[https://github.com/simonmonk/raspberrypi_cookbook_ed2/blob/master/buzzer.py github] heruntergeladen werden.
+=== LC-Display ===
+Hier gibt es verschiedene [[Python#LC-Displays_.28LCD.29|Anbieter]] und Chips. Auch ist die Darstellung unterschiedlich. Die meisten stellen nur Zeichen auf 1 oder mehr Zeilen dar, während andere auch Grafiken erlauben. Beim [https://learn.adafruit.com/drive-a-16x2-lcd-directly-with-a-raspberry-pi/overview Modul von Adafruit] kann man nach dem Herunterladen der Bibliothek ([https://github.com/adafruit/Adafruit-Raspberry-Pi-Python-Code Python-Code]) folgendes kleines Programm starten:
+ import Adafruit_CharLCD as LCD
+ from time import sleep
+ # Pins definieren für die Kommunikation
+ lcd_rs = 27 # Display zurücksetzen
+ lcd_en = 22 # Display aktivieren
+ lcd_d4 = 25 # Datenpin -> Die Pins 0-3 werden hier nicht verwendet
+ lcd_d5 = 24
+ lcd_d6 = 23
+ lcd_d7 = 18
+ lcd_backlight = 4
+ # Grösse des Displays festlegen (könnte man auch bei der Instanzierung mitgeben -> lcd.begin(16,2))
+ lcd_columns = 16 # 16 Zeichen
+ lcd_rows = 2     # 2 Reiehen
+ lcd = LCD.Adafruit_CharLCD(lcd_rs, lcd_en, lcd_d4, lcd_d5, lcd_d6, lcd_d7, lcd_columns, lcd_rows, lcd_backlight) # Instanz generieren
+ i = 0
+ while True:
+   lcd.clear()
+   lcd.message("It works\nCounting: " + str(i)) # Ausgabe auf 2 Zeilen
+   sleep(1)
+   i = i + 1
+Im Buch [[Links_und_Bücher|20 easy Raspberry PiProjects]] wird im Kapitel "Project 6" ein Beispiel mit Verdrahtung gezeigt. Dort werden auch noch die anderen Funktionen der Bibliothek aufgeführt.
 === LED ===
@@ Zeile 1.165: / Zeile 1.329: @@
 ==== 7-Segment-LED-Display ====
-Diese Anzeigen können direkt angesteuert werden. Meist verwendet man aber eine serielle Schnittstelle wie I<sup>2</sup>C, was natürlich entsprechend eingerichtet sein muss.
+Diese Anzeigen können direkt angesteuert werden. Meist verwendet man aber eine serielle Schnittstelle wie I<sup>2</sup>C, was natürlich entsprechend [[Raspberry_Pi#I2C|eingerichtet]] sein muss. Für die Ansteuerung der Anzeige von Adafruit gibt es eine Bibliothek. Beispiele und das Projekt finden sich auf der [https://learn.adafruit.com/matrix-7-segment-led-backpack-with-the-raspberry-pi/7-segment-test Homepage von Adafruit].
 ==== RGB-LED ====
@@ Zeile 1.340: / Zeile 1.504: @@
 Für die genaue Ansteuerung von (mehreren) Servo-Motoren gibt es von Adafruit ein entsprechendes [https://www.adafruit.com/product/815 Modul], das über I<sup>2</sup>C angesprochen wird.
+=== [https://de.wikipedia.org/wiki/Organische_Leuchtdiode OLED] ===
+Im Gegensatz zu LEDs werden OLED für einfache Displays eingesetzt, welche wenig Strom verbrauchen und im Gegensatz zu [[Raspberry_Pi#LC-Display|LCD]] keine Hintergrundbeleuchtung benötigen. Entsprechend ist aber auch ihre Leuchtkraft geringer. Das Display verbraucht nur für angeschaltete Pixel Strom. Die Ansteuerung kann auf verschiedene Arten geschehen. Hier ein Beispiel mit einer Ansteuerung über [[Raspberry_Pi#I2C|I<sup>2</sup>C]].
+Neben der Aktivierung von I<sup>2</sup>C muss in diesem Fall zuerst noch die Bibliothek von Adafruit eingebunden werden. Dies geschieht mit einbindung des Moduls von der git-Webseite. Damit die Dateien nicht "verstreut" auf dem System sind, sollte man zuerst in einen entsprechend erstellten Bibliotheksordner wechseln, den man am besten systemweit zur Verfügung stellt. Dazu bietet sich natürlich <code>usr/lib</code> an. Dort erstellt man den Unterordner <code>python-module</code>:
+ sudo mkdir python-module
+Damit man nicht mit sudo arbeiten muss, kann man den Unterordner natürlich auch direkt unter /home/pi anlegen, doch da man die Module später mit sudo installieren muss, empfehle ich, die gesamten Schritte direkt mit sudo in einem allgemeinen Verzeichnis durchzuführen, doch dies ist natürlich "Geschmacksache". Nun wird ins Verzeichnis gewechselt:
+ cd python-module
+Jetzt wird das Modul heruntergeladen und ins erstellte Verzeichnis gewechselt. Den Namen des Verzeichnisses muss man entsprechend im Internet oder in Git heraussuchen. Es kann direkt das "Hauptverzeichnis" verwendet werden.
+ git clone https://github.com/adafruit/Adafruit_Python_SSD1306.git
+ cd Adafruit_Python_SSD1306
+Nun wird das Modul erstellt (je nach Modul kann dieser Schritt auch entfallen, doch es schadet nichts, wenn man ihn "vergebens" aufruft).
+ python setup.py build
+Anschliessend kann das Modul installiert werden:
+ sudo python3 setup.py install
+Danach kann das Modul ganz normal eingebunden und verwendet werden.
+ import Adafruit_SSD1306
+ from PIL import Image       # Der Adafruit-Treiber stellt alles als Grafik dar. Entsprechend braucht es diese Bibliotheken
+ from PIL import ImageDraw
+ from PIL import ImageFont
+ # Display vorbereiten
+ RST = 24 # Reset-Pin definieren (falls gebraucht)
+ disp = Adafruit_SSD1306.SSD1306_128_64(rst=RST) # Display mit 128 Reihen und 64 Zeilen -> anpassen an Displaygrösse
+ disp.begin()   # Gerätkommunikation initialisieren
+ disp.clear()   # Display löschen
+ disp.display() # Display initialisieren
+ width = disp.width
+ height = disp.height
+ image = Image.new('1', (width, height)) # ein 1-Pixelfarbe Bild in der Displaygrösse erstellen
+ draw = ImageDraw.Draw(image) # leeres Bild darstellen
+ draw.rectangle ((0, 0, width, height), outline = 0, fill = 0) # schwarzes Rechteck zeichnen, um das Bild zu löschen
+ # Darstellung vorbereiten
+ padding = 2 # Rahmengrösse
+ top = padding # Abstand oben
+ x = padding # Abstand für Startposition des Textes
+ font = ImageFont.load_default() # Standard-Zeichensatz bereitstellen
+ # Text zusammenstellen
+ draw.text((x, top), "Das ist der Text", font = font, fill = 255)
+ draw.text((x, top+10), "Das ist die nächste Zeile", font = font, fill = 255)
+ # Text als Bild ausgeben
+ disp.image(image)
+ disp.display()
 === Relais ===
@@ Zeile 1.352: / Zeile 1.574: @@
 * Als Ansteuerung kann das gleiche Programm wie bei "LED blinken" verwendet werden. [https://de.wikipedia.org/wiki/Pulsdauermodulation PWM] ist wegen der Mechanik aber nicht möglich.
 <div style="clear: both"></div>
+Für den Einsatz gibt es auch fertige Module wie das HL-52S-Modul, welches bei Bedarf eine eigene Spannungsversorgung und den Anschluss über Optokoppler ermöglicht. Das Modul kann aber auch direkt am Raspi angeschlossen werden, wenn der Jumper JD-VCC und VCC geschlossen wird. In diesem Fall wird das Relais direkt vom Raspi gespeist. Ein Beispiel für den Arduino gibt es auf der Seite: https://howtomechatronics.com/tutorials/arduino/control-high-voltage-devices-arduino-relay-tutorial/ und sonst im Buch [[Links_und_Bücher|20 easy Raspberry PiProjects]] im Kapitel "Project 16".
 ==== Wechselspannung schalten ====
@@ Zeile 1.357: / Zeile 1.581: @@
 Um gefahrlos Wechselspannung zu schalten, gibt es Bausätze oder fertige Elemente, welche ein Relais mit einem Optokoppler verwenden, so dass man den GPIO-Pin direkt ans Gerät anschliessen kann. Solche Produkte und/oder Bausätze sind unter der Bezeichnung "Powerswitch tail" oder "IoT Power Relay" zu finden.
+== Audio / Sound ==
+Der Raspi kann Sound über den Klinkenausgang oder über HDMI ausgeben und ist auch dafür konfiguriert. Möchte man daher Sounds in eigene Projekte einbinden, so muss man nur schauen, dass diese in einem Format vorliegen, welches man auch abspielen kann. Ist dies nicht der Fall, so muss man die Sounds vorher konvertieren. Die Sounds in /opt/sonic-pi/etc/samples liegen etwa als <code>flac</code> vor und müssen je nach Projekt, etwa beim Einsatz mit [[Python#Sound|Python]], nach <code>wav</code> gewandelt werden. Dazu kann man die benötigten Dateien in ein eigenes Verzeichnis kopieren und folgendermassen kopieren. Falls noch nicht gemacht, das Tool <code>avconv</code> installieren.
+ sudo apt install libav-tools
+Anschliessend ins gewählte Verzeichnis wechseln und mit dem Tool die wav-Dateien erstellen. Die originalen Dateien bleiben dabei bestehen.
+ for f in *.flac; do aconv -i "$f" "${f%.flac}.wav"; done
+Möchte man anschliessend die flac-Dateien entfernen so macht man dies mit einem einfachen "rm *.flac".
+Der code>omxplayer</code>, welcher standardmässig installiert ist, kann dann die Dateien zum Test abspielen.
+ omxplayer drum.wav
+== Programmierung ==
+=== Grafische Programmierung mit [https://de.wikipedia.org/wiki/Scratch_(Programmiersprache) Scratch] ===
+==== Installation ====
+[[Datei:Scratch_installieren.png|200px|thumb|left|Skratch installieren]]
+Scratch ist eine eventgesteuerte, grafische Programmierumgebung. Im [https://de.scratch-wiki.info/ Scratch Wiki] gibt es viele Artikel zum Thema. Die Version 3 ist komplett in JavaScript implementiert. Man kann sie direkt im Internet anwenden oder auch auf einem eigenen Computer ausführen. Entsprechend steht das Programm auch für den [[Raspberry Pi|Raspi]] zur Verfügung und es gibt auch einen Ableger für [[Arduino|Arduino]]. Steht Scratch nicht zur Auswahl, kann man die Version 3 (oder auch die alte Version 1) über die Paketauswahl (Empfohlene Pakete -> Programmierung) installieren. Die Version 2 steht nicht mehr zur Verfügung, da sie auf Flash aufbaute. Nach der Installation sollte Scratch 3 im Startmenü zur Verfügung stehen.
+Bei der Verwendung mit einem (älteren) Raspi muss man sich aber bewusst sein, dass die Umgebung viel Leistung einfordert und viele Vorgänge vor allem während der Programmierung entsprechend langsam sind. Vor allem das Scrollen der Ereignisse und Drag'n'Drop kann zu einer Geduldsprobe werden. Natürlich kann man die Programme auch auf einem anderen Computer entwickeln und anschliessend einfach importieren und ausführen.
+<div style="clear: both"></div>
+==== Oberfläche ====
+[[Datei:Scratch.png|200px|thumb|left|Scratch Oberfläche]]
+Nach dem Start dauert es eine Weile, bis der Desktop aufgebaut wurde. Bei der Frage, ob man helfen möchte bei der weiteren Entwicklung steht es einem frei, dem zuzustimmen oder nicht. Anschliessend sieht man das Programmierfenster mit allen notwendigen Elementen. Das Programm selber wird mit der grünen Flagge oben gestartet und mit dem roten Kreis gestoppt. Links unten sind alle [https://de.wikipedia.org/wiki/Sprite_(Computergrafik) Sprites] (bewegliche grafische Elemente) aufgeführt. In der Mitte befindet sich die Auswahlbox für die Programmierelemente. Die Farben werden im Wikipedia-Artikel erklärt. Rechts wird das Programm zusammengeklickt. Mit den Tabs oben in der Mitte kann man zur Gestaltung der Figuren (Sprites) wechseln oder auch zu den Klängen, die man auch selber aufnehmen kann.
+Ganz oben ist das Menü, in dem man die Sprache wählen oder Projekte aden/speichern kann. Wichtig sind auch die Tutorials, welche einem als kleine Programme verschiedene Schritte aufzeigen. Daneben befindet sich der Projektname, den man anpassen kann.
+Wie bei jedem Programm muss man sich vor dem Start überlegen, was man genau möchte, wie der Ablauf aussehen soll und wie auf Events reagiert werden soll. Nachdem dies geklärt ist, kann man sich an die Programmierung machen. Am besten wählt man zuerst den Hintergrund aus (man kann auch eigene gestalten und einbinden und online zur Verfügung stellen) und wählt seine Sprites oder gestaltet selber welche und bindet auch diese ein. Die Grösse und das Aussehen kann mit den Hilfsmitteln angepasst werden. Die Grösse der Sprites kann auch im Programm variert werden, wie etwa der Pilz, der Supermario wachsen lässt.
+Über die Erweiterungen kann man auch die I/O von Raspi oder Arduino einbinden, wenn das Modul zur Verfügung steht.
+Die Positionierung der Sprites usw. kann im Programmcode wie im Beispiel über Variablen festgelegt werden. Wie es sich für eine einfache Sprache gehört, wird keine Typisierung verlangt, sondern man gibt die Werte einfach ein, doch auch hier muss man Wissen, wie das Programm aufgebaut sein soll und wie man Dinge verknüpft oder dass die Zustände von Inputs je nachdem invertiert abgefragt werden müssen.
+Die Programm-Umgebung bietet eine intuitive Parallelität, indem verschiedene Ereignisse einfach nebeneinander platziert und mit der grünen Flagge gestartet werden. So beginnen die [https://de.wikipedia.org/wiki/Thread_(Informatik) Threads] unabhängig zu laufen. Auch geklonte Ereignisse sind so möglich. Natürlich kann man auch Ereignisse starten, wenn andere Ereignisse geschehen, etwa wenn sich Sprites berühren oder ein Sprite eine bestimmte Position erreicht.
+<div style="clear: both"></div>
+==== Hintergrund und Grafiken ====
+Die Umgebung erlaubt den Wechsel zwischen mehrenen Hintergründen und auch das Scrollen ist möglich, doch am Anfang sollte man sich auf einen Hintergrund beschränken. Dieser wird unten rechts beim Fenster "Bühne" ausgewählt. Es gibt viele abgespeicherte Bilder, doch man kann natürlich auch eigene Fotos oder Zeichnungen verwenden. Sobald man auf ein Bühnenbild klickt, verändert sich der Tab oben und man kann das Bildbearbeiten. Möchte man wieder ein Sprite bearbeiten, so wählt man einfach eines an und der Tab oben wechselt wieder zu "Kostüme", wo man editieren kann. Die Position ist am Anfang nicht relevant, da man im Programmcode eingibt, wo sich die Sprites Anfangs befinden sollen. Die Grösse kann man entsprechend der Eigenschaften fix festlegen, oder diese auch beim Spielstart oder bei einem Ereignis ändern.
+==== Hardware hinzufügen ====
+Damit man mit den In- und Outputs des Raspi interagieren kann, muss man diesen zuerst zu den Blöcken hinzufügen. Dazu klickt man links unten bei den Blöcken auf das Icon "Erweiterung hinzufügen", worauf sich eine neue Seite öffnet, welche unter anderem "Raspberry Pi GPIO" anbietet, welches man anklicken kann, worauf es zu den anderen Modulen hinzugefügt wird. Ab sofort kann man die Taster einlesen, um damit Aktionen zu generieren oder auch bei bestimmten Schritten LEDs oder andere Komponenten anzusteuern. Es gibt auch Vorlagen für Zusatzmodule wie den den Raspi HAT.
+==== Programmierung / Skripte erstellen ====
+Nun erfolgt die wirkliche Programmierung. Von den Skriptblöcken werden diejenigen ausgewählt, die man fürs Programm benötigt. Die Farben sind beschriftet und zeigen entsprechend, welcher Art die zu erwartenden Befehle sind. Je nach Block erwarten einem mehr oder weniger viele Optionen. Bei den Ereignissen sind dies eine Menge, da hier alle Programmoptionen abgefangen werden müssen.
+<b>Wichtig</b> ist hier, dass sich die Skripte immer auf das ausgewählte Sprite beziehen. Hat man also die falsche Figur ausgewählt, dann wird die Aktion von der falschen Figur ausgeführt.
 [[Kategorie:Computer|Kategorie]]