一、模块来源
采购链接： 黄保凯中景园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、移植至工程
将厂家资料路径下的【OLED】文件夹，复制到自己的工程中。（工程可以参考入门手册工程模板）
我们打开工程文件，将我们刚刚复制到文件夹中的文件，导入C文件和路径。
将 oled.h 文件下的 sys.h 改为 board.h。
将 oled.c 文件下的 delay.h 注释。
3、引脚选择
该屏幕需要设置8个接口，具体接口说明见 各引脚说明。
模块为SPI通信协议的从机，SCL为SPI信号线（SCK），SDA为SPI输出线（MOSI），CS为SPI片选线（NSS）。 如果MCU的GPIO引脚不足，可以将屏幕的两个引脚接口不接入MCU的GPIO。
- 将RES接入MCU的复位引脚，当MCU复位时，屏幕也跟着复位；
硬件SPI移植
| GND | GND |
| VCC | 3.3V |
| SCL | PB9 |
| SDA | PB8 |
| RES | PB10 |
| DC | PB11 |
| CS | PB14 |
接下来我们配置 SYSCONFIG
- 双击 empty.syscfg 文件，打开它。
- 点击 ADD 添加GPIO配置
- 添加配置【根据下方图片进行添加】【添加3个】
- 开始添加配置，根据引脚选择设定
- 剩下的引脚也是一样的配置
- 点击ADD添加SPI配置
- 配置SPI
Ctrl + S保存配置文件然后点击编译（可能会报错，我们不用管！）
- 然后我们所有设定的引脚和功能就会在 ti_msp_dl_config.h 中定义。因为这个文件我们包含进了 board.h 所以我们只需要引用 board.h 即可。【这里的 board.h 就充当了芯片头文件的作用】
选择好引脚后，进入工程开始编写屏幕引脚初始化代码。
我们更改oled.h中的LCD端口定义
c
//-----------------OLED端口定义----------------
#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)OLED_Init 见如下代码。因为引脚已经在 SYSCONFIG 中自动配置了，不需要进行初始化了。
c
//OLED的初始化
void OLED_Init(void)
{
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*/
}将 oled.c 中的 OLED_WR_Byte 函数替换成下面的代码：
c
void OLED_WR_Byte(u8 dat,u8 cmd)
{
uint8_t recv_data = 0;
if(cmd)
OLED_DC_Set();
else
OLED_DC_Clr();
OLED_CS_Clr();
//发送数据
DL_SPI_transmitData8(SPI_LCD_INST, dat);
//等待SPI总线空闲
while(DL_SPI_isBusy(SPI_LCD_INST));
//接收数据
recv_data = DL_SPI_receiveData8(SPI_LCD_INST);
//等待SPI总线空闲
while(DL_SPI_isBusy(SPI_LCD_INST));
OLED_CS_Set();
OLED_DC_Set();
}到这里就移植完成了，可移步到第四节进行移植验证。
四、移植验证
在empty.c中输入代码如下:
c
#include "ti_msp_dl_config.h"
#include "board.h"
#include "oled.h"
#include "bmp.h"
int main(void)
{
SYSCFG_DL_init();
u8 t=' ';
OLED_Init();
OLED_ColorTurn(0);//0正常显示，1 反色显示
OLED_DisplayTurn(0);//0正常显示 1 屏幕翻转显示
while(1)
{
OLED_ShowPicture(0,0,128,64,BMP1,1);
OLED_Refresh();
delay_ms(500);
OLED_Clear();
OLED_ShowChinese(0,0,0,16,1);//中
OLED_ShowChinese(18,0,1,16,1);//景
OLED_ShowChinese(36,0,2,16,1);//园
OLED_ShowChinese(54,0,3,16,1);//电
OLED_ShowChinese(72,0,4,16,1);//子
OLED_ShowChinese(90,0,5,16,1);//技
OLED_ShowChinese(108,0,6,16,1);//术
OLED_ShowString(8,16,"ZHONGJINGYUAN",16,1);
OLED_ShowString(20,32,"2014/05/01",16,1);
OLED_ShowString(0,48,"ASCII:",16,1);
OLED_ShowString(63,48,"CODE:",16,1);
OLED_ShowChar(48,48,t,16,1);//显示ASCII字符
t++;
if(t>'~')t=' ';
OLED_ShowNum(103,48,t,3,16,1);
OLED_Refresh();
delay_ms(500);
OLED_Clear();
OLED_ShowChinese(0,0,0,16,1); //16*16 中
OLED_ShowChinese(16,0,0,24,1); //24*24 中
OLED_ShowChinese(24,20,0,32,1);//32*32 中
OLED_ShowChinese(64,0,0,64,1); //64*64 中
OLED_Refresh();
delay_ms(500);
OLED_Clear();
OLED_ShowString(0,0,"ABC",8,1);//6*8 “ABC”
OLED_ShowString(0,8,"ABC",12,1);//6*12 “ABC”
OLED_ShowString(0,20,"ABC",16,1);//8*16 “ABC”
OLED_ShowString(0,36,"ABC",24,1);//12*24 “ABC”
OLED_Refresh();
delay_ms(500);
OLED_ScrollDisplay(11,4,1);
}
}然后编译，调试烧录。
不知道如何操作的可以去看CCS的入门手册
【代码下载】
- 跳转到
下载中心去下载CCS模块移植代码：【点击跳转🚀】