diymore 1.3" 128x64 OLED LCD Display Module User Manual

1. Introduction

This manual provides detailed instructions for the setup, operation, and maintenance of the diymore 1.3-inch 128x64 OLED LCD Display Module. This module features an SSH1106 controller and communicates via an IIC (I2C) serial interface, making it suitable for various microcontroller projects, including those based on Arduino.

2. Specifications

The following table outlines the key technical specifications of the OLED display module:

3. Setup Instructions

3.1 Pin Definition

The module features a 4-pin IIC interface. Refer to the image below for pin identification:

• GND: Power Ground
• VCC: Power Positive (3.3V - 5V)
• SCL: Clock Wire (IIC/I2C Clock)
• SDA: Data Wire (IIC/I2C Data)

3.2 Hardware Connection

Connect the OLED module to your microcontroller (e.g., Arduino) as follows:

• Connect the GND pin of the OLED module to the GND pin of your microcontroller.
• Connect the VCC pin of the OLED module to the 3.3V or 5V power output of your microcontroller (ensure it matches the module's driving voltage range).
• Connect the SCL pin of the OLED module to the SCL (A5 on Arduino Uno/Nano, D1 on ESP32/ESP8266) pin of your microcontroller.
• Connect the SDA pin of the OLED module to the SDA (A4 on Arduino Uno/Nano, D2 on ESP32/ESP8266) pin of your microcontroller.

Note: Specific I2C pins may vary depending on your microcontroller board. Consult your board's documentation for exact pin assignments.

3.3 Software Setup (Arduino Example)

To use the OLED module with Arduino, you will typically need to install a compatible library. The SSH1106 controller is often supported by libraries designed for SSD1306, with minor modifications or specific SSH1106 libraries.

1. Install Arduino IDE: If you haven't already, download and install the Arduino IDE from the official Arduino website.
2. Install Libraries:
   • Open the Arduino IDE.
   • Go to Sketch > Include Library > Manage Libraries...
   • Search for "Adafruit SSD1306" and install it.
   • Search for "Adafruit GFX Library" and install it (this is a dependency for SSD1306).
   • Alternatively, search for "U8g2" library, which supports a wide range of monochrome displays including SSH1106.
3. Select Board and Port: Choose your Arduino board (e.g., Arduino Uno) and the correct COM port from the Tools menu.
4. Load Example Sketch: Open an example sketch from the installed library (e.g., File > Examples > Adafruit SSD1306 > ssd1306_128_64_i2c). You might need to modify the constructor to specify the SSH1106 controller or the I2C address (default is often 0x3C or 0x3D).

4. Operating Instructions

Once the hardware is connected and the necessary libraries are installed, you can program your microcontroller to display information on the OLED screen.

4.1 Basic Display Initialization (Conceptual)

The general steps for initializing and using the display in your code are:

1. Include Libraries: Add the necessary library headers (e.g., #include <Adafruit_SSD1306.h>).
2. Define I2C Address: Specify the I2C address of your OLED module (e.g., #define OLED_I2C_ADDRESS 0x3C).
3. Initialize Display Object: Create an instance of the display object (e.g., Adafruit_SSD1306 display(SCREEN_WIDTH, SCREEN_HEIGHT, &Wire, OLED_RESET);).
4. Begin Display: Call the display.begin() function to initialize the display with the correct I2C address.
5. Clear Display: Use display.clearDisplay() to clear any residual data.
6. Set Text Properties: Set text size, color, and cursor position (e.g., display.setTextSize(1); display.setTextColor(SSD1306_WHITE); display.setCursor(0,0);).
7. Print Text/Draw Graphics: Use display.print() for text or various drawing functions (e.g., display.drawPixel(), display.drawRect()) for graphics.
8. Display Content: Call display.display() to push the buffer content to the physical screen.

Refer to the examples provided with your chosen library for specific code implementations.

5. Maintenance

The diymore OLED display module is a robust electronic component, but proper care can extend its lifespan:

• Handle with Care: Avoid applying excessive force or bending the module, especially the flexible connector.
• Keep Dry: Protect the module from moisture and liquids, which can cause short circuits and damage.
• Clean Gently: If cleaning is necessary, use a soft, dry, lint-free cloth. Avoid abrasive materials or chemical cleaners.
• Static Discharge: Always handle electronic components with anti-static precautions to prevent damage from electrostatic discharge (ESD).
• Storage: Store the module in a cool, dry environment, away from direct sunlight and extreme temperatures.

6. Troubleshooting

If you encounter issues with your OLED display module, consider the following common troubleshooting steps:

• No Display/Blank Screen:
  • Verify all pin connections (GND, VCC, SCL, SDA) are secure and correct.
  • Ensure the VCC voltage is within the 3.3V-5V range.
  • Check the I2C address in your code. Common addresses are 0x3C or 0x3D. You can use an I2C scanner sketch to find the correct address.
  • Confirm that the display is initialized correctly in your code (display.begin()).
  • Make sure display.display() is called after drawing operations to update the screen.
• Garbled or Incorrect Display:
  • Ensure you are using a library compatible with the SSH1106 controller. Some SSD1306 libraries may work, but specific SSH1106 libraries or modifications might be required.
  • Check the display resolution settings in your code (should be 128x64).
  • Verify that the I2C communication is stable. Long wires or noisy environments can affect I2C.
• Module Not Detected by I2C Scanner:
  • Double-check power (VCC, GND) and I2C data/clock (SDA, SCL) connections.
  • Ensure your microcontroller's I2C pins are correctly configured.
  • Test with another I2C device if possible to rule out microcontroller issues.

7. User Tips

• Power Supply: While the module supports 3.3V-5V, using a stable 3.3V supply is often recommended for OLEDs to prolong their lifespan and ensure optimal performance.
• Library Compatibility: For best results, use libraries specifically designed or updated to support the SSH1106 controller, as it has some differences from the more common SSD1306. The U8g2 library is a good option for its broad support.
• I2C Address: If the default I2C address (0x3C or 0x3D) doesn't work, use an I2C scanner sketch to confirm the actual address of your module.
• Screen Burn-in: Like all OLEDs, prolonged display of static images can lead to screen burn-in. Consider implementing screen savers or varying displayed content to mitigate this.

8. Warranty and Support

For technical support, warranty claims, or further assistance, please contact the seller or manufacturer directly through the platform where the product was purchased. Provide your order details and a clear description of the issue to facilitate a quicker resolution.