How to Use 1.5" In OLED Display 128x128: Examples, Pinouts, and Specs

The 1.5" OLED Display 128x128 is a compact organic light-emitting diode display with a resolution of 128x128 pixels. It is designed for applications requiring vibrant colors, high contrast, and low power consumption. This display is ideal for use in portable devices, wearables, IoT projects, and other embedded systems where space and power efficiency are critical.

• Wearable devices (e.g., smartwatches, fitness trackers)
• IoT dashboards and status indicators
• Portable medical devices
• Compact user interfaces for embedded systems
• Hobbyist and DIY electronics projects

The following table outlines the key technical details of the 1.5" OLED Display 128x128:

The pinout of the 1.5" OLED Display 128x128 may vary slightly depending on the manufacturer, but a typical configuration is as follows:

To use the 1.5" OLED Display 128x128 with an Arduino UNO, follow these steps:

1. Wiring: Connect the display to the Arduino UNO as shown below:

   • GND → GND
   • VCC → 5V
   • SCL → Pin 13 (SPI Clock)
   • SDA → Pin 11 (SPI MOSI)
   • RES → Pin 8
   • DC → Pin 9
   • CS → Pin 10

2. Install Libraries: Install the necessary libraries for the SSD1351 driver. You can use the Adafruit SSD1351 library, which is available in the Arduino Library Manager.

3. Upload Code: Use the following example code to display graphics or text on the OLED:

#include <Adafruit_GFX.h>      // Core graphics library
#include <Adafruit_SSD1351.h> // SSD1351 OLED driver library
#include <SPI.h>              // SPI communication library

// Define OLED display pins
#define OLED_CS   10  // Chip Select pin
#define OLED_DC   9   // Data/Command pin
#define OLED_RST  8   // Reset pin

// Create an instance of the display
Adafruit_SSD1351 display = Adafruit_SSD1351(128, 128, &SPI, OLED_CS, OLED_DC, OLED_RST);

void setup() {
  // Initialize the display
  display.begin();
  display.fillScreen(BLACK); // Clear the screen with black color

  // Display a message
  display.setTextColor(WHITE); // Set text color to white
  display.setTextSize(1);      // Set text size
  display.setCursor(0, 0);     // Set cursor position
  display.println("Hello, OLED!"); // Print text
  display.display();           // Update the display
}

void loop() {
  // Add any animations or updates here
}

• Power Supply: Ensure the display is powered within its operating voltage range (3.3V to 5V). Exceeding this range may damage the module.
• Interface Selection: Some modules support both SPI and I2C interfaces. Check the module's documentation or solder jumpers to configure the desired interface.
• Reset Pin: Always connect the reset pin (RES) to the microcontroller to ensure proper initialization of the display.

1. The display does not turn on:

   • Verify all connections are secure and match the pinout.
   • Ensure the power supply voltage is within the specified range (3.3V to 5V).
   • Check if the reset pin (RES) is properly connected.

2. The display shows random or distorted graphics:

   • Confirm that the correct driver library (e.g., Adafruit SSD1351) is installed.
   • Ensure the SPI or I2C communication pins are correctly connected.
   • Verify that the initialization code matches the display's configuration.

3. The display is blank after uploading code:

   • Double-check the wiring and pin definitions in the code.
   • Ensure the begin() function is called in the setup to initialize the display.

Q: Can I use this display with a 3.3V microcontroller?
A: Yes, the display is compatible with both 3.3V and 5V logic levels.

Q: How do I switch between SPI and I2C modes?
A: Some modules have solder jumpers or pads to configure the interface. Refer to the module's datasheet for instructions.

Q: Can I display images on this OLED?
A: Yes, you can display images by converting them into a compatible format (e.g., RGB565) and using the appropriate library functions.

Q: What is the maximum refresh rate of this display?
A: The refresh rate depends on the driver IC (SSD1351) and the communication speed. Typically, it supports smooth animations for most applications.

By following this documentation, you can effectively integrate and use the 1.5" OLED Display 128x128 in your projects.