基于TI MSPM0L1306开发板的0.96寸SSD1306 OLED屏(IIC)驱动移植实战

基于TI MSPM0L1306开发板的0.96寸SSD1306 OLED屏(IIC)驱动移植实战

最近在准备电赛项目，用上了TI的MSPM0L1306开发板，需要一个轻量级的显示模块来输出调试信息或者简单的用户界面。0.96寸的OLED屏（SSD1306驱动，IIC接口）是个绝佳的选择，它体积小、功耗低、显示清晰，关键是网上有大量现成的驱动代码。

但问题来了，网上找到的驱动代码大多是针对STM32或者51单片机的，直接搬到MSPM0平台上编译一堆错误，根本跑不起来。别急，这篇文章就是来帮你解决这个问题的。我会手把手带你，把一份通用的SSD1306 OLED驱动代码，完整地移植到你的TI MSPM0L1306开发板上。整个过程就像拼乐高，咱们一步步来，保证你能点亮屏幕，显示“Hello World”。

1. 准备工作：认识你的屏幕和资料

在动手写代码之前，咱们得先搞清楚手头的“家伙事儿”是什么。

1.1 屏幕模块简介

我用的这块屏是市面上非常常见的0.96寸OLED模块，核心信息如下：

• 驱动芯片：SSD1306。这是屏幕的“大脑”，我们所有指令都是发给它的。
• 通信接口：IIC（也叫I2C）。这是一种只需要两根线（时钟线SCL和数据线SDA）的串行通信协议，非常节省单片机引脚。
• 分辨率：128 x 64 像素。别看是单色，显示字符和简单图形足够了。
• 工作电压：3.3V。这一点非常重要，MSPM0L1306开发板的IO口也是3.3V电平，可以直接连接，无需电平转换。
• 引脚：4个（VCC, GND, SCL, SDA）。接线非常简单。

1.2 获取原始驱动资料

移植的起点是一份能正常工作的驱动代码。通常屏幕卖家会提供资料包，里面包含针对常见单片机（如STM32）的示例程序。

提示：你可以使用自己手头的任何一份SSD1306的IIC驱动代码，移植思路是通用的。本文以一份典型的驱动为例进行讲解。

拿到资料后，重点关注这两个文件夹/文件：

1. LCD或OLED文件夹：里面通常包含oled.c和oled.h这两个核心文件，实现了屏幕初始化、画点、显示字符等功能。
2. delay相关文件：驱动里可能会用到微秒级延时函数。

我们的任务就是让oled.c和oled.h能在MSPM0的工程里愉快地编译和运行。

2. 移植第一步：工程搭建与初步修改

咱们先创建一个干净的MSPM0工程，或者使用你现有的项目。然后把屏幕驱动文件加进去。

2.1 导入驱动文件

1. 在你的MSPM0工程目录下（例如和main.c同级），新建一个文件夹，比如叫OLED。
2. 将资料包里的oled.c和oled.h文件复制到这个OLED文件夹里。
3. 在Code Composer Studio (CCS)或你使用的IDE中，将这两个文件添加到你的工程，并设置好头文件包含路径，让编译器能找到它们。

2.2 解决头文件依赖（第一个坑）

原始的驱动代码为了通用，可能会包含一些其他平台的头文件，我们需要把它们替换成MSPM0对应的。

打开oled.h文件，你可能会看到类似这样的代码：

#include “sys.h”

在MSPM0的SDK例程中，通常用一个board.h来集中管理板级支持包。所以我们需要修改它：

#include “board.h” // 替换掉原来的 sys.h

接着，打开oled.c文件，查找是否包含了delay.h。原始的延时函数我们需要用MSPM0 SDK提供的来替代，所以先注释掉这行：

// #include “delay.h” // 暂时注释掉，后面我们用自己的延时

2.3 处理数据类型定义（第二个坑）

很多从51或STM32移植过来的代码会使用u8，u16，u32这样的简短类型定义。我们需要在oled.h文件的合适位置（通常在文件开头#include之后）补充上这些定义，确保与MSPM0 SDK的类型一致。

#ifndef u8 #define u8 uint8_t #endif #ifndef u16 #define u16 uint16_t #endif #ifndef u32 #define u32 uint32_t #endif

这样，当驱动代码中使用u8时，就会被替换成MSPM0 SDK标准的uint8_t类型。

做完以上几步，先编译一下工程。如果之前的头文件依赖问题都解决了，你应该能通过编译，或者只留下一些关于引脚未定义的错误。这很正常，因为我们还没告诉程序SCL和SDA引脚接在哪里。

3. 移植核心：配置IIC引脚与底层时序

这是移植最关键的一步，我们要用MSPM0的GPIO来模拟IIC的时序（即软件IIC）。为什么用模拟？因为简单、灵活，不依赖特定的硬件IIC外设，移植成功率最高。

3.1 使用SysConfig图形化配置引脚

TI的MSPM0 SDK推荐使用SysConfig工具来配置引脚，非常直观。

1. 在CCS工程中，双击打开*.syscfg文件（例如empty.syscfg）。
2. 在打开的界面中，点击Add按钮添加配置。
3. 我们需要添加两个GPIO配置项，分别对应SCL（时钟线）和SDA（数据线）。
4. 在配置项中，为你选择的两个GPIO引脚（例如PA14和PA15）分别设置一个易记的“Instance Name”，比如OLED_SCL和OLED_SDA。方向（Direction）都选择输出（Output），因为初始状态下，主机需要控制这两根线都为高电平。
5. 配置完成后，点击保存。系统会提示生成代码，选择Yes to All。
6. 保存后，SysConfig会自动在ti_msp_dl_config.h文件中生成对应的引脚宏定义，例如CONFIG_OLED_SCL_GPIO和CONFIG_OLED_SDA_GPIO。而这个头文件通常已经被board.h所包含。

3.2 修改驱动的引脚控制宏

现在我们需要修改oled.h中的引脚控制宏定义，让它们指向我们刚刚配置的MSPM0 GPIO。

找到原来定义SCL和SDA高低电平宏的地方（可能如下所示），将其替换：

//-----------------OLED端口定义---------------- #define OLED_SCL_Clr() DL_GPIO_clearPins(CONFIG_OLED_SCL_GPIO) // SCL拉低 #define OLED_SCL_Set() DL_GPIO_setPins(CONFIG_OLED_SCL_GPIO) // SCL拉高 #define OLED_SDA_Clr() DL_GPIO_clearPins(CONFIG_OLED_SDA_GPIO) // SDA拉低 #define OLED_SDA_Set() DL_GPIO_setPins(CONFIG_OLED_SDA_GPIO) // SDA拉高

DL_GPIO_clearPins和DL_GPIO_setPins是MSPM0 SDK提供的GPIO操作函数，非常直观。

注意：有些驱动还会定义OLED_RES复位引脚。如果你的屏幕模块有复位引脚且接到了MCU，也需要用同样方式配置和定义。如果模块自身能上电复位，或者你手动接高电平了，就可以像示例中那样注释掉相关代码。

3.3 适配IIC延时函数（时序的关键）

IIC通信对时序有严格要求，SCL时钟的高低电平需要维持一定时间。原始驱动里的IIC_delay()函数就是干这个的。

在oled.c文件中找到void IIC_delay(void)函数。我们需要用MSPM0 SDK的精确延时函数来替换它。

首先，确保你的工程包含了延时函数，通常SDK会提供delay_us()。然后修改该函数：

/********************************************************** * 函 数 名 称：IIC_delay * 函 数 功 能：IIC通信时序延时 * 传 入 参 数：无 * 函 数 返 回：无 **********************************************************/ void IIC_delay(void) { delay_us(10); // 延时10微秒，这是一个常用值，如果通信不稳定可以调整 }

这个delay_us(10)意味着每次拉高或拉低SCL/SDA后，都等待10微秒，以满足SSD1306芯片的时序要求。如果后续发现屏幕显示不正常，可以尝试微调这个值（比如5us, 20us）。

4. 上电测试：让屏幕亮起来

所有代码修改完毕，是时候接上线，看看成果了。

4.1 硬件连接

请确保你的开发板和OLED模块正确连接：

• VCC-> 开发板3.3V
• GND-> 开发板GND
• SCL-> 开发板你配置的SCL引脚（如PA14）
• SDA-> 开发板你配置的SDA引脚（如PA15）

4.2 编写测试代码

在你的主函数（例如empty.c的main()）中，添加以下测试代码：

#include “board.h” #include “oled.h” // 包含我们移植好的驱动头文件 int main(void) { // 开发板初始化（时钟、延时等） board_init(); // 初始化OLED屏幕 OLED_Init(); // 清屏，清除可能存在的乱码 OLED_Clear(); while(1) { // 在屏幕不同位置，以不同大小显示“ABC” OLED_ShowString(0, 0, (uint8_t *)“Hello MSPM0!”, 8, 1); // 6x8字体 OLED_ShowString(0, 16, (uint8_t *)“OLED Test”, 16, 1); // 8x16字体 // 更新显示到屏幕 OLED_Refresh(); // 延时一段时间 delay_ms(1000); // 可以添加清屏或显示其他内容进行动态测试 // OLED_Clear(); } }

4.3 编译、下载与调试

1. 编译工程：确保0错误，0警告。
2. 连接开发板并下载程序。
3. 上电观察：如果一切顺利，你的OLED屏幕应该会亮起，并显示“Hello MSPM0!”和“OLED Test”这两行字。

如果屏幕没反应，别慌，按以下步骤排查：

1. 检查硬件：确保电源和接线绝对正确且接触良好。这是最常见的问题。
2. 检查引脚配置：回头核对SysConfig里配置的引脚，和实际接线、代码里的宏定义是否三者一致。
3. 检查IIC地址：大部分0.96寸OLED的IIC地址是0x78（写地址）或0x7A，驱动代码里通常已经写好。极少数可能是0x3C。如果你的驱动需要修改，请在oled.h中查找OLED_ADDRESS或SLAVE_ADDRESS这样的宏。
4. 调整延时：尝试增大或减小IIC_delay()函数中的delay_us()参数。时序太快或太慢都可能导致通信失败。
5. 逻辑分析仪抓波形：这是终极调试手段。用逻辑分析仪连接SCL和SDA，看看单片机是否发出了正确的IIC起始信号、地址和数据。这是定位软件IIC时序问题最直接的方法。

当屏幕上如期出现你想要的字符时，恭喜你！你已经成功将SSD1306 OLED驱动移植到了MSPM0L1306平台。接下来，你就可以利用驱动库里丰富的函数（如画点、画线、显示汉字、图片等）去实现更复杂的显示功能了。