在 YouTube 上观看

Arduino Code and Video for SSD1306 OLED 128 x 32 Display with I2C

In this tutorial, we will explore how to use the SSD1306 OLED 128 x 32 display with I2C communication on an Arduino. The goal is to display various elements such as text, rectangles, and dynamic values like voltage and temperature on the screen. This setup is ideal for projects requiring a compact and efficient display solution.

We will walk through the necessary hardware components, wiring instructions, and the Arduino code to get everything up and running. For a visual guide, make sure to check out the video accompanying this tutorial (in video at 00:00).

Hardware Explained

The key components for this project include the SSD1306 OLED display, which is a low-power display that uses I2C communication for easy interfacing. The display features a resolution of 128 x 32 pixels, making it suitable for displaying text and simple graphics.

To control the display, we will use the Arduino board, which will send commands and data via I2C. The Arduino handles the logic of displaying the information by using libraries such as Adafruit_GFX and Adafruit_SSD1306. These libraries simplify the communication process and allow for easy drawing of shapes and text.

Datasheet Details

• Check I2C address, typically 0x3C for OLEDs.
• Ensure proper power supply to avoid damage.
• Use pull-up resistors for SDA and SCL lines if required.
• Keep wiring short to reduce noise in the I2C signal.
• Consider heat dissipation if powering multiple modules.

Wiring Instructions

To wire the SSD1306 OLED display, first connect the VCC pin of the display to the 5V output on the Arduino. Next, connect the GND pin to one of the Arduino's ground pins. For the I2C communication, connect the SDA pin of the display to the SDA pin on the Arduino, which is A4 for the UNO. Then, connect the SCL pin of the display to the SCL pin on the Arduino, which is A5 for the UNO. If you are using a different Arduino model, refer to the specific pin mapping for SDA and SCL.

For additional components, if you have an LED that you want to control, connect it to pin 9 through a 330-ohm resistor. Make sure to connect the other end of the resistor to the anode of the LED, while the cathode should go to ground. This setup will allow the LED to light up when pin 9 is activated.

Code Examples & Walkthrough

In the Arduino code, we start by including the necessary libraries for the OLED display. A key identifier is display, which is an instance of the Adafruit_SSD1306 class. The display is initialized in the setup() function, where we also clear the display to prepare for drawing.

void setup() {
  Serial.begin(9600);
  display.begin(SSD1306_SWITCHCAPVCC, 0x3C);
  display.display();
  delay(2000);
  display.clearDisplay(); 
}

In the loop() function, we define a string variable vString to hold the voltage value, which is updated dynamically. The robojaxText() function is used to display text on the screen at specified coordinates.

void loop() {
  String vString = String(count, 3);
  display.clearDisplay();
  robojaxText("Voltage:          ", 4, 3, 1, false);
  robojaxText(vString, 72, 3, 1, false);
  display.display();
  count += 0.173;
  delay(2000); 
}

The robojaxText() function is crucial for positioning and displaying text. It takes parameters for the text string, x and y coordinates, text size, and a boolean to determine if the display should be updated immediately.

void robojaxText(String text, int x, int y, int size, boolean d) {
  display.setTextSize(size);
  display.setTextColor(WHITE);
  display.setCursor(x, y);
  display.println(text);
  if(d) {
    display.display();
  }
}

This function sets the text size, color, and cursor position before printing the text. Remember to watch the video for a complete walkthrough of the code (in video at 10:00).

Demonstration / What to Expect

When the code is uploaded to the Arduino, the OLED display should show the voltage, temperature, and capacity values dynamically updating every two seconds. You should also see a rectangle drawn around the text elements. If the display does not show anything, ensure that the connections are correct and that the I2C address matches the one specified in the code.

Video Timestamps

• 00:00 - Introduction to the project
• 02:00 - Wiring instructions
• 05:00 - Code walkthrough
• 10:00 - Demonstration of the output

图像

SSD1306 OLED 128x32

SSD1306 OLED 128x32

SSD1306 OLED 128x32

SSD1306 OLED 128x32

Arduino wiring for SSD1306 OLED 128x32

SSD1306 OLED 128x32

SSD1306 OLED 128x32

SSD1306 OLED 128x32

SSD1306 OLED 128x32

Arduino wiring for SSD1306 OLED 128x32

/*********************************************************************
This is an example for our monochrome OLEDs based on SSD1306 drivers.

This example is for a 128x32 size display using I2C.

If you get the error: Adafruit_GFX.h not found, download the Adafruit-GFX Library
https://github.com/adafruit/Adafruit-GFX-Library


Purchase this OLED module from Amazon: https://amzn.to/36zFvTb

Written by Limor Fried/Ladyada for Adafruit Industries.
BSD license, check license.txt for more information.
All text above, and the splash screen must be included in any redistribution.

 * Watch the video for this code to learn it fully.
  * Watch the video here: https://youtu.be/RjyulqVsz2o
 * This code is offered "as is" without any warranty.
 * Updated by Ahmad Shamshiri for Robojax.com video tutorial
 * on March 18, 2018 at 10:21 in Ajax, Ontario, Canada.
 * Please view other Robojax codes and videos at http://robojax.com/learn/arduino
 * If you are sharing this code, you must keep this copyright note.
 * 
*********************************************************************/

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

#define OLED_RESET 4
Adafruit_SSD1306 display(OLED_RESET);

#define NUMFLAKES 10
#define XPOS 0
#define YPOS 1
#define DELTAY 2
double count=0;

/*
 * PIN connection:
 * Pin connection see: https://www.arduino.cc/en/Reference/Wire
 * for UNO: SDA to A4, SCL to A5
 * for Mega2560: SDA to 20, SCL to 21
 * for Leonardo: SDA to 2, SCL to 3
 * for Due: SDA to 20, SCL to 21
 * VCC to 5V
 * GND to GND :-)
 */


// this is the Width and Height of Display which is 128 x 32
#define LOGO16_GLCD_HEIGHT 32
#define LOGO16_GLCD_WIDTH  128 


#if (SSD1306_LCDHEIGHT != 32)
#error("Height incorrect, please fix Adafruit_SSD1306.h!");
#endif

void setup()   {                
  Serial.begin(9600);

  // by default, we'll generate the high voltage from the 3.3v line internally! (neat!)
  display.begin(SSD1306_SWITCHCAPVCC, 0x3C);  // initialize with the I2C addr 0x3C (for the 128x32)
  display.display();
  delay(2000);
   // Clear the buffer.
  display.clearDisplay(); 
}


void loop() {
  String vString =  String(count, 3);// using a float and the 
  display.clearDisplay();
  robojaxText("Voltage:          ", 4, 3, 1, false);
  robojaxText(vString, 72, 3, 1, false);
  robojaxText("V", 110, 3, 1, false);
  robojaxText("Temperature: 32C", 4, 11, 1, false);
  robojaxText("Capacity:   92.86L", 4, 21, 1, false);
  //display.drawLine(1, 37, 100, 37, WHITE);
 display.drawRect(1, 1, 126,31, WHITE);
  //display.drawCircle(63,31, 31, WHITE);
   //display.startscrollright(0x00, 0x0F);
  display.display();
  count +=0.173;
   delay(2000); 
}


/*
 * robojaxText(String text, int x, int y,int size, boolean d)
 * text is the text string to be printed
 * x is the integer x position of text
 * y is the integer y position of text
 * size is the text size, 1, 2, 3 etc
 * d is either true or false.  If true, the display is updated.
 */
void robojaxText(String text, int x, int y,int size, boolean d) {

  display.setTextSize(size);
  display.setTextColor(WHITE);
  display.setCursor(x,y);
  display.println(text);
  if(d){
    display.display();
  }
  
  //delay(100);
}