要使用GT_Trace,需要在应用程序文件夹下的remote.cfg文件中将GT_Trace的配置:
//TraceUtil.attrs = TraceUtil.SOCRATES_TRACING;
TraceUtil.attrs = TraceUtil.FULL_TRACING;
//TraceUtil.attrs = TraceUtil.DEFAULT_TRACING;
//TraceUtil.attrs = TraceUtil.NO_TRACING;
要在终端上打印DEBUG信息,很简单。只需要在执行命令前加上CE_DEBUG=n,n=1,2,3即可:
在代码中使用Generic Trace Support:
首先,我们要定义一个GT_Mask对象,GT_Mask是用来描述GT模块的对象,它的定义如下:
typedef struct {
String modName;
UInt8 *flags;
} GT_Mask;
我们在程序中可以这样定义:
GT_Mask curMask = {0,0};
然后,调用初始化函数:
GT_create(&curMask, "snowwaft");
GT_set("snowwaft=01234567");
上面的代码,我们给curMask设定了名字:snowwaft,将它的级别设为0-7(有关级别,后面会描述)。
当完成以上工作后,我们就可以使用GT模块来输出信息了:
GT_0trace(curMask, GT_2CLASS, "main>; Welcome to DSP server's main().\n");
屏幕会输出如下结果:
[DSP] @0×000001a2:[T:0x00000000] snowwaft - main> Welcome to DSP server’s main().
关于GT_*trace宏,以上我们使用GT_0trace宏来输出信息,同样的,我们还可以使用以下宏:
GT_0trace( mask, classId, format )
GT_1trace( mask, classId, format, arg1 )
GT_2trace( mask, classId, format, arg1, arg2 )
GT_3trace( mask, classId, format, arg1, arg2, arg3 )
GT_4trace( mask, classId, format, arg1, arg2, arg3, arg4 )
GT_5trace( mask, classId, format, arg1, arg2, arg3, arg4, arg5 )
GT_6trace( mask, classId, format, arg1, arg2, arg3, arg4, arg5, arg6 )
这些宏分别定义了输出1个、2个、……、6个参数的使用方式,例如,我们需要输出两个参数:
GT_2trace(curMask, GT_2CLASS, "App->; Decode frame %d (0x%x)\n",p1,p2);
关于GT_*CLASS宏,在GT_*trace宏里,第二个参数为classId,这个参数是什么用的呢?某些时候,我们在打印Trace信息的时候,有可能希望只打印某些级别的信息,而不打印其他级别的信息,因此,我们指定classID。
在GT Module里一共定义了7种级别:
#define GT_1CLASS ((UInt8)0x02)
#define GT_2CLASS ((UInt8)0x04)
#define GT_3CLASS ((UInt8)0x08)
#define GT_4CLASS ((UInt8)0x10)
#define GT_5CLASS ((UInt8)0x20)
#define GT_6CLASS ((UInt8)0x40)
#define GT_7CLASS ((UInt8)0x80)
这7种级别分别表示:
GT_1CLASS : 纯粹的Debug信息
GT_2CLASS : 由开发人员指定,告诉使用人员这这条信息可能有用
GT_3CLASS : 进入某个模块
GT_4CLASS : 由开发人员指定,告诉使用人员这是比较重要的信息
GT_5CLASS : 标记
GT_6CLASS : 警告
GT_7CLASS : 错误
不难理解,为什么我们要在调用GT_set时制定:snowwaft=01234567,这表示,对于snowwaft这个GT_Mask,我们关心的信息包括以上所有部分,而0,则表示进入、退出某个函数的报告。
【小节】使用GT_Mask,可以在DSP端和ARM端间打印信息,这在一定程度上方便了我们调试信息。