DSP

开发DSP/BIOS程序

2019-07-13 10:12发布

本章通过使用DSP/BIOS优化第二章中的hello world实例介绍DSP/BIOS及如何创建、编译、调试和测试使用DSP/BIOS编写的程序。

    基本要求:CCS的DSP/BIOS组件,目标板。

3.1 创建配置文件
    实现hello world程序的另一种方法是使用DSP/BIOS API的LOG模块,它能在嵌入式程序中提供基本运行服务。对于实时DSP上的应用而言,API模块是最优的。与诸如put()这样的C库函数调用不同,API无需中止目标板中运行的应用程序就能进行实时分析。此外,API代码比标准C库函数的I/O占用空间少且运行快,根据程序需要可使用一个或多个DSP/BIOS模块。

    本章使用DSP/BIOS API修改第二章中的应用程序 (如果要跳过第二章,则须从2.1和2.2节开始)。

    在使用DSP/BIOS API的程序中必须创建一个配置文件,它定义了程序中使用的所有DSP/BIOS对象。本节介绍如何创建配置文件。

1.   
如果已经关闭了CCS,则重新开始。选择Project→Open重新打开c:/ti/myprojects/hello1文件夹中的myhello.mak 项目(如你安装其它地方,则在所安装的地方打开含有myprojects的文件夹。)

2.    选择File→New→DSP/BIOS  Config,弹出一个含有“c54xx.cdb”和“sd54.cdb”的窗口。

3.    在此窗口中选择与你的系统板相适应的DSP模板,然后点击OK(TMS320C54X DSP/BIOS 用户指南阐述了怎样创建一个用户模板),将出现上面这样一个窗口,点击左边的+和-字符能扩张和收缩列表单,窗口右边显示窗口左边选中对象的属性。

4.    在LOG-Event Log Manager处点击鼠标右键,从弹出菜单中选择Insert LOG, 这时创建一个名为LOG0的LOG对象。

5.   
在LOG0处点击鼠标右键,从弹出菜单中选择Rename,键入trace即改变此对象名称为trace。

6.    选择File→Save。在弹出窗口中选择你的工作路径(通常是c:/ti/myprojects/hello 1),并将此配置保存为myhello.cdb,实际上创建了下述文件:

o    myhello.cdb     保存配置设置

o    myhellocfg.cmd  连接命令文件

o    myhellocfg.s54   汇编语言源文件

o    myhellocfg.h54   由myhellocfg.h54包含的汇编语言头文件



3.2 向工程添加DSP/BIOS文件
    回顾上节所建立的配置文件,它实际上包括四个新文件myhello.cdb、myhellocfg.cmd、myhellocfg.s54、myhellocfg.h54。本节介绍如何向工程添加这些文件并删除被取代的文件。

1.    选择Project→Add Files to Project  在弹出窗口的文件类型框中选择配置文件(*.cdb),然后选择myhello.cdb并点击Open。注意此时在Project View中的DSP/BIOS Config文件夹下面包含配置文件myhello.cdb。另外,myhellocfg.s54作为源文件出现在source文件夹中。注意在编译工程文件的过程中,CCS在扫描文件间的依赖关系时自动向工程中添加包含文件(在此添加的是myhellocfg.h54)。

2.    输出文件名必须与.cdb文件名匹配(myhello.out和 myhello.cdb)。选择Project→Options 将出现Build Option窗口,然后选择Linker ,在Output Filename栏中确认输出文件名为myhello.out,点击OK。

3.   
再次选择Project→Add  Files to Project,在弹出窗口的文件类型栏中选择Linker Command File(*.cmd), 再选择文件myhellocfg.cmd并点击Open,随之产生如下消息框:

4.    点击Yes,则加入新生成的配置文件myhellocfg.cmd并取代hello.cmd。

5.    在Project View中的vectors.asm源文件上点击鼠标右键,然后从弹出菜单中选择Remove from project。DSP/BIOS配置文件将自动定义硬中断矢量。

6.    在RTS.lib库文件处点击鼠标右键将它从project中删除。该库已经由myhellocfg.cmd文件自动包含。

7.    双击程序hello.c打开并编辑该文件,在弹出的代码框中如果显示了汇编指令,则选择View→Mixed  Source/ASM可隐藏汇编代码。

8.    源文件中需修改的内容如下。(可以从c:/ti/c5400/tutorial/hello2/hello.c中复制和粘贴)由于puts()和 LOG_printf使用同样的资源,你必须确保使用下面的主函数取代当前存在的主函数。

/* ======== hello.c ======== */

/* DSP/BIOS header files*/

#include

#include

/* Objects created by the Configuration Tool */

extern LOG_Obj trace;

/* ======== main ======== */

Void main()

{

LOG_printf(&trace, "hello world!");

/* fall into DSP/BIOS idle loop */

return;

}

9.    注意源程序中的下述几点:

(1)C源程序中包含std.h 和 log.h头文件。所有使用DSP/BIOS API的程序都必须包含头文件std.h 和 log.h。在LOG模块中头文件log.h定义了LOG_Obj的结构并阐述了API的功能。源代码中必须首先包含std.h,而其余模块的顺序并不重要。

(2)源程序中声明了配置文件中创建的LOG对象。

(3)主函数中,通过调用LOG_printf,将LOG对象的地址(&trace)和hello world信息传到LOG_printf。

(4)主函数返回时,程序进入DSP/BIOS空循环,DSP/BIOS在空循环中等待软中断和硬中断信号,第五、六、七章将阐述这些内容。

10.  选择File→Save 或按Ctrl+S保存修改后的源程序。

11.  选择Project→Optins,在弹出窗口中选择Compiler,然后选择Category中的 Symbols,并在define symbols中删除FILEIO, 然后点击OK。

12.  点击工具栏按钮或选择Project→Rebuild  All 。



3.3 用CCS 测试
    由于使用LOG的程序只写了一行,没有更多的内容需要分析。在第五、六、七章中将用更多的方法分析程序功能。

1.    选择File→Load Program 选取myhello.out并点击open。

2.    选择Debug→Go Main。

3.    选择Tools→DSP/BIOS→Message Log,在CCS 窗口底部出现一个Message Log 窗口。

4.    在Message Log窗口中点击鼠标右键,从弹出的菜单中选择Property Page。

5.    选择trace作为监视对象,然后点击OK。缺省的刷新频率为1秒。(如果要修改刷新频率,可选择Tools→DSP/BIOS→RTA Control Panel。在RTA Control Panel处点击鼠标右键,选择Property Page并选取一个新的刷新频率,点击OK。)

6.   
选择Debug→Run 或按F5。 hello world信息将出现在Message Log 区域内。

7.    选择Debug→Halt或按 Shift F5暂停程序运行。主函数返回后,程序在DSP/BIOS空循环中等待中断信号,欲了解空循环的更多信息,请参见3.5节。

8.    在Message Log中点击鼠标右键,然后选择Close关闭Message Log。在下一节中将使用Profiler,因此必须关闭Message Log。

9.    选择Tools→RTDX启动RTDX插件,并从下拉的菜单中选取RTDX disable,然后点击鼠标右键并选择Hide。                                 

    注意:在某些目标系统中Profiling 和RTDX不能同时使用。


    在使用Profiling前,关闭使用RTDX的工具,如Message Log或其它的DSP/BIOS 插件。特别是在使用DSP/BIOS插件后,必须确保RTDX无效,选ToolsRTDX启动RTDX 插件,并从下拉菜单中选取RTDX disable,然后点击鼠标右键再选择Hide。反之亦然,如2.8节所述。

当试图同时使用Profiling和RTDX时将导致错误信息,见上图。



3.4 测算DSP/BIOS代码执行时间
LOG_printf所需的指令周期数,可像前面的puts()一样,利用CCS的功能来测算。

1.    选择File→Reload Program。

2.    选择Profiler→Enable Clock,在Enable Clock旁边可见到√。

3.    在Project View中,双击hello.c文件。

4.    选择View→Mixed Source/ASM,则灰 {MOD}的汇编指令紧随C源程序。

5.    将光标放在LOG_printf(&trace, "hello world!")行上。

6.    点击工具栏按钮(Toggle Profile-point),则这一行和其下一行的汇编指令变为绿 {MOD}高亮显示。

7.    向下移动滚动条,把光标放在程序结尾的大括号所在的行上,然后点击工具栏按钮(Toggle Profile-point),你可能会认为在程序的return行上设置了第二个测试点。但是,要注意直到大括号后一直没有相应的汇编语言显示出来。如果在return这一行上设置了测试点,CCS 将在程序运行时自动纠正这一问题。

8.    选择Project→View Statistics。

9.    点击(Run)工具栏按钮或按F5运行程序。

10.  
注意在第二个测试点显示的指令周期数为58(实际中可能稍有不同),这是执行LOG_printf函数需要的指令周期数。由于字符串的格式化在PC主机上、而不是在目标系统DSP上完成,因此调用LOG_printf的效率很高。LOG_printf需要的58个指令周期,而在第二章结束时测试的put()则需要2800个指令周期。在应用程序中调用LOG_printf监视系统状态对程序执行几乎没有影响。

11.  点击工具栏按钮或按Shift F5暂停程序运行。

12.  在进行下一章的工作之前(3.5节结束之后)做下述工作,释放测试时占用的资源。

o  进入Profiler 菜单,撤消Enable Clock前的“√”。

o  在Profiler Statistics 窗口中点击鼠标右键,并从打开的菜单选择Hide

o  选取Profiler→Profile-points,然后选择Delete All ,点击OK。

o  进入View菜单,撤消Mixed Source/ASM前的“√”。

o  关闭所有的源文件和配置窗口。

o  选择Project→Close关闭Project



3.5 进一步探索
     为进一步了解CCS,试作如下工作:

o    加载myhello.out 并在LOG_printf行设置断点,选取Debug→Breakpoints并在IDL_F_loop上设置断点。(在弹出对话框的Location栏中键入IDL_F_loop,并点击Add)。

运行程序 在第一个断点处,使用View CPU Registers CPU Registers观察寄存器值。注意:当主函数执行时,INTM=1表明中断非使能。

运行到下一个断点 注意现在INTM=0,表明中断使能。注意在执行程序时将重复遇到该断点。

启动进程和主函数执行完毕后,DSP/BIOS应用程序将进入空循环的后台线程。空循环由IDL 模块管理, 直到程序暂停时才结束工作;它在中断使能有效时循环,且允许响应任一ISR中断信号,能满足实时任务处理的要求。第五、六、七章将进一步阐述ISRs和DSP/BIOS的软中断。

o    在MS-DOS窗口中,键入以下命令行可运行sectti.exe程序。如果安装路径不是c:/ti,则须将路径修改为安装了CCS 的目录路径。

            cd c:/ti/c5400/tutorial/hello1

                sectti hello.out > hello1.prn

                cd ../hello2

                sectti hello.out > hello2.prn

比较hello1.prn和 hello2.prn文件可以发现使用stdio.h和DSP/BIOS时存储器段和空间大小的差别。与使用stdio中的puts()函数相比,DSP/BIOS调用LOG_printf时.text段占用的空间小。有关sectti工具的其它信息可参见TMS320C54x DSP/BIOS 用户指南。

3.6 进一步学习
进一步学习使用CCS 和DSP/BIOS,请参见CCS中 的在线帮助,也可参见CCS 用户指南和TMS320C54x  DSP/BIOS 用户指南。