CCS5安装配置全流程：License、Workspace与.ccxml调试

简介面向初次接触 TI Code Composer Studio 的嵌入式开发者以及高校电子类实验教学场景这份文档围绕 CCSv5 的完整安装与上手流程展开重点解决安装选项选择、工作空间设置、License 配置以及破解环节容易卡住的问题。压缩包内仅有 1 个 docx 文件体积约 1.53MB内容以图文步骤说明为主体并配有安装过程截图来帮助定位界面选项篇幅紧凑、查阅方便。文档覆盖从运行安装程序、勾选组件、指定 Workspace到覆盖 tiactutil.exe 与 mdex.dll再导入 full.lic 的许可处理思路并延伸到已有工程导入、新建工程、添加头文件与源文件以及 .ccxml 目标配置文件创建和调试器启动等环节。目前已有 718 人学习下载适合希望快速搭好 CCSv5 开发环境、少走弯路的中初级读者对照操作。1. 装了三遍才通的 CCS5版本、路径、许可证错一个后面全是坑CCS5 安装看起来很简单无非双击 exe、一路 Next可一旦补充了细节问题就全出来了。我见过最常见的出错方式是照着标着 CCSv5.1 的教程去装 5.3 的安装包向导里的选项名对不上随手点了默认结果 C6000 的器件支持根本没装进去新建工程时 Variant 下拉框空空如也。CCS 是 TI 的集成开发环境编辑、编译、链接、调试、分析全在一个界面里完成CCS5 这套 5.x 环境在 MSP430 和 C674x DSP 的板子上太常见。下面这一遍是我自己走通的顺序选包、勾组件、定 workspace、挂 license、导工程、配 .ccxml最后用断点验证。刚上手的人能照着一步步操作被旧工程限制住的人也能少走两趟。2. 装前清单CCSv5.3 与 5.1 的版本差异和机器门槛2.1 5.1 和 5.3 到底差在哪该装哪个先把版本理清楚。原始资料里标题写的是 CCS5正文一会儿 5.1、一会儿 5.3这不是笔误而是这套环境当年确实在 5.x 里迭代了好几轮。5.1 是老教程里出镜率最高的那版界面截图、菜单位置、向导文案网上流传的图文教程大多对着它拍5.3 是后续把器件支持补全、稳定性修过一轮的版本安装包文件名就叫ccs_setup_5.3.0.00090.exe。选择原则并不复杂手上工程是用 5.1 建的机器上也能找到 5.1 的安装包那就装 5.1省得去处理工程迁移的兼容问题如果是新起的 C6748 工程、或者别人给你的例程是在 5.3 上导出的直接上 5.3。5.3 打开 5.1 的工程大部分情况能读但.cproject里的编译器版本号会不一致第一次 Build 常常报找不到编译器或工具链版本不匹配需要手动在工程属性里把编译器切到本机装的那一版。我一般不推荐的折中方案是同一台机器上 5.1 和 5.3 都装。两个版本的 eclipse 主体、DebugServer、驱动都会往注册表和系统目录里写东西后装的会把先装的部分文件覆盖掉最后谁都用不安稳。真要共存装到两个完全独立的根目录比如D:\ti\ccsv5_1和D:\ti\ccsv5_3并且每次启动前确认自己点的是哪个快捷方式。还有一条容易被忽略CCS5 这代是基于 Eclipse 的 32 位程序没有 64 位版本。在 64 位系统上能跑是因为系统向下兼容 32 位但这意味着它吃不到大内存工程特别大的时候 IDE 会明显卡顿、偶尔内存溢出。这一点要有心理预期不是装错了。2.2 机器要先满足的几件事路径、磁盘、运行库安装之前我会先把下面这几项过一遍不满足就先补齐后面能少踩不少坑。项目建议值说明操作系统Windows 7 及以上新系统能装但建议用管理员权限运行兼容性选项视情况开磁盘空间预留 10 GB 以上完整功能集装完占几 GB加上 workspace 和编译中间文件安装路径纯英文、无空格、非系统盘例如D:\ti\ccsv5工作区间独立目录、纯英文例如D:\CCS5.3Workspace权限本地管理员安装和驱动注册都需要路径是最容易出问题的地方。Eclipse 系的老 IDE 对空格和中文的容忍度非常低装在C:\Program Files下面后面编译时偶尔会冒出莫名其妙的 “系统找不到指定的路径”你能查一下午。我的习惯是直接在数据盘根下开两个目录命令两行就能搞定# 安装目录和工作区间分开放路径里不要出现中文和空格 New-Item -ItemType Directory -Force -Path D:\ti\ccsv5 New-Item -ItemType Directory -Force -Path D:\CCS5.3Workspace-Force的作用是目录已存在时不报错直接复用写脚本的时候省一个判断。两个目录分开是有讲究的安装目录将来可能整个删掉重装workspace 里放的是你的工程源码和 IDE 的个人配置混在一起清理的时候很容易连着工程一起删。运行库方面安装包自带 JRE不需要你单独去装 Java这一点别被老教程带偏了。真正缺了会出事的是系统的 VC 运行库和 .NET 组件缺了的表现是安装到最后一步注册组件失败或者装完点图标闪一下就没。常见做法是装之前把系统的补丁和常用运行库跑一遍装完再重启一次。2.3 安装包到手先做两件事校验和备份安装包从哪来我不管但到手之后别急着双击。第一步校验完整性一个几 GB 的文件在传输过程中损坏是很常见的事损坏的安装包跑到一半会莫名其妙回滚报的错还跟真实原因完全无关这种排查花的时间能让人很不痛快。# 计算安装包的 MD5和下载来源给出的值逐位比对 certutil -hashfile .\ccs_setup_5.3.0.00090.exe MD5certutil是 Windows 自带的不用装任何工具。输出是一串 32 位十六进制和来源标注的值对不上就重新拿别硬装。SHA1 把参数换成SHA1即可。第二步把安装包留一份在别的盘或者移动硬盘上。CCS5 这套东西装完可能一年不动等到某天系统重做、或者要给实验室另一台机器部署再回头找那个特定版本的 exe往往就找不到了。这一步没有技术含量但我吃过亏。3. 主程序安装从 ccs_setup_5.3.0.00090.exe 到首次启动3.1 向导里的三个关键选择完整功能集、组件全勾、安装路径右键安装包选“以管理员身份运行”。直接双击也能起但后面注册驱动和写系统目录的时候可能权限不足装到一半让你重来不如一开始就给足权限。向导前几屏是许可协议和欢迎页一路 Next。真正需要你停下来做判断的是安装类型那一屏。这里会出现几个选项其中一个叫Complete Feature Set完整功能集。选它不要选典型安装或者最小安装——选 Complete Feature Set 是进入手动选择安装通道的入口只有进了这个通道你才能看到完整的组件列表并逐个勾选。进去之后是一屏组件树我的做法是全勾。里面大致是这几类器件家族支持C6000、C674x、MSP430 等、仿真器与调试服务、编译器工具链、SYS/BIOS 与例程资源、以及 IDE 主体。全勾的代价只是多占一点磁盘漏勾的代价就大了——最典型的是没勾器件支持装完新建工程时 Variant 下拉框是空的你还以为是安装包坏了其实是自己没装。提示全勾之后安装时间会明显变长中间有若干分钟界面看着像卡死那是解压和注册组件别急着点取消。安装路径那一屏把默认的C:\ti\ccsv5改成你前面建好的D:\ti\ccsv5。改完继续剩下的就是等待。3.2 安装过程中会遇到的干扰以及装完该核对的目录安装过程本身没什么可操作的但有两个干扰源要提前处理。一个是杀毒软件。CCS 安装过程中会往系统里注册调试驱动、写注册表、释放大量 dll行为特征和某些不受欢迎的程序高度相似被拦下来的表现是安装进度条走到某个百分比长时间不动最后弹一个语焉不详的失败提示。血泪经验是装之前把安装目录和D:\ti整个加进杀软白名单装完再决定要不要放开。另一个是路径长度。Windows 对路径长度有 260 字符的限制CCS 的目录层级本来就深如果再套几层带版本号的长目录名编译时生成中间文件很容易超限报错是 “找不到文件”但文件明明就在那儿。安装路径短一点这一条就绕过去了。装完之后别急着点 Finish 启动先开资源管理器核对一下目录结构。D:\ti\ccsv5下面大致是这样几块目录作用eclipseIDE 主体启动程序在里面ccs_base\DebugServer调试服务、仿真器驱动、license 相关ccs_base\compiler各器件家族的编译器工具链ccs_base\common公共组件与目标配置描述文件compiler下面按器件家族分了子目录比如 c6000、msp430 各自的版本号目录如果你在这一层只看到一个空的或者压根没有对应家族的目录说明组件没勾全回去重跑安装程序选修改安装补齐。3.3 首次启动的 Workspace 选择为什么不勾那个默认选项点 Finish 之后 CCS 会自动启动第一屏就是 Workspace 选择窗口。这一步看着简单其实是后面很多问题的源头。点 Browse指向D:\CCS5.3Workspace。这个目录可以是空的IDE 会自己在里面建.metadata存个人配置和工程索引。然后注意下面那个复选框Use this as the default and do not ask again不要勾。不勾的理由很实在。勾上之后以后每次启动都直接用这个 workspace不再问你等你哪天要打开另一个工程组、或者要临时看一眼别人给的工程就得去 File → Switch Workspace 手动切切完再切回来一路点下来比当初多勾一下麻烦得多。更要命的是某些情况下 IDE 会记住一个已经被删掉或者被移动过的 workspace 路径启动时直接报错卡在 splash 界面你得去改配置文件才能救回来这就属于自己给自己找麻烦。选择完成点 OK如果这是第一次运行会先弹一个软件许可的选择窗口点 OK 就能进 IDE 主界面。license 的正式挂载放到下一章单独说先把界面跑起来。4. 配置落地license 挂载、工程导入与 .ccxml 目标配置4.1 License 的正规挂法Help 菜单里的那条路径进到 IDE 主界面之后先解决授权否则编译到一半被拦下来更烦。菜单路径是Help → CCS License Information弹出 License Information View 对话框切到Manage选项卡。这里能看到当前机器上已有的授权位置。点Add弹出 Add License Location 对话框点 Browse 找到你的 license 文件选中打开确定然后重启 IDE 让它生效。授权文件本身要走正规渠道获取——评估期、采购的正式授权、或者随开发板附带的授权都行。安装目录ccs_base\DebugServer\license下面那几个二进制文件不要去动它网上流传的替换做法属于绕过授权我不写也不建议在正经项目里用这类改动会让调试服务的行为变得不可预期将来编译能过、下载不动的时候你连问题出在授权上还是出在驱动上都分不清等于给自己埋了个黑匣子。挂完之后回 License Information 里确认一下状态是不是有效、到期时间对不对。这一步花不了一分钟能省掉后面一整轮排查。4.2 导入已有工程先分清工程文件和源码文件拿到别人给的代码第一件事是判断它是不是一个完整的 CCS 工程。判断依据很简单看目录里有没有.project和.cproject这两个文件。有说明它是 Eclipse 体系的工程可以直接导入没有只有一堆.c和.h那叫源码得先新建工程再把文件加进去两种情况的操作完全不同。有工程文件的走导入流程。我习惯先把整个工程目录复制到 workspace 下面再导入——直接在原地导入也能用但工程位置散落在各个盘里将来备份和迁移的时候特别容易漏文件。操作路径File → Import → 展开 Code Composer Studio → 选 Existing CCS Eclipse Projects → Next → Browse 到 D:\CCS5.3Workspace\myccs1 → FinishBrowse 的时候选到工程根目录就是放着.project的那一层不要选到它的父目录也不要选到子目录。选对了中间的工程列表里会出现工程名勾上再 Finish。导入完成后左侧 Project Explorer 里就能看到它带一个小图标展开是源码树。导入之后先别急着编译看一眼工程属性里的器件型号和编译器版本是不是和本机装的对得上。别人在 5.1 上建的工程拿到 5.3 上编译器版本号大概率不一致第一次 Build 会报工具链找不到去 Properties 里把编译器切成本机那版就行。4.3 新建工程与源文件C6748 空工程从零建起没有现成工程就自己建一个。菜单File → New → CCS Project弹出新建对话框里面几个字段需要说清楚。Project name 填工程名比如myccs1不要带空格和中文。Output type 有两个选项Executable和Static library前者构建完整的可执行程序后者只产出一个静态库文件。做应用就保持 Executable只有在做库给别的工程链接时才选 Static library。Device 部分是重点分三块。Family 选C6000Variant 选C674x Floating-point DSP下面的EVMC6748Connection 保持默认。Variant 这一栏如果点开是空的或者只有寥寥几项回到第 3 章说明器件支持没装全。模板选空工程Empty ProjectFinish。工程建好之后往里加文件。新建头文件右键工程名 →New → Header File文件名必须以.h结尾比如my01.h。新建源文件右键 →New → Source File文件名以.c结尾比如my01.c。已经有现成文件要加进来右键 →Add Files找到文件位置打开后会出现一个选择框Copy files还是Link to files。区别很关键。Copy 是把文件物理复制一份进工程目录源文件后来改了工程里的不会跟着变Link 只是建一个引用工程里改的就是原文件。我一般用 Copy工程目录自成一体拷给别人不会丢文件如果那份源码是多个工程共用的公共库才用 Link改一处全部生效。4.4 目标配置文件 TMS320C6748.ccxml调试能不能连上全看它工程能编译不代表能下载。中间还差一份目标配置文件后缀.ccxml它描述的是“用什么仿真器、连什么器件”。这一步是最容易被跳过、也最容易在调试时报错的环节。在工程名上右键 →New → Target Configuration FileFile name 里填TMS320C6748.ccxml。名字建议直接用器件型号将来工程里配置多了不会混。Finish 之后会自动打开目标配置编辑器。编辑器里两栏要确认。Connection保持默认的TI Instruments Simulator——注意这是软件仿真不接板子也能跑适合先验证代码逻辑如果要连真实开发板板载仿真器或者外接 XDS 系列就把这一栏改成对应的仿真器型号。Board or Device里选器件这里是C674x ... little Endian。配置完点 Save保存后 IDE 会自动把它设为活动配置。一个工程可以有多份目标配置但同时只有一份处于活动状态只有活动的那份会在 Debug 时被用上。想看机器上所有已有的配置走View → Target Configurations列表里会标出哪份是活动的。调试连不上板子的时候先来这里确认活动的是不是你以为的那一份这个动作能解决相当一部分“玄学”问题。4.5 编译与下载Problems 窗口是唯一的判断依据配置齐了就可以编译。菜单Project → Build Project过程中下方 Console 会刷编译命令。判断成功与否不看 Console 滚了多少行看Problems窗口——没有红色错误标记就是编译通过可以进入下载调试有错误就逐条改改完重新 Build直到 Problems 清空。编译通过后点工具栏上那个绿色的 Debug 按钮IDE 会切到 Debug 视角中间是源码和当前停住的位置右边是变量和寄存器面板。点运行图标让程序跑起来观察板子上的现象或者变量值。调试过程中的几个基本操作在代码行号旁边右键 →Breakpoints → Breakpoint下断点行首会出现一个标记双击标记可以取消配合单步按钮一行行走点重新开始图标回到main()点复位按钮复位目标点中止按钮回到编辑界面。看数据靠 View 菜单下那几个窗口Variables看变量、Registers看寄存器、Expressions是观察窗口在变量上右键 Add Watch Expression 也能加进来、Disassembly看汇编、Memory Browser看内存、Breakpoints统一管理断点。这几个窗口建议在第一次调试时就都打开摆一遍熟悉位置后面查问题不用现找。5. 排查装完打不开、编译不过、连不上板子的五个坑5.1 启动阶段装不上和打不开现象一安装进度条走到一半停住最后弹窗回滚提示信息含糊。原因基本是三选一安装包损坏、路径含中文或空格、杀软拦截。损坏的安装包回滚时报的错和真实原因毫无关系所以先做校验。路径问题看安装目录C:\Program Files\ti这种带空格的写法在老 IDE 上出事概率不低。杀软拦截的表现是进度长时间不动然后失败日志里能看到某个 dll 写入被拒。解决顺序先用certutil校验哈希对不上就重新拿包对得上就把安装目录换成D:\ti\ccsv5这种短路径最后把D:\ti加进杀软白名单清掉临时目录重装。现象二装完双击图标闪一下就没了或者卡在启动画面进不去。先看是不是 workspace 被占用。CCS 同一时间只允许一个实例用一个 workspace如果你之前异常退出.metadata目录下会留下锁文件下次启动就卡住。解决方法是把 workspace 下.metadata里的.lock类文件删掉或者干脆换一个新的 workspace 目录试。如果换 workspace 也进不去检查是不是装在中文路径下、或者系统缺 VC 运行库。前者换路径重装后者补运行库再重启。现象三新建工程时 Variant 下拉框是空的或者只有一两个器件。这不是软件坏了是安装时没勾器件支持。回头重跑ccs_setup_5.3.0.00090.exe选修改/增补安装把 C6000 和 C674x 相关的组件补上。补装完成后建议重启一次让驱动和描述文件重新注册。5.2 编译与调试阶段过了编译卡在下载现象四编译报cannot open source file xxx.h但那个头文件明明就在工程目录里。原因九成是头文件搜索路径没配。Eclipse 系的工程不会自动递归搜索所有子目录只认你显式声明的 include 路径。文件在inc子目录里而 include 路径里只有工程根那就找不到。解决右键工程 → Properties → Build → C6000 Compiler → Include Options把inc这类目录加进去用相对路径${PROJECT_ROOT}/inc的形式别写死绝对路径否则工程换台机器就废。改完点 Apply重新 Build。现象五点 Debug 报连不上目标提示 Error connecting to the target 或者干脆找不到仿真器。按这个顺序查先在设备管理器里看仿真器有没有被识别成未知设备没识别就是驱动没装好重装 DebugServer 那部分组件再看板子供电和排线然后回来看.ccxml里的 Connection 是不是还停在TI Instruments Simulator——软件仿真模式下当然连不上真实板子改成对应仿真器型号再 Save 一次并确认它处于活动状态。这三步走完绝大部分连接问题就定位了。还有一类是授权问题伪装成连接问题license 无效时调试服务起不来报错文案和连不上板子很像。这时候去 Help → CCS License Information 里看一眼状态比在驱动上反复折腾快得多。6. 装完怎么验证用一个空工程把整条链路跑穿装完不验证等于没装。我的做法是新建一个最小工程从建工程到断点命中完整走一遍任何一环卡住都说明前面的配置有问题而且能精确定位到是哪一环。具体步骤新建verify01空工程器件选 C674x / EVMC6748在工程里新建一个.c文件写一个带循环的最简main建一份verify01.ccxmlConnection 先用TI Instruments Simulator器件选 C674x little EndianSave 成活动配置Build确认 Problems 为空点 Debug在main第一行下断点跑起来看是否停在那行然后打开 Variables 和 Registers 窗口单步两三行看变量的值有没有按预期变化。对照下面这张表逐项打勾全绿再往工程里搬真实代码检查点期望结果启动 IDE正常进主界面不卡 splash新建工程时 Variant能选到 C674x / EVMC6748BuildProblems 窗口零错误Debug 启动切到 Debug 视角无连接报错断点停在main设定行Variables / Registers单步后数值随代码变化License 状态License Information 里显示有效这套验证流程不到十分钟但它把安装、器件支持、编译器、目标配置、调试服务、授权六个环节全串了一遍任何一环有问题都会在这里暴露。相比之下直接拿一个大工程上来就 Build报出十几个错你根本分不清是环境没装好还是代码本身有问题。从那以后我每次装完 CCS5不管多急都强制走一遍这个空工程验证跑通了才动真实工程。省下的那十分钟往往要用一整天来还。希望帮到你。本文还有配套的精品资源点击获取