Quelltext der Seite WSAL10451 – 1.3inch OLED (B)

__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 ==
Kurzer technischer Leitfaden für das Waveshare-Modul 1.3inch OLED (B): Spezifikationen, Anschlüsse, Schnittstellenkonfiguration und Nutzung mit Raspberry Pi, STM32 oder Arduino.

== Zugeordnete Produkte bei JW Tech ==
* [https://shop.jw-tech.eu/p/WSAL10451 WSAL10451 – 1,3-Zoll-OLED (B)]

== Technische Übersicht ==
* Auflösung 128×64 Pixel; Treiberchip SH1106; Anzeigegröße ca. 14,7 mm (H) × 29,42 mm (V); Pixeldiagonale ca. 0,21 mm; Modulmaße 40,5 × 37,5 mm.
* Betriebsspannung 3,3 V bzw. 5 V; Betriebstemperatur −30…+70 °C, Lagerung −30…+80 °C; Sichtwinkel &gt;160°; Anzeige blau.
* Schnittstellen: 3-Leiter-SPI, 4-Leiter-SPI und I²C; Auswahl über zwei Widerstände BS0/BS1 auf der Rückseite des Moduls.
* Standardwerkseinstellung: 4-Leiter-SPI (BS0=0, BS1=0). Für 3-Leiter-SPI: BS0=1, BS1=0. Für I²C: BS0=0, BS1=1.
* I²C-Adresse: bei DC auf GND ergibt sich die 7-Bit-Adresse 0x3C.
* Anschlusstabelle für Raspberry Pi: VCC→3,3 V, GND→GND, DIN→SPI MOSI / I²C SDA (BCM D2), CLK→SPI SCLK / I²C SCL (BCM D3), CS→CE0 (D8), D/C→GPIO.6 (D25), RES→GPIO.2 (D27).
* Aktivierung von SPI/I²C am Raspberry Pi: sudo raspi-config → Interfacing Options → SPI/I²C aktivieren, danach Neustart.
* Unter Bookworm ist nur die lgpio-Bibliothek verfügbar; bcm2835 und WiringPi lassen sich dort nicht installieren.
* Demo-Aufruf C: cd c &amp;&amp; sudo make clean &amp;&amp; sudo make -j 8, dann sudo ./main 1.3 für dieses Modul.
* Python-Demo: cd python/example &amp;&amp; sudo python3 OLED_1in3_test.py (oder python2).

'''Befehle und Beispiele – vor Ausführung prüfen:''' 
<syntaxhighlight lang="text">
sudo raspi-config
sudo reboot
sudo apt-get install wiringpi
wget https://github.com/joan2937/lg/archive/master.zip
unzip master.zip
cd lg-master
sudo make install
sudo apt-get update
sudo apt-get install python3-pip
sudo apt-get install python3-pil
sudo apt-get install python3-numpy
sudo pip3 install spidev
sudo apt-get install python3-smbus
sudo apt-get install p7zip-full
sudo wget https://files.waveshare.com/upload/2/2c/OLED_Module_Code.7z
7z x OLED_Module_Code.7z
cd OLED_Module_Code/RaspberryPi
cd c
sudo make clean
sudo make -j 8
</syntaxhighlight>

== Hinweise und Versionsgrenzen ==
* Die genaue Zuordnung der Widerstände BS0/BS1 hängt vom Schweißmuster ab; vor dem Löten die Bestückung im Datenblatt prüfen.
* Das Programm nutzt standardmäßig SPI-Modus; zum Umschalten auf I²C muss DEV_Config.h angepasst werden – Schritt ist versionsabhängig.
* Bei STM32 wird im I²C-Demo analoges I²C verwendet; die Verdrahtung ist entsprechend anzupassen.
* Eine umgekehrte Stromversorgung kann das Modul beschädigen; Polung vor dem Einschalten kontrollieren.
* Langes Anzeigen desselben Bildes führt zu Nachbildern und schädigt das OLED; Bildinhalt regelmäßig wechseln.
* Bei Nichtleuchten nach dem Einschalten fehlt vermutlich die Programmkontrolle; ohne Softwarebefehl bleibt das Display dunkel.

== Quelle und Revisionsnachweis ==
* [https://www.waveshare.com/wiki/1.3inch_OLED_(B) 1.3inch OLED (B) - Waveshare Wiki]
* Quellrevision: 110135
* Erfasst: 2026-08-29T10:03:04+00:00
* SHA-256: <code>4cd94394b25150dbec4aca976f2a27c14965e092b399937b50ad192bd7343500</code>