Arduino Project

Arduino OLED Display Tutorial: Play “BestFriend” Animation

Kit purchase

Looking for parts? Check out our all-in-one kits below — packed with components, beginner-friendly guides, and tons of fun.

2.png__PID:4c058c33-95c6-4f46-b6eb-562b4ffd4bdf

Name	Includes Arduino board	PURCHASE LINK
Elite Explorer Kit	Arduino Uno R4 WiFi	BUY
3 in 1 Ultimate Starter Kit	Arduino Uno R4 Minima	BUY

Course Introduction

In this lesson, we will learn how to use an OLED with Arduino to play the “BEST FRIENDS” animation.

Note

If this is your first time working with an Arduino project, we recommend downloading and reviewing the basic materials first.

1.1 Install Arduino IDE(Important)
1.2 Introduction of Arduino IDE

Required Components

In this project, we need the following components:

SN	COMPONENT INTRODUCTION	QUANTITY	PURCHASE LINK
1	Arduino UNO R4 Minima	1	BUY
2	USB Type-C cable	1	×
3	Breadboard	1	BUY
4	Wires	Several	BUY
5	OLED Display Module	1	BUY

Wiring

OLED_i_miss_you_bb.png__PID:dd86090b-a507-46a6-85e3-99685dc7fef6

Common Connections:

OLED Display Module
SDA: Connect to SDA on the Arduino.
SCK: Connect to SCL on the Arduino.
GND: Connect to GND on the Arduino.
VCC: Connect to 5V on the Arduino.

Writing the Code

Note
You can copy this code into Arduino IDE.
To install the library, use the Arduino Library Manager and search for Adafruit SSD1306 and Adafruit GFX and install it.
The VideoFrame_R4.h is used here. You can click here VideoFrame_R4.zip to download it.
Then place VideoFrame_R4.h in the same folder as the following code.
Don’t forget to select the board(Arduino UNO R4 Minima/WIFI) and the correct port before clicking the Upload button.

/*
  OLED Animation Player
  Arduino UNO R4 WiFi / Minima

  Display:
  SSD1306 128x64 I2C
*/

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

#include "VideoFrame.h"

// ==========================================
// OLED settings
// ==========================================

#define SCREEN_WIDTH 128
#define SCREEN_HEIGHT 64

#define OLED_RESET -1
#define OLED_ADDRESS 0x3C

Adafruit_SSD1306 display(
  SCREEN_WIDTH,
  SCREEN_HEIGHT,
  &Wire,
  OLED_RESET
);

// ==========================================
// Animation variables
// ==========================================

uint16_t currentFrame = 0;

unsigned long previousFrameTime = 0;

// ==========================================
// Setup
// ==========================================

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

  // UNO R4 standard I2C
  Wire.begin();

  // Faster I2C
  Wire.setClock(400000);

  delay(200);

  if (!display.begin(
        SSD1306_SWITCHCAPVCC,
        OLED_ADDRESS
      )) {

    Serial.println(
      F("SSD1306 initialization failed!")
    );

    while (true) {
      delay(100);
    }
  }

  Serial.println(
    F("SSD1306 initialized.")
  );

  Serial.print(
    F("Frames: ")
  );

  Serial.println(
    TOTAL_FRAMES
  );

  display.clearDisplay();
  display.display();

  previousFrameTime = millis();
}

// ==========================================
// Main loop
// ==========================================

void loop() {
  unsigned long currentTime = millis();

  if (
    currentTime - previousFrameTime >=
    FRAME_DELAY
  ) {

    /*
      Use += instead of = currentTime
      to keep animation timing more stable.
    */
    previousFrameTime += FRAME_DELAY;

    // Clear previous image
    display.clearDisplay();

    /*
      IMPORTANT:

      The source frames use Adafruit GFX
      horizontal bitmap format.

      So drawBitmap() must be used.
    */
    display.drawBitmap(
      0,
      0,
      video_frames[currentFrame],
      SCREEN_WIDTH,
      SCREEN_HEIGHT,
      SSD1306_WHITE
    );

    // Send frame to OLED
    display.display();

    // Next frame
    currentFrame++;

    if (
      currentFrame >= TOTAL_FRAMES
    ) {
      currentFrame = 0;
    }

    /*
      Recover if playback falls too far behind.
    */
    if (
      millis() - previousFrameTime >
      FRAME_DELAY * 2
    ) {
      previousFrameTime = millis();
    }
  }
}

Recover password

Create my account

Arduino Project

Arduino OLED Display Tutorial: Play “BestFriend” Animation

Kit purchase

Course Introduction

Required Components

Wiring

Common Connections:

Writing the Code

Arduino Project

Arduino OLED Display Tutorial: Play “BestFriend” Animation

Kit purchase

Course Introduction

Required Components

Wiring

Common Connections:

Writing the Code

Subscribe to our newsletter