OLED显示屏与Arduino接口

原文：https://circuitdigest.com/microcontroller-projects/arduino-ssd1306-oled-display

将SSD1306 OLED显示屏与Arduino接口

ARDUINO的

经过**阿斯温斯·拉吉（Aswinth Raj）** 2017年6月23日5

我们大多数人都会熟悉16×2点矩阵LCD显示屏，该显示屏在大多数项目中用于向用户显示一些信息。但是这些LCD显示器在功能上有很多限制。在本教程中，我们将学习有关OLED显示器以及如何使用Arduino的信息。市场上有许多类型的OLED显示器，并且有很多使它们工作的方法。在本教程中，我们将讨论其分类以及最适合您的项目的分类。

所需硬件：

• 7pin 128×64 OLED显示模块（SSD1306）
• Arduino UNO /Nano
• 面包板
• 连接线
• 电脑/笔记本电脑(computer/Laptop)

了解OLED显示器：

OLED一词代表“*有机发光二极管”，*它使用了与我们大多数电视相同的技术，但与之相比像素更少。将这些看起来很酷的显示模块与Arduino交互是非常有趣的，因为这会使我们的项目看起来很酷。我们在这里讨论了有关OLED显示器及其类型的完整文章。

我们使用的是单色7针SSD1306 0.96英寸OLED显示屏。选择此显示器的原因是它可以在三种不同的通信协议上工作，例如SPI 3线模式，SPI四线模式和IIC模式。本教程将介绍**如何在SPI 4线模式下使用该模块，**因为它是最快的通信模式，也是默认的通信模式。

引脚及其功能在下表中说明。

针号	引脚名称	其他名称	用法
1	Gnd	Gnd	模块的接地引脚
2	Vdd	Vcc，5V	电源引脚（可承受3-5V）
3	SCK	D0，SCL，CLK	充当时钟引脚。用于I2C和SPI
4	SDA	D1，MOSI	模块的数据引脚。用于IIC和SPI
5	RES	RST, rest	重置模块（在SPI期间有用）
6	DC	A0	数据命令引脚。用于SPI协议
7	CS	Chip Select	在SPI协议下使用多个模块时很有用

在本教程中，我们将仅以4线SPI模式操作该模块，其余的将留给其他教程。

Arduino社区已经为我们提供了许多库，可以直接使用它们来简化此过程。我试用了一些库，发现Adafruit_SSD1306库非常易于使用，并且具有少量图形选项，因此在本教程中将使用相同的库。但是，如果您的项目有内存/速度限制，请尝试使用U8g库，因为它的运行速度更快且占用的程序内存更少。

硬件和连接：

该电路图的SSD1306 OLED与Arduino的接口是非常简单的，如下所示

我们只是在OLED模块和Arduino之间建立了SPI通信。由于OLED以3V-5V供电，并且消耗的功率非常小，因此不需要外部电源。您可以简单地使用电线进行连接，也可以使用面包板，因为它很容易进行实验。下面的故事中也列出了连接

序号	OLED模块上的引脚名称	Arduino上的引脚名称
*1	Gnd	Gnd
2	Vdd，Vcc，5V	5V
3	SCK，D0，SCL，CLK	10
4	SDA，D1，MOSI	9
5	RES，RST，RESET	13
6	DC，A0	11
7	CS，片选	12

***注意：***仅通过通电，您将无法看到OLED模块上的任何背光/发光。您必须对其进行正确的编程才能注意到OLED显示屏上的任何变化。

编程用于Arduino的SSD1306 OLED显示器：

连接准备就绪后，您就可以开始对Arduino进行编程了。如前所述，我们将使用Adafruit库和GFX库来处理此OLED模块。请按照以下步骤测试您的OLED显示器。

**步骤1：**使用以下链接从Github下载Adafruit库和GFX库

1. Adafruit图书馆
2. GFX图形库

**步骤2：**您应该已经下载了两个Zip文件。现在按照以下步骤将它们添加到您的Arduino中

草图->包含库->添加压缩库，如下所示。然后选择我们刚刚下载的库。您一次只能选择一个库，因此您必须再次重复此步骤。

**步骤3：**通过选择File-> Examples-> Adafruit SSD1306-> SSD1306_128 * 64_SPI.ino，启动示例程序，如下图所示。

**步骤4：*在示例程序的第64行顶部，添加行“ #define SSD1306_LCDHEIGHT 64”*，如下图所示。

步骤5：现在上传程序，您应该会看到OLED屏幕显示默认Adafruit示例代码，如下图所示。在全工作的视频在最后给出。

该示例程序向您显示了可以在OLED屏幕上显示的所有可能的图形。此代码应足以创建位图，绘制线/圆/矩形，玩像素，以不同的字体和大小显示字符和字符串等。

如果您想更好地理解库及其功能，可以进一步阅读。该代码的每个垃圾都将在注释行的帮助下进行拆分和解释。完整的代码在本文末尾给出

显示和清除屏幕：

在OLED屏幕上书写就像在黑板上书写一样，我们必须先写入值，然后将其清除才能覆盖。以下命令用于写入和清除显示

display.display（）; //写入显示
display.clearDisplay（）; //清除显示

显示字符变量：

要在变量内显示内容，可以使用以下代码。

  char i = 5; //要显示的变量
  display.setTextSize（1）; //选择文字大小
  display.setTextColor（WHITE）; //对于单色显示，只有白色
  display.setCursor（0,0）; // 0,0是OLED屏幕的左上角
  display.write（i）; //写出要显示的变量

画一条线，圆，矩形，三角形：

如果要在显示器上添加一些符号，则可以使用以下代码绘制以下任何内容

display.drawLine（display.width（）-1，0，i，display.height（）-1，WHITE）;
// void drawLine（x0，y0，x1，y1，color）;

display.drawRect（i，i，display.width（）-2 * i，display.height（）-2 * i，WHITE）;
// void drawRect（x0，y0，w，h，color）;

display.drawTriangle（display.width（）/ 2，display.height（）/ 2-i，display.width（）/ 2-i，display.height（）/ 2 + i，display.width（）/ 2+ i，display.height（）/ 2 + i，WHITE）;
// void drawTriangle（x0，y0，x1，y1，x2，y2，color）;

display.drawCircle（display.width（）/ 2，display.height（）/ 2，i，WHITE）;
// void drawCircle（x0，y0，r，color）;

在屏幕上绘制一个字符串：

可以使用以下代码块在屏幕上的特定位置和大小显示任何消息

  display.setTextSize（2）; //设置文字大小
  display.setTextColor（WHITE）; //颜色设置
  display.setCursor（10,0）; //字符串将从10,0（x，y）开始
  display.clearDisplay（）; //清除屏幕上任何先前显示的内容
  display.println（“ Circuit Digest”）; //在此处打印字符串“ Circuit Digest”
  display.display（）; //将文字发送到屏幕

显示位图图像：

OLED模块可以完成的一项不可信赖的事情是，它可以用于显示位图。以下代码用于显示位图图像

static const unsigned char PROGMEM logo16_glcd_bmp[] =
{ B00000000, B11000000,
  B00000001, B11000000,
  B00000001, B11000000,
  B00000011, B11100000,
  B11110011, B11100000,
  B11111110, B11111000,
  B01111110, B11111111,
  B00110011, B10011111,
  B00011111, B11111100,
  B00001101, B01110000,
  B00011011, B10100000,
  B00111111, B11100000,
  B00111111, B11110000,
  B01111100, B11110000,
  B01110000, B01110000,
  B00000000, B00110000
};
display.drawBitmap(XPO], YPOS, bitmap, w, h, WHITE);
//void drawBitmap( x,  y,  *bitmap,  w,  h,  color);

如您所见，为了显示图像，位图数据必须以PROMGMEM指令的形式存储在程序存储器中。简而言之，我们必须指示OLED显示器，方法是如上所示，通过向其传递来自数组的序列或值来处理每个像素。该数组将包含图像的位图数据。

听起来可能很复杂，但是借助Web工具，将图像转换为位图值并将它们加载到上述数组中非常容易。

只需加载图像并调整设置即可获得所需的图像预览。然后单击“ Generate Code”（生成代码），复制代码并将其粘贴到您的阵列中。上传程序，您就完成了。我尝试显示蝙蝠侠徽标，结果就是这样。

这些库仍然可以做很多事情。要了解完整的可能性，请访问Adafruit GFX图形“原语”页面。

希望您能够运行并准备在某些项目中实现OLED显示屏。如果您有任何问题，请在评论部分中分享它们，我将尽力予以纠正。

code

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

  Pick one up today in the adafruit shop!
  ------> http://www.adafruit.com/category/63_98

  This example is for a 128x64 size display using SPI to communicate
  4 or 5 pins are required to interface

  Adafruit invests time and resources providing this open source code,
  please support Adafruit and open-source hardware by purchasing
  products from Adafruit!

  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
*********************************************************************/

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

// If using software SPI (the default case):
#define OLED_MOSI   9
#define OLED_CLK   10
#define OLED_DC    11
#define OLED_CS    12
#define OLED_RESET 13
Adafruit_SSD1306 display(OLED_MOSI, OLED_CLK, OLED_DC, OLED_RESET, OLED_CS);

/* Uncomment this block to use hardware SPI
  #define OLED_DC     6
  #define OLED_CS     7
  #define OLED_RESET  8
  Adafruit_SSD1306 display(OLED_DC, OLED_RESET, OLED_CS);
*/

#define NUMFLAKES 10
#define XPOS 0
#define YPOS 1
#define DELTAY 2

#define LOGO16_GLCD_HEIGHT 16
#define LOGO16_GLCD_WIDTH  16
static const unsigned char PROGMEM logo16_glcd_bmp[] =
{ B00000000, B11000000,
  B00000001, B11000000,
  B00000001, B11000000,
  B00000011, B11100000,
  B11110011, B11100000,
  B11111110, B11111000,
  B01111110, B11111111,
  B00110011, B10011111,
  B00011111, B11111100,
  B00001101, B01110000,
  B00011011, B10100000,
  B00111111, B11100000,
  B00111111, B11110000,
  B01111100, B11110000,
  B01110000, B01110000,
  B00000000, B00110000
};

#define SSD1306_LCDHEIGHT 64
#if (SSD1306_LCDHEIGHT != 64)
#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);
  // init done

  // Show image buffer on the display hardware.
  // Since the buffer is intialized with an Adafruit splashscreen
  // internally, this will display the splashscreen.
  display.display();
  delay(2000);

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

  // draw a single pixel
  display.drawPixel(10, 10, WHITE);
  // Show the display buffer on the hardware.
  // NOTE: You _must_ call display after making any drawing commands
  // to make them visible on the display hardware!
  display.display();
  delay(2000);
  display.clearDisplay();

  // draw many lines
  testdrawline();
  display.display();
  delay(2000);
  display.clearDisplay();

  // draw rectangles
  testdrawrect();
  display.display();
  delay(2000);
  display.clearDisplay();

  // draw multiple rectangles
  testfillrect();
  display.display();
  delay(2000);
  display.clearDisplay();

  // draw mulitple circles
  testdrawcircle();
  display.display();
  delay(2000);
  display.clearDisplay();

  // draw a white circle, 10 pixel radius
  display.fillCircle(display.width() / 2, display.height() / 2, 10, WHITE);
  display.display();
  delay(2000);
  display.clearDisplay();

  testdrawroundrect();
  delay(2000);
  display.clearDisplay();

  testfillroundrect();
  delay(2000);
  display.clearDisplay();

  testdrawtriangle();
  delay(2000);
  display.clearDisplay();

  testfilltriangle();
  delay(2000);
  display.clearDisplay();

  // draw the first ~12 characters in the font
  testdrawchar();
  display.display();
  delay(2000);
  display.clearDisplay();

  // draw scrolling text
  testscrolltext();
  delay(2000);
  display.clearDisplay();

  // text display tests
  display.setTextSize(1);
  display.setTextColor(WHITE);
  display.setCursor(0, 0);
  display.println("Hello, world!");
  display.setTextColor(BLACK, WHITE); // 'inverted' text
  display.println(3.141592);
  display.setTextSize(2);
  display.setTextColor(WHITE);
  display.print("0x"); display.println(0xDEADBEEF, HEX);
  display.display();
  delay(2000);
  display.clearDisplay();

  // miniature bitmap display
  display.drawBitmap(30, 16,  logo16_glcd_bmp, 16, 16, 1);
  display.display();

  // invert the display
  display.invertDisplay(true);
  delay(1000);
  display.invertDisplay(false);
  delay(1000);
  display.clearDisplay();

  // draw a bitmap icon and 'animate' movement
  testdrawbitmap(logo16_glcd_bmp, LOGO16_GLCD_HEIGHT, LOGO16_GLCD_WIDTH);
}

void loop() {
}

void testdrawbitmap(const uint8_t *bitmap, uint8_t w, uint8_t h) {
  uint8_t icons[NUMFLAKES][3];

  // initialize
  for (uint8_t f = 0; f < NUMFLAKES; f++) {
    icons[f][XPOS] = random(display.width());
    icons[f][YPOS] = 0;
    icons[f][DELTAY] = random(5) + 1;

    Serial.print("x: ");
    Serial.print(icons[f][XPOS], DEC);
    Serial.print(" y: ");
    Serial.print(icons[f][YPOS], DEC);
    Serial.print(" dy: ");
    Serial.println(icons[f][DELTAY], DEC);
  }

  while (1) {
    // draw each icon
    for (uint8_t f = 0; f < NUMFLAKES; f++) {
      display.drawBitmap(icons[f][XPOS], icons[f][YPOS], bitmap, w, h, WHITE);
    }
    display.display();
    delay(200);

    // then erase it + move it
    for (uint8_t f = 0; f < NUMFLAKES; f++) {
      display.drawBitmap(icons[f][XPOS], icons[f][YPOS], bitmap, w, h, BLACK);
      // move it
      icons[f][YPOS] += icons[f][DELTAY];
      // if its gone, reinit
      if (icons[f][YPOS] > display.height()) {
        icons[f][XPOS] = random(display.width());
        icons[f][YPOS] = 0;
        icons[f][DELTAY] = random(5) + 1;
      }
    }
  }
}

void testdrawchar(void) {
  display.setTextSize(1);
  display.setTextColor(WHITE);
  display.setCursor(0, 0);

  for (uint8_t i = 0; i < 168; i++) {
    if (i == '\n') continue;
    display.write(i);
    if ((i > 0) && (i % 21 == 0))
      display.println();
  }
  display.display();
}

void testdrawcircle(void) {
  for (int16_t i = 0; i < display.height(); i += 2) {
    display.drawCircle(display.width() / 2, display.height() / 2, i, WHITE);
    display.display();
  }
}

void testfillrect(void) {
  uint8_t color = 1;
  for (int16_t i = 0; i < display.height() / 2; i += 3) {
    // alternate colors
    display.fillRect(i, i, display.width() - i * 2, display.height() - i * 2, color % 2);
    display.display();
    color++;
  }
}

void testdrawtriangle(void) {
  for (int16_t i = 0; i < min(display.width(), display.height()) / 2; i += 5) {
    display.drawTriangle(display.width() / 2, display.height() / 2 - i,
                         display.width() / 2 - i, display.height() / 2 + i,
                         display.width() / 2 + i, display.height() / 2 + i, WHITE);
    display.display();
  }
}

void testfilltriangle(void) {
  uint8_t color = WHITE;
  for (int16_t i = min(display.width(), display.height()) / 2; i > 0; i -= 5) {
    display.fillTriangle(display.width() / 2, display.height() / 2 - i,
                         display.width() / 2 - i, display.height() / 2 + i,
                         display.width() / 2 + i, display.height() / 2 + i, WHITE);
    if (color == WHITE) color = BLACK;
    else color = WHITE;
    display.display();
  }
}

void testdrawroundrect(void) {
  for (int16_t i = 0; i < display.height() / 2 - 2; i += 2) {
    display.drawRoundRect(i, i, display.width() - 2 * i, display.height() - 2 * i, display.height() / 4, WHITE);
    display.display();
  }
}

void testfillroundrect(void) {
  uint8_t color = WHITE;
  for (int16_t i = 0; i < display.height() / 2 - 2; i += 2) {
    display.fillRoundRect(i, i, display.width() - 2 * i, display.height() - 2 * i, display.height() / 4, color);
    if (color == WHITE) color = BLACK;
    else color = WHITE;
    display.display();
  }
}

void testdrawrect(void) {
  for (int16_t i = 0; i < display.height() / 2; i += 2) {
    display.drawRect(i, i, display.width() - 2 * i, display.height() - 2 * i, WHITE);
    display.display();
  }
}

void testdrawline() {
  for (int16_t i = 0; i < display.width(); i += 4) {
    display.drawLine(0, 0, i, display.height() - 1, WHITE);
    display.display();
  }
  for (int16_t i = 0; i < display.height(); i += 4) {
    display.drawLine(0, 0, display.width() - 1, i, WHITE);
    display.display();
  }
  delay(250);

  display.clearDisplay();
  for (int16_t i = 0; i < display.width(); i += 4) {
    display.drawLine(0, display.height() - 1, i, 0, WHITE);
    display.display();
  }
  for (int16_t i = display.height() - 1; i >= 0; i -= 4) {
    display.drawLine(0, display.height() - 1, display.width() - 1, i, WHITE);
    display.display();
  }
  delay(250);

  display.clearDisplay();
  for (int16_t i = display.width() - 1; i >= 0; i -= 4) {
    display.drawLine(display.width() - 1, display.height() - 1, i, 0, WHITE);
    display.display();
  }
  for (int16_t i = display.height() - 1; i >= 0; i -= 4) {
    display.drawLine(display.width() - 1, display.height() - 1, 0, i, WHITE);
    display.display();
  }
  delay(250);

  display.clearDisplay();
  for (int16_t i = 0; i < display.height(); i += 4) {
    display.drawLine(display.width() - 1, 0, 0, i, WHITE);
    display.display();
  }
  for (int16_t i = 0; i < display.width(); i += 4) {
    display.drawLine(display.width() - 1, 0, i, display.height() - 1, WHITE);
    display.display();
  }
  delay(250);
}

void testscrolltext(void) {
  display.setTextSize(2);
  display.setTextColor(WHITE);
  display.setCursor(10, 0);
  display.clearDisplay();
  display.println("scroll");
  display.display();

  display.startscrollright(0x00, 0x0F);
  delay(2000);
  display.stopscroll();
  delay(1000);
  display.startscrollleft(0x00, 0x0F);
  delay(2000);
  display.stopscroll();
  delay(1000);
  display.startscrolldiagright(0x00, 0x07);
  delay(2000);
  display.startscrolldiagleft(0x00, 0x07);
  delay(2000);
  display.stopscroll();
}