Zum Inhalt springen

WSAL17009 – 2.23inch OLED HAT

Aus JW Tech Wiki
Version vom 6. September 2026, 00:26 Uhr von JWTechPublisher (Diskussion | Beiträge) (Freigegebene technische Dokumentation veröffentlicht; Text-only und noindex)
(Unterschied) ← Nächstältere Version | Aktuelle Version (Unterschied) | Nächstjüngere Version → (Unterschied)

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

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:  

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

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

Abgerufen von „https://wiki.jw-tech.eu/index.php?title=WSAL17009_–_2.23inch_OLED_HAT&oldid=1263“