How to Use Adafruit 128x64 OLED Bonnet: Examples, Pinouts, and Specs

The Adafruit 128x64 OLED Bonnet (Manufacturer Part ID: 3531) is a compact, high-resolution OLED display module designed for use in embedded electronics projects. With a resolution of 128x64 pixels, it is ideal for displaying crisp text, detailed graphics, and animations. This module supports both I2C and SPI communication protocols, making it versatile and easy to integrate with microcontrollers and single-board computers like the Raspberry Pi.

• Displaying system status or sensor data in IoT projects
• Creating user interfaces for embedded systems
• Visualizing data in portable devices
• DIY electronics and prototyping
• Educational projects and demonstrations

The following table outlines the key technical details of the Adafruit 128x64 OLED Bonnet:

The Adafruit 128x64 OLED Bonnet features the following pin configuration:

1. Power the Bonnet: Connect the VIN pin to a 3.3V or 5V power source and the GND pin to ground.
2. Choose Communication Protocol: Decide whether to use I2C or SPI. For I2C, connect the SCL and SDA pins to the corresponding pins on your microcontroller. For SPI, connect SCK, MOSI, DC, CS, and RST as required.
3. Install Required Libraries: If using a Raspberry Pi or Arduino, install the Adafruit SSD1306 and Adafruit GFX libraries for easy control of the display.
4. Write Code: Use the libraries to initialize the display, draw graphics, and display text.

• Voltage Compatibility: Ensure the power supply voltage matches the module's requirements (3.3V to 5V).
• Pull-Up Resistors: For I2C communication, ensure pull-up resistors are present on the SCL and SDA lines.
• Brightness Settings: Adjust the brightness to balance visibility and power consumption.
• Avoid Static Damage: Handle the module carefully to prevent damage from electrostatic discharge (ESD).

#include <Wire.h>
#include <Adafruit_GFX.h>
#include <Adafruit_SSD1306.h>

// Define the OLED display dimensions
#define SCREEN_WIDTH 128
#define SCREEN_HEIGHT 64

// Create an SSD1306 display object connected via I2C
Adafruit_SSD1306 display(SCREEN_WIDTH, SCREEN_HEIGHT, &Wire, -1);

void setup() {
  // Initialize serial communication for debugging
  Serial.begin(9600);

  // Initialize the OLED display
  if (!display.begin(SSD1306_I2C_ADDRESS, 0x3C)) {
    Serial.println(F("SSD1306 allocation failed"));
    for (;;); // Halt execution if initialization fails
  }

  // Clear the display buffer
  display.clearDisplay();

  // Display a welcome message
  display.setTextSize(1); // Set text size
  display.setTextColor(SSD1306_WHITE); // Set text color
  display.setCursor(0, 0); // Set cursor position
  display.println(F("Hello, OLED!"));
  display.display(); // Render the text on the display
  delay(2000); // Pause for 2 seconds
}

void loop() {
  // Example: Draw a rectangle on the display
  display.clearDisplay(); // Clear the display buffer
  display.drawRect(10, 10, 50, 30, SSD1306_WHITE); // Draw a rectangle
  display.display(); // Render the rectangle on the display
  delay(1000); // Pause for 1 second
}

1. Display Not Turning On:

   • Verify the power connections (VIN and GND).
   • Ensure the correct communication protocol (I2C or SPI) is selected and wired properly.
   • Check for loose or incorrect connections.

2. No Output on the Display:

   • Confirm that the correct I2C address (default: 0x3C) is being used in the code.
   • Ensure the required libraries (Adafruit SSD1306 and Adafruit GFX) are installed and up to date.
   • Check for syntax errors or incorrect initialization in the code.

3. Flickering or Unstable Display:

   • Verify that the power supply provides sufficient current.
   • Check for noise or interference on the communication lines.

4. Partial or Distorted Graphics:

   • Ensure the display buffer is cleared (display.clearDisplay()) before drawing new content.
   • Verify that the display dimensions (128x64) are correctly defined in the code.

Q: Can I use this module with a Raspberry Pi?
A: Yes, the Adafruit 128x64 OLED Bonnet is fully compatible with Raspberry Pi. Use the I2C or SPI interface and install the necessary Python libraries (e.g., Adafruit-SSD1306).

Q: What is the default I2C address of the module?
A: The default I2C address is 0x3C.

Q: Can I daisy-chain multiple OLED Bonnet modules?
A: No, the module does not support daisy-chaining. Each module requires a unique I2C address or separate SPI connections.

Q: How do I adjust the brightness?
A: Brightness can be adjusted programmatically using the ssd1306_command() function in the Adafruit SSD1306 library.

Q: Is the display sunlight-readable?
A: The OLED display is not optimized for direct sunlight and is best used indoors or in shaded environments.