11 OLED 屏幕-Adafruit_SSD1306 库

已于 2024-01-09 00:55:14 修改
阅读量3.6k 收藏 49
点赞数 22
分类专栏： ESP32专栏 文章标签： vscode ide esp32 单片机
于 2024-01-07 21:27:25 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/WangPaiFeiXingYuan/article/details/135444742
版权
本文详细介绍了如何使用ESP32控制128x64OLEDSSD1306屏幕，包括电路连接、库的安装、基本操作函数如显示像素、绘制图形和进度条的实现。通过示例代码展示了如何在ArduinoIDE和VSCode中使用PlatformIO进行开发。

摘要生成于 C知道 ，由 DeepSeek-R1 满血版支持， 前往体验 >

文章作者：里海
来源网站：ESP32专栏

简介

    这是 0.96 寸的 SSD1306 芯片驱动的 OLED 屏幕。他的分辨率是 128*64，横有 128 个像素点，纵向有 64 个。
OLED 显示屏模块接口定义：

  1. GND：接地引脚
  2. VCC：电源正（3.3～5V）。
  3. D0：OLED 的 D0 脚，在 SPI 通信中为时钟管脚。
  4. D1：OLED 的 D1 脚，在 SPI 通信中为数据管脚。
  5. RES：OLED 的 RES 脚，用来复位（低电平复位）。
  6. DC：数据和命令控制管脚。
  7. CS：片选管脚。

在这里插入图片描述

电路

在这里插入图片描述

使用 Adafruit_SSD1306 库

下载支持库

先下载这两个第三方库，PlatformIO 已经为我们提供了方便的下载途径，我们可以直接在 PlatformIO 的 PIO HOME 页面中选择 Libraries 中分别搜索 Adafruit GFX Library 与 Adafruit_SSD1306，然后添加到项目中
在这里插入图片描述
在这里插入图片描述
在这里插入图片描述
platformio.ini文件中出现了添加的这两个库

[env:esp32dev]
platform = espressif32
board = esp32dev
framework = arduino
lib_deps = 
	adafruit/Adafruit GFX Library@^1.11.9
	adafruit/Adafruit SSD1306@^2.5.9

屏幕矩阵

在这里插入图片描述

使用 Adafruit_SSD1306 库的三个步骤

  1. 初始化 OLED，调用构造函数，调用 begin 方法；
  2. 初始化成功后，调用绘制类函数，当然可以设置颜色、字体等绘制完毕；
  3. 调用显示类函数 display。

Adafruit_SSD1306 库中的常用函数

  1. clearDisplay：清除显示，该方法仅清除 Arduino 缓存，不会立即显示在屏幕上，可以通过调用 display 来立即清除；
  2. display：显示内容，这个方法才是真正把绘制内容画在 OLED 屏幕上（非常重要）；
  3. drawCircle：绘制空心圆；
  4. fillCircle：绘制实心圆；
  5. drawTriangle：绘制空心三角形；
  6. fillTriangle：绘制实心三角形；
  7. drawRoundRect：绘制空心圆角方形；
  8. fillRoundRect：绘制实心圆角方形；
  9. drawBitmap：绘制 Bitmap 图形；
  10. drawXBitmap：绘制 XBitmap 图形；
  11. drawChar：绘制单个字符；
  12. getTextBounds：计算字符串在当前字体大小下的像素大小，返回左上角坐标以及宽度高度像素值；
  13. setTextSize：设置字体大小；
  14. setFont：设置字体；
  15. setCursor：设置光标位置；
  16. setTextColor：设置字体颜色；
  17. setTextWrap：设置是否自动换行；
  18. drawPixel：绘制像素点；
  19. drawFastHLine：绘制水平线；
  20. drawFastVLine：绘制垂直线；
  21. startscrollright：滚动到右边；
  22. startscrollleft：滚动到左边；
  23. startscrolldiagright：沿着对角线滚动到右边；
  24. startscrolldiagleft：沿着对角线滚动到左边；
  25. stopscroll：停止滚动：

著作权归极客侠 GeeksMan所有
基于GPL 3.0协议
原文链接：https://docs.geeksman.com/esp32/Arduino/14.esp32-arduino-spi.html

点亮像素点

在这里插入图片描述

#include <SPI.h>
#include <Adafruit_GFX.h>
#include <Adafruit_SSD1306.h>
#define SCREEN_WIDTH 128 // OLED 显示屏宽度
#define SCREEN_HEIGHT 64 // OLED 显示屏高度

// 软件SPI总线
#define OLED_MOSI 13
#define OLED_CLK 18
#define OLED_DC 2
#define OLED_CS 4
#define OLED_RESET 15
Adafruit_SSD1306 oled(SCREEN_WIDTH, SCREEN_HEIGHT,
                      OLED_MOSI, OLED_CLK, OLED_DC, OLED_RESET, OLED_CS);

void setup()
{
  oled.begin();
  oled.clearDisplay();                          
  oled.drawPixel(10,10,SSD1306_WHITE);
  oled.display();                               
}

void loop()
{
}

点亮所有像素

在这里插入图片描述
在这里插入图片描述

#include <Arduino.h>

#include <SPI.h>
#include <Adafruit_GFX.h>
#include <Adafruit_SSD1306.h>
#define SCREEN_WIDTH 128 // OLED 显示屏宽度
#define SCREEN_HEIGHT 64 // OLED 显示屏高度

// 软件SPI总线
#define OLED_MOSI 13
#define OLED_CLK 18
#define OLED_DC 2
#define OLED_CS 4
#define OLED_RESET 15
Adafruit_SSD1306 oled(SCREEN_WIDTH, SCREEN_HEIGHT,
                      OLED_MOSI, OLED_CLK, OLED_DC, OLED_RESET, OLED_CS);

void setup()
{
  oled.begin();
  oled.clearDisplay();
  for (int y = 0; y < 64; y++)
    oled.drawFastHLine(0, y, 128, SSD1306_INVERSE);
  oled.display();
}

void loop()
{
}

显示水平边界线

在这里插入图片描述

#include <Arduino.h>

#include <SPI.h>
#include <Adafruit_GFX.h>
#include <Adafruit_SSD1306.h>
#define SCREEN_WIDTH 128 // OLED 显示屏宽度
#define SCREEN_HEIGHT 64 // OLED 显示屏高度

// 软件SPI总线
#define OLED_MOSI 13
#define OLED_CLK 18
#define OLED_DC 2
#define OLED_CS 4
#define OLED_RESET 15
Adafruit_SSD1306 oled(SCREEN_WIDTH, SCREEN_HEIGHT,
                      OLED_MOSI, OLED_CLK, OLED_DC, OLED_RESET, OLED_CS);

void setup()
{
  oled.begin();
  oled.clearDisplay();
  oled.drawFastHLine(0, 0, 128, SSD1306_INVERSE);
  oled.drawFastHLine(0, 15, 128, SSD1306_INVERSE);
  oled.drawFastHLine(0, 16, 128, SSD1306_INVERSE);
  oled.drawFastHLine(0, 63, 128, SSD1306_INVERSE);
  oled.display();   
}

void loop()
{
}

显示边界线

在这里插入图片描述

#include <Arduino.h>

#include <SPI.h>
#include <Adafruit_GFX.h>
#include <Adafruit_SSD1306.h>
#define SCREEN_WIDTH 128 // OLED 显示屏宽度
#define SCREEN_HEIGHT 64 // OLED 显示屏高度

// 软件SPI总线
#define OLED_MOSI 13
#define OLED_CLK 18
#define OLED_DC 2
#define OLED_CS 4
#define OLED_RESET 15
Adafruit_SSD1306 oled(SCREEN_WIDTH, SCREEN_HEIGHT,
                      OLED_MOSI, OLED_CLK, OLED_DC, OLED_RESET, OLED_CS);

void setup()
{
  oled.begin();
  oled.clearDisplay();
  
  oled.drawFastHLine(0, 0, 128, SSD1306_INVERSE);
  oled.drawFastHLine(0, 15, 128, SSD1306_INVERSE);
  oled.drawFastHLine(0, 16, 128, SSD1306_INVERSE);
  oled.drawFastHLine(0, 63, 128, SSD1306_INVERSE);

  oled.drawLine(0, 0, 0, 63, SSD1306_WHITE); 
  oled.drawLine(127, 0, 127, 63, SSD1306_WHITE); 

  oled.display();
}

void loop()
{
}

绘制虚线

在这里插入图片描述

void setup()
{
  oled.begin();
  oled.clearDisplay();
  oled.drawFastHLine(0, 0, 128, SSD1306_WHITE);
  for(int i=0;i<128;i=i+10)
     oled.drawFastHLine(i, 0, 5, SSD1306_BLACK);
  oled.display();
}

绘制矩形

在这里插入图片描述

void setup()
{
  oled.begin();
  oled.clearDisplay();

  // 绘制矩形
  oled.drawRect(5, 5, 10, 25, SSD1306_WHITE);
  // 绘制实心矩形
  oled.fillRect(75, 5, 10, 30, SSD1306_WHITE);

  oled.display();
}

显示字符串

在这里插入图片描述

void setup()
{
  oled.begin();
  oled.clearDisplay();                          
  
  oled.setCursor(5, 50); 
  oled.setTextSize(1.5); 
  oled.setTextColor(WHITE);
  oled.println("HelloWorld"); 

  oled.display();                               
}

在这里插入图片描述

void setup()
{
  oled.begin();
  oled.clearDisplay();                          
  
  oled.setCursor(1, 50);  
  oled.setTextSize(2);  
  oled.setTextColor(WHITE);
  oled.println("里海"); 

  oled.display();                               
}

显示进度条

在这里插入图片描述

#include <SPI.h>
#include <Adafruit_GFX.h>
#include <Adafruit_SSD1306.h>
#define SCREEN_WIDTH 128 // OLED 显示屏宽度
#define SCREEN_HEIGHT 64 // OLED 显示屏高度

// 软件SPI总线
#define OLED_MOSI 13
#define OLED_CLK 18
#define OLED_DC 2
#define OLED_CS 4
#define OLED_RESET 15
Adafruit_SSD1306 oled(SCREEN_WIDTH, SCREEN_HEIGHT,
                      OLED_MOSI, OLED_CLK, OLED_DC, OLED_RESET, OLED_CS);

// 初始化进度条变量
int progress = 0;

void setup()
{
  oled.begin();
  oled.setTextSize(2);              // 设置字体大小
  oled.setTextColor(SSD1306_WHITE); // 设置文本颜色
  oled.display();                   // 显示内容
}

void loop()
{
  // 清空屏幕
  oled.clearDisplay();

  // 设置光标位置
  oled.setCursor(25, 50);
  // 显示文字
  oled.println("Process");

  // 显示进度条边框
  oled.drawRoundRect(0, 20, 128, 20, 5, SSD1306_WHITE);
  // 显示进度
  oled.fillRoundRect(5, 25, progress, 10, 2, SSD1306_WHITE);

  // 进度递增
  if (progress < 118)
  {
    progress++;
  }
  else
  {
    progress = 0;
  }

  // 刷新屏幕
  oled.display();

  delay(60); // 延迟一段时间后更新显示
}

显示彩蛋

在这里插入图片描述

#include <SPI.h>
#include <Adafruit_GFX.h>
#include <Adafruit_SSD1306.h>
#define SCREEN_WIDTH 128 // OLED 显示屏宽度
#define SCREEN_HEIGHT 64 // OLED 显示屏高度

// 软件SPI总线
#define OLED_MOSI 13
#define OLED_CLK 18
#define OLED_DC 2
#define OLED_CS 4
#define OLED_RESET 15
Adafruit_SSD1306 oled(SCREEN_WIDTH, SCREEN_HEIGHT,
                      OLED_MOSI, OLED_CLK, OLED_DC, OLED_RESET, OLED_CS);

int progress = 0;

void setup()
{
  oled.begin();
 
  oled.display(); 
}

void loop()
{

}

在这里插入图片描述

什么是ESP32？

ESP32是近几年最受欢迎和最实用的模块之一。除了Wi-Fi模块，该模块还包含蓝牙4.0模块。双核CPU工作频率为80至240 MHz，包含两个Wi-Fi和蓝牙模块以及各种输入和输出引脚， ESP32是物联网项目的理想选择。
在这里插入图片描述

ESP32模块引脚分布

在这里插入图片描述
虽然ESP32的引脚数比常用的处理器少，但在引脚上复用多个功能时不会遇到任何问题。
警告：ESP32引脚的电压电平为3.3伏。如果要将ESP32连接到其他工作电压为5伏的设备，则应使用电平转换器转换电压电平。

  • 电源引脚：该模块有两个电源引脚 5V和3.3V。您可以使用这两个引脚来向其他设备和模块供电。
  • GND引脚：该模块的接地有3个引脚。
  • 启用引脚（EN）：该引脚用于启用和禁用模块。引脚为高电平时启用模块，低电平禁用模块。
  • 输入/输出引脚（GPIO）：您可以使用32个GPIO引脚与LED、开关和其他输入/输出设备进行通信。
    您可以在内部上拉或下拉这些引脚。
    注意：GPIO6至GPIO11引脚（SCK/CLK，SDO/SD0，SDI/SD1，SHD/SD2，SWP/SD3和SCS/CMD引脚）用于模块内部闪存的SPI通信，我们不建议使用它们。
  • ADC：您可以使用此模块上的16个ADC引脚将模拟电压（某些传感器的输出）转换为数字电压。其中一些转换器连接到内部放大器，能够以高精度测量小电压。
  • DAC：ESP32模块有两个数模转换器，精度为8位。
  • 触摸焊盘：ESP32模块上有10个引脚，对电容变化很敏感。您可以将这些引脚连接到某些焊盘（PCB上的焊盘），并将它们用作触摸开关。
  • SPI：该模块上有两个SPI接口，可用于连接显示屏、SD / microSD存储卡模块、外部闪存等。
  • I2C：SDA和SCL引脚用于I2C通信。
  • 串行通信（UART）：该模块上有两个UART串行接口。使用这些引脚，您可以在两个设备之间传输高达5Mbps的信息。 UART0还具有CTS和RTS控制。
  • PWM：几乎所有ESP32输入/输出引脚都可用于PWM（脉冲宽度调制）。使用这些引脚可以控制电机、LED灯的亮度和RGB灯的颜色等。

ESP32模块模式

ESP32芯片有5种模式：

  • 活动模式：在这种模式下，Wi-Fi和蓝牙发射器和接收器的所有部分都是活动的。在这种情况下，电流消耗在80和260mA之间。
  • 调制解调器睡眠模式：处理器仍处于活动状态，但Wi-Fi和蓝牙已禁用。在这种情况下，电流消耗在3到20mA之间。
  • 轻度睡眠模式：主处理器停止工作，但RTC单元和ULP处理器单元仍处于活动状态。电流消耗约为0.8 mA。
  • 深度睡眠模式：只有RTC单元处于活动状态。在这种情况下，Wi-Fi和蓝牙通信的数据存储在RTC的存储器中。在此模式下，电流消耗在10到150μA之间。
  • 休眠模式：除了用于时钟的RTC定时器和连接到RTC的一些I / O引脚外，所有单元均被禁用。 RTC定时器或连接的引脚可以将芯片从此状态唤醒。在这种情况下，电流消耗约为2.5μA。
    有关更多信息，请查看模块数据表。

在Arduino IDE上开发ESP32

《在Arduino IDE上开发ESP32》

在VSCode中使用PlatformIO开发ESP32

《在VSCode中使用PlatformIO开发ESP32》

ESP32技术专栏

ESP32专栏

基于STM32L4XX、HAL库的SSD1306 TFT液晶驱动IC驱动程序设计
zhusl6688的博客
03-05 260
SSD1306 是一款常见的 OLED 显示控制器，支持 128x64 或 128x32 分辨率的单色显示。SSD1306 通常通过 I2C 或 SPI 接口与 MCU 通信。// 移动到下一个字符位置。// 简单的字符绘制函数，假设使用 6x8 字体。// 初始化 SSD1306。// I2C1 初始化代码。// 清屏并显示字符串。// 初始化 I2C。
Adafruit_SSD1306数据库
11-06
arduino数据库中的的Adafruit_SSD1306数据库，供大家下载学习
Adafruit_SSD1306库学习
qq_41477556的博客
01-07 2万+
1.前言 在这里了解一下Adafruit_SSD1306和Adafruit_GFX这两个库 Adafruti_SSD1306是SSD1306 OLED屏幕的专用显示库 Adafruit_GFX库是LCD和OLED屏幕的通用父类，这是一个父类的图形库 Adafruit_GFX要与屏幕的专用显示库一同使用，子类库依赖父类库 例如： SSD1306 OLED显示器：Adafruit_GFX和Adafruit_SSD1306 ST7735 1.8英寸彩色LCD显示器：Adafruit_GFX，Adafru
Adafruit_SSD1306-master_SSD1306库文件_库文件_
09-28
oled库文件，驱动库文件，简单易懂，2.点击编译程序，如库已安装正确将不会提示编译错误，如下图所示：
Adafruit_SSD1306
12-15
Arduino所用的0.96寸SSD1306 OLED类库，可通屏幕选择适用头文件
SSD 1306显示屏 adafruit SSD 1306
weixin_51397215的博客
11-21 3204
SSD 1306 OLED显示图片和汉字
SSD1306库文件
07-18
找了很久才找到的，arduino库文件SSD1306特地来分享给大家
Adafruit_SSD1306-master.zip
01-04
Adafruit_SSD1306
Adafruit_SSD1306_arduino_adafruit-ssd1306_
10-01
**Adafruit_SSD1306_arduino_adafruit-ssd1306_** 在Arduino编程领域，Adafruit_SSD1306库是一个关键的资源，它专为控制SSD1306 OLED显示屏设计。SSD1306是一款广泛使用的I2C或SPI接口的单色有机发光二极管（OLED）...
Adafruit_SSD1306-1.6.1-py2-none-any.whl.zip
04-29
这个库是Adafruit为SSD1306 OLED显示器编写的驱动程序，版本号为1.6.1，适用于Python 2环境。`whl`是Python的 Wheel 格式，它是预编译的Python二进制包，用于简化安装过程，避免了编译源代码的步骤。 SSD1306是一种...
Adafruit_Python_SSD1306_SSD1306_zip_
10-04
disp = Adafruit_SSD1306.SSD1306_128_64(rst=None) # 设置显示参数 disp.begin() # 绘制和显示文本 disp.clear() disp.display() disp.text('Hello, World!', 0, 0, 1) disp.display() ``` **应用场景** ...
Adafruit_ssd1306syp.zip
11-24
IIC总线的OLED ,ardunio第三方库
SSD1306Ascii, SSD1306 OLED显示器的纯文本库.zip
09-18
SSD1306Ascii, SSD1306 OLED显示器的纯文本库 SSD1306Ascii是只用于小型OLED显示器的无缓冲字符库，如 Adafruit 1.3"和 0.96"单色显示器。在ebay上可以以使用SSD1306控制器的很多低成本炽波器显示器。SSD1306Ascii运行在that板上，
Adafruit_SSD1306:适用于SSD1306单色128x64和128x32 OLED的Arduino库
04-30
Adafruit_SSD1306 这是我们基于SSD1306驱动程序的单色OLED的库 今天在adafruit商店取一个！ ------> 这些显示器使用I2C或SPI进行通信，需要2至5个引脚进行接口。 Adafruit投入时间和资源来提供此开源代码，请通过从Adafruit购买产品来支持Adafruit和开源硬件！ 由Limor Fried / Ladyada为Adafruit Industries撰写，并来自开源社区。 滚动代码由Michael Gregg提供。 动态缓冲区分配基于Andrew Canaday的工作。 BSD许可证，请查看license.txt以获取更多信息。 上面的所有文本都必须包含在任何重新分发中 首选的安装方法是使用Arduino IDE库管理器。 要改为从Github下载源，请单击上方的“克隆或下载”，然后单击“下载ZIP”。 解压缩后，重命名生成的
stm32HAL库驱动SSD1306oled的库文件.zip
04-22
stm32HAL库驱动SSD1306oled的库文件 包含驱动测试例程 通过宏定义可选SPI和I2C和DMA 个人写的代码 移植需要一定的基础
深入学习 OLED Adafruit_SSD1306库（8266+arduino）
热门推荐
单片机菜鸟哥的博客
12-09 2万+
SSD1306屏幕驱动库，最出名应该就是u8g2，读者可以参考 [ 玩转u8g2 OLED库，一篇就够](https://blog.csdn.net/dpjcn1990/article/details/92831760)。 但是u8g2有个弊端就是：一个超级庞大的第三方库，性能并不是非常好（但是基本上支持了市面上绝大部分的LED屏）。
探索Adafruit_Python_SSD1306：图形界面显示库的奥秘
gitblog_00072的博客
04-16 622
探索Adafruit_Python_SSD1306：图形界面显示库的奥秘 Adafruit_Python_SSD1306Python library to use SSD1306-based 128x64 or 128x32 pixel OLED displays with a Raspberry Pi or Beaglebone Black.项目地址:https://gitcode.com/g...
Arduino学习笔记：Adafruit_SSD1306——OLED学习
weixin_45783574的博客
04-19 7406
Arduino学习笔记：Adafruit_SSD1306——OLED学习 Adafruit_SSD1306——OLED实体图： 由图可见：OLED一共有4个引脚，从左到右以此是GND、VCC、SCL、SDA，分别代表接地引脚、接电源引脚、SCL引脚用于获取I2C的时钟信号、SDA引脚用于传输数据。 利用ESP8266控制OLED显示器的接线图： OLED显示原理： OLED其实就是一个MxN的像素点阵，需要显示什么就得把具体坐标位置对应的像素点点亮。 支持OLED显示的主要函数库： #includ
Adafruit_Python_SSD1306 教程
最新发布
gitblog_00240的博客
08-08 1191
Adafruit_Python_SSD1306 教程 项目地址:https://gitcode.com/gh_mirrors/ad/Adafruit_Python_SSD1306 1. 项目介绍 Adafruit_Python_SSD1306 是一个Python库，专门用于在树莓派或Beaglebone Black上操作基于SSD1306驱动的128x64或128x32像素OLED显示器。这个库由...
ssd1306库函数大全
05-03
SSD1306是一种常用的OLED显示屏控制芯片，有很多库函数可以用来控制和操作SSD1306显示屏。以下是一些常见的SSD1306库函数： 1. `begin()`：初始化SSD1306显示屏。 2. `display()`：将缓冲区中的图像数据刷新到显示屏上。 3. `clearDisplay()`：清除显示屏上的所有像素点。 4. `setTextSize(size)`：设置文本的大小，可以是1、2、3等。 5. `setTextColor(color)`：设置文本的颜色，可以是白色、黑色等。 6. `setCursor(x, y)`：设置文本光标的位置。 7. `print(text)`：在当前光标位置打印文本。 8. `drawPixel(x, y, color)`：在指定位置绘制一个像素点。 9. `drawLine(x0, y0, x1, y1, color)`：绘制一条直线。 10. `drawRect(x, y, width, height, color)`：绘制一个矩形。 11. `fillRect(x, y, width, height, color)`：填充一个矩形。 12. `drawCircle(x, y, radius, color)`：绘制一个圆形。 13. `fillCircle(x, y, radius, color)`：填充一个圆形。 14. `drawBitmap(x, y, bitmap, width, height, color)`：绘制一个位图。 这些只是SSD1306库函数的一部分，具体的库函数还取决于你使用的具体库。你可以查阅相关的文档或者参考示例代码来了解更多的库函数和用法。
评论 2
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

王牌飞行员_里海

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值