展迅调试工具使用心得
辛 琦
一、 简介
ChannelServer 和 Logel是展讯公司提供的手机实时诊断和测试工具。
ChannelServer提供手机和其他工具之间的数据中转服务。ChannelServer和手机用串口的方式连接，和其他作为客户端的各种工具之间则用socket的方式连接。
Logel则是ChannelServer的一个客户端，提供获取和按格式输出手机发送的调试信息的服务。
二、 ChannelServer
ChannelServer位于\SC6600D_BASE\Release\Tool_Cust\ChannelServer的bin目录下，而另一个Doc目录下则存放了ChannelServer的用户手册。
Bin目录下有如下的一些文件：
ChannelServer系统文件是ChannelServer 运行时需要的文件。
转发的数据日志文件记录了工具和手机之间通讯的数据包：
Tool_To_CS.log: 所有从工具发到ChannelServer的消息
CS_To_MS.log: 所有从ChannelServer发到MS的消息
MS_To_CS.log: 所有从MS发到ChannelServer的消息
CS_To_Tool.log: 所有从ChannelServer发到工具的消息
运行ChannelServer后，ChannelServer的图标会出现在Windows的托盘区：
右键点击该图标后出现菜单：
Configure：进入ChannelServer配置界面
Connect MSSim：连接到MS
Disconnect MSSim: 断开和MS的连接
MS Asserted: 设置ChannelServer为Assert状态。当MS已处于Assert状态时，而ChannelServer为了可以查看MS的内部状态信息，必须设置为Assert状态。ChannelServer处于Assert状态时，图标会变红。
LogData：选中则开始记录ChannelServer中转的数据日志。
Show&LogData：显示和记录ChannelServer中转的数据日志。弹出窗口的Clear按钮可以清除显示的数据。
About：ChannelServer的版本和作者信息
Exit：退出ChannelServer
三、 Logel
Logel位于\SC6600D_BASE\Release\Tool_Cust\Logel的bin目录下，而另一个Doc目录下则存放了Logel的用户手册。
Bin目录下存放的文件如下：
History目录下通常会有的一些文件：
以下是对定位问题有帮助的文件:
.ass：AssertFrame窗口中的操作的日志文件
.lst：Logel收到的消息的日志文件
.mem：手机内存Dump文件
运行Logel后，会出现Logel的主窗口：
关于Logel使用的介绍，请参见Reference库上的文档：
$/20050810-展讯软件文档/调试工具/Logel用户手册.doc:
四、 问题定位实例
当手机上出现Assert状态时，为了定位问题的方便，应当使用ChannelServer和Logel连接到手机，并获取相关的信息。
下面以一个实际的例子来介绍定位RS910手机上Assert问题的方法：
1、 在ccapp.c文件中的CC_HandleEnterNumWinMsg函数中插入一段Assert代码
SCI_TRACE_LOW( "win_id = %d, msg_id = %d, param = %x", win_id, msg_id, param );
SCI_PASSERT( 0, ("Test Assert") );
2、 打开手机，进入拨号界面，手机出现Assert状态。
3、 启动ChannelServer，连接到手机。
4、 选择ChannelServer右键菜单的MS Asserted，设置ChannelServer为Asserted状态。
5、 启动Logel，连接到ChannelServer，打开Logging开关。
6、 点击Logel的Assert菜单。
Assert菜单有3个选项：
Open Assert Frame：打开Assert窗口
Open Map File：打开符号映射文件。
Assert MS：使手机端出现Assert状态。
7、 由于手机已处于Assert状态，选择Open Assert Frame打开Assert窗口。
Assert窗口是一个使用命令行操作的窗口，支持的命令如下：
8、 键入1，查看Assert信息：
Assert信息分为3部分，版本信息、Assert信息、当前线程信息
＞ 1
＞
Current Version:
SW version: RS910-V1.1.2.RS910-V1.1.2
HW version: RS910-V1.1.0
＞
File: ccapp.c
Line: 8909
PASSERT(0)
＞
Current thread info:
＞
ID: 0x15
Name: T_P_APP
Tcb_Addr: 0x0404a9ec
Last_Err: 0xa
Stack_Start: 0x0404d8a0
Stack_End: 0x0404f7df
Queue_Name: Q_P_APP
Queue_Total: 256
Queue_Used: 2
Queue_Available: 254
Queue_Start: 0x0404f7e0
Queue_End: 0x0404fbe0
线程信息中包含了线程堆栈地址和队列的信息，对定位问题是非常有用的信息。
9、 键入8，查看调用栈：
最前面的就是当前Assert的线程，可以看到列出的都是函数地址，这是因为没有载入对应的符号映射文件。
＞ 8
＞
All Task Callback Function List:
＞
Current Task 21 (T_P_APP):
＞ Entry at [0x00007936]
＞ Entry at [0x0009acbc]
＞ Entry at [0x0003ddac]
＞ Entry at [0x0003a7ea]
＞ Entry at [0x0003a93c]
＞ Entry at [0x0003a97e]
＞ Entry at [0x000109f6]
＞ Entry at [0x00010b74]
＞ Entry at [0x000006f8]
＞ Entry at [0x00131ee4]
＞ ***Reach top of stack.***
选择Assert菜单下的Open Map File，载入编译的手机版本的目标库的符号映射文件：
再次键入命令8，可以看到函数地址都转换成了易读的函数名：
＞ 8
＞
All Task Callback Function List:
＞
Current Task 21 (T_P_APP):
＞ SCI_PAssert()
＞ CC_HandleEnterNumWinMsg()
＞ MMK_RunWinProc()
＞ MMK_DispatchToHandle()
＞ DispatchWinMSG()
＞ MMK_DispatchMSGQueue()
＞ MMI_ProcessMsg()
＞ APP_Task()
＞ _ThreadEntry()
＞ Entry at [0x00131ee4]
Ø ***Reach top of stack.***
10、 获取当前寄存器的信息
键入命令2，获取寄存器的信息，R13寄存器是当前堆栈的地址指针：
＞ 2
＞
R0 = 0x00007970 R1 = 0x00000093
R2 = 0x0000003f R3 = 0x20000013
R4 = 0x040500f4 R5 = 0x000022cd
R6 = 0x00007959 R7 = 0x00000000
R8 = 0x00000000 R9 = 0x00000000
R10 = 0x0404d8a0 R11 = 0x00000000
R12 = 0x00000000 R13 = 0x0404f668
R14 = 0x00007959 PC = 0x00007970
SPSR= 0x20000033 CPSR = 0x20000093
＞ SVC mode:
＞
R13 = 0x0404f668 R14 = 0x00007959
SPSR = 0x20000033
＞ IRQ mode:
＞
R13 = 0x043fc7fc R14 = 0x00150e94
SPSR = 0x00000033
＞ Abort mode:
＞
R13 = 0x043fca04 R14 = 0x00000000
SPSR = 0x00000010
＞ Undefined mode:
＞
R13 = 0x043fc9fc R14 = 0x00000000
SPSR = 0x00000010
11、 查看其他线程的堆栈信息
使用命令7，可以获得所有线程的堆栈使用信息：
＞ 7
＞
Stack info:
＞
Task_ID Name TotalSize[x1] Max_Used[x2] Available [x3] Cur_Ptr Start End
＞
0x0 T_CM 4096 1972 2124 0x040516cc 0x04050e80 0x04051e7f
＞
0x2 T_KPDSVR 800 656 500 0x04053164 0x04052f70 0x0405328f
＞
0x4 T_AUDIO 6896 356 6540 0x4000e51c 0x4000cb90 0x4000e67f
…….
12、 读取内存信息，分析函数调用栈
当前栈顶地址是0x0404f668，可以读取栈顶指向的内存地址，分析函数调用栈，
这是定位Assert问题的非常重要的手段。
＞ 9
＞
Read memory:
＞ Input address:
＞ 0x0404f668
＞ Input size(0＜ size ＜ 1024):
＞ 1024
＞ Read Memory Start Address: 0x0404f668 Size: 0x00000404
＞ 0x0404f668 0x00000000 0x0000a778 0x0000000b 0x01050100
＞ 0x0404f678 0x00007970 0x0404f668 0x00000039 0x0009ac1c
＞ 0x0404f688 0x00090d68 0x000022cd 0x040500f4 0x00000000
＞ 0x0404f698 0x00000000 0x00000000 0x00000000 0x0009ad0b
＞ 0x0404f6a8 0x040500f4 0x00000000 0x00000000 0x00000000
＞ 0x0404f6b8 0x00000000 0x00000000 0x00000000 0x00000000
＞ 0x0404f6c8 0x00000000 0x00000000 0x00000000 0x00000000
＞ 0x0404f6d8 0x00000000 0x00ef0123 0x00000000 0x0424b920
＞ 0x0404f6e8 0x00000000 0x0003beb3 0x00000000 0x00000001
[x4] ＞ 0x0404f6f8 0x000000ba 0x00000091 0x00000000 [x5] 0x0424bc58
＞ 0x0404f708 0x0424bc58 0x00000000 0x00000000 0x0003ddeb
＞ 0x0404f718 0x0424bc58 0x00000091 0x00000000 0x0424bc58
＞ 0x0404f728 0x00000000 0x0424bc58 0x00000000 0x0003a8b9
＞ 0x0404f738 0x00000001 0x00000002 0x0424bb10 0x00000000
＞ 0x0404f748 0x00000001 0x00000000 0x00000000 0x00000001
＞ 0x0404f758 0x0424bc58 0x00000091 0x00000000 0x0404f790
＞ 0x0404f768 0x00000000 0x00000000 0x00000000 0x0003a96b
＞ 0x0404f778 0x0404f790 0x00003217 0x00000000 0x0003a9ad
＞ 0x0404f788 0x00000001 0x00010a13 0x0424bc58 0x00000000
＞ 0x0404f798 0x00910000 0x00000000 0x00000000 0x00010c2d
＞ 0x0404f7a8 0x04239d50 0x00000000 0x00000000 0x00000737
＞ 0x0404f7b8 0x00010b75 0x00000000 0x00000000 0x00000000
＞ 0x0404f7c8 0x00000000 0x00131eff 0x00000000 0x00000000
＞ 0x0404f7d8 0x00000000 0x5a5a5a5a 0x042399e0 0x0423a160
…………..
13、 Dump手机内存，分配函数调用栈
要分析函数调用栈，还可以使用Dump手机内存的方法。
键入命令3：
＞ 3
＞
Dumping memory to a file, please wait ......
＞ ....................................................................................................................................................................................................................................................................................................................................... Saving memory data to the file:
E:\work\SC6600D_BASE\Release\Tool_Cust\Logel\Bin\History\2006_03_17_17_44_51_9960.mem
＞
Dumping memory completed !!!
＞
打开生成的Dump文件，用出现Assert的线程的堆栈地址减去0x04000000，就是该内存地址在文件中的映射地址。
但是T_AUDIO任务的线程堆栈起始地址为0x4000cb90，而Dump的手机内存映射文件只有4306KB，很显然不适用上面的方法。用命令9读一段T_AUDIO的堆栈内存数据，然后在映射文件中查找，发现T_AUDIO的堆栈位置和映射文件中的位置的差为0x3FBFF0C0。
14、 查看内存使用情况
定位内存分配方面的问题，则命令4会有所帮助。
命令4把所有调用了SCI_Alloc的代码位置和所申请的内存大小都打印了出来，可以帮助分析：
＞ 4
＞
Allocated memory info:
＞
No. Size FileName (Line)
＞
2 372 efs_item.c (Line 1472)
＞
3 800 efs_item.c (Line 1477)
＞
4 128 efs_item.c (Line 1478)
……
15、 查看内存堆使用情况
输入命令5，可以查看当前的内存堆使用情况：
＞ 5
＞
Memory Pool Information:
＞
Pool_Name Start_Addr End_Addr Total_Num[x6] Max_Used[x7] Avail_Num[x8]
＞
System uint8 heap[x9] 0x04065e60 0x0420ee60 1740800 142428 1602228
＞
pool_52 heap 0x0420ee60 0x0421e860 800 91 717
＞
pool_100 heap 0x0421e860 0x04221a60 100 6 97
＞
pool_300 heap 0x04221a60 0x04227410 70 10 61
＞
pool_600 heap 0x04227410 0x0422eeb8 50 7 45
＞
pool_1600 heap 0x0422eeb8 0x04256aa8 100 5 97
[x10]
需要注意的有2点：
1、 曾经使用的最大数目加上现在的可用数目应当大于等于最大可用数
2、 当固定大小的内存堆使用完后，再次申请会出现Assert。比如pool_100_heap已经使用了100个，当还想继续申请时，就会出现Assert。
16、 查看全局变量和静态变量
在定位问题时，可能还涉及到全局变量和静态变量，这时可以从编译生成的符号映射文件中，找到变量的地址，再用命令9或者从Dump的内存文件中获得该变量的值。
例如：
全局变量g_appinit_task_id在map文件中的定义如下：
g_appinit_task_id 0x04050830 Data 4 app_tasks.o(.bss)
从前面Dump下来的文件的偏移地址0x50830处，可以读到该变量的值。
参考文档：
Channel Server 用户手册.doc:
Logel用户手册.doc