企业官网建设流程全解析

简介：面向初次接触 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 机器要先满足的几件事：路径、磁盘、运行库

安装之前，我会先把下面这几项过一遍，不满足就先补齐，后面能少踩不少坑。

路径是最容易出问题的地方。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 MD5

certutil是 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下面大致是这样几块：

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 → Finish

Browse 的时候选到工程根目录（就是放着.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 选C6000；Variant 选C674x Floating-point DSP下面的EVMC6748；Connection 保持默认。Variant 这一栏如果点开是空的或者只有寥寥几项，回到第 3 章，说明器件支持没装全。模板选空工程（Empty Project），Finish。

工程建好之后往里加文件。新建头文件：右键工程名 →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 File，File 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.ccxml，Connection 先用TI Instruments Simulator，器件选 C674x little Endian，Save 成活动配置；Build，确认 Problems 为空；点 Debug，在main第一行下断点，跑起来看是否停在那行；然后打开 Variables 和 Registers 窗口，单步两三行，看变量的值有没有按预期变化。

对照下面这张表逐项打勾，全绿再往工程里搬真实代码：

这套验证流程不到十分钟，但它把安装、器件支持、编译器、目标配置、调试服务、授权六个环节全串了一遍，任何一环有问题都会在这里暴露。相比之下，直接拿一个大工程上来就 Build，报出十几个错，你根本分不清是环境没装好还是代码本身有问题。

从那以后我每次装完 CCS5，不管多急，都强制走一遍这个空工程验证，跑通了才动真实工程。省下的那十分钟，往往要用一整天来还。希望帮到你。

本文还有配套的精品资源，点击获取