Spreadtrum Android 8805和8810抓取LOG环境安装和方法V1.0.5.doc

Spreadtrum Android 8805G和8810G抓取LOG环境安装和方法Version: 1.0.5DocCode: Date: 2012-04-05A-15 重要声明版权声明本文档中的任何内容受中华人民共和国著作权法的保护，版权所有 2010, 展讯通信有限公司，保留所有权利，但注明引用其他方的内容除外。商标声明展讯通信有限公司和展讯通信有限公司的产品是展讯通信有限公司专有。在提及其他公司及其产品时将使用各自公司所拥有的商标，这种使用的目的仅限于引用。不作保证声明展讯通信有限公司不对此文档中的任何内容作任何明示或暗示的陈述或保证，而且不对特定目的的适销性及适用性或者任何间接、特殊或连带的损失承担任何责任。保密声明本文档（包括任何附件）包含的信息是保密信息。接收人了解其获得的本文档是保密的，除用于规定的目的外不得用于任何目的，也不得将本文档泄露给任何第三方。前 言文档说明本文档针对展讯SC8805G/SC8810G Android抓取log的环境安装和使用方法。阅读对象本文档提供给展讯基带芯片SC8805G/SC8810G进行相关设计的客户及内部相关工程师。内容介绍本文档包括若干章节文档约定本文档采用下面醒目标志来表示在操作过程中应该特别注意的地方。注意：提醒操作中应注意的事项。说明：说明比较重要的事项。本文档中描述为【推荐使用】字样，表示其和展讯SC8805G/SC8810G平台参考设计一致。建议客户设计最好参照【推荐使用】，这样底层驱动改动最小，有利于产品软件开发。相关文档无附录A 修改记录VersionDateOwnerNotes1.0.02011-09-01JZCreated1.0.12012-01-11XQModified1.0.22012-02-06XQAdd dsp log through USB1.0.32012-02-09XQRevise a clerical error, Add card log for Android and ARM1.0.42012-02-10XQAdd log saved to SD card, Add other logs and log bat file.1.0.52012-04-05XQRevise error for DSP log endian to Little Endian.目 录附录A 修改记录ii第1章 Spreadtrum Android LOG简介1-1第2章 环境安装和工具2-22.1 USB驱动安装2.1-22.2 adb和fastboot工具2.2-32.3 写入USB VID2.3-32.4 ARM LOG工具2.4-42.5 DSP LOG工具2.5-4第3章 Log 抓取3-53.1 Android log3.1-53.2 Kernel log3.2-53.3 Modem ARM log3.3-53.4 通过串口1获取Modem DSP log3.4-83.5 通过USB口获取Modem DSP log3.5-11第4章 SD卡自动存Log4-134.1 如何操作Android log存在SD卡里？4.1-134.2 如何操作ARM log存在SD卡里？4.2-134.3 SD卡自动存Android log的相关代码介绍4.3-13第5章 其他Log说明5-145.1 如何抓取网络相关的数据业务的log？5.1-145.2 电话，消息，SIM卡电话本，PIN码相关，STK相关等问题需要哪些log？5.2-145.3 “冻屏”、“定屏”、“变砖”以后怎么办？5.3-145.4 如何使用脚本一次性抓取大量LOG？5.4-15 第1章 Spreadtrum Android LOG简介Spreadtrum Android手机分为AP和Modem两部分。其中AP部分运行Android，抓取Log的方法和其它Android手机一样，在Windows下和Ubuntu下均可以抓取。而MODEM部分运行spreadtrum通信协议，抓取Log的方法和spreadtrum的feature手机一样，仅在Windows下可以获取。所以，在Spreadtrum Android手机上调试和测试过程中可能需要获取三种Log: Modem DSP log，Modem ARM log和Andorid 及Linux kernel log。其中，Modem DSP Log可以从uart1或者USB输出，Modem ARM Log从USB口输出，而Android和Kernel Log从USB口输出。另外，在adb没有起来之前，对于开机调试uboot和kernel，可以通过Uart1抓取log。开机时uboot的log直接从uart1出来，而kernel log要从uart1出来，必须要修改nvitem，NVitemGSM_DownloadParamlog_switch_structDSP_log_switch: 1代表出DSPlog，0代表出kernel log。Modem DSP Log输出端口控制通过nvitem作如下修改：NVitemnv_typeNV_REF_PARAMETERdsp_log_set=2USB方式抓取DSP logNVitemnv_typeNV_REF_PARAMETERdsp_log_set=1Uart1方式抓取DSP log8805上后期支持Modem DSP Log输出端口控制，名字为dsp_log_mode，含义同上。第2章 环境安装和工具2.1 USB驱动安装Android手机USB为复合设备，包括adb, usb mass storage, rndis, usb2serial等。Spreadtrum提供了Windows下的驱动安装文件SCI-android-usb-driver-jungo.rar，以下为安装步骤：1, 拔掉手机2, 打开驱动目录 (x86 for 32bit, amd64 for 64bit), 双击DpInst.exe.3, 点击next开始安装4, 用USB线连接PC和手机5, 弹出new device found窗口后选择相应文件目录安装即可。安装完毕在设备管理器里面会显示如下新设备：在Windows下如果要安装Fastboot驱动，其文件和这里adb使用的驱动文件一样。在Windows下如果要安装USB 绑定的驱动，其文件也在这个驱动文件包里。Ubuntu下不需要安装驱动，将正常开机的手机连接到电脑。运行lsusb命令会显示出一个ID 1782:5d04 Spreadtrum Communications Inc.的设备，这个就是spreadtrum的adb设备。2.2 adb和fastboot工具windows下的adb.exe和fastboot.exe都位于Google发布的标准Android SDK包里面。Ubuntu下的adb和fastboot在编译完Android之后，可以在out/host/linux-x86/bin下找到。2.3 写入USB VID要使adb正常工作，要把spreadtrum USB VID就是0x1782写入相应的adb_usb.ini文件。在Windows下：cd %USERPROFILE%md .androidcd .android创建文件adb_usb.ini，并写入0x1782，存盘退出。为使用正常，最好重启Windows。连接手机，运行D:Android-SDKandroid-sdk-windowstoolsadb devices命令，返回：List of devices attached19761202 device就表明adb正确安装了，可以使用adb的命令了。在Ubuntu下：cd mkdir .androidcd .android创建文件adb_usb.ini，并写入0x1782，存盘退出。连接手机，在Ubuntu下运行adb devices命令，返回：List of devices attached19761202 device就表明adb正确安装了，可以使用adb的命令了。2.4 ARM LOG工具在配套的工具包里面，运行Logel_for_TD_custbinArmLogelC.exe。2.5 DSP LOG工具在配套的工具包里面，运行DSPLOGGERBinDspLogger.exe。第3章 Log 抓取3.1 Android logSpreadtrum Android手机的Android log和其它任何Android手机一样，采用adb logcat来抓取main，radio， event等log。在Windows或者Ubuntu机器上，命令行里输入：adb logcat v timeadb logcat v time b radioadb logcat v time b event可以得到带时间信息的相应log，注意要看时间值，所以加 -v time。3.2 Kernel logSpreadtrum Android手机的Kernel log和其它任何Android手机一样，使用命令为：adb shell #cat /proc/kmsg /显示所有输出的kernel log#cat /proc/kmsg |grep -i abcd /仅显示含字串abcd的kernel log行也可使用一行命令，adb shell cat /proc/kmsg来获取kernel log。3.3 Modem ARM log1. 运行ArmLogelC.exe,点击“IP settings” 菜单或者按钮2. 选择端口Type“Uart”, 端口port为“SCI Vendor U2S(DIAG)” Port, 点击OK如果设置DSP log也是从USB口出来，则需要使用channel server提供的端口，Type要选择Channel Server，Port也选择Channel Sever的端口相同，比如366663. 点击 “connect with MS” 按钮4. 点击“Logging” 按钮5. 此时arm log信息会出来：3.4 通过串口1获取Modem DSP logDSP log可以通过手机串口1输出，也可以通过USB口输出。如果通过串口1输出，则需经过串转U设备连接到PC的USB口。如果是使用spreadtrum提供的红盒子作串/U转换，需要安装对应驱动。1. 运行运行DSP log工具DspLogger.exe，点击“Settings” 按钮。2. 选择正确的UART口, 设置波特率为 “2000000”, 然后点击“OK” 按钮。Endian为Little Endian。3. 点击“Connect” 按钮4. 点击“Start logging test points” 按钮5. DSP log可以接收到并显示：3.5 通过USB口获取Modem DSP log1. 硬件连线：直接用一根USB线连接手机和PC，不需要使用串转U或者连接红盒子。2. Channel Server设置用USB方式输出DSP log必须连接Channel Server，ChannelServer设置如下图：1) Type：设置成UART2) Port：根据实际情况选择，如果安装的是Jungo驱动，选择SPRD U2S Diag端口3) BaudRate：设置成4608004) Endian：根据手机版本选择，8805G/8810版本为小端版本，选择Little Endian。5) WinSocket Server Port：保持默认的36666即可，如需在同一台笔记本上同时接多台手机，则需要开多个channel server，并且将Port设置成不同值3. DSP Logger工具设置1) Socket IP address：设置成，即本机2) Port：和Channel Server中WinSocket Server Port保持一致3) Endian：根据手机版本选择，8805G/8810版本为小端版本，选择Little Endian。4. Assert后log保存方法a. 在Armlogel的assert窗口中输入m,，其作用是：Print DSP assert info，当DSP Assert信息Dump完毕后会提示“Dump DSP Assert Information finished！”b. 保存DSP log，此时除了保存下tp文件以外，在同一目录下还会保存1个.dump文件c. 在assert窗口依次输入8-1后，保存Arm log第4章 SD卡自动存Log4.1 如何操作Android log存在SD卡里？ 回答：/sdcard/logs4android/logs4android-0/目录保存了开机后android记录的所有log，包括 logcat和logcat b radio的Android消息以及cat /proc/kmsg的内核信息等。如果重新开机，老的log保存在1里面。4.2 如何操作ARM log存在SD卡里？ T卡存ARM LOG功能已实现，可通过工程模式*#*#83781#*#*开关。*#*#83781#*#* - Log Settings - Modem Arm Log - SDCard，即可捕捉log到sd卡logs4modem目录*#*#83781#*#* - Log Settings - Modem Arm Log - PC，即可停止捕捉log到sd卡不过在有条件的情况下，建议使用正常的PC抓Log的方式，减少Log数据不足的风险。4.3 SD卡自动存Android log的相关代码介绍在3rdparty/tools/tools-binary/special/tools/目录中含有如下脚本. logs4android.sdcard.umount.sh./tools/tools-binary/special/tools/logs4android.bt.sh./tools/tools-binary/special/tools/logs4android.bt.service.sh./tools/tools-binary/special/tools/logs4android.sh在3rdparty /tools/tools-binary/special/init.3rdparty.rc文件中有如下内容：service logs4android /system/bin/logwrapper /system/xbin/logs4android.sh eng# disabledservice logs4androidbt /system/bin/logwrapper /system/xbin/logs4android.bt.service.sh eng disabled oneshoton property:logs4android.enable=1 start logs4androidon property:logs4android.enable=0stop logs4android以上这些内容在编译时会复制到/system/sps/init/init.sp8805ga.3rdparty.rc文件中，在开机时调用，直接运行。其中 eng表明仅在eng模式，就是Android 调试模式下运行。第5章 其他Log说明除了前面说到的通用的Android logcat, Android kernel log，MODEM ARM log，MODEM DSP log之外，还有以下一些log需要注意。最后，我们在windows系统下开发了抓取全部log的bat文件，可以在测试时统一使用。5.1 如何抓取网络相关的数据业务的log？ 在Android侧主要使用tcpdump命令来抓取网络应用相关的数据业务，比如彩信，浏览器，流媒体等应用。使用adb shell tcpdump命令来抓。adb shell tcpdump -i any -p -s 0 -w /sdcard/capture.pcap 会把CAP包存在SD卡目录上。用adb pull可以复制到电脑上。*#*#83782#*#* - PS related - Log Switch - CAP log 开启，连接 modem arm log工具进行操作，操作完成后保存log，即可在保存的log中生成cap包。有了第一种方法，正常情况不需要这种方法。5.2 电话，消息，SIM卡电话本，PIN码相关，STK相关等问题需要哪些log？ 这些问题都是和MODEM相关的，不仅在Android侧要抓main和radio的log，还需要modem的Log。一次抓全可避免发过来的Log不全，还要频繁要求客户复现问题抓Log。5.3 “冻屏”、“定屏”、“变砖”以后怎么办？ 如果出现“冻屏”、“定屏”状况，请观察下列信息并加入问题描述，对分析极有帮助： 1. logcat是否还在继续出，抓取下来。adb logcat -v time logcat_main.logadb logcat -v time -b radio logcat_radio.log2. kernel log (/proc/kmsg) 是否还在继续出，抓取下来。adb shell cat /proc/kmsg kmsg.log3. arm/dsp log是否还在继续出。 抓取arm/dsplog4. 看adb shell能否进入手机，观察data/anr/traces.txt文件时间是否和当前一致，抓取下来。adb pull /data/anr/* ./anr/adb pull /data/tombstones/* ./tombstones/adb bugreport bugreport.log出现问题之前请先清掉前次测试可能遗留的log adb shell rm -rf /data/anradb shell rm -rf /data/tombstones变砖后怎么办有时候会发现手机按任何键都没有反应，屏幕也不会刷新，通过usb连接到pc，pc也没有反应，俗称砖头的情况， 可能是kernel发生了panic。现在加入了一个机制，可以将panic时的message存储到flash上，下次开机可以获取出来。方法：发生panic后， 重新开机： 1.adb pull /data/dontpanic/apanic_console 2.adb pull /data/dontpanic/apanic_threads 以上两个文件如果发生了panic，就会有log存储下来。 3.adb pull /proc/last_kmsg (这个不一定有，只有在reboot的情况下才会有这个文件)5.4 如何使用脚本一次性抓