Zum Inhalt springen

WSAL14747 – 1.5inch RGB OLED Module/en

Aus JW Tech Wiki

Documentation notice: This technical documentation was independently rewritten from an archived supplier source. Check technical details and commands against the product version and manufacturer documentation before use.

Summary

Technical overview of the Waveshare 1.5-inch RGB OLED module: specifications, SPI connection, SSD1351 control, and setup instructions for Raspberry Pi, STM32 and Arduino.

Related products at JW Tech

Technical overview

  • Resolution 128×128 pixels at 65K color depth; driver IC is SSD1351 with a 128×128×18-bit SRAM buffer.
  • Two operating modes: 4-wire SPI (default) and 3-wire SPI, switchable via a solderable resistor on the module's rear side.
  • In 4-wire SPI, the DC line selects mode: low = command byte, high = data byte(s).
  • In 3-wire SPI, the DC signal is omitted; instead an extra bit is prepended to each transfer to distinguish command from data; transfers are 9-bit blocks.
  • Pins: VCC (3.3 V or 5 V), GND, DIN (MOSI), SCL/SCK, CS (active-low), DC, RST (active-low).
  • Operating voltage must be chosen between 3.3 V and 5 V; ensure supply and logic levels match, otherwise the module will not work properly.
  • For Raspberry Pi: enable SPI via 'sudo raspi-config' under Interfacing Options -> SPI -> Yes, then reboot.
  • Available libraries: BCM2835, WiringPi, lgpio and Python (spidev, PIL, numpy); on Bookworm only lgpio is usable.
  • C test demo: run 'sudo make clean && sudo make -j 8' in the 'c' directory, then 'sudo ./main 1.5rgb'.
  • Python test demo: 'cd python/example' and run 'sudo python3 OLED_1in5_rgb_test.py'.

Commands and examples – verify before use:  

sudo raspi-config
sudo reboot
sudo apt-get install wiringpi
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
sudo ./main 1.5rgb
cd python/example
sudo python3 OLED_1in5_rgb_test.py

Notes and version constraints

  • The source contains placeholders such as {{{name2}}} through {{{name6}}} and {{{userDefinedInfo}}}, indicating incomplete metadata – complete these before publication via human review.
  • Voltage choice 3.3 V vs. 5 V: The source explicitly warns that supply voltage and logic level must match; an incorrect combination causes malfunction.
  • Library usability is version-sensitive: On Bookworm, per the source, BCM2835 and WiringPi cannot be installed; only lgpio is available.
  • The stated current draw (~60 mA full white / ~4 mA full black at 3.3 V) comes from the FAQ section; exact values should be confirmed with the supplier.
  • The module has no backlight and only lights up after programming – without control commands the display stays dark.
  • The demo file is downloaded from an external URL; if network access is unavailable or paths have changed, the download may fail.

Source and revision record

Abgerufen von „https://wiki.jw-tech.eu/index.php?title=WSAL14747_–_1.5inch_RGB_OLED_Module/en&oldid=1452“