一、模块来源
采购链接: 0.91寸OLED显示屏12832液晶屏显串口屏iic接口屏i2cssd1306
资料下载链接: https://pan.baidu.com/s/1fKmD5lr4bA0WB54ukonI-A
资料提取码:1111
二、规格参数
工作电压:3~5V
工作电流:最大16mA
模块尺寸:12(H) x 38(V) MM
像素大小:128(H) x 32(V)
驱动芯片:SSD1306
通信协议:IIC
以上信息见厂家资料文件
三、移植过程
我们的目标是将例程移植至开发板上。按照以下步骤,即可完成移植。
- 将源码导入工程;
- 根据编译报错处进行粗改;
- 修改引脚配置;
- 修改时序配置;
- 移植验证。
1、查看资料
打开厂家资料例程(例程下载见百度网盘链接下载)。具体路径见例程路径
2、移植至工程
将厂家资料路径下的【OLED】文件夹,复制到自己的工程中的BSP文件夹中。(工程可以参考入门手册工程模板)
我们打开工程文件,将我们刚刚复制到文件夹中的文件,导入C文件和路径。
将oled.h文件下的 sys.h 改为 board.h。
TIP
(在左边将 oled.h 的工程目录展开,就发现有 oled.h )
将 oled.c 中的 delay.h 注释掉
首先分别在oled.h文件中定义三个宏,u32、u16与u8。
#ifndef u8
#define u8 uint8_t
#endif
#ifndef u16
#define u16 uint16_t
#endif
#ifndef u32
#define u32 uint32_t
#endif
2
3
4
5
6
7
8
9
10
11
3、引脚选择
模块为IIC通信协议的从机,SCL为IIC信号线,SDA为IIC数据线。
软件SPI移植
接下来我们配置 SYSCONFIG
- 双击 empty.syscfg 文件,打开它。
- 在 empty.syscfg 文件界面点击 Tools,然后点击 SYSCONFIG 工具。
- 点击 ADD 添加配置
- 添加配置【根据下方图片进行添加】【添加2个】
- 开始添加配置,根据引脚选择设定
剩下的引脚也是一样的配置
点击保存
WARNING
出现只要出现下面的框就一定要选择:Yes to All
- 然后点击编译(可能会报错,我们不用管!)
- 然后我们所有设定的引脚和功能就会在 ti_msp_dl_config.h 中定义。因为这个文件我们包含进了 board.h 所以我们只需要引用 board.h 即可。【这里的 board.h 就充当了芯片头文件的作用】
选择好引脚后,进入工程开始修改初始化代码。
将 oled.c 源代码中的 void OLED_Init(void) 修改为如下代码。
//OLED的初始化
void OLED_Init(void)
{
// OLED_RES_Clr();
delay_ms(200);
// OLED_RES_Set();
OLED_WR_Byte(0xAE,OLED_CMD); /*display off*/
OLED_WR_Byte(0x00,OLED_CMD); /*set lower column address*/
OLED_WR_Byte(0x10,OLED_CMD); /*set higher column address*/
OLED_WR_Byte(0x00,OLED_CMD); /*set display start line*/
OLED_WR_Byte(0xB0,OLED_CMD); /*set page address*/
OLED_WR_Byte(0x81,OLED_CMD); /*contract control*/
OLED_WR_Byte(0xff,OLED_CMD); /*128*/
OLED_WR_Byte(0xA1,OLED_CMD); /*set segment remap*/
OLED_WR_Byte(0xA6,OLED_CMD); /*normal / reverse*/
OLED_WR_Byte(0xA8,OLED_CMD); /*multiplex ratio*/
OLED_WR_Byte(0x1F,OLED_CMD); /*duty = 1/32*/
OLED_WR_Byte(0xC8,OLED_CMD); /*Com scan direction*/
OLED_WR_Byte(0xD3,OLED_CMD); /*set display offset*/
OLED_WR_Byte(0x00,OLED_CMD);
OLED_WR_Byte(0xD5,OLED_CMD); /*set osc division*/
OLED_WR_Byte(0x80,OLED_CMD);
OLED_WR_Byte(0xD9,OLED_CMD); /*set pre-charge period*/
OLED_WR_Byte(0x1f,OLED_CMD);
OLED_WR_Byte(0xDA,OLED_CMD); /*set COM pins*/
OLED_WR_Byte(0x00,OLED_CMD);
OLED_WR_Byte(0xdb,OLED_CMD); /*set vcomh*/
OLED_WR_Byte(0x40,OLED_CMD);
OLED_WR_Byte(0x8d,OLED_CMD); /*set charge pump enable*/
OLED_WR_Byte(0x14,OLED_CMD);
OLED_Clear();
OLED_WR_Byte(0xAF,OLED_CMD); /*display ON*/
}
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
因为引脚已经在 SYSCONFIG 中自动配置了,不需要进行初始化了。
将oled.h中的 OLED端口定义 宏,修改为下方代码框中的代码。
//-----------------OLED端口定义----------------
#define OLED_SCL_Clr() DL_GPIO_clearPins(OLED_PORT,OLED_SCL_PIN)//SCL
#define OLED_SCL_Set() DL_GPIO_setPins(OLED_PORT,OLED_SCL_PIN)
#define OLED_SDA_Clr() DL_GPIO_clearPins(OLED_PORT,OLED_SDA_PIN)//DIN
#define OLED_SDA_Set() DL_GPIO_setPins(OLED_PORT,OLED_SDA_PIN)
//#define OLED_RES_Clr() GPIO_ResetBits(GPIOD,GPIO_Pin_4)//RES
//#define OLED_RES_Set() GPIO_SetBits(GPIOD,GPIO_Pin_4)
2
3
4
5
6
7
8
9
10
打开 oled.c 文件,找到 void IIC_delay(void) 函数,修改为:
//延时
void IIC_delay(void)
{
delay_us(4);
}
2
3
4
5
到这里软件SPI就移植完成了,可移步到第四节进行移植验证。
四、移植验证
在empty.c中输入代码如下:
#include "board.h"
#include <stdio.h>
#include "oled.h"
int main(void)
{
board_init();
OLED_Init(); //初始化OLED
OLED_Clear();
OLED_Refresh();
while(1)
{
OLED_ShowString(0,0,(uint8_t *)"ABC",8,1);//6*8 “ABC”
OLED_ShowString(10,8,(uint8_t *)"ABC",12,1);//6*12 “ABC”
OLED_ShowString(20,18,(uint8_t *)"ABC",16,1);//8*16 “ABC”
OLED_ShowString(60,36,(uint8_t *)"ABC",24,1);//12*24 “ABC”
OLED_Refresh();
delay_ms(500);
}
}
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
上电效果:
代码下载
链接在开发板介绍
章节的离线资料下载!!