WSAL10451 – 1.3inch OLED (B)
Erscheinungsbild
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
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 >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 && sudo make clean && sudo make -j 8, dann sudo ./main 1.3 für dieses Modul.
- Python-Demo: cd python/example && sudo python3 OLED_1in3_test.py (oder python2).
Befehle und Beispiele – vor Ausführung prüfen:
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
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
- 1.3inch OLED (B) - Waveshare Wiki
- Quellrevision: 110135
- Erfasst: 2026-08-29T10:03:04+00:00
- SHA-256:
4cd94394b25150dbec4aca976f2a27c14965e092b399937b50ad192bd7343500