一、模块来源
采购链接： 0.96寸OLED显示屏12864液晶屏模块IIC显示屏ssd1306 12864oled
资料下载链接： https://pan.baidu.com/s/1xy2zH8-hs-S8-_AcVtBP_g
资料提取码：0jhj
二、规格参数
工作电压：3.3V
工作电流：9MA
模块尺寸：27.3 x 27.8 MM
像素大小：128(H) x 64(V)RGB
驱动芯片：SSD1306
通信协议：IIC
管脚数量：4 Pin（2.54mm间距排针）
以上信息见厂家资料文件
三、移植过程
我们的目标是将例程移植至MSPM0G3507开发板上。按照以下步骤，即可完成移植。
- 将源码导入工程；
- 根据编译报错处进行粗改；
- 修改引脚配置；
- 修改时序配置；
- 移植验证。
1、查看资料
打开厂家资料例程（例程下载见百度网盘链接下载）。具体路径见例程路径
2、移植至工程
将厂家资料路径下的【OLED】文件夹，复制到自己的工程中的BSP文件夹中。（工程可以参考入门手册工程模板）
我们打开工程文件，将我们刚刚复制到文件夹中的文件，导入C文件和路径。
将oled.h文件下的 sys.h 改为 board.h。
TIP
(在左边将 oled.h 的工程目录展开，就发现有 oled.h )
将 oled.c 中的 delay.h 注释掉
3、引脚选择
该屏幕需要设置4个接口，具体接口说明见 各引脚说明。
模块为IIC通信协议的从机，SCL为IIC信号线，SDA为IIC数据线。
硬件IIC移植
| GND | GND |
| VCC | 3.3V |
| SCL | PA1 |
| SDA | PA0 |
接下来我们配置 SYSCONFIG
- 双击 empty.syscfg 文件，打开它。
- 添加配置【根据下方图片进行添加】【添加3个】
- 点击 ADD 添加IIC配置
- 配置IIC
Ctrl + S保存配置文件然后点击编译（可能会报错，我们不用管！）
- 然后我们所有设定的引脚和功能就会在 ti_msp_dl_config.h 中定义。因为这个文件我们包含进了 board.h 所以我们只需要引用 board.h 即可。【这里的 board.h 就充当了芯片头文件的作用】
选择好引脚后，进入工程开始编写屏幕引脚初始化代码。
我们注释掉 oled.h中的 OLED 端口定义
开始修改屏幕引脚初始化代码。
c
//OLED的初始化
void OLED_Init(void)
{
OLED_WR_Byte(0xAE,OLED_CMD);//--turn off oled panel
OLED_WR_Byte(0x00,OLED_CMD);//---set low column address
OLED_WR_Byte(0x10,OLED_CMD);//---set high column address
OLED_WR_Byte(0x40,OLED_CMD);//--set start line address Set Mapping RAM Display Start Line (0x00~0x3F)
OLED_WR_Byte(0x81,OLED_CMD);//--set contrast control register
OLED_WR_Byte(0xCF,OLED_CMD);// Set SEG Output Current Brightness
OLED_WR_Byte(0xA1,OLED_CMD);//--Set SEG/Column Mapping 0xa0左右反置 0xa1正常
OLED_WR_Byte(0xC8,OLED_CMD);//Set COM/Row Scan Direction 0xc0上下反置 0xc8正常
OLED_WR_Byte(0xA6,OLED_CMD);//--set normal display
OLED_WR_Byte(0xA8,OLED_CMD);//--set multiplex ratio(1 to 64)
OLED_WR_Byte(0x3f,OLED_CMD);//--1/64 duty
OLED_WR_Byte(0xD3,OLED_CMD);//-set display offset Shift Mapping RAM Counter (0x00~0x3F)
OLED_WR_Byte(0x00,OLED_CMD);//-not offset
OLED_WR_Byte(0xd5,OLED_CMD);//--set display clock divide ratio/oscillator frequency
OLED_WR_Byte(0x80,OLED_CMD);//--set divide ratio, Set Clock as 100 Frames/Sec
OLED_WR_Byte(0xD9,OLED_CMD);//--set pre-charge period
OLED_WR_Byte(0xF1,OLED_CMD);//Set Pre-Charge as 15 Clocks & Discharge as 1 Clock
OLED_WR_Byte(0xDA,OLED_CMD);//--set com pins hardware configuration
OLED_WR_Byte(0x12,OLED_CMD);
OLED_WR_Byte(0xDB,OLED_CMD);//--set vcomh
OLED_WR_Byte(0x40,OLED_CMD);//Set VCOM Deselect Level
OLED_WR_Byte(0x20,OLED_CMD);//-Set Page Addressing Mode (0x00/0x01/0x02)
OLED_WR_Byte(0x02,OLED_CMD);//
OLED_WR_Byte(0x8D,OLED_CMD);//--set Charge Pump enable/disable
OLED_WR_Byte(0x14,OLED_CMD);//--set(0x10) disable
OLED_WR_Byte(0xA4,OLED_CMD);// Disable Entire Display On (0xa4/0xa5)
OLED_WR_Byte(0xA6,OLED_CMD);// Disable Inverse Display On (0xa6/a7)
OLED_Clear();
OLED_WR_Byte(0xAF,OLED_CMD);
}打开 oled.c 文件 找到 void IIC_delay(void) 函数，将里面的内容替换为下方代码。
c
/**********************************************************
* 函 数 名 称：IIC_delay
* 函 数 功 能：延时
* 传 入 参 数：无
* 函 数 返 回：无
* 作 者：www.lckfb.com
* 备 注：
**********************************************************/
void IIC_delay(void)
{
delay_us(10);
}删掉 oled.c 和 oled.h 中的 I2C_Start、I2C_Stop、I2C_WaitAck、Send_Byte 函数。
修改 OLED_WR_Byte 函数为下面的代码：
c
//发送一个字节
//mode:数据/命令标志 0,表示命令;1,表示数据;
void OLED_WR_Byte(u8 dat,u8 mode)
{
uint16_t i;
uint8_t Send_Buff[5] = {0};
uint8_t SendData_Count = 2;
if(mode)
Send_Buff[0] = 0x40;
else
Send_Buff[0] = 0x00;
Send_Buff[1] = dat;
DL_I2C_fillControllerTXFIFO(I2C_OLED_INST, Send_Buff, SendData_Count);
while (!(DL_I2C_getControllerStatus(I2C_OLED_INST) & DL_I2C_CONTROLLER_STATUS_IDLE));
DL_I2C_startControllerTransfer(I2C_OLED_INST, 0x3C, DL_I2C_CONTROLLER_DIRECTION_TX, SendData_Count);
}修改 OLED_Refresh 函数为下面的代码：
c
void OLED_Refresh(void)
{
u8 i,n;
for(i=0;i<8;i++)
{
OLED_WR_Byte(0xb0+i,OLED_CMD); //设置行起始地址
OLED_WR_Byte(0x00,OLED_CMD); //设置低列起始地址
OLED_WR_Byte(0x10,OLED_CMD); //设置高列起始地址
OLED_WR_Byte(0x40,OLED_DATA);
for(n=0;n<128;n++)
{
OLED_WR_Byte(OLED_GRAM[n][i], OLED_DATA);
}
}
}到这里就移植完成了，可移步到第四节进行移植验证。
四、移植验证
在empty.c中输入代码如下:
c
#include "ti_msp_dl_config.h"
#include "board.h"
#include "oled.h"
#include "bmp.h"
int main(void)
{
SYSCFG_DL_init();
// 串口输出测试
lc_printf("Hello %s\r\n","World");
// 日志输出测试
LOG_D("Log Debug Test....%s", "LCKFB");
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模块移植代码：【点击跳转🚀】