CC2640R2 LaunchPad到手第一步：用CCS 10.3.1导入官方工程点亮OLED（保姆级避坑）-程序员充电站

CC2640R2 LaunchPad开箱实战：从零点亮OLED的完整避坑指南

刚拿到TI的CC2640R2 LaunchPad开发板时，那种既兴奋又忐忑的心情我至今记忆犹新。作为嵌入式开发的新手，面对这块功能强大的低功耗蓝牙开发板，最迫切的需求就是尽快看到第一个程序运行的效果——比如让OLED屏幕亮起来显示自定义内容。本文将带你完整走过从开发环境配置到最终点亮OLED的全过程，重点解决那些官方文档没有详细说明的"坑点"。

1. 开发环境准备：CCS 10.3.1安装详解

安装Code Composer Studio(CCS)是第一步，也是第一个容易出问题的环节。TI的CCS虽然功能强大，但安装过程中的选项设置直接影响后续开发体验。

1.1 获取正确的安装包

访问TI官网下载CCS 10.3.1时，需要注意几个关键点：

确保下载的是完整版而非在线安装版，后者依赖网络环境且容易中断
核对文件名为CCS10.3.1.00003_win64.zip（针对64位Windows系统）
下载完成后验证文件完整性，避免因网络问题导致安装包损坏

1.2 安装过程中的关键选择

运行安装程序后，以下几个步骤需要特别注意：

安装路径：虽然默认路径(C:\ti)可以工作，但建议改为不含空格和特殊字符的路径，如D:\TI_CCS。某些插件对路径中的空格敏感。
组件选择：
- 必须勾选SimpleLink CC13x2/CC26x2 SDK，这是支持CC2640R2的核心组件
- 建议同时安装XDCtools和TI ARM Compiler，避免后续单独安装
- 如果磁盘空间允许，可以安装所有CC26xx相关组件
环境变量设置：安装完成后，检查系统环境变量中是否自动添加了CCS_INSTALL_DIR。如果没有，需要手动添加指向CCS安装目录。

注意：安装过程可能需要较长时间（30分钟以上），期间不要操作计算机或断开网络连接。

2. 导入官方示例工程

CCS安装完成后，接下来就是导入TI提供的示例工程。这是验证开发环境是否正常工作的关键一步。

2.1 创建工作区

首次启动CCS时，系统会提示选择工作区(Workspace)位置。建议：

为每个项目创建独立的工作区
工作区路径尽量短且不含中文或特殊字符
勾选"将此值用作默认值"避免每次启动都提示

2.2 使用Resource Explorer导入工程

Resource Explorer是TI提供的资源管理器，可以方便地访问各种示例代码和文档。导入工程的具体步骤：

点击菜单栏View > Resource Explorer打开资源管理器
在左侧导航树中找到Software > SimpleLink CC13x2/CC26x2 SDK
展开Examples > Development Tools > CC2640R2 LaunchPad
选择project_zero工程，右键点击Import to IDE

首次导入时可能会遇到以下问题及解决方案：

缺少依赖包：系统会提示安装所需软件包，按照向导完成安装后需要重启CCS
工程显示错误：如果工程图标上有红色感叹号，通常是因为编译工具链未正确配置
路径问题：如果提示找不到文件，检查工程属性中的路径设置是否正确

2.3 验证工程完整性

导入完成后，通过以下步骤验证工程是否准备就绪：

右键点击工程，选择Properties
检查General > Project下的Toolchain是否为TI v20.2.5.LTS
在Build > ARM Compiler > Include Options中确认包含路径完整
在Debug配置下检查Target Configuration是否正确设置为CC2640R2

3. 编译与下载：避开常见错误

工程导入成功后，就可以尝试编译并下载到开发板了。这个阶段新手常会遇到各种编译错误和下载失败问题。

3.1 首次编译的注意事项

点击工具栏的Build按钮开始编译，需要注意：

首次编译时间较长，因为需要构建所有依赖项
如果出现file not found错误，通常是路径问题，检查：
- 工程属性中的包含路径
- 系统环境变量CCS_INSTALL_DIR和TI_ARM_CLANG_installDir是否设置正确
遇到undefined symbol错误时，可能需要重新安装SDK或更新编译器版本

3.2 连接开发板并下载程序

编译成功后，将开发板通过USB连接到电脑，然后：

点击Debug按钮启动调试会话
选择正确的调试器配置（通常是Texas Instruments XDS110 USB Debug Probe）
如果提示找不到设备：
- 检查USB线是否连接可靠
- 尝试更换USB端口
- 重启CCS和开发板

成功连接后，程序会自动下载到开发板并暂停在main()函数入口。点击Resume让程序开始运行。

3.3 验证程序运行

对于project_zero示例工程，可以通过以下方式验证是否运行成功：

开发板上的红色LED应该开始闪烁
按下开发板上的按键时，LED闪烁频率应该改变
在CCS的Console视图中可以看到调试输出信息

如果这些基本功能都正常，说明开发环境和下载流程已经正确配置。

4. 驱动OLED屏幕：完整实现指南

让OLED屏幕正常工作是在CC2640R2上实现的第一个有视觉反馈的项目。下面详细介绍硬件连接和软件修改的全过程。

4.1 硬件连接

CC2640R2 LaunchPad通过I2C接口连接OLED模块（以常见的SSD1306为例）：

LaunchPad引脚	OLED模块引脚	备注
3.3V	VCC	电源正极
GND	GND	电源地
DIO12	SDA	I2C数据线
DIO13	SCL	I2C时钟线

连接时需注意：

确保OLED模块工作电压为3.3V（与LaunchPad匹配）
使用杜邦线连接时，尽量缩短线长以减少干扰
检查接触是否良好，接触不良是导致显示异常的最常见原因

4.2 添加OLED驱动代码

在project_zero工程中添加OLED支持需要以下几个步骤：

添加驱动文件：
- 将board_oled.h和board_oled.c文件复制到工程目录
- 在CCS中右键点击工程，选择Add Files...添加这两个文件
修改主程序：在project_zero.c文件中进行以下修改：

#include "board_oled.h" // 添加在文件开头的include部分 // 在ProjectZero_init函数末尾添加： Board_initOLED(); // 初始化OLED OLED_clear(); // 清屏 OLED_writeString("CC2640R2 Ready", OLED_LINE1); // 第一行显示文本 OLED_writeString("RSSI: -", OLED_LINE2); // 第二行预留信号强度显示

配置I2C引脚：在board.c文件中找到PIN_Config BoardGpioInitTable[]数组，添加OLED使用的引脚配置：

PIN_Config BoardGpioInitTable[] = { // 其他现有配置... Board_DIO12 | PIN_GPIO_OUTPUT_EN | PIN_GPIO_LOW | PIN_PUSHPULL | PIN_DRVSTR_MAX, // OLED SDA Board_DIO13 | PIN_GPIO_OUTPUT_EN | PIN_GPIO_LOW | PIN_PUSHPULL | PIN_DRVSTR_MAX, // OLED SCL PIN_TERMINATE };

4.3 常见问题排查

如果OLED没有正常显示，可以按照以下步骤排查：

检查硬件连接：
- 确认电源和信号线连接正确
- 用万用表测量OLED模块供电是否为3.3V
验证I2C通信：在board_oled.c的Board_initOLED()函数中添加调试输出：

bool Board_initOLED(void) { I2C_Handle i2cHandle = I2C_open(Board_I2C0, &i2cParams); if (i2cHandle == NULL) { System_printf("I2C open failed!\n"); return false; } // ...其余初始化代码 }

调整显示对比度：有些OLED模块需要设置合适的对比度才能显示内容，可以尝试修改初始化代码中的对比度值：

static uint8_t initCmds[] = { 0xAE, 0xD5, 0x80, 0xA8, 0x3F, 0xD3, 0x00, 0x40, 0x8D, 0x14, 0x20, 0x00, 0xA1, 0xC8, 0xDA, 0x12, 0x81, 0xCF, // 修改此处的0xCF可以调整对比度 0xD9, 0xF1, 0xDB, 0x40, 0xA4, 0xA6, 0xAF };

5. 进阶功能：实现动态内容显示

基础显示功能实现后，我们可以进一步让OLED显示动态信息，如蓝牙信号强度、设备状态等。

5.1 显示蓝牙RSSI值

在project_zero.c中修改蓝牙事件处理函数，添加RSSI显示：

static void ProjectZero_bleStateChangeCB(ProjectZero_States_t newState) { // 原有代码... // 添加RSSI显示 if (newState == PROJECTZERO_STATE_CONNECTED) { int8_t rssi; Gap_getParamValue(GAP_PARAM_RSSI, &rssi); char rssiStr[16]; sprintf(rssiStr, "RSSI: %ddBm", rssi); OLED_writeString(rssiStr, OLED_LINE2); } }

5.2 添加菜单界面

通过按键控制可以在OLED上实现简单的菜单系统：

首先定义菜单结构：

typedef struct { const char* text; void (*action)(void); } MenuItem; MenuItem mainMenu[] = { {"1. Device Info", showDeviceInfo}, {"2. BT Settings", showBTSettings}, {"3. Factory Reset", doFactoryReset} };

实现菜单显示函数：

void showMenu(uint8_t selected) { OLED_clear(); for (int i = 0; i < 3; i++) { if (i == selected) { OLED_writeString(">", i); // 用>标记当前选中项 } OLED_writeString(mainMenu[i].text, i); } }

在按键处理函数中添加菜单导航：

void handleButtons(uint8_t buttons) { static uint8_t currentSelection = 0; if (buttons & Board_BUTTON0) { // 上键 if (currentSelection > 0) currentSelection--; showMenu(currentSelection); } else if (buttons & Board_BUTTON1) { // 下键 if (currentSelection < 2) currentSelection++; showMenu(currentSelection); } else if (buttons & Board_BUTTON2) { // 确认键 mainMenu[currentSelection].action(); } }

5.3 优化显示性能

当需要频繁更新OLED内容时，可以采取以下优化措施：

局部刷新：只更新需要改变的部分，而不是整个屏幕
双缓冲：在内存中完成所有绘制操作后一次性更新到屏幕
减少字符串操作：预先格式化好要显示的字符串

实现局部刷新的示例：

void updateRSSI(int8_t rssi) { static int8_t lastRssi = 0; if (rssi != lastRssi) { char buf[16]; sprintf(buf, "RSSI: %ddBm", rssi); OLED_clearLine(OLED_LINE2); // 只清除需要更新的行 OLED_writeString(buf, OLED_LINE2); lastRssi = rssi; } }

6. 项目打包与分享

完成OLED驱动开发后，你可能希望将项目分享给团队成员或备份供以后使用。CCS提供了完整的项目导出功能。

6.1 导出可移植工程

右键点击工程，选择Export...
在弹出窗口中选择Code Composer Studio > CCS Projects
勾选Export as a zip file和Export user-defined build settings
指定导出路径和文件名（建议包含日期和版本信息）

6.2 创建可重用的OLED组件

为了便于在其他项目中复用OLED驱动代码，可以将其打包为CCS的库项目：

新建Static Library项目：File > New > CCS Project
选择Output type: Static Library
将OLED驱动文件添加到新项目中
设置好公共头文件路径
构建项目生成.lib文件

在其他项目中只需：

添加对库项目的引用
包含头文件
链接生成的库文件

6.3 版本控制集成

CCS支持与Git等版本控制系统集成，便于团队协作：

在项目根目录初始化Git仓库
创建合理的.gitignore文件，排除临时文件和构建输出
建议纳入版本控制的文件：
- 源文件(.c/.h)
- 工程文件(.project,.cproject)
- 链接脚本(.cmd)
- 必要的配置文件

# 示例.gitignore内容 Debug/ *.out *.obj *.d *.map *.lst

通过以上步骤，你已经完成了从零开始使用CC2640R2 LaunchPad驱动OLED屏幕的完整流程。在实际项目中，这些基础功能可以进一步扩展为更复杂的应用界面和交互系统。

CC2640R2 LaunchPad到手第一步：用CCS 10.3.1导入官方工程点亮OLED（保姆级避坑）