【STM32+HAL库】---- 软件IIC驱动0.96OLED （不使用Delay）_stm32hal库oled驱动
简介：这是一个超级简单的STM32HAL库使用软件IIC驱动0.96寸OLED，并且驱动程序不包含Hal_Delay（）;所以用起来非常方便。
1 软件准备
STM32CubeMX + STM32CubeIDE
2 程序准备
OLED
--OLED.c
--OLED.h
--OLED_Data.c--OLED_Data.h
3 STM32CubeMX配置
3.1 基础配置
配置烧录（如果不配置，烧一次程序第二次就烧不进去了）
配置时钟
对于此项目主频是多少无所谓。大家72-168Mhz之间随便填就行
3.2 OLED相关配置
GPIO配置
因为我们使用的是软件模拟IIC所以任意选择两个空闲的GPIO引脚即可本示例选择如下：
PD11 —— OLED_SDA
PD12 —— OLED_SCL
3.3 project工程配置
4 驱动程序设计
4.1 文件夹结构 搜索路径添加
新建文件夹 OLED
在OLED文件夹下新建4个文件（2个.h 文件 2个.c文件），如下：
OLED_Data.c
OLED_Data.h
OLED.c
OLED.h
添加搜索路径：
4.2 驱动程序
OLED_Data.c
/* * OLED_Data.c * * Created on: Mar 2, 2025 * Author: Ma */#include \"OLED_Data.h\"/** * 数据存储格式： * 纵向8点，高位在下，先从左到右，再从上到下 * 每一个Bit对应一个像素点 * * B0 B0 B0 B0 * B1 B1 B1 B1 * B2 B2 B2 B2 * B3 B3 -------------> B3 B3 -- * B4 B4 B4 B4 | * B5 B5 B5 B5 | * B6 B6 B6 B6 | * B7 B7 B7 B7 | * | * ----------------------------------- * | * | B0 B0 B0 B0 * | B1 B1 B1 B1 * | B2 B2 B2 B2 * --> B3 B3 -------------> B3 B3 * B4 B4 B4 B4 * B5 B5 B5 B5 * B6 B6 B6 B6 * B7 B7 B7 B7 * *//*ASCII字模数据*********************//*宽8像素，高16像素*/const uint8_t OLED_F8x16[][16] ={0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,// 00x00,0x00,0x00,0xF8,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x33,0x30,0x00,0x00,0x00,// ! 10x00,0x16,0x0E,0x00,0x16,0x0E,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,// \" 20x40,0xC0,0x78,0x40,0xC0,0x78,0x40,0x00,0x04,0x3F,0x04,0x04,0x3F,0x04,0x04,0x00,// # 30x00,0x70,0x88,0xFC,0x08,0x30,0x00,0x00,0x00,0x18,0x20,0xFF,0x21,0x1E,0x00,0x00,// $ 40xF0,0x08,0xF0,0x00,0xE0,0x18,0x00,0x00,0x00,0x21,0x1C,0x03,0x1E,0x21,0x1E,0x00,// % 50x00,0xF0,0x08,0x88,0x70,0x00,0x00,0x00,0x1E,0x21,0x23,0x24,0x19,0x27,0x21,0x10,// & 60x00,0x00,0x00,0x16,0x0E,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,// \' 70x00,0x00,0x00,0xE0,0x18,0x04,0x02,0x00,0x00,0x00,0x00,0x07,0x18,0x20,0x40,0x00,// ( 80x00,0x02,0x04,0x18,0xE0,0x00,0x00,0x00,0x00,0x40,0x20,0x18,0x07,0x00,0x00,0x00,// ) 90x40,0x40,0x80,0xF0,0x80,0x40,0x40,0x00,0x02,0x02,0x01,0x0F,0x01,0x02,0x02,0x00,// * 100x00,0x00,0x00,0xF0,0x00,0x00,0x00,0x00,0x01,0x01,0x01,0x1F,0x01,0x01,0x01,0x00,// + 110x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0xB0,0x70,0x00,0x00,0x00,0x00,0x00,// , 120x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x01,0x01,0x01,0x01,0x01,0x01,0x01,// - 130x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x30,0x30,0x00,0x00,0x00,0x00,0x00,// . 140x00,0x00,0x00,0x00,0x80,0x60,0x18,0x04,0x00,0x60,0x18,0x06,0x01,0x00,0x00,0x00,// / 150x00,0xE0,0x10,0x08,0x08,0x10,0xE0,0x00,0x00,0x0F,0x10,0x20,0x20,0x10,0x0F,0x00,// 0 160x00,0x10,0x10,0xF8,0x00,0x00,0x00,0x00,0x00,0x20,0x20,0x3F,0x20,0x20,0x00,0x00,// 1 170x00,0x70,0x08,0x08,0x08,0x88,0x70,0x00,0x00,0x30,0x28,0x24,0x22,0x21,0x30,0x00,// 2 180x00,0x30,0x08,0x88,0x88,0x48,0x30,0x00,0x00,0x18,0x20,0x20,0x20,0x11,0x0E,0x00,// 3 190x00,0x00,0xC0,0x20,0x10,0xF8,0x00,0x00,0x00,0x07,0x04,0x24,0x24,0x3F,0x24,0x00,// 4 200x00,0xF8,0x08,0x88,0x88,0x08,0x08,0x00,0x00,0x19,0x21,0x20,0x20,0x11,0x0E,0x00,// 5 210x00,0xE0,0x10,0x88,0x88,0x18,0x00,0x00,0x00,0x0F,0x11,0x20,0x20,0x11,0x0E,0x00,// 6 220x00,0x38,0x08,0x08,0xC8,0x38,0x08,0x00,0x00,0x00,0x00,0x3F,0x00,0x00,0x00,0x00,// 7 230x00,0x70,0x88,0x08,0x08,0x88,0x70,0x00,0x00,0x1C,0x22,0x21,0x21,0x22,0x1C,0x00,// 8 240x00,0xE0,0x10,0x08,0x08,0x10,0xE0,0x00,0x00,0x00,0x31,0x22,0x22,0x11,0x0F,0x00,// 9 250x00,0x00,0x00,0xC0,0xC0,0x00,0x00,0x00,0x00,0x00,0x00,0x30,0x30,0x00,0x00,0x00,// : 260x00,0x00,0x00,0xC0,0xC0,0x00,0x00,0x00,0x00,0x00,0x80,0xB0,0x70,0x00,0x00,0x00,// ; 270x00,0x00,0x80,0x40,0x20,0x10,0x08,0x00,0x00,0x01,0x02,0x04,0x08,0x10,0x20,0x00,// 300x00,0x70,0x48,0x08,0x08,0x08,0xF0,0x00,0x00,0x00,0x00,0x30,0x36,0x01,0x00,0x00,// ? 310xC0,0x30,0xC8,0x28,0xE8,0x10,0xE0,0x00,0x07,0x18,0x27,0x24,0x23,0x14,0x0B,0x00,// @ 320x00,0x00,0xC0,0x38,0xE0,0x00,0x00,0x00,0x20,0x3C,0x23,0x02,0x02,0x27,0x38,0x20,// A 330x08,0xF8,0x88,0x88,0x88,0x70,0x00,0x00,0x20,0x3F,0x20,0x20,0x20,0x11,0x0E,0x00,// B 340xC0,0x30,0x08,0x08,0x08,0x08,0x38,0x00,0x07,0x18,0x20,0x20,0x20,0x10,0x08,0x00,// C 350x08,0xF8,0x08,0x08,0x08,0x10,0xE0,0x00,0x20,0x3F,0x20,0x20,0x20,0x10,0x0F,0x00,// D 360x08,0xF8,0x88,0x88,0xE8,0x08,0x10,0x00,0x20,0x3F,0x20,0x20,0x23,0x20,0x18,0x00,// E 370x08,0xF8,0x88,0x88,0xE8,0x08,0x10,0x00,0x20,0x3F,0x20,0x00,0x03,0x00,0x00,0x00,// F 380xC0,0x30,0x08,0x08,0x08,0x38,0x00,0x00,0x07,0x18,0x20,0x20,0x22,0x1E,0x02,0x00,// G 390x08,0xF8,0x08,0x00,0x00,0x08,0xF8,0x08,0x20,0x3F,0x21,0x01,0x01,0x21,0x3F,0x20,// H 400x00,0x08,0x08,0xF8,0x08,0x08,0x00,0x00,0x00,0x20,0x20,0x3F,0x20,0x20,0x00,0x00,// I 410x00,0x00,0x08,0x08,0xF8,0x08,0x08,0x00,0xC0,0x80,0x80,0x80,0x7F,0x00,0x00,0x00,// J 420x08,0xF8,0x88,0xC0,0x28,0x18,0x08,0x00,0x20,0x3F,0x20,0x01,0x26,0x38,0x20,0x00,// K 430x08,0xF8,0x08,0x00,0x00,0x00,0x00,0x00,0x20,0x3F,0x20,0x20,0x20,0x20,0x30,0x00,// L 440x08,0xF8,0xF8,0x00,0xF8,0xF8,0x08,0x00,0x20,0x3F,0x00,0x3F,0x00,0x3F,0x20,0x00,// M 450x08,0xF8,0x30,0xC0,0x00,0x08,0xF8,0x08,0x20,0x3F,0x20,0x00,0x07,0x18,0x3F,0x00,// N 460xE0,0x10,0x08,0x08,0x08,0x10,0xE0,0x00,0x0F,0x10,0x20,0x20,0x20,0x10,0x0F,0x00,// O 470x08,0xF8,0x08,0x08,0x08,0x08,0xF0,0x00,0x20,0x3F,0x21,0x01,0x01,0x01,0x00,0x00,// P 480xE0,0x10,0x08,0x08,0x08,0x10,0xE0,0x00,0x0F,0x18,0x24,0x24,0x38,0x50,0x4F,0x00,// Q 490x08,0xF8,0x88,0x88,0x88,0x88,0x70,0x00,0x20,0x3F,0x20,0x00,0x03,0x0C,0x30,0x20,// R 500x00,0x70,0x88,0x08,0x08,0x08,0x38,0x00,0x00,0x38,0x20,0x21,0x21,0x22,0x1C,0x00,// S 510x18,0x08,0x08,0xF8,0x08,0x08,0x18,0x00,0x00,0x00,0x20,0x3F,0x20,0x00,0x00,0x00,// T 520x08,0xF8,0x08,0x00,0x00,0x08,0xF8,0x08,0x00,0x1F,0x20,0x20,0x20,0x20,0x1F,0x00,// U 530x08,0x78,0x88,0x00,0x00,0xC8,0x38,0x08,0x00,0x00,0x07,0x38,0x0E,0x01,0x00,0x00,// V 540xF8,0x08,0x00,0xF8,0x00,0x08,0xF8,0x00,0x03,0x3C,0x07,0x00,0x07,0x3C,0x03,0x00,// W 550x08,0x18,0x68,0x80,0x80,0x68,0x18,0x08,0x20,0x30,0x2C,0x03,0x03,0x2C,0x30,0x20,// X 560x08,0x38,0xC8,0x00,0xC8,0x38,0x08,0x00,0x00,0x00,0x20,0x3F,0x20,0x00,0x00,0x00,// Y 570x10,0x08,0x08,0x08,0xC8,0x38,0x08,0x00,0x20,0x38,0x26,0x21,0x20,0x20,0x18,0x00,// Z 580x00,0x00,0x00,0xFE,0x02,0x02,0x02,0x00,0x00,0x00,0x00,0x7F,0x40,0x40,0x40,0x00,// [ 590x00,0x0C,0x30,0xC0,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x01,0x06,0x38,0xC0,0x00,// \\ 600x00,0x02,0x02,0x02,0xFE,0x00,0x00,0x00,0x00,0x40,0x40,0x40,0x7F,0x00,0x00,0x00,// ] 610x00,0x20,0x10,0x08,0x04,0x08,0x10,0x20,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,// ^ 620x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x80,0x80,0x80,0x80,0x80,0x80,0x80,0x80,// _ 630x00,0x02,0x04,0x08,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,// ` 640x00,0x00,0x80,0x80,0x80,0x80,0x00,0x00,0x00,0x19,0x24,0x22,0x22,0x22,0x3F,0x20,// a 650x08,0xF8,0x00,0x80,0x80,0x00,0x00,0x00,0x00,0x3F,0x11,0x20,0x20,0x11,0x0E,0x00,// b 660x00,0x00,0x00,0x80,0x80,0x80,0x00,0x00,0x00,0x0E,0x11,0x20,0x20,0x20,0x11,0x00,// c 670x00,0x00,0x00,0x80,0x80,0x88,0xF8,0x00,0x00,0x0E,0x11,0x20,0x20,0x10,0x3F,0x20,// d 680x00,0x00,0x80,0x80,0x80,0x80,0x00,0x00,0x00,0x1F,0x22,0x22,0x22,0x22,0x13,0x00,// e 690x00,0x80,0x80,0xF0,0x88,0x88,0x88,0x18,0x00,0x20,0x20,0x3F,0x20,0x20,0x00,0x00,// f 700x00,0x00,0x80,0x80,0x80,0x80,0x80,0x00,0x00,0x6B,0x94,0x94,0x94,0x93,0x60,0x00,// g 710x08,0xF8,0x00,0x80,0x80,0x80,0x00,0x00,0x20,0x3F,0x21,0x00,0x00,0x20,0x3F,0x20,// h 720x00,0x80,0x98,0x98,0x00,0x00,0x00,0x00,0x00,0x20,0x20,0x3F,0x20,0x20,0x00,0x00,// i 730x00,0x00,0x00,0x80,0x98,0x98,0x00,0x00,0x00,0xC0,0x80,0x80,0x80,0x7F,0x00,0x00,// j 740x08,0xF8,0x00,0x00,0x80,0x80,0x80,0x00,0x20,0x3F,0x24,0x02,0x2D,0x30,0x20,0x00,// k 750x00,0x08,0x08,0xF8,0x00,0x00,0x00,0x00,0x00,0x20,0x20,0x3F,0x20,0x20,0x00,0x00,// l 760x80,0x80,0x80,0x80,0x80,0x80,0x80,0x00,0x20,0x3F,0x20,0x00,0x3F,0x20,0x00,0x3F,// m 770x00,0x80,0x80,0x00,0x80,0x80,0x00,0x00,0x00,0x20,0x3F,0x21,0x00,0x20,0x3F,0x20,// n 780x00,0x00,0x80,0x80,0x80,0x80,0x00,0x00,0x00,0x1F,0x20,0x20,0x20,0x20,0x1F,0x00,// o 790x80,0x80,0x00,0x80,0x80,0x00,0x00,0x00,0x80,0xFF,0xA1,0x20,0x20,0x11,0x0E,0x00,// p 800x00,0x00,0x00,0x80,0x80,0x80,0x80,0x00,0x00,0x0E,0x11,0x20,0x20,0xA0,0xFF,0x80,// q 810x80,0x80,0x80,0x00,0x80,0x80,0x80,0x00,0x20,0x20,0x3F,0x21,0x20,0x00,0x01,0x00,// r 820x00,0x00,0x80,0x80,0x80,0x80,0x80,0x00,0x00,0x33,0x24,0x24,0x24,0x24,0x19,0x00,// s 830x00,0x80,0x80,0xE0,0x80,0x80,0x00,0x00,0x00,0x00,0x00,0x1F,0x20,0x20,0x00,0x00,// t 840x80,0x80,0x00,0x00,0x00,0x80,0x80,0x00,0x00,0x1F,0x20,0x20,0x20,0x10,0x3F,0x20,// u 850x80,0x80,0x80,0x00,0x00,0x80,0x80,0x80,0x00,0x01,0x0E,0x30,0x08,0x06,0x01,0x00,// v 860x80,0x80,0x00,0x80,0x00,0x80,0x80,0x80,0x0F,0x30,0x0C,0x03,0x0C,0x30,0x0F,0x00,// w 870x00,0x80,0x80,0x00,0x80,0x80,0x80,0x00,0x00,0x20,0x31,0x2E,0x0E,0x31,0x20,0x00,// x 880x80,0x80,0x80,0x00,0x00,0x80,0x80,0x80,0x80,0x81,0x8E,0x70,0x18,0x06,0x01,0x00,// y 890x00,0x80,0x80,0x80,0x80,0x80,0x80,0x00,0x00,0x21,0x30,0x2C,0x22,0x21,0x30,0x00,// z 900x00,0x00,0x00,0x00,0x80,0x7C,0x02,0x02,0x00,0x00,0x00,0x00,0x00,0x3F,0x40,0x40,// { 910x00,0x00,0x00,0x00,0xFF,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0xFF,0x00,0x00,0x00,// | 920x00,0x02,0x02,0x7C,0x80,0x00,0x00,0x00,0x00,0x40,0x40,0x3F,0x00,0x00,0x00,0x00,// } 930x00,0x80,0x40,0x40,0x80,0x00,0x00,0x80,0x00,0x00,0x00,0x00,0x00,0x01,0x01,0x00,// ~ 94};/*宽6像素，高8像素*/const uint8_t OLED_F6x8[][6] ={0x00,0x00,0x00,0x00,0x00,0x00,// 00x00,0x00,0x00,0x2F,0x00,0x00,// ! 10x00,0x00,0x07,0x00,0x07,0x00,// \" 20x00,0x14,0x7F,0x14,0x7F,0x14,// # 30x00,0x24,0x2A,0x7F,0x2A,0x12,// $ 40x00,0x23,0x13,0x08,0x64,0x62,// % 50x00,0x36,0x49,0x55,0x22,0x50,// & 60x00,0x00,0x00,0x07,0x00,0x00,// \' 70x00,0x00,0x1C,0x22,0x41,0x00,// ( 80x00,0x00,0x41,0x22,0x1C,0x00,// ) 90x00,0x14,0x08,0x3E,0x08,0x14,// * 100x00,0x08,0x08,0x3E,0x08,0x08,// + 110x00,0x00,0x00,0xA0,0x60,0x00,// , 120x00,0x08,0x08,0x08,0x08,0x08,// - 130x00,0x00,0x60,0x60,0x00,0x00,// . 140x00,0x20,0x10,0x08,0x04,0x02,// / 150x00,0x3E,0x51,0x49,0x45,0x3E,// 0 160x00,0x00,0x42,0x7F,0x40,0x00,// 1 170x00,0x42,0x61,0x51,0x49,0x46,// 2 180x00,0x21,0x41,0x45,0x4B,0x31,// 3 190x00,0x18,0x14,0x12,0x7F,0x10,// 4 200x00,0x27,0x45,0x45,0x45,0x39,// 5 210x00,0x3C,0x4A,0x49,0x49,0x30,// 6 220x00,0x01,0x71,0x09,0x05,0x03,// 7 230x00,0x36,0x49,0x49,0x49,0x36,// 8 240x00,0x06,0x49,0x49,0x29,0x1E,// 9 250x00,0x00,0x36,0x36,0x00,0x00,// : 260x00,0x00,0x56,0x36,0x00,0x00,// ; 270x00,0x08,0x14,0x22,0x41,0x00,// 300x00,0x02,0x01,0x51,0x09,0x06,// ? 310x00,0x3E,0x49,0x55,0x59,0x2E,// @ 320x00,0x7C,0x12,0x11,0x12,0x7C,// A 330x00,0x7F,0x49,0x49,0x49,0x36,// B 340x00,0x3E,0x41,0x41,0x41,0x22,// C 350x00,0x7F,0x41,0x41,0x22,0x1C,// D 360x00,0x7F,0x49,0x49,0x49,0x41,// E 370x00,0x7F,0x09,0x09,0x09,0x01,// F 380x00,0x3E,0x41,0x49,0x49,0x7A,// G 390x00,0x7F,0x08,0x08,0x08,0x7F,// H 400x00,0x00,0x41,0x7F,0x41,0x00,// I 410x00,0x20,0x40,0x41,0x3F,0x01,// J 420x00,0x7F,0x08,0x14,0x22,0x41,// K 430x00,0x7F,0x40,0x40,0x40,0x40,// L 440x00,0x7F,0x02,0x0C,0x02,0x7F,// M 450x00,0x7F,0x04,0x08,0x10,0x7F,// N 460x00,0x3E,0x41,0x41,0x41,0x3E,// O 470x00,0x7F,0x09,0x09,0x09,0x06,// P 480x00,0x3E,0x41,0x51,0x21,0x5E,// Q 490x00,0x7F,0x09,0x19,0x29,0x46,// R 500x00,0x46,0x49,0x49,0x49,0x31,// S 510x00,0x01,0x01,0x7F,0x01,0x01,// T 520x00,0x3F,0x40,0x40,0x40,0x3F,// U 530x00,0x1F,0x20,0x40,0x20,0x1F,// V 540x00,0x3F,0x40,0x38,0x40,0x3F,// W 550x00,0x63,0x14,0x08,0x14,0x63,// X 560x00,0x07,0x08,0x70,0x08,0x07,// Y 570x00,0x61,0x51,0x49,0x45,0x43,// Z 580x00,0x00,0x7F,0x41,0x41,0x00,// [ 590x00,0x02,0x04,0x08,0x10,0x20,// \\ 600x00,0x00,0x41,0x41,0x7F,0x00,// ] 610x00,0x04,0x02,0x01,0x02,0x04,// ^ 620x00,0x40,0x40,0x40,0x40,0x40,// _ 630x00,0x00,0x01,0x02,0x04,0x00,// ` 640x00,0x20,0x54,0x54,0x54,0x78,// a 650x00,0x7F,0x48,0x44,0x44,0x38,// b 660x00,0x38,0x44,0x44,0x44,0x20,// c 670x00,0x38,0x44,0x44,0x48,0x7F,// d 680x00,0x38,0x54,0x54,0x54,0x18,// e 690x00,0x08,0x7E,0x09,0x01,0x02,// f 700x00,0x18,0xA4,0xA4,0xA4,0x7C,// g 710x00,0x7F,0x08,0x04,0x04,0x78,// h 720x00,0x00,0x44,0x7D,0x40,0x00,// i 730x00,0x40,0x80,0x84,0x7D,0x00,// j 740x00,0x7F,0x10,0x28,0x44,0x00,// k 750x00,0x00,0x41,0x7F,0x40,0x00,// l 760x00,0x7C,0x04,0x18,0x04,0x78,// m 770x00,0x7C,0x08,0x04,0x04,0x78,// n 780x00,0x38,0x44,0x44,0x44,0x38,// o 790x00,0xFC,0x24,0x24,0x24,0x18,// p 800x00,0x18,0x24,0x24,0x18,0xFC,// q 810x00,0x7C,0x08,0x04,0x04,0x08,// r 820x00,0x48,0x54,0x54,0x54,0x20,// s 830x00,0x04,0x3F,0x44,0x40,0x20,// t 840x00,0x3C,0x40,0x40,0x20,0x7C,// u 850x00,0x1C,0x20,0x40,0x20,0x1C,// v 860x00,0x3C,0x40,0x30,0x40,0x3C,// w 870x00,0x44,0x28,0x10,0x28,0x44,// x 880x00,0x1C,0xA0,0xA0,0xA0,0x7C,// y 890x00,0x44,0x64,0x54,0x4C,0x44,// z 900x00,0x00,0x08,0x7F,0x41,0x00,// { 910x00,0x00,0x00,0x7F,0x00,0x00,// | 920x00,0x00,0x41,0x7F,0x08,0x00,// } 930x00,0x08,0x04,0x08,0x10,0x08,// ~ 94};/*********************ASCII字模数据*//*汉字字模数据*********************//*相同的汉字只需要定义一次，汉字不分先后顺序*//*必须全部为汉字或者全角字符，不要加入任何半角字符*//*宽16像素，高16像素*/const ChineseCell_t OLED_CF16x16[] = {\"，\",0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x58,0x38,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,\"。\",0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x18,0x24,0x24,0x18,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,\"你\",0x00,0x80,0x60,0xF8,0x07,0x40,0x20,0x18,0x0F,0x08,0xC8,0x08,0x08,0x28,0x18,0x00,0x01,0x00,0x00,0xFF,0x00,0x10,0x0C,0x03,0x40,0x80,0x7F,0x00,0x01,0x06,0x18,0x00,\"好\",0x10,0x10,0xF0,0x1F,0x10,0xF0,0x00,0x80,0x82,0x82,0xE2,0x92,0x8A,0x86,0x80,0x00,0x40,0x22,0x15,0x08,0x16,0x61,0x00,0x00,0x40,0x80,0x7F,0x00,0x00,0x00,0x00,0x00,\"世\",0x20,0x20,0x20,0xFE,0x20,0x20,0xFF,0x20,0x20,0x20,0xFF,0x20,0x20,0x20,0x20,0x00,0x00,0x00,0x00,0x7F,0x40,0x40,0x47,0x44,0x44,0x44,0x47,0x40,0x40,0x40,0x00,0x00,\"界\",0x00,0x00,0x00,0xFE,0x92,0x92,0x92,0xFE,0x92,0x92,0x92,0xFE,0x00,0x00,0x00,0x00,0x08,0x08,0x04,0x84,0x62,0x1E,0x01,0x00,0x01,0xFE,0x02,0x04,0x04,0x08,0x08,0x00,/*按照上面的格式，在这个位置加入新的汉字数据*///.../*未找到指定汉字时显示的默认图形（一个方框，内部一个问号），请确保其位于数组最末尾*/\"\",0xFF,0x01,0x01,0x01,0x31,0x09,0x09,0x09,0x09,0x89,0x71,0x01,0x01,0x01,0x01,0xFF,0xFF,0x80,0x80,0x80,0x80,0x80,0x80,0x96,0x81,0x80,0x80,0x80,0x80,0x80,0x80,0xFF,};/*********************汉字字模数据*//*图像数据*********************//*测试图像（一个方框，内部一个二极管符号），宽16像素，高16像素*/const uint8_t Diode[] = {0xFF,0x01,0x81,0x81,0x81,0xFD,0x89,0x91,0xA1,0xC1,0xFD,0x81,0x81,0x81,0x01,0xFF,0xFF,0x80,0x80,0x80,0x80,0x9F,0x88,0x84,0x82,0x81,0x9F,0x80,0x80,0x80,0x80,0xFF,};/*按照上面的格式，在这个位置加入新的图像数据*///.../*********************图像数据*//*****************江协科技|版权所有****************//*****************jiangxiekeji.com*****************/OLED_Data.h
/* * OLED_Data.h * * Created on: Mar 2, 2025 * Author: Ma */#ifndef OLED_DATA_H_#define OLED_DATA_H_#include /*中文字符字节宽度*/#define OLED_CHN_CHAR_WIDTH3//UTF-8编码格式给3，GB2312编码格式给2/*字模基本单元*/typedef struct{char Index[OLED_CHN_CHAR_WIDTH + 1];//汉字索引uint8_t Data[32];//字模数据} ChineseCell_t;/*ASCII字模数据声明*/extern const uint8_t OLED_F8x16[][16];extern const uint8_t OLED_F6x8[][6];/*汉字字模数据声明*/extern const ChineseCell_t OLED_CF16x16[];/*图像数据声明*/extern const uint8_t Diode[];/*按照上面的格式，在这个位置加入新的图像数据声明*///.../*****************江协科技|版权所有****************//*****************jiangxiekeji.com*****************/#endif /* OLED_DATA_H_ */OLED.c
/* * OLED.c * * Created on: Mar 2, 2025 * Author: Ma *//*************************************************************************************** * 本程序由江协科技创建并免费开源共享 * 你可以任意查看、使用和修改，并应用到自己的项目之中 * 程序版权归江协科技所有，任何人或组织不得将其据为己有 * * 程序名称：0.96寸OLED显示屏驱动程序（4针脚I2C接口） * 程序创建时间：2023.10.24 * 当前程序版本：V1.2 * 当前版本发布时间：2024.4.24 * * 江协科技官方网站：jiangxiekeji.com * 江协科技官方淘宝店：jiangxiekeji.taobao.com * 程序介绍及更新动态：jiangxiekeji.com/tutorial/oled.html * * 如果你发现程序中的漏洞或者笔误，可通过邮件向我们反馈：feedback@jiangxiekeji.com * 发送邮件之前，你可以先到更新动态页面查看最新程序，如果此问题已经修改，则无需再发邮件 *************************************************************************************** */#include \"gpio.h\"#include \"OLED.h\"#include #include #include #include /** * 数据存储格式： * 纵向8点，高位在下，先从左到右，再从上到下 * 每一个Bit对应一个像素点 * * B0 B0 B0 B0 * B1 B1 B1 B1 * B2 B2 B2 B2 * B3 B3 -------------> B3 B3 -- * B4 B4 B4 B4 | * B5 B5 B5 B5 | * B6 B6 B6 B6 | * B7 B7 B7 B7 | * | * ----------------------------------- * | * | B0 B0 B0 B0 * | B1 B1 B1 B1 * | B2 B2 B2 B2 * --> B3 B3 -------------> B3 B3 * B4 B4 B4 B4 * B5 B5 B5 B5 * B6 B6 B6 B6 * B7 B7 B7 B7 * * 坐标轴定义： * 左上角为(0, 0)点 * 横向向右为X轴，取值范围：0~127 * 纵向向下为Y轴，取值范围：0~63 * * 0 X轴 127 * .-------------------------------> * 0 | * | * | * | * Y轴 | * | * | * | * 63 | * v * *//*全局变量*********************//** * OLED显存数组 * 所有的显示函数，都只是对此显存数组进行读写 * 随后调用OLED_Update函数或OLED_UpdateArea函数 * 才会将显存数组的数据发送到OLED硬件，进行显示 */uint8_t OLED_DisplayBuf[8][128];/*********************全局变量*//*引脚配置*/void OLED_W_SCL(GPIO_PinState x){HAL_GPIO_WritePin(OLED_SCL_GPIO_Port, OLED_SCL_Pin,x); //改成自己的引脚名字}void OLED_W_SDA(GPIO_PinState x){HAL_GPIO_WritePin(OLED_SDA_GPIO_Port, OLED_SDA_Pin,x); //改成自己的引脚名字}/*引脚初始化*/void OLED_I2C_Init(void){ MX_GPIO_Init();OLED_W_SCL(1);OLED_W_SDA(1);}/*通信协议*********************//** * 函 数：I2C起始 * 参 数：无 * 返 回 值：无 */void OLED_I2C_Start(void){OLED_W_SDA(1);//释放SDA，确保SDA为高电平OLED_W_SCL(1);//释放SCL，确保SCL为高电平OLED_W_SDA(0);//在SCL高电平期间，拉低SDA，产生起始信号OLED_W_SCL(0);//起始后把SCL也拉低，即为了占用总线，也为了方便总线时序的拼接}/** * 函 数：I2C终止 * 参 数：无 * 返 回 值：无 */void OLED_I2C_Stop(void){OLED_W_SDA(0);//拉低SDA，确保SDA为低电平OLED_W_SCL(1);//释放SCL，使SCL呈现高电平OLED_W_SDA(1);//在SCL高电平期间，释放SDA，产生终止信号}/** * 函 数：I2C发送一个字节 * 参 数：Byte 要发送的一个字节数据，范围：0x00~0xFF * 返 回 值：无 */void OLED_I2C_SendByte(uint8_t Byte){uint8_t i;/*循环8次，主机依次发送数据的每一位*/for (i = 0; i > i)));OLED_W_SCL(1);//释放SCL，从机在SCL高电平期间读取SDAOLED_W_SCL(0);//拉低SCL，主机开始发送下一位数据}OLED_W_SCL(1);//额外的一个时钟，不处理应答信号OLED_W_SCL(0);}/** * 函 数：OLED写命令 * 参 数：Command 要写入的命令值，范围：0x00~0xFF * 返 回 值：无 */void OLED_WriteCommand(uint8_t Command){OLED_I2C_Start();//I2C起始OLED_I2C_SendByte(0x78);//发送OLED的I2C从机地址OLED_I2C_SendByte(0x00);//控制字节，给0x00，表示即将写命令OLED_I2C_SendByte(Command);//写入指定的命令OLED_I2C_Stop();//I2C终止}/** * 函 数：OLED写数据 * 参 数：Data 要写入数据的起始地址 * 参 数：Count 要写入数据的数量 * 返 回 值：无 */void OLED_WriteData(uint8_t *Data, uint8_t Count){uint8_t i;OLED_I2C_Start();//I2C起始OLED_I2C_SendByte(0x78);//发送OLED的I2C从机地址OLED_I2C_SendByte(0x40);//控制字节，给0x40，表示即将写数据/*循环Count次，进行连续的数据写入*/for (i = 0; i > 4));//设置X位置高4位OLED_WriteCommand(0x00 | (X & 0x0F));//设置X位置低4位}/*********************硬件配置*//*工具函数*********************//*工具函数仅供内部部分函数使用*//** * 函 数：次方函数 * 参 数：X 底数 * 参 数：Y 指数 * 返 回 值：等于X的Y次方 */uint32_t OLED_Pow(uint32_t X, uint32_t Y){uint32_t Result = 1;//结果默认为1while (Y --)//累乘Y次{Result *= X;//每次把X累乘到结果上}return Result;}/** * 函 数：判断指定点是否在指定多边形内部 * 参 数：nvert 多边形的顶点数 * 参 数：vertx verty 包含多边形顶点的x和y坐标的数组 * 参 数：testx testy 测试点的X和y坐标 * 返 回 值：指定点是否在指定多边形内部，1：在内部，0：不在内部 */uint8_t OLED_pnpoly(uint8_t nvert, int16_t *vertx, int16_t *verty, int16_t testx, int16_t testy){int16_t i, j, c = 0;/*此算法由W. Randolph Franklin提出*//*参考链接：https://wrfranklin.org/Research/Short_Notes/pnpoly.html*/for (i = 0, j = nvert - 1; i testy) != (verty[j] > testy)) &&(testx < (vertx[j] - vertx[i]) * (testy - verty[i]) / (verty[j] - verty[i]) + vertx[i])){c = !c;}}return c;}/** * 函 数：判断指定点是否在指定角度内部 * 参 数：X Y 指定点的坐标 * 参 数：StartAngle EndAngle 起始角度和终止角度，范围：-180~180 * 水平向右为0度，水平向左为180度或-180度，下方为正数，上方为负数，顺时针旋转 * 返 回 值：指定点是否在指定角度内部，1：在内部，0：不在内部 */uint8_t OLED_IsInAngle(int16_t X, int16_t Y, int16_t StartAngle, int16_t EndAngle){int16_t PointAngle;PointAngle = atan2(Y, X) / 3.14 * 180;//计算指定点的弧度，并转换为角度表示if (StartAngle = StartAngle && PointAngle = StartAngle || PointAngle <= EndAngle){return 1;}}return 0;//不满足以上条件，则判断判定指定点不在指定角度}/*********************工具函数*//*功能函数*********************//** * 函 数：将OLED显存数组更新到OLED屏幕 * 参 数：无 * 返 回 值：无 * 说 明：所有的显示函数，都只是对OLED显存数组进行读写 * 随后调用OLED_Update函数或OLED_UpdateArea函数 * 才会将显存数组的数据发送到OLED硬件，进行显示 * 故调用显示函数后，要想真正地呈现在屏幕上，还需调用更新函数 */void OLED_Update(void){uint8_t j;/*遍历每一页*/for (j = 0; j < 8; j ++){/*设置光标位置为每一页的第一列*/OLED_SetCursor(j, 0);/*连续写入128个数据，将显存数组的数据写入到OLED硬件*/OLED_WriteData(OLED_DisplayBuf[j], 128);}}/** * 函 数：将OLED显存数组部分更新到OLED屏幕 * 参 数：X 指定区域左上角的横坐标，范围：-32768~32767，屏幕区域：0~127 * 参 数：Y 指定区域左上角的纵坐标，范围：-32768~32767，屏幕区域：0~63 * 参 数：Width 指定区域的宽度，范围：0~128 * 参 数：Height 指定区域的高度，范围：0~64 * 返 回 值：无 * 说 明：此函数会至少更新参数指定的区域 * 如果更新区域Y轴只包含部分页，则同一页的剩余部分会跟随一起更新 * 说 明：所有的显示函数，都只是对OLED显存数组进行读写 * 随后调用OLED_Update函数或OLED_UpdateArea函数 * 才会将显存数组的数据发送到OLED硬件，进行显示 * 故调用显示函数后，要想真正地呈现在屏幕上，还需调用更新函数 */void OLED_UpdateArea(int16_t X, int16_t Y, uint8_t Width, uint8_t Height){int16_t j;int16_t Page, Page1;/*负数坐标在计算页地址时需要加一个偏移*//*(Y + Height - 1) / 8 + 1的目的是(Y + Height) / 8并向上取整*/Page = Y / 8;Page1 = (Y + Height - 1) / 8 + 1;if (Y < 0){Page -= 1;Page1 -= 1;}/*遍历指定区域涉及的相关页*/for (j = Page; j = 0 && X = 0 && j <= 7)//超出屏幕的内容不显示{/*设置光标位置为相关页的指定列*/OLED_SetCursor(j, X);/*连续写入Width个数据，将显存数组的数据写入到OLED硬件*/OLED_WriteData(&OLED_DisplayBuf[j][X], Width);}}}/** * 函 数：将OLED显存数组全部清零 * 参 数：无 * 返 回 值：无 * 说 明：调用此函数后，要想真正地呈现在屏幕上，还需调用更新函数 */void OLED_Clear(void){uint8_t i, j;for (j = 0; j < 8; j ++)//遍历8页{for (i = 0; i < 128; i ++)//遍历128列{OLED_DisplayBuf[j][i] = 0x00;//将显存数组数据全部清零}}}/** * 函 数：将OLED显存数组部分清零 * 参 数：X 指定区域左上角的横坐标，范围：-32768~32767，屏幕区域：0~127 * 参 数：Y 指定区域左上角的纵坐标，范围：-32768~32767，屏幕区域：0~63 * 参 数：Width 指定区域的宽度，范围：0~128 * 参 数：Height 指定区域的高度，范围：0~64 * 返 回 值：无 * 说 明：调用此函数后，要想真正地呈现在屏幕上，还需调用更新函数 */void OLED_ClearArea(int16_t X, int16_t Y, uint8_t Width, uint8_t Height){int16_t i, j;for (j = Y; j < Y + Height; j ++)//遍历指定页{for (i = X; i = 0 && i =0 && j <= 63)//超出屏幕的内容不显示{OLED_DisplayBuf[j / 8][i] &= ~(0x01 << (j % 8));//将显存数组指定数据清零}}}}/** * 函 数：将OLED显存数组全部取反 * 参 数：无 * 返 回 值：无 * 说 明：调用此函数后，要想真正地呈现在屏幕上，还需调用更新函数 */void OLED_Reverse(void){uint8_t i, j;for (j = 0; j < 8; j ++)//遍历8页{for (i = 0; i < 128; i ++)//遍历128列{OLED_DisplayBuf[j][i] ^= 0xFF;//将显存数组数据全部取反}}}/** * 函 数：将OLED显存数组部分取反 * 参 数：X 指定区域左上角的横坐标，范围：-32768~32767，屏幕区域：0~127 * 参 数：Y 指定区域左上角的纵坐标，范围：-32768~32767，屏幕区域：0~63 * 参 数：Width 指定区域的宽度，范围：0~128 * 参 数：Height 指定区域的高度，范围：0~64 * 返 回 值：无 * 说 明：调用此函数后，要想真正地呈现在屏幕上，还需调用更新函数 */void OLED_ReverseArea(int16_t X, int16_t Y, uint8_t Width, uint8_t Height){int16_t i, j;for (j = Y; j < Y + Height; j ++)//遍历指定页{for (i = X; i = 0 && i =0 && j <= 63)//超出屏幕的内容不显示{OLED_DisplayBuf[j / 8][i] ^= 0x01 << (j % 8);//将显存数组指定数据取反}}}}/** * 函 数：OLED显示一个字符 * 参 数：X 指定字符左上角的横坐标，范围：-32768~32767，屏幕区域：0~127 * 参 数：Y 指定字符左上角的纵坐标，范围：-32768~32767，屏幕区域：0~63 * 参 数：Char 指定要显示的字符，范围：ASCII码可见字符 * 参 数：FontSize 指定字体大小 * 范围：OLED_8X16宽8像素，高16像素 * OLED_6X8宽6像素，高8像素 * 返 回 值：无 * 说 明：调用此函数后，要想真正地呈现在屏幕上，还需调用更新函数 */void OLED_ShowChar(int16_t X, int16_t Y, char Char, uint8_t FontSize){if (FontSize == OLED_8X16)//字体为宽8像素，高16像素{/*将ASCII字模库OLED_F8x16的指定数据以8*16的图像格式显示*/OLED_ShowImage(X, Y, 8, 16, OLED_F8x16[Char - \' \']);}else if(FontSize == OLED_6X8)//字体为宽6像素，高8像素{/*将ASCII字模库OLED_F6x8的指定数据以6*8的图像格式显示*/OLED_ShowImage(X, Y, 6, 8, OLED_F6x8[Char - \' \']);}}/** * 函 数：OLED显示字符串 * 参 数：X 指定字符串左上角的横坐标，范围：-32768~32767，屏幕区域：0~127 * 参 数：Y 指定字符串左上角的纵坐标，范围：-32768~32767，屏幕区域：0~63 * 参 数：String 指定要显示的字符串，范围：ASCII码可见字符组成的字符串 * 参 数：FontSize 指定字体大小 * 范围：OLED_8X16宽8像素，高16像素 * OLED_6X8宽6像素，高8像素 * 返 回 值：无 * 说 明：调用此函数后，要想真正地呈现在屏幕上，还需调用更新函数 */void OLED_ShowString(int16_t X, int16_t Y, char *String, uint8_t FontSize){uint8_t i;for (i = 0; String[i] != \'\\0\'; i++)//遍历字符串的每个字符{/*调用OLED_ShowChar函数，依次显示每个字符*/OLED_ShowChar(X + i * FontSize, Y, String[i], FontSize);}}/** * 函 数：OLED显示数字（十进制，正整数） * 参 数：X 指定数字左上角的横坐标，范围：-32768~32767，屏幕区域：0~127 * 参 数：Y 指定数字左上角的纵坐标，范围：-32768~32767，屏幕区域：0~63 * 参 数：Number 指定要显示的数字，范围：0~4294967295 * 参 数：Length 指定数字的长度，范围：0~10 * 参 数：FontSize 指定字体大小 * 范围：OLED_8X16宽8像素，高16像素 * OLED_6X8宽6像素，高8像素 * 返 回 值：无 * 说 明：调用此函数后，要想真正地呈现在屏幕上，还需调用更新函数 */void OLED_ShowNum(int16_t X, int16_t Y, uint32_t Number, uint8_t Length, uint8_t FontSize){uint8_t i;for (i = 0; i = 0)//数字大于等于0{OLED_ShowChar(X, Y, \'+\', FontSize);//显示+号Number1 = Number;//Number1直接等于Number}else//数字小于0{OLED_ShowChar(X, Y, \'-\', FontSize);//显示-号Number1 = -Number;//Number1等于Number取负}for (i = 0; i < Length; i++)//遍历数字的每一位{/*调用OLED_ShowChar函数，依次显示每个数字*//*Number1 / OLED_Pow(10, Length - i - 1) % 10 可以十进制提取数字的每一位*//*+ \'0\' 可将数字转换为字符格式*/OLED_ShowChar(X + (i + 1) * FontSize, Y, Number1 / OLED_Pow(10, Length - i - 1) % 10 + \'0\', FontSize);}}/** * 函 数：OLED显示十六进制数字（十六进制，正整数） * 参 数：X 指定数字左上角的横坐标，范围：-32768~32767，屏幕区域：0~127 * 参 数：Y 指定数字左上角的纵坐标，范围：-32768~32767，屏幕区域：0~63 * 参 数：Number 指定要显示的数字，范围：0x00000000~0xFFFFFFFF * 参 数：Length 指定数字的长度，范围：0~8 * 参 数：FontSize 指定字体大小 * 范围：OLED_8X16宽8像素，高16像素 * OLED_6X8宽6像素，高8像素 * 返 回 值：无 * 说 明：调用此函数后，要想真正地呈现在屏幕上，还需调用更新函数 */void OLED_ShowHexNum(int16_t X, int16_t Y, uint32_t Number, uint8_t Length, uint8_t FontSize){uint8_t i, SingleNumber;for (i = 0; i < Length; i++)//遍历数字的每一位{/*以十六进制提取数字的每一位*/SingleNumber = Number / OLED_Pow(16, Length - i - 1) % 16;if (SingleNumber < 10)//单个数字小于10{/*调用OLED_ShowChar函数，显示此数字*//*+ \'0\' 可将数字转换为字符格式*/OLED_ShowChar(X + i * FontSize, Y, SingleNumber + \'0\', FontSize);}else//单个数字大于10{/*调用OLED_ShowChar函数，显示此数字*//*+ \'A\' 可将数字转换为从A开始的十六进制字符*/OLED_ShowChar(X + i * FontSize, Y, SingleNumber - 10 + \'A\', FontSize);}}}/** * 函 数：OLED显示二进制数字（二进制，正整数） * 参 数：X 指定数字左上角的横坐标，范围：-32768~32767，屏幕区域：0~127 * 参 数：Y 指定数字左上角的纵坐标，范围：-32768~32767，屏幕区域：0~63 * 参 数：Number 指定要显示的数字，范围：0x00000000~0xFFFFFFFF * 参 数：Length 指定数字的长度，范围：0~16 * 参 数：FontSize 指定字体大小 * 范围：OLED_8X16宽8像素，高16像素 * OLED_6X8宽6像素，高8像素 * 返 回 值：无 * 说 明：调用此函数后，要想真正地呈现在屏幕上，还需调用更新函数 */void OLED_ShowBinNum(int16_t X, int16_t Y, uint32_t Number, uint8_t Length, uint8_t FontSize){uint8_t i;for (i = 0; i = 0)//数字大于等于0{OLED_ShowChar(X, Y, \'+\', FontSize);//显示+号}else//数字小于0{OLED_ShowChar(X, Y, \'-\', FontSize);//显示-号Number = -Number;//Number取负}/*提取整数部分和小数部分*/IntNum = Number;//直接赋值给整型变量，提取整数Number -= IntNum;//将Number的整数减掉，防止之后将小数乘到整数时因数过大造成错误PowNum = OLED_Pow(10, FraLength);//根据指定小数的位数，确定乘数FraNum = round(Number * PowNum);//将小数乘到整数，同时四舍五入，避免显示误差IntNum += FraNum / PowNum;//若四舍五入造成了进位，则需要再加给整数/*显示整数部分*/OLED_ShowNum(X + FontSize, Y, IntNum, IntLength, FontSize);/*显示小数点*/OLED_ShowChar(X + (IntLength + 1) * FontSize, Y, \'.\', FontSize);/*显示小数部分*/OLED_ShowNum(X + (IntLength + 2) * FontSize, Y, FraNum, FraLength, FontSize);}/** * 函 数：OLED显示汉字串 * 参 数：X 指定汉字串左上角的横坐标，范围：-32768~32767，屏幕区域：0~127 * 参 数：Y 指定汉字串左上角的纵坐标，范围：-32768~32767，屏幕区域：0~63 * 参 数：Chinese 指定要显示的汉字串，范围：必须全部为汉字或者全角字符，不要加入任何半角字符 * 显示的汉字需要在OLED_Data.c里的OLED_CF16x16数组定义 * 未找到指定汉字时，会显示默认图形（一个方框，内部一个问号） * 返 回 值：无 * 说 明：调用此函数后，要想真正地呈现在屏幕上，还需调用更新函数 */void OLED_ShowChinese(int16_t X, int16_t Y, char *Chinese){uint8_t pChinese = 0;uint8_t pIndex;uint8_t i;char SingleChinese[OLED_CHN_CHAR_WIDTH + 1] = {0};for (i = 0; Chinese[i] != \'\\0\'; i ++)//遍历汉字串{SingleChinese[pChinese] = Chinese[i];//提取汉字串数据到单个汉字数组pChinese ++;//计次自增/*当提取次数到达OLED_CHN_CHAR_WIDTH时，即代表提取到了一个完整的汉字*/if (pChinese >= OLED_CHN_CHAR_WIDTH){pChinese = 0;//计次归零/*遍历整个汉字字模库，寻找匹配的汉字*//*如果找到最后一个汉字（定义为空字符串），则表示汉字未在字模库定义，停止寻找*/for (pIndex = 0; strcmp(OLED_CF16x16[pIndex].Index, \"\") != 0; pIndex ++){/*找到匹配的汉字*/if (strcmp(OLED_CF16x16[pIndex].Index, SingleChinese) == 0){break;//跳出循环，此时pIndex的值为指定汉字的索引}}/*将汉字字模库OLED_CF16x16的指定数据以16*16的图像格式显示*/OLED_ShowImage(X + ((i + 1) / OLED_CHN_CHAR_WIDTH - 1) * 16, Y, 16, 16, OLED_CF16x16[pIndex].Data);}}}/** * 函 数：OLED显示图像 * 参 数：X 指定图像左上角的横坐标，范围：-32768~32767，屏幕区域：0~127 * 参 数：Y 指定图像左上角的纵坐标，范围：-32768~32767，屏幕区域：0~63 * 参 数：Width 指定图像的宽度，范围：0~128 * 参 数：Height 指定图像的高度，范围：0~64 * 参 数：Image 指定要显示的图像 * 返 回 值：无 * 说 明：调用此函数后，要想真正地呈现在屏幕上，还需调用更新函数 */void OLED_ShowImage(int16_t X, int16_t Y, uint8_t Width, uint8_t Height, const uint8_t *Image){uint8_t i = 0, j = 0;int16_t Page, Shift;/*将图像所在区域清空*/OLED_ClearArea(X, Y, Width, Height);/*遍历指定图像涉及的相关页*//*(Height - 1) / 8 + 1的目的是Height / 8并向上取整*/for (j = 0; j < (Height - 1) / 8 + 1; j ++){/*遍历指定图像涉及的相关列*/for (i = 0; i = 0 && X + i <= 127)//超出屏幕的内容不显示{/*负数坐标在计算页地址和移位时需要加一个偏移*/Page = Y / 8;Shift = Y % 8;if (Y = 0 && Page + j <= 7)//超出屏幕的内容不显示{/*显示图像在当前页的内容*/OLED_DisplayBuf[Page + j][X + i] |= Image[j * Width + i] <= 0 && Page + j + 1 > (8 - Shift);}}}}}/** * 函 数：OLED使用printf函数打印格式化字符串 * 参 数：X 指定格式化字符串左上角的横坐标，范围：-32768~32767，屏幕区域：0~127 * 参 数：Y 指定格式化字符串左上角的纵坐标，范围：-32768~32767，屏幕区域：0~63 * 参 数：FontSize 指定字体大小 * 范围：OLED_8X16宽8像素，高16像素 * OLED_6X8宽6像素，高8像素 * 参 数：format 指定要显示的格式化字符串，范围：ASCII码可见字符组成的字符串 * 参 数：... 格式化字符串参数列表 * 返 回 值：无 * 说 明：调用此函数后，要想真正地呈现在屏幕上，还需调用更新函数 */void OLED_Printf(int16_t X, int16_t Y, uint8_t FontSize, char *format, ...){char String[256];//定义字符数组va_list arg;//定义可变参数列表数据类型的变量argva_start(arg, format);//从format开始，接收参数列表到arg变量vsprintf(String, format, arg);//使用vsprintf打印格式化字符串和参数列表到字符数组中va_end(arg);//结束变量argOLED_ShowString(X, Y, String, FontSize);//OLED显示字符数组（字符串）}/** * 函 数：OLED在指定位置画一个点 * 参 数：X 指定点的横坐标，范围：-32768~32767，屏幕区域：0~127 * 参 数：Y 指定点的纵坐标，范围：-32768~32767，屏幕区域：0~63 * 返 回 值：无 * 说 明：调用此函数后，要想真正地呈现在屏幕上，还需调用更新函数 */void OLED_DrawPoint(int16_t X, int16_t Y){if (X >= 0 && X =0 && Y <= 63)//超出屏幕的内容不显示{/*将显存数组指定位置的一个Bit数据置1*/OLED_DisplayBuf[Y / 8][X] |= 0x01 <= 0 && X =0 && Y <= 63)//超出屏幕的内容不读取{/*判断指定位置的数据*/if (OLED_DisplayBuf[Y / 8][X] & 0x01 < x1) {temp = x0; x0 = x1; x1 = temp;}/*遍历X坐标*/for (x = x0; x y1) {temp = y0; y0 = y1; y1 = temp;}/*遍历Y坐标*/for (y = y0; y x1)//0号点X坐标大于1号点X坐标{/*交换两点坐标*//*交换后不影响画线，但是画线方向由第一、二、三、四象限变为第一、四象限*/temp = x0; x0 = x1; x1 = temp;temp = y0; y0 = y1; y1 = temp;}if (y0 > y1)//0号点Y坐标大于1号点Y坐标{/*将Y坐标取负*//*取负后影响画线，但是画线方向由第一、四象限变为第一象限*/y0 = -y0;y1 = -y1;/*置标志位yflag，记住当前变换，在后续实际画线时，再将坐标换回来*/yflag = 1;}if (y1 - y0 > x1 - x0)//画线斜率大于1{/*将X坐标与Y坐标互换*//*互换后影响画线，但是画线方向由第一象限0~90度范围变为第一象限0~45度范围*/temp = x0; x0 = y0; y0 = temp;temp = x1; x1 = y1; y1 = temp;/*置标志位xyflag，记住当前变换，在后续实际画线时，再将坐标换回来*/xyflag = 1;}/*以下为Bresenham算法画直线*//*算法要求，画线方向必须为第一象限0~45度范围*/dx = x1 - x0;dy = y1 - y0;incrE = 2 * dy;incrNE = 2 * (dy - dx);d = 2 * dy - dx;x = x0;y = y0;/*画起始点，同时判断标志位，将坐标换回来*/if (yflag && xyflag){OLED_DrawPoint(y, -x);}else if (yflag){OLED_DrawPoint(x, -y);}else if (xyflag){OLED_DrawPoint(y, x);}else{OLED_DrawPoint(x, y);}while (x < x1)//遍历X轴的每个点{x ++;if (d < 0)//下一个点在当前点东方{d += incrE;}else//下一个点在当前点东北方{y ++;d += incrNE;}/*画每一个点，同时判断标志位，将坐标换回来*/if (yflag && xyflag){OLED_DrawPoint(y, -x);}else if (yflag){OLED_DrawPoint(x, -y);}else if (xyflag){OLED_DrawPoint(y, x);}else{OLED_DrawPoint(x, y);}}}}/** * 函 数：OLED矩形 * 参 数：X 指定矩形左上角的横坐标，范围：-32768~32767，屏幕区域：0~127 * 参 数：Y 指定矩形左上角的纵坐标，范围：-32768~32767，屏幕区域：0~63 * 参 数：Width 指定矩形的宽度，范围：0~128 * 参 数：Height 指定矩形的高度，范围：0~64 * 参 数：IsFilled 指定矩形是否填充 * 范围：OLED_UNFILLED不填充 * OLED_FILLED填充 * 返 回 值：无 * 说 明：调用此函数后，要想真正地呈现在屏幕上，还需调用更新函数 */void OLED_DrawRectangle(int16_t X, int16_t Y, uint8_t Width, uint8_t Height, uint8_t IsFilled){int16_t i, j;if (!IsFilled)//指定矩形不填充{/*遍历上下X坐标，画矩形上下两条线*/for (i = X; i < X + Width; i ++){OLED_DrawPoint(i, Y);OLED_DrawPoint(i, Y + Height - 1);}/*遍历左右Y坐标，画矩形左右两条线*/for (i = Y; i < Y + Height; i ++){OLED_DrawPoint(X, i);OLED_DrawPoint(X + Width - 1, i);}}else//指定矩形填充{/*遍历X坐标*/for (i = X; i < X + Width; i ++){/*遍历Y坐标*/for (j = Y; j < Y + Height; j ++){/*在指定区域画点，填充满矩形*/OLED_DrawPoint(i, j);}}}}/** * 函 数：OLED三角形 * 参 数：X0 指定第一个端点的横坐标，范围：-32768~32767，屏幕区域：0~127 * 参 数：Y0 指定第一个端点的纵坐标，范围：-32768~32767，屏幕区域：0~63 * 参 数：X1 指定第二个端点的横坐标，范围：-32768~32767，屏幕区域：0~127 * 参 数：Y1 指定第二个端点的纵坐标，范围：-32768~32767，屏幕区域：0~63 * 参 数：X2 指定第三个端点的横坐标，范围：-32768~32767，屏幕区域：0~127 * 参 数：Y2 指定第三个端点的纵坐标，范围：-32768~32767，屏幕区域：0~63 * 参 数：IsFilled 指定三角形是否填充 * 范围：OLED_UNFILLED不填充 * OLED_FILLED填充 * 返 回 值：无 * 说 明：调用此函数后，要想真正地呈现在屏幕上，还需调用更新函数 */void OLED_DrawTriangle(int16_t X0, int16_t Y0, int16_t X1, int16_t Y1, int16_t X2, int16_t Y2, uint8_t IsFilled){int16_t minx = X0, miny = Y0, maxx = X0, maxy = Y0;int16_t i, j;int16_t vx[] = {X0, X1, X2};int16_t vy[] = {Y0, Y1, Y2};if (!IsFilled)//指定三角形不填充{/*调用画线函数，将三个点用直线连接*/OLED_DrawLine(X0, Y0, X1, Y1);OLED_DrawLine(X0, Y0, X2, Y2);OLED_DrawLine(X1, Y1, X2, Y2);}else//指定三角形填充{/*找到三个点最小的X、Y坐标*/if (X1 < minx) {minx = X1;}if (X2 < minx) {minx = X2;}if (Y1 < miny) {miny = Y1;}if (Y2 maxx) {maxx = X1;}if (X2 > maxx) {maxx = X2;}if (Y1 > maxy) {maxy = Y1;}if (Y2 > maxy) {maxy = Y2;}/*最小最大坐标之间的矩形为可能需要填充的区域*//*遍历此区域中所有的点*//*遍历X坐标*/for (i = minx; i <= maxx; i ++){/*遍历Y坐标*/for (j = miny; j <= maxy; j ++){/*调用OLED_pnpoly，判断指定点是否在指定三角形之中*//*如果在，则画点，如果不在，则不做处理*/if (OLED_pnpoly(3, vx, vy, i, j)) {OLED_DrawPoint(i, j);}}}}}/** * 函 数：OLED画圆 * 参 数：X 指定圆的圆心横坐标，范围：-32768~32767，屏幕区域：0~127 * 参 数：Y 指定圆的圆心纵坐标，范围：-32768~32767，屏幕区域：0~63 * 参 数：Radius 指定圆的半径，范围：0~255 * 参 数：IsFilled 指定圆是否填充 * 范围：OLED_UNFILLED不填充 * OLED_FILLED填充 * 返 回 值：无 * 说 明：调用此函数后，要想真正地呈现在屏幕上，还需调用更新函数 */void OLED_DrawCircle(int16_t X, int16_t Y, uint8_t Radius, uint8_t IsFilled){int16_t x, y, d, j;/*使用Bresenham算法画圆，可以避免耗时的浮点运算，效率更高*//*参考文档：https://www.cs.montana.edu/courses/spring2009/425/dslectures/Bresenham.pdf*//*参考教程：https://www.bilibili.com/video/BV1VM4y1u7wJ*/d = 1 - Radius;x = 0;y = Radius;/*画每个八分之一圆弧的起始点*/OLED_DrawPoint(X + x, Y + y);OLED_DrawPoint(X - x, Y - y);OLED_DrawPoint(X + y, Y + x);OLED_DrawPoint(X - y, Y - x);if (IsFilled)//指定圆填充{/*遍历起始点Y坐标*/for (j = -y; j < y; j ++){/*在指定区域画点，填充部分圆*/OLED_DrawPoint(X, Y + j);}}while (x < y)//遍历X轴的每个点{x ++;if (d < 0)//下一个点在当前点东方{d += 2 * x + 1;}else//下一个点在当前点东南方{y --;d += 2 * (x - y) + 1;}/*画每个八分之一圆弧的点*/OLED_DrawPoint(X + x, Y + y);OLED_DrawPoint(X + y, Y + x);OLED_DrawPoint(X - x, Y - y);OLED_DrawPoint(X - y, Y - x);OLED_DrawPoint(X + x, Y - y);OLED_DrawPoint(X + y, Y - x);OLED_DrawPoint(X - x, Y + y);OLED_DrawPoint(X - y, Y + x);if (IsFilled)//指定圆填充{/*遍历中间部分*/for (j = -y; j < y; j ++){/*在指定区域画点，填充部分圆*/OLED_DrawPoint(X + x, Y + j);OLED_DrawPoint(X - x, Y + j);}/*遍历两侧部分*/for (j = -x; j < x; j ++){/*在指定区域画点，填充部分圆*/OLED_DrawPoint(X - y, Y + j);OLED_DrawPoint(X + y, Y + j);}}}}/** * 函 数：OLED画椭圆 * 参 数：X 指定椭圆的圆心横坐标，范围：-32768~32767，屏幕区域：0~127 * 参 数：Y 指定椭圆的圆心纵坐标，范围：-32768~32767，屏幕区域：0~63 * 参 数：A 指定椭圆的横向半轴长度，范围：0~255 * 参 数：B 指定椭圆的纵向半轴长度，范围：0~255 * 参 数：IsFilled 指定椭圆是否填充 * 范围：OLED_UNFILLED不填充 * OLED_FILLED填充 * 返 回 值：无 * 说 明：调用此函数后，要想真正地呈现在屏幕上，还需调用更新函数 */void OLED_DrawEllipse(int16_t X, int16_t Y, uint8_t A, uint8_t B, uint8_t IsFilled){int16_t x, y, j;int16_t a = A, b = B;float d1, d2;/*使用Bresenham算法画椭圆，可以避免部分耗时的浮点运算，效率更高*//*参考链接：https://blog.csdn.net/myf_666/article/details/128167392*/x = 0;y = b;d1 = b * b + a * a * (-b + 0.5);if (IsFilled)//指定椭圆填充{/*遍历起始点Y坐标*/for (j = -y; j < y; j ++){/*在指定区域画点，填充部分椭圆*/OLED_DrawPoint(X, Y + j);OLED_DrawPoint(X, Y + j);}}/*画椭圆弧的起始点*/OLED_DrawPoint(X + x, Y + y);OLED_DrawPoint(X - x, Y - y);OLED_DrawPoint(X - x, Y + y);OLED_DrawPoint(X + x, Y - y);/*画椭圆中间部分*/while (b * b * (x + 1) < a * a * (y - 0.5)){if (d1 <= 0)//下一个点在当前点东方{d1 += b * b * (2 * x + 3);}else//下一个点在当前点东南方{d1 += b * b * (2 * x + 3) + a * a * (-2 * y + 2);y --;}x ++;if (IsFilled)//指定椭圆填充{/*遍历中间部分*/for (j = -y; j 0){if (d2 <= 0)//下一个点在当前点东方{d2 += b * b * (2 * x + 2) + a * a * (-2 * y + 3);x ++;}else//下一个点在当前点东南方{d2 += a * a * (-2 * y + 3);}y --;if (IsFilled)//指定椭圆填充{/*遍历两侧部分*/for (j = -y; j < y; j ++){/*在指定区域画点，填充部分椭圆*/OLED_DrawPoint(X + x, Y + j);OLED_DrawPoint(X - x, Y + j);}}/*画椭圆两侧部分圆弧*/OLED_DrawPoint(X + x, Y + y);OLED_DrawPoint(X - x, Y - y);OLED_DrawPoint(X - x, Y + y);OLED_DrawPoint(X + x, Y - y);}}/** * 函 数：OLED画圆弧 * 参 数：X 指定圆弧的圆心横坐标，范围：-32768~32767，屏幕区域：0~127 * 参 数：Y 指定圆弧的圆心纵坐标，范围：-32768~32767，屏幕区域：0~63 * 参 数：Radius 指定圆弧的半径，范围：0~255 * 参 数：StartAngle 指定圆弧的起始角度，范围：-180~180 * 水平向右为0度，水平向左为180度或-180度，下方为正数，上方为负数，顺时针旋转 * 参 数：EndAngle 指定圆弧的终止角度，范围：-180~180 * 水平向右为0度，水平向左为180度或-180度，下方为正数，上方为负数，顺时针旋转 * 参 数：IsFilled 指定圆弧是否填充，填充后为扇形 * 范围：OLED_UNFILLED不填充 * OLED_FILLED填充 * 返 回 值：无 * 说 明：调用此函数后，要想真正地呈现在屏幕上，还需调用更新函数 */void OLED_DrawArc(int16_t X, int16_t Y, uint8_t Radius, int16_t StartAngle, int16_t EndAngle, uint8_t IsFilled){int16_t x, y, d, j;/*此函数借用Bresenham算法画圆的方法*/d = 1 - Radius;x = 0;y = Radius;/*在画圆的每个点时，判断指定点是否在指定角度内，在，则画点，不在，则不做处理*/if (OLED_IsInAngle(x, y, StartAngle, EndAngle)){OLED_DrawPoint(X + x, Y + y);}if (OLED_IsInAngle(-x, -y, StartAngle, EndAngle)) {OLED_DrawPoint(X - x, Y - y);}if (OLED_IsInAngle(y, x, StartAngle, EndAngle)) {OLED_DrawPoint(X + y, Y + x);}if (OLED_IsInAngle(-y, -x, StartAngle, EndAngle)) {OLED_DrawPoint(X - y, Y - x);}if (IsFilled)//指定圆弧填充{/*遍历起始点Y坐标*/for (j = -y; j < y; j ++){/*在填充圆的每个点时，判断指定点是否在指定角度内，在，则画点，不在，则不做处理*/if (OLED_IsInAngle(0, j, StartAngle, EndAngle)) {OLED_DrawPoint(X, Y + j);}}}while (x < y)//遍历X轴的每个点{x ++;if (d < 0)//下一个点在当前点东方{d += 2 * x + 1;}else//下一个点在当前点东南方{y --;d += 2 * (x - y) + 1;}/*在画圆的每个点时，判断指定点是否在指定角度内，在，则画点，不在，则不做处理*/if (OLED_IsInAngle(x, y, StartAngle, EndAngle)) {OLED_DrawPoint(X + x, Y + y);}if (OLED_IsInAngle(y, x, StartAngle, EndAngle)) {OLED_DrawPoint(X + y, Y + x);}if (OLED_IsInAngle(-x, -y, StartAngle, EndAngle)) {OLED_DrawPoint(X - x, Y - y);}if (OLED_IsInAngle(-y, -x, StartAngle, EndAngle)) {OLED_DrawPoint(X - y, Y - x);}if (OLED_IsInAngle(x, -y, StartAngle, EndAngle)) {OLED_DrawPoint(X + x, Y - y);}if (OLED_IsInAngle(y, -x, StartAngle, EndAngle)) {OLED_DrawPoint(X + y, Y - x);}if (OLED_IsInAngle(-x, y, StartAngle, EndAngle)) {OLED_DrawPoint(X - x, Y + y);}if (OLED_IsInAngle(-y, x, StartAngle, EndAngle)) {OLED_DrawPoint(X - y, Y + x);}if (IsFilled)//指定圆弧填充{/*遍历中间部分*/for (j = -y; j < y; j ++){/*在填充圆的每个点时，判断指定点是否在指定角度内，在，则画点，不在，则不做处理*/if (OLED_IsInAngle(x, j, StartAngle, EndAngle)) {OLED_DrawPoint(X + x, Y + j);}if (OLED_IsInAngle(-x, j, StartAngle, EndAngle)) {OLED_DrawPoint(X - x, Y + j);}}/*遍历两侧部分*/for (j = -x; j < x; j ++){/*在填充圆的每个点时，判断指定点是否在指定角度内，在，则画点，不在，则不做处理*/if (OLED_IsInAngle(-y, j, StartAngle, EndAngle)) {OLED_DrawPoint(X - y, Y + j);}if (OLED_IsInAngle(y, j, StartAngle, EndAngle)) {OLED_DrawPoint(X + y, Y + j);}}}}}/*********************功能函数*//*****************江协科技|版权所有****************//*****************jiangxiekeji.com*****************/OLED.h
/* * OLED.h * * Created on: Mar 2, 2025 * Author: Ma */#ifndef OLED_H_#define OLED_H_#include #include \"OLED_Data.h\"/*参数宏定义*********************//*FontSize参数取值*//*此参数值不仅用于判断，而且用于计算横向字符偏移，默认值为字体像素宽度*/#define OLED_8X168#define OLED_6X86/*IsFilled参数数值*/#define OLED_UNFILLED0#define OLED_FILLED1/*********************参数宏定义*//*函数声明*********************//*初始化函数*/void OLED_Init(void);/*更新函数*/void OLED_Update(void);void OLED_UpdateArea(int16_t X, int16_t Y, uint8_t Width, uint8_t Height);/*显存控制函数*/void OLED_Clear(void);void OLED_ClearArea(int16_t X, int16_t Y, uint8_t Width, uint8_t Height);void OLED_Reverse(void);void OLED_ReverseArea(int16_t X, int16_t Y, uint8_t Width, uint8_t Height);/*显示函数*/void OLED_ShowChar(int16_t X, int16_t Y, char Char, uint8_t FontSize);void OLED_ShowString(int16_t X, int16_t Y, char *String, uint8_t FontSize);void OLED_ShowNum(int16_t X, int16_t Y, uint32_t Number, uint8_t Length, uint8_t FontSize);void OLED_ShowSignedNum(int16_t X, int16_t Y, int32_t Number, uint8_t Length, uint8_t FontSize);void OLED_ShowHexNum(int16_t X, int16_t Y, uint32_t Number, uint8_t Length, uint8_t FontSize);void OLED_ShowBinNum(int16_t X, int16_t Y, uint32_t Number, uint8_t Length, uint8_t FontSize);void OLED_ShowFloatNum(int16_t X, int16_t Y, double Number, uint8_t IntLength, uint8_t FraLength, uint8_t FontSize);void OLED_ShowChinese(int16_t X, int16_t Y, char *Chinese);void OLED_ShowImage(int16_t X, int16_t Y, uint8_t Width, uint8_t Height, const uint8_t *Image);void OLED_Printf(int16_t X, int16_t Y, uint8_t FontSize, char *format, ...);/*绘图函数*/void OLED_DrawPoint(int16_t X, int16_t Y);uint8_t OLED_GetPoint(int16_t X, int16_t Y);void OLED_DrawLine(int16_t X0, int16_t Y0, int16_t X1, int16_t Y1);void OLED_DrawRectangle(int16_t X, int16_t Y, uint8_t Width, uint8_t Height, uint8_t IsFilled);void OLED_DrawTriangle(int16_t X0, int16_t Y0, int16_t X1, int16_t Y1, int16_t X2, int16_t Y2, uint8_t IsFilled);void OLED_DrawCircle(int16_t X, int16_t Y, uint8_t Radius, uint8_t IsFilled);void OLED_DrawEllipse(int16_t X, int16_t Y, uint8_t A, uint8_t B, uint8_t IsFilled);void OLED_DrawArc(int16_t X, int16_t Y, uint8_t Radius, int16_t StartAngle, int16_t EndAngle, uint8_t IsFilled);/*********************函数声明*//*****************江协科技|版权所有****************//*****************jiangxiekeji.com*****************/#endif /* OLED_H_ */5 驱动代码使用
5.1·接线
STM32 —— OLED
PD11 —— OLED_SDA
PD12 —— OLED_SCL
3V3 —— VCC
GND —— GND
5.2 调用
main.c
#include \"OLED.h\" //包含头文件
// 延时+初始化+OLED显示
HAL_Delay(100);
OLED_Init();
OLED_ShowString(0,0, \"OLED is OK\", 6);
OLED_Update(); // 一定要有这段代码，没有这句无法显示。每次显示都要调用这句
6 演示效果
7 驱动代码源文件下载
STM32各种模块驱动程序下载
