|Model number||1.5inch RGB OLED Module|
|Part Number||1.5inch RGB OLED Module|
|Package Dimensions||6.86 x 5.08 x 2.29 cm; 45 Grams|
|Item Weight||45 g|
|Item Model Number||1.5inch RGB OLED Module|
|Date First Available||29 March 2019|
waveshare 1.5inch RGB OLED Display Module, 128x128 Pixels Displaying 65K Colors, Support Raspberry Pi Arduino STM32, SPI Interface
We don't know when or if this item will be back in stock.
- 128x128 high resolution, 65K colors, clearly displays colorful images
- Supports 4-wire SPI OR 3-wire SPI interface, configured via onboard resistor
- Comes with development resources and manual (examples for Raspberry Pi/Arduino/STM32)
- A cool addition to any Arduino project and is fairly simple to get setup and running
- SSD1351 OLED
Have a question?
Find answers in product info, Q&As, reviews
Your question might be answered by sellers, manufacturers, or customers who bought this product.
Please make sure that you've entered a valid question. You can edit your question or post anyway.
Please enter a question.
1.5inch RGB OLED display module, 128x128 pixels, 16-bit high color, SPI interface Overview This is a general RGB OLED display Module, 1.5inch diagonal, 128x128 pixels, 16-bit high color (65K colors), with embedded controller, communicating via SPI interface. Specifications Driver: SSD1351 Interface: 4-wire SPI, 3-wire SPI Display color: RGB, 65K colors Resolution: 128x128 Viewing angle: >160 Operating voltage: 3.3V / 5V Dimension: 44.5 x 37 (mm) Package Content 1.5inch RGB OLED Module x1 PH2.0 7Pin x1 Note:100% original from Waveshare, technical support is provided ,please feel free to contact us !
Review this product
Top reviews from other countries
So, as an example of the poor documentation here are the steps the manufacturer laid out to install the libraries:
Click to download the bcm2835-1.39 libraries or bcm2835-1.45 libraries. You can also obtain the latest version from the bcm2835 website:
Copy the installation package into your own system, enter the bcm2835 libraries folder, then do this to install:
sudo make check
sudo make install
Here is what I've had to do because the product page was last updated in 2017 and there have been multiple version changes and depreciations since then.
chmod +x configure : because the configure was not set to executable
./configure : actually run the file
sudo apt-get install automake : because it doesn't come installed on raspbian
automake --add-missing : to create the ./compile which was not created previously
sudo ln -sf /usr/bin/aclocal /usr/bin/aclocal-1.13 : the make is looking for a specific version of aclocal and fails so I created a symbolic link to the automake
sudo ln -sf /usr/bin/automake /usr/bin/automake-1.13 : for the same reason
make : hey it didn't immediately error out but now I'm getting this
gcc -DHAVE_CONFIG_H -I. -I.. -g -O2 -MT test.o -MD -MP -MF .deps/test.Tpo -c -o test.o test.c
test.c: In function ‘main’:
test.c:16:9: warning: implicit declaration of function ‘geteuid’; did you mean getenv’? [-Wimplicit-function-declaration]
if (geteuid() == 0 && !getenv("FAKEROOTKEY"))
[other assorted errors]
Anyway, if that excites you then have at it. If you're like me and are willing to put up with some hardware idiosyncrasies to just get back to doing the cool stuff with the coding then look elsewhere. I'm all googled/binged out. This will go into a small pile of stuff that seemed like a good idea at first, and then turned to a huge waste of time. I can do the same thing with an official 3" LCD display and some jumper wires but I liked the idea of a lower power display that didn't throw off a lot of unnecessary light.
I was able to get it working at a very slow refresh rate using the basic Adafruit libraries and instructions you will find if you google "Adafruit 1.5 oled". Translation of pins labeled on the board:
VCC = +5 V
GND = ground, obviously
DIN = SDA = MOSI
CLK = SCLK = SCL
CS = SS = OLEDCS
DC = DC
RST = Reset
I had to use the software SPI mode ("option 1" in the Adafruit test code) to get the thing working. It does work, but it is very slow to refresh the display. It's painful. I was not able to get the hardware SPI mode ("option 2") to work at all. If anyone figures that out, please post about it here. I am sure it is quite snappy when hardware SPI is enabled.
Update I did some more research and found that if i removed the (ucg.clearScreen();) from loop and use the ucg.setFont(ucg_font_inb21_mr); font it works way better!
Notes: This was for Retropie 4.3 rpi1_zero, I tried using the newest build (Buster at this time), but it seemed to run slower than Jesse.
This screen doesn't display anything till the driver is kicked in. So don't get nervous if you don't see it turn on after you wire it up. Also, it takes a bit to display on boot up.
My use case:
// Enable SPI (Interfaces), disable overlay (Advanced):
// Setup wifi, or use LAN cable
// Make sure your version of Raspian has git
// Get fbcp, compile, copy to bin:
sudo git clone https://github.com/tasanakorn/rpi-fbcp
sudo cd rpi-fbcp
sudo mkdir build
sudo cd build
sudo cmake ..
sudo cp fbcp /usr/bin
sudo chmod +x /usr/bin/fbcp
// Enter text to /etc/rc.local (before line: exit 0):
// Create file, with text /etc/modules-load.d/fbtft.conf:
// Create file, with text /etc/modprobe.d/fbtft.conf file:
options fbtft_device custom name=fb_ssd1351 width=128 height=128 buswidth=8 gpios=reset:24,dc:25 speed=32000000 bgr=1 rotate=180
Your reset and dc pin may be different than GPIO 24 and 25, make the change accordingly.
// (Optional) Make changes to /boot/config.txt
hdmi_cvt=128 128 60
This will force the HDMI buffer to match the OLED screen resolution. Caution, this will affect the HDMI output as well. Thus most screens won't support the resolution of 128 x 128 from the HDMI port. You can try setting hdmi_cvt to a more acceptable middle ground resolution, like 320 240 or 640 480, if so desired.
// My pin setup:
VCC (Power +): Any 3.3V
GND (Power -): Any GND
DIN: GPIO 10 MOSI
CLK: GPIO 11 CLK
CS: GPIO 8 CE0
DC: GPIO 24
RST: GPIO 25
Reviewed in the United States on 14 June 2020