ESP32 使用ESP-IDF驱动SPI接口OLED12864源码分享

一、源码分享
二、oled12864介绍
- 1、核心特性与优势
- 2、接口与控制
- [3、显示内存 (GDDRAM) 组织](#3、显示内存 (GDDRAM) 组织)
- 4、常见应用场景
- 5、使用注意事项
三、ESP-IDF详解
- [1、ESP32 概述](#1、ESP32 概述)
- [2、 ESP-IDF 详解](#2、 ESP-IDF 详解)
- - [2.1 、ESP-IDF 的核心组件与架构](#2.1 、ESP-IDF 的核心组件与架构)
  - [2.2 、ESP-IDF 开发环境与工具链](#2.2 、ESP-IDF 开发环境与工具链)
  - [2.3 、ESP-IDF 开发流程简述](#2.3 、ESP-IDF 开发流程简述)
  - [2.4、示例代码结构 (最简单的 Hello World)](#2.4、示例代码结构 (最简单的 Hello World))
  - [2.5、优势与特点](#2.5、优势与特点)
  - [2.6 、适用场景](#2.6 、适用场景)
- 3、总结

一、源码分享

1、效果展示

2、开发环境搭建

参考我这篇博文：VS Code 在线安装ESP-IDF，ESP32开发环境搭建详细教程

3、源码分享

3.1、oled12864.h

c 复制代码

#ifndef _OLED12864_H_
#define _OLED12864_H_

#include <stdint.h> 
#include <string.h> 
#include <math.h> 
#include "freertos/FreeRTOS.h" 
#include "freertos/task.h" 
#include "esp_log.h" 
#include "driver/rmt_tx.h"
#include "driver/spi_master.h"



// OLED引脚定义
#define OLED_MOSI   23
#define OLED_SCLK   18
#define OLED_CS     27
#define OLED_DC     16
#define OLED_RST    17


#define OLED_CMD  0	//写命令
#define OLED_DATA 1	//写数据


// OLED屏幕参数
#define OLED_WIDTH  128
#define OLED_HEIGHT 64

// SSD1306命令定义
#define SSD1306_SETCONTRAST 0x81
#define SSD1306_DISPLAYALLON_RESUME 0xA4
#define SSD1306_DISPLAYALLON 0xA5
#define SSD1306_NORMALDISPLAY 0xA6
#define SSD1306_INVERTDISPLAY 0xA7
#define SSD1306_DISPLAYOFF 0xAE
#define SSD1306_DISPLAYON 0xAF
#define SSD1306_SETDISPLAYOFFSET 0xD3
#define SSD1306_SETCOMPINS 0xDA
#define SSD1306_SETVCOMDETECT 0xDB
#define SSD1306_SETDISPLAYCLOCKDIV 0xD5
#define SSD1306_SETPRECHARGE 0xD9
#define SSD1306_SETMULTIPLEX 0xA8
#define SSD1306_SETLOWCOLUMN 0x00
#define SSD1306_SETHIGHCOLUMN 0x10
#define SSD1306_SETSTARTLINE 0x40
#define SSD1306_MEMORYMODE 0x20
#define SSD1306_COLUMNADDR 0x21
#define SSD1306_PAGEADDR   0x22
#define SSD1306_COMSCANINC 0xC0
#define SSD1306_COMSCANDEC 0xC8
#define SSD1306_SEGREMAP 0xA0
#define SSD1306_CHARGEPUMP 0x8D

void oled_init(void);
void oled_clear(void); 
void oled_refresh_gram(void);
void oled_show_char(uint8_t x,uint8_t y,uint8_t chr,uint8_t size,uint8_t mode);
void oled_show_num(uint8_t x,uint8_t y,uint32_t num,uint8_t len,uint8_t size);
void oled_show_string(uint8_t x,uint8_t y,const uint8_t *p,uint8_t size);
void oled_clear_buf(void);
void oled_draw_circle(uint8_t x0,uint8_t y0,uint8_t r);
void oled_display_on(void);
void oled_display_off(void);



#endif /* _HDW_WS2812_H_ */

3.2、oled12864.c

c 复制代码

#include "oled12864.h"
#include "driver/gpio.h"

const char *TAG = "OLED12864";

const static unsigned char asc2_1206[95][12]={
{0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00},/*" ",0*/
{0x00,0x00,0x00,0x00,0x3F,0x40,0x00,0x00,0x00,0x00,0x00,0x00},/*"!",1*/
{0x00,0x00,0x30,0x00,0x40,0x00,0x30,0x00,0x40,0x00,0x00,0x00},/*""",2*/
{0x09,0x00,0x0B,0xC0,0x3D,0x00,0x0B,0xC0,0x3D,0x00,0x09,0x00},/*"#",3*/
{0x18,0xC0,0x24,0x40,0x7F,0xE0,0x22,0x40,0x31,0x80,0x00,0x00},/*"$",4*/
{0x18,0x00,0x24,0xC0,0x1B,0x00,0x0D,0x80,0x32,0x40,0x01,0x80},/*"%",5*/
{0x03,0x80,0x1C,0x40,0x27,0x40,0x1C,0x80,0x07,0x40,0x00,0x40},/*"&",6*/
{0x10,0x00,0x60,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00},/*"'",7*/
{0x00,0x00,0x00,0x00,0x00,0x00,0x1F,0x80,0x20,0x40,0x40,0x20},/*"(",8*/
{0x00,0x00,0x40,0x20,0x20,0x40,0x1F,0x80,0x00,0x00,0x00,0x00},/*")",9*/
{0x09,0x00,0x06,0x00,0x1F,0x80,0x06,0x00,0x09,0x00,0x00,0x00},/*"*",10*/
{0x04,0x00,0x04,0x00,0x3F,0x80,0x04,0x00,0x04,0x00,0x00,0x00},/*"+",11*/
{0x00,0x10,0x00,0x60,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00},/*",",12*/
{0x04,0x00,0x04,0x00,0x04,0x00,0x04,0x00,0x04,0x00,0x00,0x00},/*"-",13*/
{0x00,0x00,0x00,0x40,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00},/*".",14*/
{0x00,0x20,0x01,0xC0,0x06,0x00,0x38,0x00,0x40,0x00,0x00,0x00},/*"/",15*/
{0x1F,0x80,0x20,0x40,0x20,0x40,0x20,0x40,0x1F,0x80,0x00,0x00},/*"0",16*/
{0x00,0x00,0x10,0x40,0x3F,0xC0,0x00,0x40,0x00,0x00,0x00,0x00},/*"1",17*/
{0x18,0xC0,0x21,0x40,0x22,0x40,0x24,0x40,0x18,0x40,0x00,0x00},/*"2",18*/
{0x10,0x80,0x20,0x40,0x24,0x40,0x24,0x40,0x1B,0x80,0x00,0x00},/*"3",19*/
{0x02,0x00,0x0D,0x00,0x11,0x00,0x3F,0xC0,0x01,0x40,0x00,0x00},/*"4",20*/
{0x3C,0x80,0x24,0x40,0x24,0x40,0x24,0x40,0x23,0x80,0x00,0x00},/*"5",21*/
{0x1F,0x80,0x24,0x40,0x24,0x40,0x34,0x40,0x03,0x80,0x00,0x00},/*"6",22*/
{0x30,0x00,0x20,0x00,0x27,0xC0,0x38,0x00,0x20,0x00,0x00,0x00},/*"7",23*/
{0x1B,0x80,0x24,0x40,0x24,0x40,0x24,0x40,0x1B,0x80,0x00,0x00},/*"8",24*/
{0x1C,0x00,0x22,0xC0,0x22,0x40,0x22,0x40,0x1F,0x80,0x00,0x00},/*"9",25*/
{0x00,0x00,0x00,0x00,0x08,0x40,0x00,0x00,0x00,0x00,0x00,0x00},/*":",26*/
{0x00,0x00,0x00,0x00,0x04,0x60,0x00,0x00,0x00,0x00,0x00,0x00},/*";",27*/
{0x00,0x00,0x04,0x00,0x0A,0x00,0x11,0x00,0x20,0x80,0x40,0x40},/*"<",28*/
{0x09,0x00,0x09,0x00,0x09,0x00,0x09,0x00,0x09,0x00,0x00,0x00},/*"=",29*/
{0x00,0x00,0x40,0x40,0x20,0x80,0x11,0x00,0x0A,0x00,0x04,0x00},/*">",30*/
{0x18,0x00,0x20,0x00,0x23,0x40,0x24,0x00,0x18,0x00,0x00,0x00},/*"?",31*/
{0x1F,0x80,0x20,0x40,0x27,0x40,0x29,0x40,0x1F,0x40,0x00,0x00},/*"@",32*/
{0x00,0x40,0x07,0xC0,0x39,0x00,0x0F,0x00,0x01,0xC0,0x00,0x40},/*"A",33*/
{0x20,0x40,0x3F,0xC0,0x24,0x40,0x24,0x40,0x1B,0x80,0x00,0x00},/*"B",34*/
{0x1F,0x80,0x20,0x40,0x20,0x40,0x20,0x40,0x30,0x80,0x00,0x00},/*"C",35*/
{0x20,0x40,0x3F,0xC0,0x20,0x40,0x20,0x40,0x1F,0x80,0x00,0x00},/*"D",36*/
{0x20,0x40,0x3F,0xC0,0x24,0x40,0x2E,0x40,0x30,0xC0,0x00,0x00},/*"E",37*/
{0x20,0x40,0x3F,0xC0,0x24,0x40,0x2E,0x00,0x30,0x00,0x00,0x00},/*"F",38*/
{0x0F,0x00,0x10,0x80,0x20,0x40,0x22,0x40,0x33,0x80,0x02,0x00},/*"G",39*/
{0x20,0x40,0x3F,0xC0,0x04,0x00,0x04,0x00,0x3F,0xC0,0x20,0x40},/*"H",40*/
{0x20,0x40,0x20,0x40,0x3F,0xC0,0x20,0x40,0x20,0x40,0x00,0x00},/*"I",41*/
{0x00,0x60,0x20,0x20,0x20,0x20,0x3F,0xC0,0x20,0x00,0x20,0x00},/*"J",42*/
{0x20,0x40,0x3F,0xC0,0x24,0x40,0x0B,0x00,0x30,0xC0,0x20,0x40},/*"K",43*/
{0x20,0x40,0x3F,0xC0,0x20,0x40,0x00,0x40,0x00,0x40,0x00,0xC0},/*"L",44*/
{0x3F,0xC0,0x3C,0x00,0x03,0xC0,0x3C,0x00,0x3F,0xC0,0x00,0x00},/*"M",45*/
{0x20,0x40,0x3F,0xC0,0x0C,0x40,0x23,0x00,0x3F,0xC0,0x20,0x00},/*"N",46*/
{0x1F,0x80,0x20,0x40,0x20,0x40,0x20,0x40,0x1F,0x80,0x00,0x00},/*"O",47*/
{0x20,0x40,0x3F,0xC0,0x24,0x40,0x24,0x00,0x18,0x00,0x00,0x00},/*"P",48*/
{0x1F,0x80,0x21,0x40,0x21,0x40,0x20,0xE0,0x1F,0xA0,0x00,0x00},/*"Q",49*/
{0x20,0x40,0x3F,0xC0,0x24,0x40,0x26,0x00,0x19,0xC0,0x00,0x40},/*"R",50*/
{0x18,0xC0,0x24,0x40,0x24,0x40,0x22,0x40,0x31,0x80,0x00,0x00},/*"S",51*/
{0x30,0x00,0x20,0x40,0x3F,0xC0,0x20,0x40,0x30,0x00,0x00,0x00},/*"T",52*/
{0x20,0x00,0x3F,0x80,0x00,0x40,0x00,0x40,0x3F,0x80,0x20,0x00},/*"U",53*/
{0x20,0x00,0x3E,0x00,0x01,0xC0,0x07,0x00,0x38,0x00,0x20,0x00},/*"V",54*/
{0x38,0x00,0x07,0xC0,0x3C,0x00,0x07,0xC0,0x38,0x00,0x00,0x00},/*"W",55*/
{0x20,0x40,0x39,0xC0,0x06,0x00,0x39,0xC0,0x20,0x40,0x00,0x00},/*"X",56*/
{0x20,0x00,0x38,0x40,0x07,0xC0,0x38,0x40,0x20,0x00,0x00,0x00},/*"Y",57*/
{0x30,0x40,0x21,0xC0,0x26,0x40,0x38,0x40,0x20,0xC0,0x00,0x00},/*"Z",58*/
{0x00,0x00,0x00,0x00,0x7F,0xE0,0x40,0x20,0x40,0x20,0x00,0x00},/*"[",59*/
{0x00,0x00,0x70,0x00,0x0C,0x00,0x03,0x80,0x00,0x40,0x00,0x00},/*"\",60*/
{0x00,0x00,0x40,0x20,0x40,0x20,0x7F,0xE0,0x00,0x00,0x00,0x00},/*"]",61*/
{0x00,0x00,0x20,0x00,0x40,0x00,0x20,0x00,0x00,0x00,0x00,0x00},/*"^",62*/
{0x00,0x10,0x00,0x10,0x00,0x10,0x00,0x10,0x00,0x10,0x00,0x10},/*"_",63*/
{0x00,0x00,0x00,0x00,0x40,0x00,0x00,0x00,0x00,0x00,0x00,0x00},/*"`",64*/
{0x00,0x00,0x02,0x80,0x05,0x40,0x05,0x40,0x03,0xC0,0x00,0x40},/*"a",65*/
{0x20,0x00,0x3F,0xC0,0x04,0x40,0x04,0x40,0x03,0x80,0x00,0x00},/*"b",66*/
{0x00,0x00,0x03,0x80,0x04,0x40,0x04,0x40,0x06,0x40,0x00,0x00},/*"c",67*/
{0x00,0x00,0x03,0x80,0x04,0x40,0x24,0x40,0x3F,0xC0,0x00,0x40},/*"d",68*/
{0x00,0x00,0x03,0x80,0x05,0x40,0x05,0x40,0x03,0x40,0x00,0x00},/*"e",69*/
{0x00,0x00,0x04,0x40,0x1F,0xC0,0x24,0x40,0x24,0x40,0x20,0x00},/*"f",70*/
{0x00,0x00,0x02,0xE0,0x05,0x50,0x05,0x50,0x06,0x50,0x04,0x20},/*"g",71*/
{0x20,0x40,0x3F,0xC0,0x04,0x40,0x04,0x00,0x03,0xC0,0x00,0x40},/*"h",72*/
{0x00,0x00,0x04,0x40,0x27,0xC0,0x00,0x40,0x00,0x00,0x00,0x00},/*"i",73*/
{0x00,0x10,0x00,0x10,0x04,0x10,0x27,0xE0,0x00,0x00,0x00,0x00},/*"j",74*/
{0x20,0x40,0x3F,0xC0,0x01,0x40,0x07,0x00,0x04,0xC0,0x04,0x40},/*"k",75*/
{0x20,0x40,0x20,0x40,0x3F,0xC0,0x00,0x40,0x00,0x40,0x00,0x00},/*"l",76*/
{0x07,0xC0,0x04,0x00,0x07,0xC0,0x04,0x00,0x03,0xC0,0x00,0x00},/*"m",77*/
{0x04,0x40,0x07,0xC0,0x04,0x40,0x04,0x00,0x03,0xC0,0x00,0x40},/*"n",78*/
{0x00,0x00,0x03,0x80,0x04,0x40,0x04,0x40,0x03,0x80,0x00,0x00},/*"o",79*/
{0x04,0x10,0x07,0xF0,0x04,0x50,0x04,0x40,0x03,0x80,0x00,0x00},/*"p",80*/
{0x00,0x00,0x03,0x80,0x04,0x40,0x04,0x50,0x07,0xF0,0x00,0x10},/*"q",81*/
{0x04,0x40,0x07,0xC0,0x02,0x40,0x04,0x00,0x04,0x00,0x00,0x00},/*"r",82*/
{0x00,0x00,0x06,0x40,0x05,0x40,0x05,0x40,0x04,0xC0,0x00,0x00},/*"s",83*/
{0x00,0x00,0x04,0x00,0x1F,0x80,0x04,0x40,0x00,0x40,0x00,0x00},/*"t",84*/
{0x04,0x00,0x07,0x80,0x00,0x40,0x04,0x40,0x07,0xC0,0x00,0x40},/*"u",85*/
{0x04,0x00,0x07,0x00,0x04,0xC0,0x01,0x80,0x06,0x00,0x04,0x00},/*"v",86*/
{0x06,0x00,0x01,0xC0,0x07,0x00,0x01,0xC0,0x06,0x00,0x00,0x00},/*"w",87*/
{0x04,0x40,0x06,0xC0,0x01,0x00,0x06,0xC0,0x04,0x40,0x00,0x00},/*"x",88*/
{0x04,0x10,0x07,0x10,0x04,0xE0,0x01,0x80,0x06,0x00,0x04,0x00},/*"y",89*/
{0x00,0x00,0x04,0x40,0x05,0xC0,0x06,0x40,0x04,0x40,0x00,0x00},/*"z",90*/
{0x00,0x00,0x00,0x00,0x04,0x00,0x7B,0xE0,0x40,0x20,0x00,0x00},/*"{",91*/
{0x00,0x00,0x00,0x00,0x00,0x00,0xFF,0xF0,0x00,0x00,0x00,0x00},/*"|",92*/
{0x00,0x00,0x40,0x20,0x7B,0xE0,0x04,0x00,0x00,0x00,0x00,0x00},/*"}",93*/
{0x40,0x00,0x80,0x00,0x40,0x00,0x20,0x00,0x20,0x00,0x40,0x00},/*"~",94*/
};  
//16*16 ASCII字符集点阵
const unsigned char asc2_1608[95][16]={	  
{0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00},/*" ",0*/
{0x00,0x00,0x00,0x00,0x00,0x00,0x1F,0xCC,0x00,0x0C,0x00,0x00,0x00,0x00,0x00,0x00},/*"!",1*/
{0x00,0x00,0x08,0x00,0x30,0x00,0x60,0x00,0x08,0x00,0x30,0x00,0x60,0x00,0x00,0x00},/*""",2*/
{0x02,0x20,0x03,0xFC,0x1E,0x20,0x02,0x20,0x03,0xFC,0x1E,0x20,0x02,0x20,0x00,0x00},/*"#",3*/
{0x00,0x00,0x0E,0x18,0x11,0x04,0x3F,0xFF,0x10,0x84,0x0C,0x78,0x00,0x00,0x00,0x00},/*"$",4*/
{0x0F,0x00,0x10,0x84,0x0F,0x38,0x00,0xC0,0x07,0x78,0x18,0x84,0x00,0x78,0x00,0x00},/*"%",5*/
{0x00,0x78,0x0F,0x84,0x10,0xC4,0x11,0x24,0x0E,0x98,0x00,0xE4,0x00,0x84,0x00,0x08},/*"&",6*/
{0x08,0x00,0x68,0x00,0x70,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00},/*"'",7*/
{0x00,0x00,0x00,0x00,0x00,0x00,0x07,0xE0,0x18,0x18,0x20,0x04,0x40,0x02,0x00,0x00},/*"(",8*/
{0x00,0x00,0x40,0x02,0x20,0x04,0x18,0x18,0x07,0xE0,0x00,0x00,0x00,0x00,0x00,0x00},/*")",9*/
{0x02,0x40,0x02,0x40,0x01,0x80,0x0F,0xF0,0x01,0x80,0x02,0x40,0x02,0x40,0x00,0x00},/*"*",10*/
{0x00,0x80,0x00,0x80,0x00,0x80,0x0F,0xF8,0x00,0x80,0x00,0x80,0x00,0x80,0x00,0x00},/*"+",11*/
{0x00,0x01,0x00,0x0D,0x00,0x0E,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00},/*",",12*/
{0x00,0x00,0x00,0x80,0x00,0x80,0x00,0x80,0x00,0x80,0x00,0x80,0x00,0x80,0x00,0x80},/*"-",13*/
{0x00,0x00,0x00,0x0C,0x00,0x0C,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00},/*".",14*/
{0x00,0x00,0x00,0x06,0x00,0x18,0x00,0x60,0x01,0x80,0x06,0x00,0x18,0x00,0x20,0x00},/*"/",15*/
{0x00,0x00,0x07,0xF0,0x08,0x08,0x10,0x04,0x10,0x04,0x08,0x08,0x07,0xF0,0x00,0x00},/*"0",16*/
{0x00,0x00,0x08,0x04,0x08,0x04,0x1F,0xFC,0x00,0x04,0x00,0x04,0x00,0x00,0x00,0x00},/*"1",17*/
{0x00,0x00,0x0E,0x0C,0x10,0x14,0x10,0x24,0x10,0x44,0x11,0x84,0x0E,0x0C,0x00,0x00},/*"2",18*/
{0x00,0x00,0x0C,0x18,0x10,0x04,0x11,0x04,0x11,0x04,0x12,0x88,0x0C,0x70,0x00,0x00},/*"3",19*/
{0x00,0x00,0x00,0xE0,0x03,0x20,0x04,0x24,0x08,0x24,0x1F,0xFC,0x00,0x24,0x00,0x00},/*"4",20*/
{0x00,0x00,0x1F,0x98,0x10,0x84,0x11,0x04,0x11,0x04,0x10,0x88,0x10,0x70,0x00,0x00},/*"5",21*/
{0x00,0x00,0x07,0xF0,0x08,0x88,0x11,0x04,0x11,0x04,0x18,0x88,0x00,0x70,0x00,0x00},/*"6",22*/
{0x00,0x00,0x1C,0x00,0x10,0x00,0x10,0xFC,0x13,0x00,0x1C,0x00,0x10,0x00,0x00,0x00},/*"7",23*/
{0x00,0x00,0x0E,0x38,0x11,0x44,0x10,0x84,0x10,0x84,0x11,0x44,0x0E,0x38,0x00,0x00},/*"8",24*/
{0x00,0x00,0x07,0x00,0x08,0x8C,0x10,0x44,0x10,0x44,0x08,0x88,0x07,0xF0,0x00,0x00},/*"9",25*/
{0x00,0x00,0x00,0x00,0x00,0x00,0x03,0x0C,0x03,0x0C,0x00,0x00,0x00,0x00,0x00,0x00},/*":",26*/
{0x00,0x00,0x00,0x00,0x00,0x01,0x01,0x06,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00},/*";",27*/
{0x00,0x00,0x00,0x80,0x01,0x40,0x02,0x20,0x04,0x10,0x08,0x08,0x10,0x04,0x00,0x00},/*"<",28*/
{0x02,0x20,0x02,0x20,0x02,0x20,0x02,0x20,0x02,0x20,0x02,0x20,0x02,0x20,0x00,0x00},/*"=",29*/
{0x00,0x00,0x10,0x04,0x08,0x08,0x04,0x10,0x02,0x20,0x01,0x40,0x00,0x80,0x00,0x00},/*">",30*/
{0x00,0x00,0x0E,0x00,0x12,0x00,0x10,0x0C,0x10,0x6C,0x10,0x80,0x0F,0x00,0x00,0x00},/*"?",31*/
{0x03,0xE0,0x0C,0x18,0x13,0xE4,0x14,0x24,0x17,0xC4,0x08,0x28,0x07,0xD0,0x00,0x00},/*"@",32*/
{0x00,0x04,0x00,0x3C,0x03,0xC4,0x1C,0x40,0x07,0x40,0x00,0xE4,0x00,0x1C,0x00,0x04},/*"A",33*/
{0x10,0x04,0x1F,0xFC,0x11,0x04,0x11,0x04,0x11,0x04,0x0E,0x88,0x00,0x70,0x00,0x00},/*"B",34*/
{0x03,0xE0,0x0C,0x18,0x10,0x04,0x10,0x04,0x10,0x04,0x10,0x08,0x1C,0x10,0x00,0x00},/*"C",35*/
{0x10,0x04,0x1F,0xFC,0x10,0x04,0x10,0x04,0x10,0x04,0x08,0x08,0x07,0xF0,0x00,0x00},/*"D",36*/
{0x10,0x04,0x1F,0xFC,0x11,0x04,0x11,0x04,0x17,0xC4,0x10,0x04,0x08,0x18,0x00,0x00},/*"E",37*/
{0x10,0x04,0x1F,0xFC,0x11,0x04,0x11,0x00,0x17,0xC0,0x10,0x00,0x08,0x00,0x00,0x00},/*"F",38*/
{0x03,0xE0,0x0C,0x18,0x10,0x04,0x10,0x04,0x10,0x44,0x1C,0x78,0x00,0x40,0x00,0x00},/*"G",39*/
{0x10,0x04,0x1F,0xFC,0x10,0x84,0x00,0x80,0x00,0x80,0x10,0x84,0x1F,0xFC,0x10,0x04},/*"H",40*/
{0x00,0x00,0x10,0x04,0x10,0x04,0x1F,0xFC,0x10,0x04,0x10,0x04,0x00,0x00,0x00,0x00},/*"I",41*/
{0x00,0x03,0x00,0x01,0x10,0x01,0x10,0x01,0x1F,0xFE,0x10,0x00,0x10,0x00,0x00,0x00},/*"J",42*/
{0x10,0x04,0x1F,0xFC,0x11,0x04,0x03,0x80,0x14,0x64,0x18,0x1C,0x10,0x04,0x00,0x00},/*"K",43*/
{0x10,0x04,0x1F,0xFC,0x10,0x04,0x00,0x04,0x00,0x04,0x00,0x04,0x00,0x0C,0x00,0x00},/*"L",44*/
{0x10,0x04,0x1F,0xFC,0x1F,0x00,0x00,0xFC,0x1F,0x00,0x1F,0xFC,0x10,0x04,0x00,0x00},/*"M",45*/
{0x10,0x04,0x1F,0xFC,0x0C,0x04,0x03,0x00,0x00,0xE0,0x10,0x18,0x1F,0xFC,0x10,0x00},/*"N",46*/
{0x07,0xF0,0x08,0x08,0x10,0x04,0x10,0x04,0x10,0x04,0x08,0x08,0x07,0xF0,0x00,0x00},/*"O",47*/
{0x10,0x04,0x1F,0xFC,0x10,0x84,0x10,0x80,0x10,0x80,0x10,0x80,0x0F,0x00,0x00,0x00},/*"P",48*/
{0x07,0xF0,0x08,0x18,0x10,0x24,0x10,0x24,0x10,0x1C,0x08,0x0A,0x07,0xF2,0x00,0x00},/*"Q",49*/
{0x10,0x04,0x1F,0xFC,0x11,0x04,0x11,0x00,0x11,0xC0,0x11,0x30,0x0E,0x0C,0x00,0x04},/*"R",50*/
{0x00,0x00,0x0E,0x1C,0x11,0x04,0x10,0x84,0x10,0x84,0x10,0x44,0x1C,0x38,0x00,0x00},/*"S",51*/
{0x18,0x00,0x10,0x00,0x10,0x04,0x1F,0xFC,0x10,0x04,0x10,0x00,0x18,0x00,0x00,0x00},/*"T",52*/
{0x10,0x00,0x1F,0xF8,0x10,0x04,0x00,0x04,0x00,0x04,0x10,0x04,0x1F,0xF8,0x10,0x00},/*"U",53*/
{0x10,0x00,0x1E,0x00,0x11,0xE0,0x00,0x1C,0x00,0x70,0x13,0x80,0x1C,0x00,0x10,0x00},/*"V",54*/
{0x1F,0xC0,0x10,0x3C,0x00,0xE0,0x1F,0x00,0x00,0xE0,0x10,0x3C,0x1F,0xC0,0x00,0x00},/*"W",55*/
{0x10,0x04,0x18,0x0C,0x16,0x34,0x01,0xC0,0x01,0xC0,0x16,0x34,0x18,0x0C,0x10,0x04},/*"X",56*/
{0x10,0x00,0x1C,0x00,0x13,0x04,0x00,0xFC,0x13,0x04,0x1C,0x00,0x10,0x00,0x00,0x00},/*"Y",57*/
{0x08,0x04,0x10,0x1C,0x10,0x64,0x10,0x84,0x13,0x04,0x1C,0x04,0x10,0x18,0x00,0x00},/*"Z",58*/
{0x00,0x00,0x00,0x00,0x00,0x00,0x7F,0xFE,0x40,0x02,0x40,0x02,0x40,0x02,0x00,0x00},/*"[",59*/
{0x00,0x00,0x30,0x00,0x0C,0x00,0x03,0x80,0x00,0x60,0x00,0x1C,0x00,0x03,0x00,0x00},/*"\",60*/
{0x00,0x00,0x40,0x02,0x40,0x02,0x40,0x02,0x7F,0xFE,0x00,0x00,0x00,0x00,0x00,0x00},/*"]",61*/
{0x00,0x00,0x00,0x00,0x20,0x00,0x40,0x00,0x40,0x00,0x40,0x00,0x20,0x00,0x00,0x00},/*"^",62*/
{0x00,0x01,0x00,0x01,0x00,0x01,0x00,0x01,0x00,0x01,0x00,0x01,0x00,0x01,0x00,0x01},/*"_",63*/
{0x00,0x00,0x40,0x00,0x40,0x00,0x20,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00},/*"`",64*/
{0x00,0x00,0x00,0x98,0x01,0x24,0x01,0x44,0x01,0x44,0x01,0x44,0x00,0xFC,0x00,0x04},/*"a",65*/
{0x10,0x00,0x1F,0xFC,0x00,0x88,0x01,0x04,0x01,0x04,0x00,0x88,0x00,0x70,0x00,0x00},/*"b",66*/
{0x00,0x00,0x00,0x70,0x00,0x88,0x01,0x04,0x01,0x04,0x01,0x04,0x00,0x88,0x00,0x00},/*"c",67*/
{0x00,0x00,0x00,0x70,0x00,0x88,0x01,0x04,0x01,0x04,0x11,0x08,0x1F,0xFC,0x00,0x04},/*"d",68*/
{0x00,0x00,0x00,0xF8,0x01,0x44,0x01,0x44,0x01,0x44,0x01,0x44,0x00,0xC8,0x00,0x00},/*"e",69*/
{0x00,0x00,0x01,0x04,0x01,0x04,0x0F,0xFC,0x11,0x04,0x11,0x04,0x11,0x00,0x18,0x00},/*"f",70*/
{0x00,0x00,0x00,0xD6,0x01,0x29,0x01,0x29,0x01,0x29,0x01,0xC9,0x01,0x06,0x00,0x00},/*"g",71*/
{0x10,0x04,0x1F,0xFC,0x00,0x84,0x01,0x00,0x01,0x00,0x01,0x04,0x00,0xFC,0x00,0x04},/*"h",72*/
{0x00,0x00,0x01,0x04,0x19,0x04,0x19,0xFC,0x00,0x04,0x00,0x04,0x00,0x00,0x00,0x00},/*"i",73*/
{0x00,0x00,0x00,0x03,0x00,0x01,0x01,0x01,0x19,0x01,0x19,0xFE,0x00,0x00,0x00,0x00},/*"j",74*/
{0x10,0x04,0x1F,0xFC,0x00,0x24,0x00,0x40,0x01,0xB4,0x01,0x0C,0x01,0x04,0x00,0x00},/*"k",75*/
{0x00,0x00,0x10,0x04,0x10,0x04,0x1F,0xFC,0x00,0x04,0x00,0x04,0x00,0x00,0x00,0x00},/*"l",76*/
{0x01,0x04,0x01,0xFC,0x01,0x04,0x01,0x00,0x01,0xFC,0x01,0x04,0x01,0x00,0x00,0xFC},/*"m",77*/
{0x01,0x04,0x01,0xFC,0x00,0x84,0x01,0x00,0x01,0x00,0x01,0x04,0x00,0xFC,0x00,0x04},/*"n",78*/
{0x00,0x00,0x00,0xF8,0x01,0x04,0x01,0x04,0x01,0x04,0x01,0x04,0x00,0xF8,0x00,0x00},/*"o",79*/
{0x01,0x01,0x01,0xFF,0x00,0x85,0x01,0x04,0x01,0x04,0x00,0x88,0x00,0x70,0x00,0x00},/*"p",80*/
{0x00,0x00,0x00,0x70,0x00,0x88,0x01,0x04,0x01,0x04,0x01,0x05,0x01,0xFF,0x00,0x01},/*"q",81*/
{0x01,0x04,0x01,0x04,0x01,0xFC,0x00,0x84,0x01,0x04,0x01,0x00,0x01,0x80,0x00,0x00},/*"r",82*/
{0x00,0x00,0x00,0xCC,0x01,0x24,0x01,0x24,0x01,0x24,0x01,0x24,0x01,0x98,0x00,0x00},/*"s",83*/
{0x00,0x00,0x01,0x00,0x01,0x00,0x07,0xF8,0x01,0x04,0x01,0x04,0x00,0x00,0x00,0x00},/*"t",84*/
{0x01,0x00,0x01,0xF8,0x00,0x04,0x00,0x04,0x00,0x04,0x01,0x08,0x01,0xFC,0x00,0x04},/*"u",85*/
{0x01,0x00,0x01,0x80,0x01,0x70,0x00,0x0C,0x00,0x10,0x01,0x60,0x01,0x80,0x01,0x00},/*"v",86*/
{0x01,0xF0,0x01,0x0C,0x00,0x30,0x01,0xC0,0x00,0x30,0x01,0x0C,0x01,0xF0,0x01,0x00},/*"w",87*/
{0x00,0x00,0x01,0x04,0x01,0x8C,0x00,0x74,0x01,0x70,0x01,0x8C,0x01,0x04,0x00,0x00},/*"x",88*/
{0x01,0x01,0x01,0x81,0x01,0x71,0x00,0x0E,0x00,0x18,0x01,0x60,0x01,0x80,0x01,0x00},/*"y",89*/
{0x00,0x00,0x01,0x84,0x01,0x0C,0x01,0x34,0x01,0x44,0x01,0x84,0x01,0x0C,0x00,0x00},/*"z",90*/
{0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x01,0x00,0x3E,0xFC,0x40,0x02,0x40,0x02},/*"{",91*/
{0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0xFF,0xFF,0x00,0x00,0x00,0x00,0x00,0x00},/*"|",92*/
{0x00,0x00,0x40,0x02,0x40,0x02,0x3E,0xFC,0x01,0x00,0x00,0x00,0x00,0x00,0x00,0x00},/*"}",93*/
{0x00,0x00,0x60,0x00,0x80,0x00,0x80,0x00,0x40,0x00,0x40,0x00,0x20,0x00,0x20,0x00},/*"~",94*/
};  




static spi_device_handle_t spi;
uint8_t oledGram[OLED_WIDTH][OLED_HEIGHT];	

// 初始化SPI总线
esp_err_t spi_bus_init(void)
{
    esp_err_t ret;
    
    // 配置SPI总线
    spi_bus_config_t buscfg = {
        .mosi_io_num = OLED_MOSI,
        .miso_io_num = -1,
        .sclk_io_num = OLED_SCLK,
        .quadwp_io_num = -1,
        .quadhd_io_num = -1,
        .max_transfer_sz = 4096,
    };
    
    // 配置SPI设备
    spi_device_interface_config_t devcfg = {
        .clock_speed_hz = 10 * 1000 * 1000,  // 10MHz
        .mode = 0,
        .spics_io_num = OLED_CS,
        .queue_size = 7,
        .flags = SPI_DEVICE_NO_DUMMY,
    };
    
    // 初始化SPI总线
    ret = spi_bus_initialize(VSPI_HOST, &buscfg, SPI_DMA_CH_AUTO);
    if (ret != ESP_OK) {
        ESP_LOGE(TAG, "Failed to initialize SPI bus");
        return ret;
    }
    
    // 添加SPI设备
    ret = spi_bus_add_device(VSPI_HOST, &devcfg, &spi);
    if (ret != ESP_OK) {
        ESP_LOGE(TAG, "Failed to add SPI device");
        return ret;
    }
    
    return ESP_OK;
}

// GPIO初始化
static void gpio_init(void)
{
    gpio_config_t io_conf = {
        .pin_bit_mask = (1ULL << OLED_DC) | (1ULL << OLED_RST),
        .mode = GPIO_MODE_OUTPUT,
        .pull_up_en = GPIO_PULLUP_DISABLE,
        .pull_down_en = GPIO_PULLDOWN_DISABLE,
        .intr_type = GPIO_INTR_DISABLE,
    };
    gpio_config(&io_conf);
    gpio_set_level(OLED_RST, 1);  // 复位
}

// 发送命令
void oled_command(uint8_t cmd)
{
    gpio_set_level(OLED_DC, 0);  // 命令模式
    
    spi_transaction_t t = {
        .length = 8,
        .tx_buffer = &cmd,
    };
    
    spi_device_transmit(spi, &t);
}

// 发送数据
void oled_data(uint8_t *data, size_t len)
{
    gpio_set_level(OLED_DC, 1);  // 数据模式
    
    spi_transaction_t t = {
        .length = len * 8,
        .tx_buffer = data,
    };
    
    spi_device_transmit(spi, &t);
}


void oled_init(void)
{
    spi_bus_init();
    gpio_init();


    oled_command(0xAE); 
	oled_command(0xD5); 
	oled_command(80);  
	oled_command(0xA8);
	oled_command(0X3F);
	oled_command(0xD3); 
	oled_command(0X00);

	oled_command(0x40); 
													    
	oled_command(0x8D); 
	oled_command(0x14); 
	oled_command(0x20); 
	oled_command(0x02); 
	oled_command(0xA1);  //设置左右方向 0xA1正常 0xA0是左右反置
	oled_command(0xC0);  //设置上下方向 0xC8正常 0xC0上下反置
	oled_command(0xDA); 
	oled_command(0x12); 
		 
	oled_command(0x81); 
	oled_command(0xEF);
	oled_command(0xD9); 
	oled_command(0xf1); 
	oled_command(0xDB); 
	oled_command(0x30); 

	oled_command(0xA4); 
	oled_command(0xA6); 
	oled_command(0xAF); 

    oled_clear();

}

/************************************************* 
* @function:static rt_err_t oled_write_byte(const rt_uint8_t data,rt_uint8_t cmd)
* @description:OLED写字节
* @calls:          
* @input:                    
* @return:       
* @others:       
*************************************************/   
static int oled_write_byte(const uint8_t data,uint8_t cmd)
{
    uint8_t send = data;

    gpio_set_level(OLED_DC, cmd);  // 数据模式
    spi_transaction_t t = {
        .length = 8,
        .tx_buffer = &send,
    };
    
    spi_device_transmit(spi, &t);

    return 0;
}
/************************************************* 
* @function:void oled_display_on(void)
* @description:更新显存到LCD		
* @calls:          
* @input:                    
* @return:       
* @others:       
*************************************************/   
void oled_refresh_gram(void)
{
	uint8_t i,n;
	uint8_t buf[128];	
	for(i=0;i<8;i++)  
	{  
		oled_write_byte (0xb0+i,OLED_CMD);    //设置页地址（0~7）
		oled_write_byte (0x02,OLED_CMD);      //设置显示位置---列低地址
		oled_write_byte (0x10,OLED_CMD);      //设置显示位置---列高地址   
		for(n=0;n<128;n++)
		{
			buf[n] = oledGram[n][i];
		}
        oled_data(buf, 128);
	}   
}


/************************************************* 
* @function:void oled_display_on(void)
* @description:打开显示
* @calls:          
* @input:                    
* @return:       
* @others:       
*************************************************/   
void oled_display_on(void)
{
	oled_write_byte(0X8D,OLED_CMD);  //SET DCDC命令
	oled_write_byte(0X14,OLED_CMD);  //DCDC ON
	oled_write_byte(0XAF,OLED_CMD);  //DISPLAY ON
}
/************************************************* 
* @function:void oled_display_off(void)
* @description:关闭显示
* @calls:          
* @input:                    
* @return:       
* @others:       
*************************************************/     
void oled_display_off(void)
{
	oled_write_byte(0X8D,OLED_CMD);  //SET DCDC命令
	oled_write_byte(0X10,OLED_CMD);  //DCDC OFF
	oled_write_byte(0XAE,OLED_CMD);  //DISPLAY OFF
}		   			 
/************************************************* 
* @function:void oled_clear(void) 
* @description:清除显示
* @calls:          
* @input:                    
* @return:       
* @others:       
*************************************************/  
void oled_clear(void)  
{  
	uint8_t i,n;  
	for(i=0;i<8;i++)for(n=0;n<128;n++)oledGram[n][i]=0X00;  
	oled_refresh_gram();//更新显示
}
/************************************************* 
* @function:void oled_clear_buf()
* @description:清除缓冲区
* @calls:          
* @input:                    
* @return:       
* @others:       
*************************************************/ 
void oled_clear_buf()
{
	uint8_t i,n;  
	for(i=0;i<8;i++)
	{
		for(n=0;n<128;n++)
			oledGram[n][i]=0X00; 
	}		
	
}
/************************************************* 
* @function:void oled_fill(uint8_t x1,uint8_t y1,uint8_t x2,uint8_t y2,uint8_t dot)  
* @description:画点
* @calls:          
* @input:                    
* @return:       
* @others:       
*************************************************/ 		   
void oled_draw_point(uint8_t x,uint8_t y,uint8_t t)
{
	uint8_t pos,bx,temp=0;
	if(x>127||y>63)return;//超出范围了.
	pos=7-y/8;
	bx=y%8;
	temp=1<<(7-bx);
	if(t)oledGram[x][pos]|=temp;
	else oledGram[x][pos]&=~temp;	    
}
/************************************************* 
* @function:void oled_fill(uint8_t x1,uint8_t y1,uint8_t x2,uint8_t y2,uint8_t dot)  
* @description:填充
* @calls:          
* @input:                    
* @return:       
* @others:       
*************************************************/ 
void oled_fill(uint8_t x1,uint8_t y1,uint8_t x2,uint8_t y2,uint8_t dot)  
{  
	uint8_t x,y;  
	for(x=x1;x<=x2;x++)
	{
		for(y=y1;y<=y2;y++)oled_draw_point(x,y,dot);
	}													    
	oled_refresh_gram();//更新显示
}
/************************************************* 
* @function:void oled_show_char(uint8_t x,uint8_t y,uint8_t chr,uint8_t size,uint8_t mode)
* @description:显示字符
* @calls:          
* @input:                    
* @return:       
* @others:       
*************************************************/ 	
void oled_show_char(uint8_t x,uint8_t y,uint8_t chr,uint8_t size,uint8_t mode)
{      			    
	uint8_t temp,t,t1;
	uint8_t y0=y;
	uint8_t csize=(size/8+((size%8)?1:0))*(size/2);		//得到字体一个字符对应点阵集所占的字节数
	chr=chr-' ';//得到偏移后的值		 
    for(t=0;t<csize;t++)
    {   
		if(size==12)temp=asc2_1206[chr][t]; 	 	//调用1206字体
		else if(size==16)temp=asc2_1608[chr][t];	//调用1608字体
		else return;								//没有的字库
        for(t1=0;t1<8;t1++)
		{
			if(temp&0x80)oled_draw_point(x,y,mode);
			else oled_draw_point(x,y,!mode);
			temp<<=1;
			y++;
			if((y-y0)==size)
			{
				y=y0;
				x++;
				break;
			}
		}  	 
    }          
}
/************************************************* 
* @function:vuint32_t mypow(uint8_t m,uint8_t n)
* @description:m^n
* @calls:          
* @input:                    
* @return:       
* @others:       
*************************************************/ 	
uint32_t mypow(uint8_t m,uint8_t n)
{
	uint32_t result=1;	 
	while(n--)result*=m;    
	return result;
}				  
/************************************************* 
* @function:void oled_show_num(uint8_t x,uint8_t y,uint32_t num,uint8_t len,uint8_t size)
* @description:显示数字
* @calls:          
* @input:                    
* @return:       
* @others:       
*************************************************/ 		  
void oled_show_num(uint8_t x,uint8_t y,uint32_t num,uint8_t len,uint8_t size)
{         	
	uint8_t t,temp;
	uint8_t enshow=0;						   
	for(t=0;t<len;t++)
	{
		temp=(num/mypow(10,len-t-1))%10;
		if(enshow==0&&t<(len-1))
		{
			if(temp==0)
			{
				oled_show_char(x+(size/2)*t,y,' ',size,1);
				continue;
			}else enshow=1; 
		 	 
		}
	 	oled_show_char(x+(size/2)*t,y,temp+'0',size,1); 
	}
} 
/************************************************* 
* @function:void oled_show_string(uint8_t x,uint8_t y,const uint8_t *p,uint8_t size)      
* @description:显示字符串
* @calls:          
* @input:                    
* @return:       
* @others:       
*************************************************/ 
void oled_show_string(uint8_t x,uint8_t y,const uint8_t *p,uint8_t size)
{	
    while((*p<='~')&&(*p>=' '))//判断是不是非法字符!
    {       
        if(x>(128-(size/2))){x=0;y+=size;}
        if(y>(64-size)){y=x=0;oled_clear();}
        oled_show_char(x,y,*p,size,1);	 
        x+=size/2;
        p++;
    }  
	
}	  
/************************************************* 
* @function:void oled_draw_circle(uint8_t x0,uint8_t y0,uint8_t r)       
* @description:画线
* @calls:          
* @input:                    
* @return:       
* @others:       
*************************************************/ 
void oled_draw_line(uint8_t x1,uint8_t y1,uint8_t x2,uint8_t y2)
{
	uint8_t t; 
	int xerr=0,yerr=0,delta_x,delta_y,distance;
	int incx,incy,uRow,uCol;
	delta_x=x2-x1; //计算坐标增量 
	delta_y=y2-y1;
	uRow=x1;//画线起点坐标
	uCol=y1;
	if(delta_x>0)incx=1; //设置单步方向 
	else if (delta_x==0)incx=0;//垂直线 
	else {incx=-1;delta_x=-delta_x;}
	if(delta_y>0)incy=1;
	else if (delta_y==0)incy=0;//水平线 
	else {incy=-1;delta_y=-delta_y;}
	if(delta_x>delta_y)distance=delta_x; //选取基本增量坐标轴 
	else distance=delta_y;
	for(t=0;t<distance+1;t++)
	{
		oled_draw_point(uRow,uCol,1);//画点
		xerr+=delta_x;
		yerr+=delta_y;
		if(xerr>distance)
		{
			xerr-=distance;
			uRow+=incx;
		}
		if(yerr>distance)
		{
			yerr-=distance;
			uCol+=incy;
		}
	}
}


/************************************************* 
* @function:void oled_draw_circle(uint8_t x0,uint8_t y0,uint8_t r)       
* @description:画圆 
* @calls:          
* @input:                    
* @return:       
* @others:       
*************************************************/ 
void oled_draw_circle(uint8_t x0,uint8_t y0,uint8_t r)
{
	int a,b;
	a=0;b=r;	  
	while(a<=b)
	{
		oled_draw_point(x0-b,y0-a,1);             //3           
		oled_draw_point(x0+b,y0-a,1);             //0           
		oled_draw_point(x0-a,y0+b,1);             //1                
		oled_draw_point(x0-a,y0-b,1);             //2             
		oled_draw_point(x0+b,y0+a,1);             //4               
		oled_draw_point(x0+a,y0-b,1);             //5
		oled_draw_point(x0+a,y0+b,1);             //6 
		oled_draw_point(x0-b,y0+a,1);             //7
		a++;
		if((a*a+b*b)>(r*r))//判断要画的点是否过远
		{
			b--;
		}
	}
}

3.3、main.c

c 复制代码

#include <stdio.h>
#include "freertos/FreeRTOS.h"
#include "freertos/task.h"

#include "oled12864.h"


void app_main(void)
{
    oled_init();

    oled_show_string(0,0,(uint8_t *)"ESP32 OLED TEST",16);
    oled_show_string(0,16,(uint8_t *)"XuPeng",16);
    oled_show_string(0,32,(uint8_t *)"Very Good!",16);
    oled_refresh_gram();

    while (1)
    {
        oled_show_string(0,0,(uint8_t *)"OLED TEST",16);
        oled_refresh_gram();
        printf("OLED TEST\n");
        vTaskDelay(pdTICKS_TO_MS(500));
    }
    
}

二、oled12864介绍

OLED12864 指的是一种常见的 128 x 64 像素 、使用 OLED（有机发光二极管）显示技术的显示屏模块。它因其高对比度、宽视角、低功耗和相对简单的接口而广泛应用于各种嵌入式系统和电子项目中。

1、核心特性与优势

OLED 技术： 不同于传统的 LCD（液晶显示器）需要背光源，OLED 是自发光器件。每个像素点都可以独立开启或关闭，实现真正的黑色（关闭状态）。这使得 OLED 显示屏具有：
- 极高的对比度： 黑色深邃，白色明亮。
- 宽视角： 几乎从任何角度看都能保持色彩和亮度。
- 响应速度快： 几乎没有拖影现象。
- 结构相对简单： 无需背光层，可以做得很薄。
分辨率： 128 x 64 像素。这是一个中等大小的点阵显示屏，适合显示文字、简单图形和图标。
尺寸： 物理尺寸通常有 0.96 英寸、1.3 英寸等版本。
颜色： 常见的 OLED12864 模块通常是单色显示，多为蓝色、黄色或白色（或双色，如蓝黄）。
低功耗： 由于黑色像素不发光，显示内容以深色为主时功耗很低，特别适合电池供电设备。

2、接口与控制

驱动芯片： 这类模块通常使用 SSD1306 或 SH1106 驱动芯片。SSD1306 更为常见。
通信接口：
- SPI (串行外设接口)： 高速，引脚少（通常需要 SCLK, MOSI, CS, DC, RES），适合需要快速刷新的场景。
- I2C (Inter-Integrated Circuit)： 只需两根信号线（SDA, SCL），占用 MCU 引脚更少，但速度相对 SPI 慢一些。模块通常带有一个或多个地址选择焊点（如 0x3C 或 0x3D）。
- 部分模块可能支持 8位或 4位并行接口（6800/8080时序），但这在 12864 模块中不如 SPI/I2C 普及。
控制方式： MCU 通过发送命令和数据来控制显示内容。命令用于设置显示参数（如对比度、扫描方向、显示开关等），数据则写入显示缓存区（GDDRAM）以点亮像素。

3、显示内存 (GDDRAM) 组织

OLED12864 的显示内存通常被组织成 页 (Page) 的形式：

总高度 64 像素被分为 8 页 (Page0 - Page7)。
每页对应显示区域的 8 行像素。
每页有 128 列 (Segment)。
向 GDDRAM 写入数据时，通常是按页写入。向某一页的某一列地址写入一个字节的数据（8位），就控制了该页中该列位置上的 8 个像素点的亮灭状态（1 表示亮，0 表示灭）。

4、常见应用场景

嵌入式系统状态显示（电压、电流、温度、传感器数据等）。
便携式设备的用户界面（如智能手表、小型仪器）。
电子制作项目（如 DIY 时钟、游戏机、示波器）。
物联网设备的显示终端。

5、使用注意事项

静电防护 (ESD)： OLED 屏对静电敏感，操作时需注意防静电。
刷新率： 不需要像 LCD 那样不断刷新，内容变化时才更新屏幕即可，有助于节能。
烧屏： 长时间显示静态高亮度图像可能导致该区域亮度衰减加快（类似 CRT 老化），设计界面时应避免长时间固定显示高亮度内容。
接口电平： 注意模块工作电压（通常为 3.3V 或 5V）是否与控制器匹配。

三、ESP-IDF详解

1、ESP32 概述

ESP32 是由乐鑫科技（Espressif Systems）推出的一款高性能、低功耗、高集成度的 Wi-Fi & 蓝牙双模系统级芯片（SoC）。它广泛应用于物联网（IoT）、智能家居、工业控制等领域。其关键特性包括：

双核处理器（通常为 Xtensa LX6，某些型号为 RISC-V）
集成 Wi-Fi (802.11 b/g/n) 和蓝牙 (包括经典蓝牙和低功耗蓝牙 BLE)
丰富的外设接口： S P I SPI SPI, I 2 C I2C I2C, I 2 S I2S I2S, U A R T UART UART, A D C ADC ADC, D A C DAC DAC, P W M PWM PWM, 触摸传感器等
充足的内存（RAM 和 Flash 选项多样）
强大的安全特性（如加密加速器）
超低功耗设计，支持多种休眠模式

2、 ESP-IDF 详解

ESP-IDF (Espressif IoT Development Framework) 是乐鑫官方为 ESP32、ESP32-S 系列、ESP32-C 系列等芯片提供的开发框架和 SDK（软件开发工具包）。它是开发基于 ESP32 芯片应用程序的首选和官方推荐工具。

2.1 、ESP-IDF 的核心组件与架构

ESP-IDF 是一个分层、模块化的框架：

硬件抽象层 (HAL)： 提供对芯片硬件资源（如 GPIO、UART、SPI、I2C、定时器、ADC、DAC、RTC、Wi-Fi、蓝牙等）进行操作的统一接口，屏蔽底层硬件细节。
驱动 (Drivers)： 在 HAL 之上，提供更易用、功能更丰富的设备驱动（如 SPI Flash 驱动、SD 卡驱动、以太网驱动等）。
FreeRTOS： ESP-IDF 深度集成了开源的 FreeRTOS 实时操作系统内核。它提供了任务管理、队列、信号量、软件定时器、中断管理等机制，充分利用 ESP32 的多核特性（任务可以在不同核心上运行）。
中间件：
- Wi-Fi 协议栈： 实现 Wi-Fi 的 Station（客户端）、SoftAP（接入点）、Promiscuous（监听）模式。
- 蓝牙协议栈： 实现经典蓝牙和低功耗蓝牙 (BLE) 的各种角色（如 GATT Client/Server, GAP Central/Peripheral）。
- TCP/IP 协议栈 (lwIP)： 轻量级的 TCP/IP 协议栈，支持 IPv4/IPv6 (部分型号)、DHCP、DNS、Socket API 等。
- 文件系统 (FATFS/VFS)： 支持在 SPI Flash 或外部存储设备上使用 FAT 文件系统。
- 加密库： 提供 AES、SHA、RSA 等加密算法的软件和硬件加速实现。
- HTTP/WebSocket/MQTT 等协议库： 方便构建网络应用。
应用程序： 用户编写的业务逻辑代码，运行在 FreeRTOS 的任务中，通过调用下层 API 实现功能。

2.2 、ESP-IDF 开发环境与工具链

工具链： 基于 GNU GCC 编译器（针对 Xtensa 或 RISC-V 架构）。
构建系统： 使用 CMake （早期版本使用 GNU Make）。开发者编写 CMakeLists.txt 文件来定义项目结构、源文件、依赖组件等。
配置工具： menuconfig。这是一个基于文本的图形化配置工具（类似于 Linux Kernel 的 make menuconfig），用于配置 ESP-IDF 的众多选项，如：
- 选择目标芯片型号
- 配置 Wi-Fi/BT 参数
- 调整 FreeRTOS 设置（任务栈大小、优先级等）
- 配置日志输出级别和方式
- 配置内存布局
- 启用/禁用特定功能和外设驱动
核心工具 - idf.py： 这是 ESP-IDF 提供的命令行工具，用于执行构建、烧录、调试、监视串口输出等几乎所有开发任务。常用命令如：
- idf.py set-target esp32 (设置目标芯片)
- idf.py menuconfig (启动配置工具)
- idf.py build (编译项目)
- idf.py -p PORT flash (烧录固件到设备，PORT 为串口，如 COM3 或 /dev/ttyUSB0)
- idf.py -p PORT monitor (启动串口监视器，查看设备日志输出)
- idf.py fullclean (彻底清理构建目录)

2.3 、ESP-IDF 开发流程简述

环境搭建： 在 Windows、Linux 或 macOS 上安装 ESP-IDF 开发环境（包括工具链、Python、Git 等）。
创建项目： 使用 idf.py create-project 或复制示例项目模板。
编写代码： 在 main 目录下编写应用程序代码 (通常是 main.c 或 app_main() 函数)。
配置项目： 运行 idf.py menuconfig 根据需求进行配置。
编译项目： 运行 idf.py build 生成可执行固件 (.bin 文件)。
烧录固件： 将 ESP32 开发板连接到电脑，运行 idf.py -p PORT flash 将固件烧录到设备 Flash 中。
监视输出： 运行 idf.py -p PORT monitor 查看设备运行日志，进行调试。可以使用 ESP_LOGx (如 ESP_LOGI, ESP_LOGE) 函数打印不同级别的日志。

2.4、示例代码结构 (最简单的 Hello World)

c 复制代码

#include "freertos/FreeRTOS.h"
#include "freertos/task.h"
#include "esp_log.h"

static const char *TAG = "MAIN";

void app_main(void)
{
    while (1) {
        ESP_LOGI(TAG, "Hello World!"); // 打印 Info 级别日志
        vTaskDelay(pdMS_TO_TICKS(1000)); // 延时 1000 毫秒 (FreeRTOS 延时)
    }
}

2.5、优势与特点

官方支持： 由芯片原厂维护，更新及时，与新芯片特性同步快。
功能全面： 提供对 ESP32 所有硬件特性和外设的底层访问。
性能优化： 针对 ESP32 硬件进行了深度优化（如 Wi-Fi/BT 共存）。
稳定性高： 经过大量商业产品验证。
社区活跃： 用户多，社区支持好，问题容易找到解决方案。
文档完善： 官方提供详尽的 API 参考指南、编程指南和示例代码。
模块化： 易于扩展和复用代码，方便管理大型项目。
开源免费： 基于 Apache 2.0 许可证。

2.6 、适用场景

ESP-IDF 适用于需要深度控制硬件、追求高性能、高稳定性或需要使用 ESP32 特有功能（如超低功耗协处理器 ULP）的应用开发。对于快速原型开发，也可以考虑基于 ESP-IDF 构建的更高级框架（如 Arduino for ESP32、MicroPython），但这些框架最终都依赖于 ESP-IDF 的底层功能。

3、总结

ESP-IDF 是开发 ESP32 系列芯片的强大、灵活且功能完备的官方框架。它提供了从硬件操作到网络协议栈的全套解决方案，结合 FreeRTOS 实现了高效的多任务处理。虽然其学习曲线相对陡峭，尤其是对于不熟悉嵌入式开发和 RTOS 的开发者，但它提供了最直接、最强大的方式来充分利用 ESP32 的潜力，是开发复杂或高性能 ESP32 应用的基石。掌握 idf.py 工具链和 menuconfig 配置是使用 ESP-IDF 的关键。

ESP32 使用ESP-IDF驱动SPI接口OLED12864源码分享

ESP32 使用ESP-IDF驱动SPI接口OLED12864源码分享

一、源码分享

1、效果展示

2、开发环境搭建

3、源码分享

3.1、oled12864.h

3.2、oled12864.c

3.3、main.c

二、oled12864介绍

1、核心特性与优势

2、接口与控制

3、 显示内存 (GDDRAM) 组织

4、常见应用场景

5、使用注意事项

三、ESP-IDF详解

1、ESP32 概述

2、 ESP-IDF 详解

2.1 、ESP-IDF 的核心组件与架构

2.2 、ESP-IDF 开发环境与工具链

2.3 、ESP-IDF 开发流程简述

2.4、 示例代码结构 (最简单的 Hello World)

2.5、 优势与特点

2.6 、适用场景

3、总结

3、显示内存 (GDDRAM) 组织

2.4、示例代码结构 (最简单的 Hello World)

2.5、优势与特点