📚 课程目录第3章 SDK与IDE准备

3. SDK与IDE准备：SimpleLink SDK安装、CCS/IAR工程导入、SysConfig图形化配置工具初探

好，咱们正式开始动手前的最后一步——把吃饭的家当都备齐了。

很多新手朋友拿到开发板，第一件事就是急着写代码。我当年也这样，结果折腾半天发现SDK版本不对，编译器报错一堆，连个LED都点不亮。所以这一章，咱们踏踏实实把环境搭好。环境顺了，后面调试才不闹心。

3.1 开发环境全景图

先看看咱们这一章要搞定的几个核心组件，它们之间的关系是这样的：

说白了，SDK是食材和菜谱，IDE是灶台和锅铲，SysConfig就是那个帮你配好调料比例的智能量勺。三样东西缺一不可。

3.2 SimpleLink SDK 安装

SDK是TI官方提供的软件开发套件。里面包含了驱动库、协议栈（比如咱们要用的TI 15.4-Stack）、示例工程、文档等等。我个人习惯把SDK装在一个路径不含中文和空格的目录下，省得后面编译出些莫名其妙的路径问题。

3.2.1 下载与安装步骤

获取SDK：从TI官网下载 SimpleLink CC13xx/CC26xx SDK。目前稳定版是 v5.xx 系列。
运行安装程序：双击 .exe 文件，选择安装路径。我建议装到 C:\ti\simplelink_cc13xx_cc26xx_sdk_5_xx_xx_xx。
等待安装完成：大概需要5-10分钟。安装过程中会自动解压文档和示例。
验证安装：打开安装目录，看看有没有 examples、docs、source 这些文件夹。

💡 我的经验： 安装完成后，建议先打开 docs\release_notes.html 看一眼。里面会列出这个版本已知的问题和修复的bug。我曾经因为没看release notes，在一个有bug的驱动版本上浪费了两天时间。

3.2.2 SDK 目录结构速览

装好后，咱们看看SDK里都有啥。我挑几个关键目录说一下：

目录/文件	说明	你以后会经常用到
`examples/rtos/`	基于TI-RTOS的示例工程	✅ 是的，从这里导入工程
`examples/nortos/`	无操作系统的裸机示例	✅ 简单应用可以看这里
`source/ti/devices/`	芯片外设驱动库源码	✅ 调试驱动问题时必看
`source/ti/ti154stack/`	TI 15.4-Stack 协议栈源码	✅ 咱们课程的核心区域
`docs/`	API参考手册、用户指南	✅ 查函数说明时翻它
`tools/`	辅助工具（如SysConfig命令行版）	✅ 高级用户会用到

⚠️ 注意： 千万不要手动修改 source/ti/ti154stack/ 目录下的协议栈源码文件。这些文件是只读的，编译时会被链接器引用。我曾经手欠改了一个头文件，结果整个协议栈编译不过，最后重装了SDK才解决。

3.3 IDE 工程导入：CCS 与 IAR

SDK装好了，接下来就是导入示例工程。咱们课程主要用CCS（Code Composer Studio），但IAR也是很多工程师的选择。我两个都讲一下。

3.3.1 CCS 工程导入

CCS是TI自家的IDE，基于Eclipse。我个人比较推荐用它，因为和TI的调试器（XDS110）配合得最好。

打开CCS，选择工作空间（Workspace）。工作空间路径也建议不要有中文。
点击菜单栏 Project → Import CCS Projects...
在 Select search-directory 里，浏览到SDK的示例目录，比如：
C:\ti\simplelink_cc13xx_cc26xx_sdk_5_xx_xx_xx\examples\rtos\CC1352P1_LAUNCHXL\ti154stack\sensor
勾选你要导入的工程（比如 sensor 和 collector），点击 Finish。
等待工程索引完成。第一次导入会慢一些，因为要解析所有头文件路径。

  🔧 避坑指南： 导入后如果工程名旁边有个红叉，别慌。右键工程 → Properties → CCS General，检查 Products 和 Runtime Support 是否勾选了正确的SDK版本。我曾经遇到过SDK版本没自动关联，手动选一下就好了。

3.3.2 IAR 工程导入

如果你习惯用IAR，流程也差不多：

打开IAR Embedded Workbench。
点击 File → Open → Workspace...
浏览到SDK示例目录下的 .eww 文件。比如：
...\sensor\tirtos\iar\sensor.eww
IAR会加载整个工作空间，里面包含多个工程。
在 Workspace 窗口里，右键工程名，选择 Set as Active。

💡 我的习惯： 我平时调试用CCS，因为它的变量监视窗口更顺手。但做代码尺寸优化时，我会切到IAR，因为IAR的编译器优化选项更丰富。两个IDE各有千秋，你选一个顺手的就行。

3.4 SysConfig 图形化配置工具初探

好，重点来了。SysConfig是TI这几年主推的图形化配置工具。你想想看，以前配个引脚、设个时钟频率、调个协议栈参数，都得翻手册找寄存器地址，然后手写代码。现在呢？点点鼠标就搞定了。

3.4.1 什么是 SysConfig？

SysConfig 本质上是一个元数据驱动的配置工具。它读取芯片和SDK的元数据（.syscfg 文件），然后生成C代码和头文件。你只需要在图形界面里勾选、填参数，它自动帮你生成初始化代码。

说白了，它就是个代码生成器。但它的好处是：

可视化：引脚分配、外设连接一目了然
防冲突：如果你把两个外设配到同一个引脚上，它会报错
可追溯：生成的代码有清晰的注释，告诉你哪段配置对应哪个图形操作

3.4.2 在CCS中打开SysConfig

导入工程后，你会看到工程目录下有一个 .syscfg 文件。双击它，就会自动打开SysConfig视图。

界面大概分三个区域：

区域	功能
左侧导航树	列出所有可配置的模块（RF、GPIO、UART、Timer等）
中间配置区	当前选中模块的详细参数配置
右侧概览/问题面板	显示配置错误、警告、以及生成的引脚分配图

3.4.3 快速上手：配置一个UART

咱们拿配置UART举个例子，感受一下SysConfig的便利：

在左侧导航树找到 UART，点击 Add。
在中间配置区，设置波特率为 115200，数据位 8，停止位 1，无校验。
在 PinMux 选项卡里，选择UART要用的TX/RX引脚。SysConfig会自动检查引脚是否被其他外设占用。
保存文件（Ctrl+S）。SysConfig会自动生成 ti_drivers_config.c 和 ti_drivers_config.h。

  🔧 实际项目经验： 我在做一个Sub-1GHz网关项目时，需要同时用UART打印日志、用SPI接LCD、用I2C接传感器。如果没有SysConfig，我得手动算引脚复用，很容易搞错。SysConfig的冲突检测帮我省了不少事。

3.4.4 SysConfig 与协议栈配置

对于咱们的课程，SysConfig最重要的功能是配置TI 15.4-Stack的参数。比如：

RF参数：频段（868MHz / 915MHz）、发射功率、信道
网络参数：设备类型（Sensor / Collector）、PAN ID、安全密钥
MAC参数：信标间隔、超帧结构、CSMA-CA参数

这些参数在 .syscfg 文件的 TI 15.4-Stack 节点下。你改完参数，保存，SysConfig会自动更新协议栈的初始化代码。嗯，这里要注意：改完参数后，最好重新编译整个工程，确保所有依赖都更新了。

⚠️ 重要提醒： SysConfig生成的配置文件（ti_drivers_config.c/h）是自动生成的，不要手动修改。如果你改了，下次保存SysConfig时会被覆盖。正确的做法是：所有配置都在SysConfig界面里改，然后重新生成。

3.5 本章小结

咱们这一章把开发环境的三件套都搞定了：

SDK：装好了食材和菜谱
IDE：架好了灶台和锅铲
SysConfig：学会了用智能量勺配调料