JWTechPublisher: Freigegebene technische Dokumentation veröffentlicht; Text-only und noindex

2026-09-06T07:58:15Z

Freigegebene technische Dokumentation veröffentlicht; Text-only und noindex

Neue Seite

__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 ==
Das 1,27-Zoll RGB OLED-Modul (Waveshare WSAL24691) ist ein selbstleuchtendes Display mit 128×96 Auflösung und 262K Farben. Es wird über 4-Draht-SPI oder 3-Draht-SPI angesteuert und verwendet den SSD1351-Controller.

== Zugeordnete Produkte bei JW Tech ==
* [https://shop.jw-tech.eu/p/WSAL24691 WSAL24691 – 1,27-Zoll RGB OLED-Displaymodul, 128×96 Auflösung, 262K Farben, SPI-Schnittstelle]

== Technische Übersicht ==
* Auflösung: 128(H) × 96(V), 262K Farben, Pixelgröße 0,047 × 0,185 mm; Abmessungen 25,708 × 19,28 mm.
* Betriebsspannung: 3,3 V/5 V – Versorgungsspannung und Logikspannung müssen übereinstimmen, sonst funktioniert das Modul nicht ordnungsgemäß.
* Schnittstelle: 4-Draht-SPI (Vorgabe) oder 3-Draht-SPI, umschaltbar über einen lötbaren Widerstand auf der Rückseite (BS0 = 0 für 4 Draht, BS = 1 für 3 Draht).
* SSD1351-Controller: unterstützt 262K und 65K Farbtiefe, 128×128×18-Bit SRAM als Display-Puffer.
* Pinbelegung: VCC, GND, DIN (MOSI), SCL (SCK), CS (aktiv niedrig), DC (niedrig = Befehl, hoch = Daten), RST (Reset, aktiv niedrig).
* In 4-Draht-SPI wird DC vor dem Senden gesetzt: DC=0 → Befehlsbyte, DC=1 → Datenbytes in die SRAM.
* In 3-Draht-SPI entfällt der DC-Pin; jedes Übertragungsbyte wird mit einem zusätzlichen Bit ergänzt (9 statt 8 Bit), um Befehl/Daten zu kennzeichnen; DC muss geerdet sein.
* Raspberry Pi-Anschluss: 7-PIN-Kabel; Pinzuordnung: VCC→3.3V, GND→GND, DIN→BCM19/Pin3, CLK→BCM23/Pin5, CS→CE0(BCM24), DC→BCM25/Pin22, RST→BCM27/Pin13.
* SPI-Aktivierung: raspi-config → Interfacing Options → SPI → Yes, dann Neustart; I2C analog aktivieren.
* Python-Umgebung: python3-pip, python3-pil, python3-numpy, spidev, python3-smbus installieren; Demo über OLED_1in27_rgb_test.py ausführen.
* C-Demo: im Verzeichnis c: make clean, make -j 8, dann sudo ./main 1.27rgb.
* Bildkonvertierung: horizontales Scannen, 16-Bit-Farbformat, höhere Bits zuerst.
* Bei Bookworm-Betriebssystem nur lgpio verfügbar; bcm2835 und WiringPi sind dort nicht installierbar.

'''Befehle und Beispiele – vor Ausführung prüfen:'''
<syntaxhighlight lang="text">
sudo raspi-config
sudo reboot
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/c
sudo make clean
sudo make -j 8
sudo ./main 1.27rgb
cd OLED_Module_Code/RaspberryPi/python/example
sudo python3 OLED_1in27_rgb_test.py
</syntaxhighlight>

== Hinweise und Versionsgrenzen ==
* Die Quellangabe listet keine genauen Stromwerte spezifisch für das 1,27-Zoll RGB OLED-Modul; die genannten Werte betreffen andere Größen (0,95 Zoll, 0,96 Zoll, 1,3 Zoll, 1,51 Zoll, 2,42 Zoll).
* Der 3,3-V/5-V-Betriebsbereich basiert auf einer 24-Stunden-Langzeitprüfung des Herstellers; bei 5-V-Betrieb sollte die Kompatibilität mit der Zielplatine individuell geprüft werden.
* Die Wahl zwischen 4-Draht- und 3-Draht-SPI erfordert ein Löten des Widerstands auf der Rückseite – Schweißarbeiten erfordern Sorgfalt und passende Ausrüstung.
* Auf Bookworm kann nur lgpio genutzt werden; Versuche mit bcm2835 oder WiringPi schlagen dort fehl.
* Ein statisches Bild über längere Zeit kann Restbilder erzeugen und das OLED beschädigen; regelmäßiger Bildwechsel wird empfohlen.
* Vor dem Ausführen der Demos muss sichergestellt sein, dass SPI nicht von anderen Geräten belegt ist (Prüfung in /boot/config.txt).
* Alle Anweisungen im Quelltext, die auf externe Downloads oder Installationen verweisen, sollten vor der Ausführung auf ihre Relevanz und Sicherheit überprüft werden.

== Quelle und Revisionsnachweis ==
* [https://www.waveshare.com/wiki/1.27inch_RGB_OLED_Module 1.27inch RGB OLED Module - Waveshare Wiki]
* Quellrevision: 109424
* Erfasst: 2026-09-05T02:41:43+00:00
* SHA-256: <code>0c26161008760fef5e01e612ebe11e24571e9971b22ef07e0c4141f90139900f</code>

WSAL24691 – 1.27inch RGB OLED Module - Versionsgeschichte

JWTechPublisher: Freigegebene technische Dokumentation veröffentlicht; Text-only und noindex