Zum Inhalt springen

WSAL24691 – 1.27inch RGB OLED Module

Aus JW Tech Wiki

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

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:  

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

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

Abgerufen von „https://wiki.jw-tech.eu/index.php?title=WSAL24691_–_1.27inch_RGB_OLED_Module&oldid=2880“