TI C2000 TMS320F28P550开发板驱动0.96寸IIC OLED屏幕移植与显示实战

TI C2000 TMS320F28P550开发板驱动0.96寸IIC OLED屏幕移植与显示实战最近在做一个基于TI C2000 DSP的小项目需要一个小巧的显示屏来显示一些参数和状态。0.96寸的OLED屏是个不错的选择它体积小、功耗低、显示清晰而且通过IIC接口连接只需要两根数据线非常节省IO口。但网上找到的驱动代码大多是针对STM32这类ARM单片机的怎么把它移植到TI的TMS320F28P550这款DSP开发板上呢这个坑我踩过今天就把完整的移植过程和实战经验分享给大家手把手教你从零开始点亮这块屏幕。1. 准备工作认识你的屏幕和开发板在开始写代码之前咱们得先搞清楚手头的“家伙事儿”是什么。1.1 0.96寸OLED屏幕这次要驱动的是一块非常常见的0.96寸OLED显示屏核心信息如下驱动芯片SSD1306。这是市面上绝大多数小尺寸单色OLED屏的“大脑”负责管理屏幕上的每一个像素点。通信协议IIC也叫I²C。这是一种只需要两根线时钟线SCL和数据线SDA的串行通信方式非常适合连接这种简单的外设。分辨率128 x 64。横向有128个像素纵向有64个像素。工作电压3.3V。这一点非常重要一定要接3.3V接5V可能会烧坏屏幕接口4个引脚2.54mm间距排针分别是GND电源地。VCC电源正极3.3V。SCLIIC时钟线。SDAIIC数据线。这块屏幕本身是“从机”我们的开发板作为“主机”通过IIC协议向它发送命令和数据来控制显示。1.2 TI TMS320F28P550开发板我们使用的平台是TI的C2000系列DSP开发板主控是TMS320F28P550。C2000系列在电机控制、数字电源等领域非常强大。对于这个项目我们主要用到它的GPIO通用输入输出功能来模拟IIC的时序。2. 移植第一步获取驱动源码并导入工程网上有很多现成的SSD1306驱动代码我们不需要从头写。我的做法是找一个经过验证的、代码结构清晰的驱动库然后把它“搬”到我们的工程里。找到驱动源码你可以从提供的资料链接下载或者从熟悉的开源平台如GitHub搜索“SSD1306”或“OLED IIC”找到适用于C语言的驱动。通常它会包含几个核心文件oled.c、oled.h、oledfont.h字库文件。导入工程在你的CCSCode Composer Studio工程目录下新建一个文件夹比如叫OLED把下载到的oled.c、oled.h、oledfont.h这三个文件复制进去。在CCS中添加文件路径在项目上右键选择Properties。找到Build-C2000 Compiler-Include Options。在Add dir to #include search path中添加你刚才创建的OLED文件夹的路径。这样编译器才能找到我们的头文件。添加源文件在CCS的工程浏览器里右键点击你的工程选择Add Files...把oled.c和oledfont.h添加到工程中。注意原始驱动代码里可能包含了针对其他平台的头文件比如#include “sys.h”或#include “delay.h”。我们需要根据F28P550的环境进行修改。例如把sys.h替换成我们开发板对应的初始化头文件根据原文提示可能是tjx_init.h而delay.h可能需要根据实际情况注释掉或替换。3. 硬件连接与引脚配置代码搬过来了接下来要把屏幕和开发板物理上连起来并在软件里告诉开发板用哪两个脚来通信。3.1 接线按照下面的对应关系用杜邦线连接好OLED屏幕引脚开发板引脚GND任意GND引脚VCC3.3V电源引脚SCLGPIO51SDAGPIO50这里我们选择GPIO51和GPIO50你可以根据自己板子的空闲情况选择其他GPIO但后续代码也要相应修改。3.2 使用SysConfig图形化配置引脚TI的C2000系列现在推荐使用SysConfig工具来配置外设和引脚非常直观。在CCS工程中找到c2000.syscfg文件双击打开。在界面中找到GPIO的配置部分点击ADD添加一个GPIO配置集。找到GPIO50和GPIO51将它们配置为普通的数字输出引脚Digital Output。因为我们要用软件模拟IIC时序所以不需要配置成硬件IIC外设模式。按下Ctrl S保存配置。按下Ctrl B编译工程。这时SysConfig会自动根据你的图形化配置生成对应的board.h等底层代码。你可能会看到一些编译警告暂时不用管只要没有阻碍编译的错误就行。完成这步后在代码中就可以通过GPIO_writePin()这样的函数来控制GPIO50和GPIO51的电平高低了。4. 驱动代码适配与修改这是移植的核心部分我们需要修改驱动代码让它能在F28P550上运行。4.1 修改引脚控制宏定义打开oled.h文件找到引脚控制的宏定义部分。我们需要把原来针对其他芯片的GPIO操作函数改成F28P550的。原来的代码可能是这样的#define OLED_SCL_Clr() GPIO_ResetBits(GPIOB, GPIO_Pin_8) //STM32的写法 #define OLED_SCL_Set() GPIO_SetBits(GPIOB, GPIO_Pin_8)要修改成适应我们开发板的写法。根据原文和SysConfig生成的代码风格修改如下//-----------------OLED端口定义---------------- #define OLED_SCL_Clr() GPIO_writePin(SCREEN_SCL, 0) //SCL置低 #define OLED_SCL_Set() GPIO_writePin(SCREEN_SCL, 1) //SCL置高 #define OLED_SDA_Clr() GPIO_writePin(SCREEN_SDA, 0) //SDA置低 #define OLED_SDA_Set() GPIO_writePin(SCREEN_SDA, 1) //SDA置高 // 如果你的屏幕有RESET引脚也需要定义本例中IIC屏通常不需要 // #define OLED_RES_Clr() ... // #define OLED_RES_Set() ...这里SCREEN_SCL和SCREEN_SDA需要在别处定义或者直接替换成具体的引脚编号比如51和50。更规范的做法是在board.h或你自己的配置头文件里定义#define SCREEN_SCL 51 #define SCREEN_SDA 504.2 修改延时函数IIC通信对时序有要求驱动里会有一个微秒级的延时函数IIC_delay。在oled.c中找到这个函数。原来的延时可能是基于循环空跑我们需要替换成F28P550可用的精确延时。如果你有基于系统时钟的delay_us()函数直接调用它。例如void IIC_delay(void) { delay_us(10); // 延时10微秒具体时间可根据IIC速度调整 }如果还没有微秒延时函数你需要实现一个。一个简单但不精确的方法是用空循环但更推荐使用DSP的定时器或CPU周期计数器例如__delay_cycles()内置函数来实现。4.3 检查并替换头文件确保oled.c和oled.h中包含的头文件是有效的。通常需要包含// 在 oled.c 顶部 #include “oled.h” #include “board.h” // 或你的引脚定义头文件如 tjx_init.h #include “driverlib.h” // TI DriverLib库用于GPIO操作根据原文提示如果工程已经包含了tjx_init.h并且这个头文件里包含了芯片相关的定义那么可能就不需要再包含board.h了。5. 核心驱动代码解析与调用驱动修改好后我们来了解一下最关键的几个函数并看看如何在主程序中使用。5.1 初始化函数OLED_Init()这个函数最重要它通过一系列IIC命令来配置SSD1306驱动芯片。这些命令设置了对比度、扫描方向、起始行、显示模式等。通常这部分代码不需要修改除非你有特殊的显示需求比如翻转显示。函数末尾的OLED_Clear()和0xAF命令分别是清屏和开启显示。5.2 基础显示函数驱动库提供了丰富的显示功能我们挑几个最常用的OLED_Clear()清空整个屏幕。OLED_ShowChar(x, y, chr, size, mode)在指定坐标(x,y)显示一个字符。x, y起始坐标左上角为(0,0)。chr要显示的字符。size字体大小例如8, 12, 16, 24。mode0-反色显示黑底白字1-正常显示白底黑字。OLED_ShowString(x, y, *str, size, mode)显示一串字符。OLED_ShowChinese(x, y, num, size, mode)显示一个汉字。num是汉字在字库数组Hzk1、Hzk2等中的索引号。OLED_ShowPicture(x, y, sizex, sizey, BMP[], mode)显示一张位图。BMP[]是一个数组包含了图像的位数据。关键一步所有上述画图、写字函数都只是在内存中的一个叫OLED_GRAM的数组里操作。要想真正让内容显示在屏幕上必须调用OLED_Refresh()函数它会把OLED_GRAM里的数据全部通过IIC发送到屏幕上去。所以你的流程通常是OLED_Clear()- 画图/写字 -OLED_Refresh()。5.3 在主函数中测试现在我们可以在main.c里写个测试程序了。记得包含必要的头文件。#include “driverlib.h” #include “device.h” #include “board.h” // 或 tjx_init.h #include “oled.h” #include “bmp.h” // 如果你有图片数据 void main(void) { // 1. 芯片和外设初始化这部分代码通常由CCS或SysConfig自动生成 Device_init(); Device_initGPIO(); Interrupt_initModule(); Interrupt_initVectorTable(); Board_init(); EINT; // 开启全局中断 ERTM; // 2. OLED初始化 OLED_Init(); OLED_ColorTurn(0); //0正常显示1反色显示 OLED_DisplayTurn(0); //0正常方向1翻转180度 u8 t ‘ ‘; // 定义一个字符变量用于测试 while(1) { // 测试1显示一张图片 OLED_ShowPicture(0, 0, 128, 64, BMP1, 1); OLED_Refresh(); delay_ms(1000); // 延时1秒 OLED_Clear(); // 测试2显示汉字和英文字符串 OLED_ShowChinese(0, 0, 0, 16, 1); // 显示字库中第0个汉字16x16大小 OLED_ShowString(20, 20, “Hello F28P550!”, 16, 1); OLED_Refresh(); delay_ms(1000); OLED_Clear(); // 测试3动态显示变化的ASCII字符 OLED_ShowString(0, 40, “Char:”, 16, 1); OLED_ShowChar(40, 40, t, 16, 1); t; if(t ‘~’) t ‘ ‘; // ASCII字符循环 OLED_Refresh(); delay_ms(500); OLED_Clear(); } }6. 编译、下载与调试编译点击CCS的编译按钮。确保没有错误最多只有一些警告。连接开发板用USB线连接开发板和电脑确保CCS能识别到仿真器XDS110等。下载程序点击调试按钮程序会自动编译并下载到开发板。上电观察给开发板上电或者按一下复位键。你应该能看到OLED屏幕依次显示图片、文字和动态变化的字符。如果屏幕没有反应别急这是调试的常态检查接线这是第一要务确保VCC是3.3VGND接好SCL和SDA线没有接反或松动。检查引脚配置确认SysConfig里GPIO50和51确实配置成了输出并且主函数里的初始化代码被正确执行。用逻辑分析仪或示波器抓时序这是最有效的调试手段。查看SCL和SDA线上是否有波形是否符合IIC的起始、停止、应答信号。如果完全没有波形说明GPIO控制代码没执行如果波形不对说明时序尤其是延时有问题。简化测试先不显示复杂内容只在初始化后调用OLED_Clear()和OLED_Refresh()看屏幕是否全黑或全亮取决于初始化设置。当你看到屏幕上如期出现预想的内容时这份移植工作就大功告成了。这套驱动代码功能很全你可以在此基础上轻松地显示传感器数据、系统状态、菜单界面等为你基于C2000的项目增添一个清晰的人机交互窗口。