Quelltext der Seite WSAL17009 – 2.23inch OLED HAT

__NOINDEX__
'''Dokumentationshinweis:''' Diese technische Dokumentation wurde aus einer archivierten Lieferantenquelle neu formuliert. Technische Angaben und Befehle müssen vor der Verwendung mit der Produktversion und den Herstellerunterlagen abgeglichen werden.

== Zusammenfassung ==
Technisches Handbuch zum Waveshare 2,23-Zoll-OLED-HAT mit SSD1305-Controller: Schnittstellen SPI/I2C, Pinbelegung, Aktivierung der Schnittstellen auf dem Raspberry Pi sowie Demo-Laufumgebungen (BCM2835, WiringPi, lgpio, Python) und Arduino-Anbindung.

== Zugeordnete Produkte bei JW Tech ==
* [https://shop.jw-tech.eu/p/WSAL17009 WSAL17009 – 128×32, 2,23 Zoll OLED Display HAT für Raspberry Pi]

== Technische Übersicht ==
* Display: 128×32 Pixel, 2,23 Zoll, weißes Monochrom-OLED; Controller SSD1305 (interne GDDRAM 132×64).
* Standardmäßig wird SPI verwendet; per Lötbrücken (BS1/BS2/DIN/CLK/CS/DC) lässt sich I2C aktivieren.
* Betriebsspannung 3,3 V; Temperaturbereich −40 bis 70 °C.
* Pinbelegung: VCC (3,3 V/5 V), GND, DIN (Daten), CLK (Takt), CS (Chip-Auswahl, low-aktiv), DC (Register/Daten-Wahl im SPI), RST (Reset, low-aktiv).
* Raspberry Pi: SPI über `raspi-config` → Interfacing Options → SPI aktivieren, dann Neustart; in `/boot/config.txt` erscheint `dtparam=spi=on`.
* Raspberry Pi: I2C analog über `raspi-config` → Interfacing Options → I2C aktivieren und Neustart.
* Bibliotheken: BCM2835 (Quellcode-Kompilierung), WiringPi (`apt-get install wiringpi` bzw. .deb oder Git-Build), lgpio (Git + make install), Python (spidev, smbus, python3-pil, python3-numpy).
* Demo-Code-Paket aus der Quelle herunterladen, entpacken und je nach Laufzeit kompilieren/läuten (make/sudo ./oled bzw. python3 stats.py).
* Arduino: UNO PLUS als Referenzplatine; I2C: DIN→SDA(D14), SCL→D15; SPI: DIN→MOSI(D11), CLK→SCK(D13), CS→D10, DC→D8, RST→D9.
* Bildgenerierung: Image2Lcd mit Datentyp *c, horizontales Scannen, Monochrom, Maximalgröße 128×32.

'''Befehle und Beispiele – vor Ausführung prüfen:''' 
<syntaxhighlight lang="text">
sudo raspi-config
sudo reboot
ls /dev/spi*
sudo wget http://www.airspayce.com/mikem/bcm2835/bcm2835-1.71.tar.gz
sudo tar zxvf bcm2835-1.71.tar.gz
cd bcm2835-1.71/
sudo ./configure && sudo make && sudo make check && sudo make install
sudo apt-get install wiringpi
wget https://files.waveshare.com/wiki/common/wiringpi-latest.deb
sudo dpkg -i wiringpi-latest.deb
gpio -v
sudo git clone https://github.com/WiringPi/WiringPi
cd WiringPi
sudo ./build
sudo su
wget https://github.com/joan2937/lg/archive/master.zip
unzip master.zip
cd lg-master
sudo make install
sudo apt-get update
</syntaxhighlight>

== Hinweise und Versionsgrenzen ==
* Versionsempfindlich: Auf Bookworm ist nur die lgpio-Bibliothek verfügbar; bcm2835 und wiringPi können dort nicht installiert oder genutzt werden.
* Konfliktwarnung: Wird die BCM2835-Bibliothek zuerst geladen, schlagen die WiringPi- und Python-Demos fehl; Systemneustart erforderlich.
* Die genaue Lötbrücken-Konfiguration für I2C muss vor Inbetriebnahme verifiziert werden; die Quelle zeigt nur eine Abbildung ohne vollständige Pinzuordnungstabelle.
* Die Demo-URLs (files.waveshare.com) sind externe Links; Verfügbarkeit nicht garantiert.
* Keine Angaben zu Garantie, Zertifikaten oder Sicherheitsprüfungen in der Quelle – keine Weitergabe.
* Die Arduino-Anbindung nutzt D8–D15; andere Boards erfordern angepasste Pinzuordnungen.

== Quelle und Revisionsnachweis ==
* [https://www.waveshare.com/wiki/2.23inch_OLED_HAT 2.23inch OLED HAT - Waveshare Wiki]
* Quellrevision: 76299
* Erfasst: 2026-08-31T03:58:10+00:00
* SHA-256: <code>f7261d2710adf6a510510fe7a8cb9091ecd58c25fdd63ec3cb4bc35904373768</code>