stm32miniOLED显示实验

一，OLED简介

OLED，即有机发光二极管（Organic Light-Emitting Diode），又称为有机电激光显示（Organic Electroluminesence Display， OELD）。OLED 由于同时具备自发光，不需背光源、对比度高、 厚度薄、视角广、反应速度快、可用于挠曲性面板、使用温度范围广、构造及制程较简单等优 异之特性，被认为是下一代的平面显示器新兴应用技术。

二，硬件设计

本实验用到的硬件资源有： 1） 指示灯 DS0 2） OLED 模块

 OLED模块插在液晶屏插的靠左的位置，板子上也有提示。

三，总体思路及前置知识

1）设置 STM32 与 OLED 模块相连接的 IO。

这一步，先将我们与 OLED 模块相连的 IO 口设置为输出，具体使用哪些 IO 口，这里需要 根据连接电路以及 OLED 模块所设置的通讯模式来确定。这些将在硬件设计部分向大家介绍。

2）初始化 OLED 模块。 其实这里就是上面的初始化框图的内容，通过对 OLED 相关寄存器的初始化，来启动 OLED 的显示。为后续显示字符和数字做准备。

3）通过函数将字符和数字显示到 OLED 模块上。

这里就是通过我们设计的程序，将要显示的字符送到 OLED 模块就可以了，这些函数将在 软件设计部分向大家介绍。

接下来介绍一些后面函数会用到的专有名词。

CS：OLED 片选信号。

WR：向 OLED 写入数据。

RD：从 OLED 读取数据。

D[7：0]：8 位双向数据线。

RST(RES)：硬复位 OLED。

DC：命令/数据标志（0，读写命令；1，读写数据）。

ALIENTEK OLED 模块的控制器是 SSD1306，下面介绍几个SSD1306的常用命令。

 第一个命令为 0X81，用于设置对比度的，这个命令包含了两个字节，第一个 0X81 为命令， 随后发送的一个字节为要设置的对比度的值。这个值设置得越大屏幕就越亮。

第二个命令为 0XAE/0XAF。0XAE 为关闭显示命令；0XAF 为开启显示命令。

第三个命令为 0X8D，该指令也包含 2 个字节，第一个为命令字，第二个为设置值，第二 个字节的 BIT2 表示电荷泵的开关状态，该位为 1，则开启电荷泵，为 0 则关闭。在模块初始化 的时候，这个必须要开启，否则是看不到屏幕显示的。

第四个命令为 0XB0~B7，该命令用于设置页地址，其低三位的值对应着 GRAM 的页地址。

第五个指令为 0X00~0X0F，该指令用于设置显示时的起始列地址低四位。

第六个指令为 0X10~0X1F，该指令用于设置显示时的起始列地址高四位。

四，软件设计

OLED_Init函数代码如下：

//初始化 SSD1306 
void OLED_Init(void)
{ 
GPIO_InitTypeDef GPIO_InitStructure; 
RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOB|RCC_APB2Periph_GPIOC, 
ENABLE );
#if OLED_MODE==1
RCC_APB2PeriphClockCmd(RCC_APB2Periph_AFIO, ENABLE); //使能 AFIO 时钟
GPIO_PinRemapConfig(GPIO_Remap_SWJ_JTAGDisable , ENABLE);
 //JTAG-DP 失能 + SW-DP 使能
GPIO_InitStructure.GPIO_Pin = GPIO_Pin_0|GPIO_Pin_1|GPIO_Pin_2|
GPIO_Pin_3|GPIO_Pin_4|GPIO_Pin_5|GPIO_Pin_6|GPIO_Pin_7;
GPIO_InitStructure.GPIO_Mode = GPIO_Mode_Out_PP; //推挽输出
GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz;
GPIO_Init(GPIOB, &GPIO_InitStructure); 
GPIO_Write(GPIOB,0XFFFF);
GPIO_InitStructure.GPIO_Pin = GPIO_Pin_6|GPIO_Pin_7|GPIO_Pin_8|GPIO_Pin_9;
GPIO_InitStructure.GPIO_Mode = GPIO_Mode_Out_PP; //推挽输出
GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz;
GPIO_Init(GPIOC, &GPIO_InitStructure);
GPIO_SetBits(GPIOC, GPIO_Pin_6|GPIO_Pin_7|GPIO_Pin_8|GPIO_Pin_9);
//如果每一位决定一个 GPIO_Pin,则可以通过或的形式来初始化多个 IO
#else
GPIO_InitStructure.GPIO_Pin = GPIO_Pin_0|GPIO_Pin_1;
GPIO_InitStructure.GPIO_Mode = GPIO_Mode_Out_PP; //推挽输出
GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz;
GPIO_Init(GPIOB, &GPIO_InitStructure);
GPIO_InitStructure.GPIO_Pin = GPIO_Pin_7;
GPIO_InitStructure.GPIO_Mode = GPIO_Mode_AF_OD ; //推挽输出
GPIO_Init(GPIOB, &GPIO_InitStructure); 
GPIO_Write(GPIOB,0X03);
GPIO_InitStructure.GPIO_Pin = GPIO_Pin_8|GPIO_Pin_9;
GPIO_InitStructure.GPIO_Mode = GPIO_Mode_Out_PP; //推挽输出
GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz;
GPIO_Init(GPIOC, &GPIO_InitStructure);
GPIO_SetBits(GPIOC, GPIO_Pin_8|GPIO_Pin_9);
#endif 
 
OLED_WR_Byte(0xAE,OLED_CMD); //关闭显示
OLED_WR_Byte(0xD5,OLED_CMD); //设置时钟分频因子,震荡频率
OLED_WR_Byte(80,OLED_CMD); //[3:0],分频因子;[7:4],震荡频率
OLED_WR_Byte(0xA8,OLED_CMD); //设置驱动路数
OLED_WR_Byte(0X3F,OLED_CMD); //默认 0X3F(1/64) 
OLED_WR_Byte(0xD3,OLED_CMD); //设置显示偏移
OLED_WR_Byte(0X00,OLED_CMD); //默认为 0
OLED_WR_Byte(0x40,OLED_CMD); //设置显示开始行 [5:0],行数.
 
OLED_WR_Byte(0x8D,OLED_CMD); //电荷泵设置
OLED_WR_Byte(0x14,OLED_CMD); //bit2，开启/关闭
OLED_WR_Byte(0x20,OLED_CMD); //设置内存地址模式
OLED_WR_Byte(0x02,OLED_CMD); //
OLED_WR_Byte(0xA1,OLED_CMD); //段重定义设置,bit0:0,0->0;1,0->127;
OLED_WR_Byte(0xC0,OLED_CMD); //设置 COM 扫描方向;
OLED_WR_Byte(0xDA,OLED_CMD); //设置 COM 硬件引脚配置
OLED_WR_Byte(0x12,OLED_CMD); //[5:4]配置
OLED_WR_Byte(0x81,OLED_CMD); //对比度设置
OLED_WR_Byte(0xEF,OLED_CMD); //1~255;默认 0X7F (亮度设置,越大越亮)
OLED_WR_Byte(0xD9,OLED_CMD); //设置预充电周期
OLED_WR_Byte(0xf1,OLED_CMD); //[3:0],PHASE 1;[7:4],PHASE 2;
OLED_WR_Byte(0xDB,OLED_CMD); //设置 VCOMH 电压倍率
OLED_WR_Byte(0x30,OLED_CMD); //[6:4] 000,0.65*vcc;001,0.77*vcc;011,0.83*vcc;
OLED_WR_Byte(0xA4,OLED_CMD); //全局显示开启;bit0:1,开启;0,关闭;(白屏/黑屏)
OLED_WR_Byte(0xA6,OLED_CMD); //设置显示方式;bit0:1,反相显示;0,正常显示 
 
OLED_WR_Byte(0xAF,OLED_CMD); //开启显示
OLED_Clear();
}

接着，要介绍的是 OLED_Refresh_Gram 函数。我们在 STM32 内部定义了一个块 GRAM： u8 OLED_GRAM[128][8];此部分 GRAM 对应 OLED 模块上的 GRAM。在操作的时候，我们只 要修改 STM32 内部的 GRAM 就可以了，然后通过 OLED_Refresh_Gram 函数把 GRAM 一次刷 新到 OLED 的 GRAM 上。该函数代码如下：

//更新显存到 LCD
void OLED_Refresh_Gram(void)
{
u8 i,n; 
for(i=0;i<8;i++) 
{ 
OLED_WR_Byte (0xb0+i,OLED_CMD); //设置页地址（0~7）
OLED_WR_Byte (0x00,OLED_CMD); //设置显示位置—列低地址
OLED_WR_Byte (0x10,OLED_CMD); //设置显示位置—列高地址 
for(n=0;n<128;n++)OLED_WR_Byte(OLED_GRAM[n][i],OLED_DATA); 
} 
}

OLED_Refresh_Gram 函数先设置页地址，然后写入列地址（也就是纵坐标），然后从 0 开 始写入 128 个字节，写满该页，最后循环把 8 页的内容都写入，就实现了整个从 STM32 显存 到 OLED 显存的拷贝。 OLED_Refresh_Gram 函数还用到了一个外部函数，也就是我们接着要介绍的函数： OLED_WR_Byte，该函数直接和硬件相关，函数代码如下：

#if OLED_MODE==1
//向 SSD1306 写入一个字节。
//dat:要写入的数据/命令
//cmd:数据/命令标志 0,表示命令;1,表示数据;
void OLED_WR_Byte(u8 dat,u8 cmd)
{
DATAOUT(dat); 
OLED_RS=cmd;
OLED_CS=0; 
OLED_WR=0;
OLED_WR=1;
OLED_CS=1; 
OLED_RS=1;
} 
#else
//向 SSD1306 写入一个字节。
//dat:要写入的数据/命令
//cmd:数据/命令标志 0,表示命令;1,表示数据;
void OLED_WR_Byte(u8 dat,u8 cmd)
{
u8 i; 
OLED_RS=cmd; //写命令
OLED_CS=0; 
for(i=0;i<8;i++)
{ 
OLED_SCLK=0;
if(dat&0x80)OLED_SDIN=1;
else OLED_SDIN=0;
OLED_SCLK=1;
dat<<=1; 
}
OLED_CS=1; 
OLED_RS=1; 
} 
#endif

这里有 2 个一样的函数，通过宏定义 OLED_MODE 来决定使用哪一个。如果 OLED_MODE=1，就定义为并口模式，选择第一个函数，而如果为 0，则为 4 线串口模式，选 择第二个函数。这两个函数输入参数均为 2 个：dat 和 cmd，dat 为要写入的数据，cmd 则表明 该数据是命令还是数据。这两个函数的时序操作就是根据上面我们对 8080 接口以及 4 线 SPI 接口的时序来编写的。 OLED_GRAM[128][8]中的 128 代表列数（x 坐标），而 8 代表的是页，每页又包含 8 行， 总共 64 行（y 坐标）。从高到低对应行数从小到大。比如，我们要在 x=100，y=29 这个点写入 1，则可以用这个句子实现： OLED_GRAM[100][4]|=1<<2； 一个通用的在点（x，y）置 1 表达式为： OLED_GRAM[x][7-y/8]|=1<<(7-y%8)； 其中 x 的范围为：0~127；y 的范围为：0~63。 因此，我们可以得出下一个将要介绍的函数：画点函数，void OLED_DrawPoint(u8 x，u8 y， u8 t)；函数代码如下：

void OLED_DrawPoint(u8 x,u8 y,u8 t)
{
u8 pos,bx,temp=0;
if(x>127||y>63)return;//超出范围了.
pos=7-y/8;
bx=y%8;
temp=1<<(7-bx);
if(t)OLED_GRAM[x][pos]|=temp;
else OLED_GRAM[x][pos]&=~temp; 
}

该函数有 3 个参数，前两个是坐标，第三个 t 为要写入 1 还是 0。该函数实现了我们在 OLED 模块上任意位置画点的功能。

在知道了取模方式之后，我们就可以根据取模的方式来编写显示字符的代码了，这里我们 针对以上取模方式的显示字符代码如下：

//在指定位置显示一个字符,包括部分字符
//x:0~127
//y:0~63
//mode:0,反白显示;1,正常显示
//size:选择字体 12/16/24
void OLED_ShowChar(u8 x,u8 y,u8 chr,u8 size,u8 mode)
{ 
u8 temp,t,t1;
u8 y0=y;
u8 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 if(size==24)temp=asc2_2412[chr][t]; //调用 2412 字体
else return; //没有的字库
 for(t1=0;t1<8;t1++)
{
if(temp&0x80)OLED_DrawPoint(x,y,mode);
else OLED_DrawPoint(x,y,!mode);
temp<<=1;
y++;
if((y-y0)==size)
{
y=y0; x++;
break;
}
} 
 }
}

该函数为字符以及字符串显示的核心部分，函数中 chr=chr-' ';这句是要得到在字符点阵数 据里面的实际地址，因为我们的取模是从空格键开始的，例如 oled_asc2_1206[0][0]，代表的是 空格符开始的点阵码。在接下来的代码，我们也是按照从上到小(先 y++)，从左到右（再 x++） 的取模方式来编写的，先得到最高位，然后判断是写 1 还是 0，画点；接着读第二位，如此循 环，直到一个字符的点阵全部取完为止。这其中涉及到列地址和行地址的自增，根据取模方式 来理解，就不难了。 oled.c 的内容就为大家介绍到这里，接下来我们看看 oled.h 的代码：

#ifndef __OLED_H
#define __OLED_H 
#include "sys.h"
#include "stdlib.h" 
//OLED 模式设置
//0: 4 线串行模式 （模块的 BS1，BS2 均接 GND）
//1: 并行 8080 模式 （模块的 BS1，BS2 均接 VCC）
#define OLED_MODE 1
//OLED 端口定义 
#define OLED_CS PCout(9)
//#define OLED_RST PBout(14)//ÔÚMINISTM32ÉÏÖ±½Ó½Óµ½ÁËSTM32µÄ¸´Î»½Å£¡
#define OLED_RS PCout(8)
#define OLED_WR PCout(7) 
#define OLED_RD PCout(6)
//PB0~7,作为数据线
#define DATAOUT(DataValue) 
{GPIO_Write(GPIOB,(GPIO_ReadOutputData(GPIOB)&0xff00)|(DataValue&0x00FF));} 
//使用 4 线 SPI 接口时使用
#define OLED_SCLK PBout(0)
#define OLED_SDIN PBout(1) 
#define OLED_CMD 0 //写命令
#define OLED_DATA 1 //写数据
//OLED 控制用函数
void OLED_WR_Byte(u8 dat,u8 cmd); 
…… //忽略部分函数声明
void OLED_ShowString(u8 x,u8 y,const u8 *p);
#endif 

该部分比较简单，OLED_MODE 的定义也在这个文件里面，我们必须根据自己 OLED 模 块 BS1 和 BS2 的设置（目前代码仅支持 8080 和 4 线 SPI）来确定 OLED_MODE 的值。 接下来我们看看主函数代码，该部分代码如下：

int main(void)

{
u8 t=0;
delay_init(72); //延时初始化
NVIC_PriorityGroupConfig(NVIC_PriorityGroup_2);
LED_Init();
 OLED_Init(); //初始化 OLED 
 OLED_ShowString(0,0,"ALIENTEK",24); 
OLED_ShowString(0,24, "0.96' OLED TEST",16); 
OLED_ShowString(0,40,"ATOM 2014/3/7",12); 
OLED_ShowString(0,52,"ASCII:",12); 
OLED_ShowString(64,52,"CODE:",12); 
OLED_Refresh_Gram();//更新显示到 OLED
t=' '; 
while(1) 
{
OLED_ShowChar(36,52,t,12,1);//显示 ASCII 字符
OLED_ShowNum(94,52,t,3,12); //显示 ASCII 字符的码值 
OLED_Refresh_Gram();//更新显示到 OLED
t++;
if(t>'~')t=' '; 
delay_ms(500);
LED0=!LED0;
} 
}

该部分代码用于在 OLED 上显示一些字符，然后从空格键开始不停的循环显示 ASCII 字符 集，并显示该字符的 ASCII 值。然后我们编译此工程，直到编译成功为止。

检验无误就可以开始运行了。