第 5 章

CCS3.1 集成调试环境简介

5.1 CCS3.1 集成调试环境主要菜单及功能介绍

系统的配置之后，给实验开发板供电，双击快捷方式CCStudio 3.1 文件图标，就可进入集成调试环境。

调试程序的一般步骤

创建工程：

添加文件到工程中：

编译连结和调试程序：

5.1.1 Project （项目）菜单

CCS 集成调试环境不能直接将汇编源代码或 C 语言源代码文件 Build 生成 DSP 可执行代码，必须使用项目（ Project ）来管理整个设计和调试过程。

项目文件保存时为 *.pjt 文件。

Project 菜单中的主要命令

· New 新建一个项目，项目保存至新建项目文件夹中。· Open 打开一个已有的项目。· Add Files to Project 将文件加载到该项目中。

项目中可以加入的文件的扩展名：

对于头文件和在程序中用 include 引用的文件，项目管理会自动加入。

项目管理不允许用户添入其它类型的文件。

*.C C 源程序文件，项目管理将对该类文件进行编译和链接。*.ASM 汇编源程序文件，项目管理将对该类文件进行汇编和链接。*.OBJ 目标文件，项目管理将对该类文件进行链接。*.LIB 库文件，项目管理将对该类文件进行链接。*.CMD 链接命令文件，项目管理在链接各个文件时根据此文件分配系统程序空间及数据空间。

·Save 将一个已打开的项目保存。·Close 将一个已打开的项目关闭。·Add Files to Project… 添加该项目中用到的所有文件和所需的库文件。·Compile Files 对项目中的 C 语言和汇编语言源代码文件进行编译。·Build 对项目进行编译、汇编和链接，生成可执行文件为 *.OUT ，对于没有修改的源程序文件不重新编译。

·Rebuild All 项目重新进行一次编译、汇编和链接，生成可执行文件为 *.OUT 。·Stop Build 停止对项目的编译、汇编和链接。·Show Project Dependencies 显示该项目中用到的所有文件和所需的库文件。·Scan All File Dependencies 详细查看该项目中用到的所有文件和所需的库文件。·Build Options 对编译器、汇编器和链接器的参数进行配置。 ·Recent Project Files 显示最近打开过的项目。

可以配置：寄存器优先调试，特定函数优先调试，或某个子程序优先调试等选项。

通常在 Build 时采用默认设置。

5.1.2 View （观察）菜单

·Disassembly 观察反汇编程序窗口。当将 DSP 可执行程序 *.OUT 文件载入目标系统后，CCS 集成调试环境将自动打开一个反汇编窗口，反汇编窗口根据存储器的内容显示反汇编指令和符号信息。

·Memory 观察存储器窗口。

Address ：输入需要观察的存储器的起始地址。

Format ：选择存储器的显示格式。 Page ：选择显示存储器的类型。

1. 在 Watch Window 中加入一个新的表达式： 在 Watch Window 中的 Name 文件框输入要观察的变量名，或者在程序窗口择选中要观察的变量名，然后单击右键，再在打开的快捷菜单中选择 Add to Watch Window 即可。

5.1.3 Debug （调试）菜单 Debug 菜单中包含所有可用的调试命令 。

·Breakpoints 断点设置。

将鼠标放在程序中需设置断点处，选择 Breakpoints 并进行相应的设置，可在程序中设置断点。

移动鼠标至需要设置断点的程序语句上，右击鼠标，在弹出的快捷菜单中选择 Toggle breakpoint 。

若要取消断点，则选中相应的断点处语句，再右击鼠标，在弹出的快捷菜单中再次选择 Toggle breakpoint 。

5.2 工作窗口区

在 CCS 集成调试环境中，常用工作窗口有 Files （文件）窗口、 Disassembly （反汇编程序）窗口、 CPU 寄存器窗口、 Memory （存储器）窗口以及 Watch （观察）窗口等。

根据需要，用户可对这些窗口分别打开、关闭、调整大小、移动和浏览窗口的内容等。

1. Files （文件）窗口

该窗口包括当前系统用到的 GEL 文件和项目。

GEL 文件：包括缺省的 f2407.gel 文件。

项目：包括用户用到的头文件、用 include 定义的引用文件和用户建立或添加的 C 源程序文件 *.C 、汇编源程序文件 *.ASM 、目标文件 *.OBJ 、库文件 *.LIB 和链接命令文件 *.CMD 。

添加文件：把鼠标移到相应的 *.pjt 文件夹处，单击右键，可以从弹出的快捷菜单中选择 Add Files to Project 选项，选择添加适当的文件；

删除文件：把鼠标移到相应文件处，单击右键，在弹出的快捷菜单中选择 Remove from project 选项即可。

2. Disassembly （反汇编程序）窗口

显示程序的反汇编代码和程序存储器的内容。

在窗口中用一反显高亮条来表示当前程序指针。

可用鼠标单击汇编语句的方法来设置断点，再单击一次，则取消设置的断点。

3. CPU 寄存器窗口

显示在程序调试过程中的 CPU 寄存器（程序指针 PC 、累加器 ACC 、状态寄存器 ST0 和 ST1 、重复计数器 RTC 、辅助寄存器 XAR0-XAR7 、中断使能寄存器 IER 和中断标志寄存器 IFR 等）的状态。

用户可通过 CPU 寄存器窗口来监视程序的执行过程。

若要改变寄存器内容，则可用鼠标单击需要改变的寄存器，直接输入修改值。

4. 状态寄存器窗口

显示状态寄存器中的各个状态位：

SXM 、 OVM 、 TC 、 C 、 Z 、 N 、 V 、 PM 、OVC 、 INTM 、 DBGM 、 PAGE0 、 VMAP 、 SPA 、 LOOP 、 EALLOW 、 IDLESTAT 、 AMODE 、 OBJMODE 、 CNT 、 M0M1MAP 、 XF 及ARP 。

用户可以很清楚地看到程序执行过程中各状态位的变化。

若要改变状态位内容，则可用鼠标单击需改变的状态位，直接输入修改的值。

5. Memory （存储器）窗口显示存储器的内容。

存储器：

程序存储器；

数据存储器；

I/O 空间。

改变存储器内容，可用鼠标单击需改变的存储器地址，再输入修改值。

注意，某些存储器内容不能被改变。

6. Watch （观察）窗口显示所选择的变量、寄存器和存储器的内容 。

7. Build （建立）状态窗口对项目进行编译、汇编和链接时，显示一些状态信息。

如果在编译、汇编和链接过程中发现错误，则该窗口显示出错误类型和错误的位置。

双击错误信息处，鼠标跳到程序中相应的位置。

5.3 4 个基本文件和 1 个库函数文件简介

在 CCS3.1 集成调试环境中可以直接编写汇编语言程序和 C 语言程序，编写程序完成后可直接运行编译链接等调试。

编写模块化的程序块：在进行调试之前，一般需要 1个库函数文件和书写 4种格式的文件： C 语言文件，汇编语言文件，头文件和命令文件。

在编写这 4 类文件时，通常要用到一些汇编伪指令。

5.3.1 C 语言程序文件

C 语言程序文件名的后缀为 .c 。

程序中实现 DSP 要完成的功能，由开发人员编写。

5.3.4 中断向量文件中断向量文件 vectors.asm ：定义了系统各种中断服务程序。

5.3.5 库文件 rts2xx.librts2xx.lib 库文件可在“ C:\CCStudio_v3.1\C2400\cgtools\lib”下找到 。

Rts2xx.lib 包含：ANSIC 标准库；系统启动程序 _c_int0 ；允许 C访问特殊指令的函数和宏。

5.4 利用 CCS 编译器开发调试程序的简单步骤

5.4.1 4种类型的文件DSPC 语言应用程序，需要以下 4种类型的文件：C 语言文件 * .C ；汇编语言文件 *.ASM ：编写复位初始化程序和中断向量表 ；头文件 *.H ：定义 DSP 内部寄存器的地址分配 ；命令文件 *.CMD ：定义堆栈、程序和数据空间分配。

注意：

4种类型的文件和 1 个库文件必须储存在同一个文件夹中。

文件用 Windows操作系统中的“记事本” 编写，也可以用其它一些常用的文本编辑器编写，只须储存成相应的格式 。

5.4.2 建立一个项目

建立一个项目的步骤：

（ 1 ）单击桌面上的 CCStudio 3.1 图标。

安装好 CCS3.1 调试仿真软件。

（ 2 ）选择 Project→New 选项。

输入名称，并存于相应的子目录中。该子目录必须包含前面所述的 4种类型的文件。

（ 3 ）选择 Project→Add Files to Project 选项，然后找到前面所述的子目录，将该项目中用到的 *.asm ，*.s* ， *.cmd ， *.o* ， *.lib 等文件添加到该项目中。

如果程序中调用了一些库函数，比如 _atan 、 _sqrt 、_cos 、 _sin 等，则需将这些函数所在的库文件添加到该项目中。

把 C 语言文件、汇编语言文件、命令文件和 rts2xx . lib 文件添加到当前项目后，头文件不需要用户自己添加，只要头文件和项目在同一个目录下，链接时调试工具将自动识别。

在安装目录之下会出现一个文件夹 C:\CCStudio_v3.1\MyProjects ，可将用户调试的项目放在该文件夹中，也可以将项目放在其它子目录。

一个项目的信息储存在一个项目文件中 (*.pjt) 。当项目中建立多个文件时，每个文件名都是唯一的。

注意：由于不同项目使用的源程序文件和头文件不尽完全相同，所以最好每个项目选择一个文件夹，保存自己的源程序文件和头文件，以便把不同的项目区分开来。

5.4.3 编译环境的简单配置选择 Option→Customize 选项

选择 Load Program After Build 选项，在每次 Build （重建）源程序文件之后，如果没有语法错误，则生成的可执行代码将自动下载到 DSP芯片中。

5.4.4 编译源程序文件

选择 Project→Build 选项，则可实现 C 源程序文件的编译。

如果没有语法错误，则可直接生成可执行代码并直接下载到 DSP芯片中；

如果有语法错误或其它类型的错误，则编译器会给出相应的提示，根据提示改掉错误后，再进行同样的操作，直到没有任何错误为止。

编译和运行程序步骤（ 1 ） 选择 Project→Rebuild All 选项，或者单击工具条中的 按钮。

CCS 就会重编译、汇编并链接项目中所有的文件。

如果在汇编链接过程中没有错误，则生成一个名字和项目名相同的可下载执行的输出文件 .out 文件；

如果在编译链接过程中出现错误，则系统会提示该错误的类型和位置，用户可根据此信息返回到源程序中修改。

（ 2) 默认的“ . out” 文件放在项目的调试目录中。

要想改变这个目录，可以在 CCS 工具条中选择不同的目录。（ 3 ） 选择 File→Load Program 选项（下载程序），则调试工具将 .out 文件下载到实验开发板上。也可以在 CCS 中直接设置编译完后直接下载功能，这样每次编译后可以自动完成程序下载。当 .out 文件下载之后，就可对源程序进行仿真调试。（ 4 ） 选择 View→Mixed Source 选项。可以直接观察 C 源程序代码以及汇编的结果代码。（ 5 ） 选择 Debug→Go Main 选项。可以直接开始主程序的执行。执行就暂停在主程序入口并用标示。

（ 6 ） 选择 Debug→Run 选项或者单击运行工具栏中的按钮可以运行程序。当用户执行程序很大时，又想观察程序执行到某处相应寄存器的值，可以将 run 和 Break Points 一起使用。程序运行到断点处自动停止，重新选择 run 之后又可继续运行。

在调试过程中，对于数据存储器空间中的某些单元可以进行修改，以满足调试的需要。

（ 7 ）选择 Debug →StepInto 选项或快捷键 F8 可以进行单步调试。在调试过程中，菜单栏 Debug 调试中给出了一些调试选项，用户可以选择单步执行并进入子程序 StepInto 来观察程序执行每一步时相应寄存器单元的变化，或者选择单步执行但不进入子程序 Step Over 来观察执行子程序的结果，或者采用全速运行 run 来运行程序等。（ 8 ） 选择 Debug→Halt 选项，可以暂停正在运行的程序。（ 9 ） 可以在 GEL 菜单下查看程序执行过程中寄存器的变化。

View→Register 选项

将 CPU 寄存器和状态寄存器窗口打开，在 CPU 寄存器中，用户可观察到在仿真过程中累加器、乘积寄存器、状态寄存器、 PC 指针、数据页指针 DP 、全局中断屏蔽寄存器、全局中断标志寄存器以及 8个辅助寄存器的单元值变化状况。

选择 View→Memory 选项

输入该外设所处的地址范围，例如在作 A/D 采样时希望知道采样的结果寄存器中的值，则输入地址为 70A0h ，选择 page （页面）为 data （数据）页，其它选项采用默认值，则系统将打开一个从 70A0h 开始的数据存储器空间，用户就可以很方便的观察到 A/D 采样的结果。

View→ Watch window 选项

输入要观察的变量或表达式，调试工具就打开一个Watch 窗口，显示变量或表达式的值。