本文档主要介绍 YLog 的使用方法。
1、YLog 介绍
1.1 概述
展锐 Log 抓取方式分为在线方式和离线方式。在线方式指 PC 方式抓取 Log。离线方式可离线工作并获 取 Log,早期叫 SLog,后来升级为 YLog(Your Log)。 YLog 是一个 C 语言编写的守护程序,运行于
安卓系统的 native 层,用于收集
手机中各
模块输出的各种 Log,以文件形式保存在手机内存或手机 SD 卡中,便于开发者查看及定位分析问题。 YLog 通过工程暗码进入,在拨号键盘输入*#*#83781#*#*进入
工程模式,在菜单 DEBUG&LOG 中选择 YLog 选项,进入 YLog 功能主界面,如图 1-1 所示。
1. YLog 开关及 YLog 当前场景:蓝色表示开启,灰色表示关闭。
2. 内部存储使用情况:红色表示已使用的空间,灰色表示剩余空间。
3. 当前场景 Log 内容信息:表示当前场景下 Log 输出的模块信息,如 AP Log、
Modem Log 等,与选择的场景息息相关。
4. 当前场景 Log 存储路径:表示 Log 当前的储存位置。
5. 当前场景 Log 存储时间:表示 Log 从开始抓取的持续时间,停止抓取后计时清零。
1.2 Log 种类介绍
展锐
芯片分为有独立 AG
DSP 模块的芯片和无独立 AGDSP 模块的芯片:
-有独立AGDSP模块是指有单独的
Audio DSP,如
UMS512 等芯片。
-无独立AGDSP模块是指Audio和PHY_
GSM共用一个 DSP,如
SC9863A、
sc9832E、
SC7731E等芯片。在有独立AGDSP模块的芯片上,YLog所抓取的Log种类信息如表1-1所示:
Log种类 | Log名 | Log描述 |
AP | Androidlog | main、system>rADIo、events>crash各个缓冲中的log |
kernellog | 读取/proc/kmsg的log |
apcaplog | AP侧Tcpdumplog |
bthcilog | host和controller交互时打印的蓝牙log |
Modem | pslog | 协议栈log |
armpcmlog | 语音通话相关armpcm数据 |
agdsplog | AudioDSP模块log |
agdsppcmlog | AudioDSP模块pcm数据 |
dsplog | 物理层log |
Connectivity | wenlog | 包括BT/wifi/FM相关log |
GNSSlog | 定位相关log |
Others | cpcaplog | CP侧Tcpdumplog |
sensorhublog | sensorhub处理器的log |
dsppcmlog | 语音通话相关dspmem数据 |
在无独立 AGDSP 模块的芯片上,YLog 所抓取的 Log 无 agdsp log 及 agdsp pcm log,其余与表 1-1 中一致。
2、YLog 版本说明
YLog 的版本号可以在 YLog 主界面看到,如图 2-1 所示:
2.1 YLog 版本变更历史
YLog 版本变更历史如表 2-1 所示:
YLog版本号 | 变更记录 |
2.1 | •修改AP Log存储位置:AP Log保存在ylog/ap目录下(之前在ylog目录 下)
•修改AP Log目录文件名:AP Log达到单个目录限制大小后会创建新的Log 目录保存,新建的Log目录名称中包含Log起始和终止时间
•优化AP Log配额管理策略:空间足够时各类Log无存储比例限制,空间紧张时恢复默认限制
•新增AP poweron log单独保存在ylog/ap/poweron目录下 |
3.0 | •扩大Log压缩的范围(原来只支持android log压缩,现在 kernel/sysinfo/hcidump/tcpdump等也支持压缩),提高IO写效率,同时减 少磁盘的消耗
•各类Log都压缩到同一个压缩文件中,减少系统开销,同时便于Log管理
•优化架构,支持可配置的Log source加载,便于增加新的Log类型输出
•取消history log目录重命名操作,解决history log丢失问题
•优化与Logmanger的通讯指令,减少通讯中出现问题的概率
•修改了 YLog存储策略,移除了最大40%空间占用的限制
•优化了 tcpdump/hcidump log机制,避免了格式错误问题
•优化了工厂模式抓取Log机制,确保工厂Log能抓取 |
4.0 | •新增抓取 Uboot log/lastlog (上次重启时的 android、kernel log)
•修复android/ylog crash可能导致丢失Log问题
•优化Log打开/关闭/清除性能 |
4.1 | •修改默认log存储路径为data/ylog,删除存储路径切换sd卡方式
•删除Get all log功能
•新增Log拷贝到SD卡功能 |
更多内容请下载附件查看