一、模块来源
采购链接: 黄保凯中景园1.3寸OLED显示屏12864液晶屏sh1106 12864 OLED模块
资料下载链接: https://pan.baidu.com/s/1FNGHM0u5MQ2li3QOrTkTuA
资料提取码:8888
二、规格参数
工作电压:3.3V ~ 5V
工作电流:20mA
模块尺寸:33.5 x 35.4 MM
像素间距:0.23(H) x 0.23(V)
像素尺寸:0.21(H) x 0.21(V)
驱动芯片:SH1106
通信协议:SPI(可调IIC)
以上信息见厂家资料文件
三、移植过程
我们的目标是将例程移植至MSPM0G3507开发板上。按照以下步骤,即可完成移植。
- 将源码导入工程;
- 根据编译报错处进行粗改;
- 修改引脚配置;
- 修改时序配置;
- 移植验证。
1、查看资料
打开厂家资料例程(例程下载见百度网盘链接下载)。具体路径见例程路径
2、移植至工程
将厂家资料路径下的【LCD】文件夹,复制到自己的工程中。(工程可以参考入门手册工程模板)
我们打开工程文件,将我们刚刚复制到文件夹中的文件,导入C文件和路径。
将 oled.h 文件下的 sys.h 改为 board.h。
将 oled.c 文件下的 delay.h 注释。
首先分别在lcd_init.h与lcd.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、引脚选择
该屏幕需要设置8个接口,具体接口说明见 各引脚说明。
模块为SPI通信协议的从机,SCL为SPI信号线(SCK),SDA为SPI输出线(MOSI),CS为SPI片选线(NSS)。 如果MCU的GPIO引脚不足,可以将屏幕的两个引脚接口不接入MCU的GPIO。
- 将RES接入MCU的复位引脚,当MCU复位时,屏幕也跟着复位;
软件SPI移植
接下来我们配置 SYSCONFIG
- 双击 empty.syscfg 文件,打开它。
- 在 empty.syscfg 文件界面点击 Tools,然后点击 SYSCONFIG 工具。
- 点击 ADD 添加配置
- 添加配置【根据下方图片进行添加】【添加5个】
- 开始添加配置,根据引脚选择设定
- 剩下的引脚也是一样的配置
- 点击保存
WARNING
出现只要出现下面的框就一定要选择:Yes to All
- 然后点击编译(可能会报错,我们不用管!)
- 然后我们所有设定的引脚和功能就会在 ti_msp_dl_config.h 中定义。因为这个文件我们包含进了 board.h 所以我们只需要引用 board.h 即可。【这里的 board.h 就充当了芯片头文件的作用】
将 oled.c 源代码中的 void OLED_Init(void) 修改为如下代码。因为引脚已经在 SYSCONFIG 中自动配置了,不需要进行初始化了。
//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(0x02,OLED_CMD); /*set lower column address*/
OLED_WR_Byte(0x10,OLED_CMD); /*set higher column address*/
OLED_WR_Byte(0x40,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(0xcf,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(0x3F,OLED_CMD); /*duty = 1/64*/
OLED_WR_Byte(0xad,OLED_CMD); /*set charge pump enable*/
OLED_WR_Byte(0x8b,OLED_CMD); /* 0x8B 内供 VCC */
OLED_WR_Byte(0x33,OLED_CMD); /*0X30---0X33 set VPP 9V */
OLED_WR_Byte(0xC8,OLED_CMD); /*Com scan direction*/
OLED_WR_Byte(0xD3,OLED_CMD); /*set display offset*/
OLED_WR_Byte(0x00,OLED_CMD); /* 0x20 */
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); /*0x22*/
OLED_WR_Byte(0xDA,OLED_CMD); /*set COM pins*/
OLED_WR_Byte(0x12,OLED_CMD);
OLED_WR_Byte(0xdb,OLED_CMD); /*set vcomh*/
OLED_WR_Byte(0x40,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
在 oled.c 文件中将 OLED_WR_Byte 函数改为下面的样子。
void OLED_WR_Byte(u8 dat,u8 cmd)
{
u8 i;
if(cmd)
OLED_DC_Set();
else
OLED_DC_Clr();
delay_us(3);
OLED_CS_Clr();
for(i=0;i<8;i++)
{
OLED_SCL_Clr();
if(dat&0x80)
OLED_SDA_Set();
else
OLED_SDA_Clr();
delay_us(3);
OLED_SCL_Set();
delay_us(3);
dat<<=1;
}
OLED_CS_Set();
OLED_DC_Set();
delay_us(3);
}
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
将lcd_init.h中的 LCD端口定义 宏,修改为下方代码的样子。
//-----------------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_MOSI_PIN)//SDA
#define OLED_SDA_Set() DL_GPIO_setPins(OLED_PORT,OLED_MOSI_PIN)
#define OLED_RES_Clr() DL_GPIO_clearPins(OLED_PORT,OLED_RES_PIN)//RES
#define OLED_RES_Set() DL_GPIO_setPins(OLED_PORT,OLED_RES_PIN)
#define OLED_DC_Clr() DL_GPIO_clearPins(OLED_PORT,OLED_DC_PIN)//DC
#define OLED_DC_Set() DL_GPIO_setPins(OLED_PORT,OLED_DC_PIN)
#define OLED_CS_Clr() DL_GPIO_clearPins(OLED_PORT,OLED_CS_PIN)//CS
#define OLED_CS_Set() DL_GPIO_setPins(OLED_PORT,OLED_CS_PIN)
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
到这里软件SPI就移植完成了,可移步到第四节进行移植验证。
四、移植验证
在empty.c中输入代码如下:
#include "board.h"
#include <stdio.h>
#include "oled.h"
int main(void)
{
//开发板初始化
board_init();
OLED_Init(); //初始化OLED
OLED_Clear();
uint8_t t = 0;
while(1)
{
OLED_ShowString(0,0,(uint8_t *)"ABC",8,1);//6*8 “ABC”
OLED_ShowString(0,8,(uint8_t *)"ABC",12,1);//6*12 “ABC”
OLED_ShowString(0,20,(uint8_t *)"ABC",16,1);//8*16 “ABC”
OLED_ShowString(0,36,(uint8_t *)"ABC",24,1);//12*24 “ABC”
OLED_ShowString(50,8,(uint8_t *)"Num:",16,1);//12*24 “ABC”
OLED_ShowNum(90,8,t,3,16,1);
t += 1;
OLED_Refresh();
delay_ms(1000);
}
}
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
上电效果:
移植成功案例下载链接(软件SPI):