使用Arduino开发ESP32：（详解）IIC接口控制SH1106、SSD1306或SSD1315驱动的OLED显示屏

润泽玺

已于 2025-03-05 13:15:45 修改

阅读量1.1k

点赞数 12

CC 4.0 BY-SA版权

分类专栏： ESP32 文章标签： ESP32 Arduino 单片机 mcu 物联网

于 2025-03-02 21:38:11 首次发布

本文链接：https://blog.youkuaiyun.com/m0_55383178/article/details/145969830

ESP32 专栏收录该内容

4 篇文章

订阅专栏

本文将详细介绍使用ESP8266_and_ESP32_OLED_driver_for_SSD1306_displays库文件，控制SH1106、SSD1306、SSD1315驱动的OLED显示屏，实现显示文字、图片、绘图等功能。

ESP32_C3驱动报错请参考本人另外一篇文章：使用Arduino开发ESP32：（报错及解决）IIC接口控制SH1106、SSD1306或SSD1315驱动的OLED显示屏

基本函数介绍

display.init();//显示初始化
display.flipScreenVertically();//垂直翻转屏幕
display.display();//显示

//普通文本显示
display.setFont(ArialMT_Plain_10);//设置字体高度为10个像素,也可以设置为16、24
display.drawString(0, 0, "Hello world");//坐标以及打印的文字

//显示长文本并自动换行
display.setFont(ArialMT_Plain_10);//同上，设置字体大小
display.setTextAlignment(TEXT_ALIGN_LEFT);//设置对齐方式，可以为TEXT_ALIGN_LEFT左对齐，TEXT_ALIGN_RIGHT右对齐，TEXT_ALIGN_CENTER居中，TEXT_ALIGN_CENTER_BOTH（这个不确定）
display.drawStringMaxWidth(0, 0, 128,"Lorem ipsum\n dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore." );//前两个参数为x/y坐标，注意左对齐时是左上角坐标，右对齐时右上角坐标，第三个参数是最大宽度，最后是要显示的文本。
//display.setTextAlignment函数同样可以用于display.drawString的显示。

//绘图
display.setPixel(5, 5);在给定位置绘制一个像素，参数为坐标
display.drawRect(12, 12, 20, 20);//画一个矩形，参数为坐标、宽度、高度
display.fillRect(14, 14, 17, 17);//填充矩形，，参数为坐标、宽度、高度
display.drawHorizontalLine(0, 40, 20);//画一条水平线，参数为坐标、长度
display.drawVerticalLine(40, 0, 20);//画一条垂直线，参数为坐标、长度
display.drawCircle(32, 32, 3);//画一个圆，参数为坐标、半径
display.fillCircle(96, 32, 32 - i * 3);//填充一个圆，参数为坐标、半径
display.setColor(BLACK);//设置颜色，可以为WHITE、BLACK

//显示进度条
display.drawProgressBar(0, 32, 120, 10, progress);参数为坐标、宽度、高度、进度
//可以结合上述文本显示，打印相关进度的文字说明

//图片显示
display.drawXbm(34, 14, 64, 32, WiFi_Logo_bits);//参数为坐标xy，宽度，高度，图片数据。
//图片数据示例
const uint8_t WiFi_Logo_bits[] PROGMEM = {
  0x00, 0x00, 0xF8,0xFF, 0x07, 0x00, 0x00, 0x00,...//后面省略
};