Android STB 高效调试技巧
文章目录
-
- 一、编译
-
- 1.1 版本全编
- 1.2 模块单编
- 1.3 芯片特有单编模块
-
- 1.3.1 Uboot
- 1.3.2 boot.img&dt.img
- 二、调试
-
- 2.1 文件替换
-
- 2.1.1 常规文件替换
- 2.1.2 特殊文件替换
- 2.2 常用调试命令
-
- 2.2.1 ADB命令
- 2.2.2 LINUX命令
- 2.2.3 VIM命令
- 2.2.4 GIT命令
- 2.2.5 命令使用小技巧
- 三、积累关键功能调试经验
-
- 3.1 功能开关
- 3.2 调试思路
本系列文章：
Android STB 遥控器适配
Android STB ROM体积精简
Android STB 添加系统接口
Android STB 高效调试技巧
Android STB 海思平台调试
Android STB HDMI开发
Android STB 编译自定义jar
在开发机顶盒ROM时，有一些高效的开发技巧，可以让开发工作效率大大提升，本篇文章基于Android4.4.2系统，简单介绍下一些常见的高效调试方法。
一、编译
先说编译，是因为Android系统开发和Android应用开发有个明显不同的地方：完整ROM编译的时间会比较长，可能会达到一个小时以上，所以要谨慎全编版本。
1.1 版本全编
先简单说下全编译版本，此处就以Hi3798MV300为例介绍，全编ROM的过程分为3个步骤：
1>source build/envsetup.sh
该步骤其实是调用了build/envsetup.sh脚本，该脚本的作用是初始化编译环境，并引入一些辅助的Shell函数，如mm、mmm等。
2>lunch Hi3798MV300H-eng
该步骤是调用了lunch函数，这个函数后面的参数包含两部分：硬件类型和版本类型。
3>make bigfish -j 2>&1 | tee log_Hi3798MV300H.txt
此时开始真正编译，make bigfish是编译版本的命令；2>&1是将将标准错误重定向到标准输出；tee log_Hi3798MV300H.txt是从标准输入设备读取数据，将其内容输出到标准输出设备，同时保存成文件。简单来说，该命令的作用是：开始编译版本，并且将编译日志保存到系统代码根目录下的log_Hi3798MV300H.txt文件。
1.2 模块单编
说完了全编，接下来就要说单编某个模块。要单编模块，需要先执行source build/envsetup.sh和lunch Hi3798MV300H-eng命令，然后再执行单编命令。经常单编的模块如下：
1>apk
在packages/app/ApkName目录，执行mm -B即可。编出来的 Apk 一般在out/target/product/Hi3798MV300H/system/app目录。如在packages/app/Bluetooth目录下执行mm -B，则编出来的apk是out/target/product/Hi3798MV300H/system/app/Bluetooth.apk。
但也有特殊情况，如在packages/app/Settings目录执行mm -B，则编出来的apk是out/target/product/Hi3798MV300H/system/priv-app目录下。
关于system/priv-app和system/app的区别，可以简单理解为system/priv-app目录下的系统应用可以获取的权限更高一些。
2>jar
此处指的是修改framework代码，单编命令也是mm -B和mmm，常见的单编命令执行目录及其对应的jar如下：
| 目录 | jar |
|---|---|
| frameworks/base/services | services.jar |
| frameworks/base/policy | android.policy.jar |
| frameworks/base | framework.jar |
3>so
在调试播放器、HDMI等涉及到较底层代码时，常常会编译出so文件，如在device/hisilicon/bigfish/frameworks/hidisplaymanager/hal执行mm -B，会生成out/target/product/Hi3798MV300H/system/lib/hw/hidisplay.bigfish.so文件。
4>bin
在frameworks/base/cmds/bootanimation目录执行mm -B，会生成out/target/product/Hi3798MV300H/system/bin/bootanimation文件；在external/dhcpcd执行mm -B，会生成out/target/product/Hi3798MV300H/system/bin/dhcpcd文件。
1.3 芯片特有单编模块
除了这些公共的可以单编的模块，在不同的芯片平台，还有一些特殊的可以单编的模块，如在Amlogic905上，就有以下模块可以单编：
1.3.1 Uboot
即Amlogic的bootloader，此处以gxlx_p261.dts配置为例，编译uboot文件方式如下：
1、配置编译环境
export PATH=sdk路径/toolchain/gcc-arm-none-eabi-6-2017-q2-update/bin/:$PATH
2、修改makefile脚本
diff --git a/uboot/Makefile b/uboot/Makefile
index 641b28c..551c757 100755
--- a/uboot/Makefile
+++ b/uboot/Makefile
@@ -246,7 +246,7 @@ ifeq ($(HOSTARCH),$(ARCH))
CROSS_COMPILE ?=
endif
-export CROSS_COMPILE=/opt/gcc-linaro-aarch64-none-elf-4.8-2013.11_linux/bin/aarch64-none-elf-
+export CROSS_COMPILE=sdk路径/toolchain/gcc-linaro-aarch64-none-elf-4.8-2013.11_linux/bin/aarch64-none-elf-
KCONFIG_CONFIG ?= .config
3、在sdk/uboot目录执行： ./mk gxl_p211_v1
生成的uboot文件为：uboot/fip/gxl目录下的u-boot.bin、u-boot.bin.sd.bin、u-boot.bin.usb.bl2和u-boot.bin.usb.tpl。
1.3.2 boot.img&dt.img
编译的命令为：make bootimage，此命令会同时生成boot.img和dt.img。
二、调试
编译简单介绍完了，就要说调试了，机顶盒ROM的调试方式比较多样，就先接着第一章节，介绍一下上面的问题怎么替换。
2.1 文件替换
2.1.1 常规文件替换
第一章节编出来的文件有apk、so、bin、jar等，替换到out目录下对应的机顶盒路径中即可。这句话可能有点不好理解，例子如下：
| 源码目录 | 机顶盒中路径 |
|---|---|
| out/target/product/Hi3798MV300H/system/bin/dhcpcd | system/bin/dhcpcd |
| out/target/product/Hi3798MV300H/system/framework/android.policy.jar | system/framework/android.policy.jar |
| out/target/product/Hi3798MV300H/system/lib/hw/hidisplay.bigfish.so | system/lib/hw/hidisplay.bigfish.so |
| out/target/product/Hi3798MV300H/system/app/BluetoothSet.apk | system/app/BluetoothSet.apk |
替换文件时，除了apk、so、jar之外，别的（还有如：20-dns.conf、bootAnimation.zip等）都要保持替换前后权限一致。查看文件权限的命令是"ll filename"，文件权限为"r:4 w:2 x:1 "，常见的权限如下：
-rw------- (600) 只有拥有者有读写权限。
-rw-r--r-- (644) 只有拥有者有读写权限；而属组用户和其他用户只有读权限。
-rwx------ (700) 只有拥有者有读、写、执行权限。
-rwxr-xr-x (755) 拥有者有读、写、执行权限；而属组用户和其他用户只有读、执行权限。
-rwx--x--x (711) 拥有者有读、写、执行权限；而属组用户和其他用户只有执行权限。
-rw-rw-rw- (666) 所有用户都有文件读、写权限。
-rwxrwxrwx (777) 所有用户都有读、写、执行权限。
2.1.2 特殊文件替换
特殊的文件，可简单理解为不能直接替换到机顶盒中的文件，比如1.3章节中编出的文件，替换方式如下(usb_disk代表U盘挂载到终端后的路径)：
1>boot.img
cat usb_disk/boot.img > /dev/block/boot
2>uboot
cat usb_disk/u-boot.bin.sd.bin > /dev/block/bootloader
2.2 常用调试命令
要想让开发过程变得高效，常用的调试命令必须要能够熟练地使用。在不同的芯片平台上，U盘挂载后的路径是不同的，如下：
| 芯片 | 常规U盘路径 |
|---|---|
| 海思 | mnt/sda/sda1 |
| Amlogic | storage/external_storage/sda1 |
| Mstar | mnt/usb/sda1 |
为方便表示，下文中的U盘路径均用usb_disk表示。
2.2.1 ADB命令
| ADB命令 | 串口命令 | 意义 |
|---|---|---|
| adb connect IP:port | - | 连接 Android 设备 |
| adb disconnect | - | 断开 ADB 连接 |
| adb kill-server | - | 关闭 PC ADB 调试，效果等同断开连接 |
| adb shell | - | 进入 shell 模式，效果等同于串口连接 |
| adb remount | mount -o remount,rw /system | 将 ‘/system’ 部分置于可写入的模式 |
| ll file(adb shell后) | ll file | 查看该目录下文件的详细信息，如最后修改时间、权限等 |
| chmod 755 file(adb shell后) | chmod 755 file | 赋予文件755权限 |
| adb reboot | reboot | 重启 |
| reboot recovery(adb shell后) | reboot recovery | 重启后进入recovery |
| adb install -r **.apk | pm install -r **.apk | 覆盖安装某个应用 |
| adb uninstall com.exp.test | pm uninstall com.exp.test | 卸载某个应用(com.exp.test为应用的包名) |
| pm list packages(adb shell后) | pm list packages | 查看已安装的应用及其对应的包名 |
| adb logcat –c | logcat -c | 清除log缓存 |
| logcat(adb shell后) | logcat | 直接查看运行log |
| adb logcat –v threadtime >E:\1.log | logcat -v threadtime -f /sdcard/.log | 抓取1.log |
| dmesg(adb shell后) | dmesg | 直接查看运行内核log |
| tcpdump -s 0 -i eth0 -w /data/dhcp.pcap(adb shell后) | tcpdump -s 0 -i eth0 -w /data/dhcp.pcap | 抓取网络包 |
| adb pull system/media/bootanimation.zip E:\ | cp -r system/media/bootanimation.zip usb_disk | 从终端中拷贝文件出来 |
| adb push E:\Provision.apk system/app/Provision.apk | cp -r usb_disk/Provision.apk system/app/Provision.apk | 替换文件到终端中 |
| adb shell sync | sync | 将内存缓冲区中的数据 写入到磁盘 |
| am start -n 包名/完整Activity路径(adb shell后) | am start -n 包名/完整Activity路径 | 启动Activity |
| am broadcast -a “broadcastactionfilter”(adb shell后) | am broadcast -a “broadcastactionfilter” | 发送Broadcast |
| am startservice “com.exm.test/.TestService”(adb shell后) | am startservice “com.exm.test/.TestService” | 启动Service |
| content query --uri content://stbconfig/authentication(adb shell后) | content query --uri content://stbconfig/authentication | 查询ContentProvider内容 |
| am force-stop com.exp.test(adb shell后) | am force-stop com.exp.test | 强制关闭应用 |
| screencap /sdcard/screen.png(adb shell后) | screencap /sdcard/test.png | 截屏 |
| screenrecord /sdcard/demo.mp4(adb shell后) | screenrecord /sdcard/demo.mp4 | 录制视频 |
| input text “123”(adb shell后) | input text “123” | 输入一段字符串 |
| input keyevent 23(adb shell后) | input keyevent 23 | 模拟按键 |
| dumpsys -l/service list(adb shell后) | dumpsys -l/service list | 查看当前运行的Service |
| dumpsys package(adb shell后) | dumpsys package | 查看应用的四大组件信息 |
| dumpsys activity (adb shell后) | dumpsys activity | 查询AMS服务相关信息 |
| dumpsys window(adb shell后) | dumpsys window | 查询WMS服务相关信息 |
| dumpsys cpuinfo(adb shell后) | dumpsys cpuinfo | 查询CPU情况 |
| dumpsys meminfo(adb shell后) | dumpsys meminfo | 查询内存情况 |
| top(adb shell后) | top | 查询试试内存情况 |
| ps(adb shell后) | ps | 查看进程 |
| start adbd(adb shell后) | start adbd | 启用adbd，可以使用adb连接功能 |
| stop adbd(adb shell后) | stop adbd | 禁用adbd |
| start console(adb shell后) | start console | 启用串口调试功能 |
| stop console(adb shell后) | stop console | 禁用串口调试功能 |
| getprop(adb shell后) | getprop | 查看属性 |
| setprop prop_name prop_val(adb shell后) | setprop prop_name prop_val | 设置属性值 |
| cat node_path(adb shell后) | cat node_path | 查看节点值 |
| remotecfg(adb shell后，Amlogic上使用) stop ir_user(adb shell后，海思上使用) busybox devmem 0x1f007b00 16 0x0000 (adb shell后，Mstar9380上使用) |
remotecfg(Amlogic上使用) stop ir_user(海思上使用) busybox devmem 0x1f007b00 16 0x0000 (Mstar9380上使用) |
禁用红外遥控器使用功能 |
| ./system/bin/remotecfg.sh(adb shell后，Amlogic上使用) start ir_user(adb shell后，海思上使用) busybox devmem 0x1f007b00 16 0x01bf(adb shell后，Mstar9380上使用) |
./system/bin/remotecfg.sh(Amlogic上使用) start ir_user(海思上使用) busybox devmem 0x1f007b00 16 0x01bf (Mstar9380上使用) |
启用红外遥控器使用功能 |
| settings get secure ntp_server (adb shell后) | settings get secure ntp_server | 查看系统数据库中值 |
| settings put secure ntp_server cn.pool.ntp.org(adb shell后) | settings put secure ntp_server cn.pool.ntp.org | 设置系统数据库中值 |
| wm size(adb shell后) | wm size | 查看UI分辨率 |
| wm size 1920x1080(adb shell后) | wm size 1920x1080 | 修改UI分辨率 |
| wm density(adb shell后) | wm density | 查看屏幕密度 |
| wm density 240(adb shell后) | wm density 240 | 修改屏幕密度 |
| cat /proc/cpuinfo(adb shell后) | cat /proc/cpuinfo | 查看CPU信息 |
2.2.2 LINUX命令
| LINUX命令 | 意义 |
|---|---|
| cd / cd - cd dirA |
切换到根目录 切换到上次操作目录 切换到dirA目录 |
| pwd | 查看当前目录 |
| su userName | 切换用户 |
| df | 查看磁盘使用情况 |
| mkdir | 创建目录 |
| rm –f fileName | 强制删除文件 |
| rm –rf folderName | 强制删除文件夹(慎用) |
| mv aName bName | 文件(夹)重命名 |
| cp –rf dirA dirB | 拷贝文件夹 A 内容到文件夹 B |
| find . –name fileName | 在当前目录搜索某文件 |
| grep –rin “str” ./* | 在当前目录检索字符串 |
| tar –cvf test.tar ./fName | 压缩 fName 目录文件为 test.tar |
| tar –xvf a.tar | 解压 test.tar |
| make clean | 清除编译内容 |
| busybox md5sum fileName | 查看文件 md5 |
| echo 7 > /proc/sys/kernel/printk | 修改内核log等级 |
| cat /proc/sys/kernel/printk | 查看内核log等级 |
| java -Xmx2048m -jar signapk.jar -w platform.x509.pem platform.pk8 test.apk test_sign.apk | apk签名 |
| java -Xmx2048m -jar signapk.jar -w testkey.x509.pem testkey.pk8 update.zip update_signed.zip | update.zip签名 |
此外，还有一些不那么常用、却很有用的命令，可以尽量掌握下：
1>lsmod
查看已加载的模块，输出结果和"cat /proc/modules"一致，示例内容如下：
dwc_otg 282708 0 - Live 0x0000000000000000
dwc3 18053 0 - Live 0x0000000000000000
bt_usb 14905 0 - Live 0x0000000000000000 (O)
mac80211 412290 0 - Live 0x0000000000000000
cfg80211 401371 1 mac80211, Live 0x0000000000000000
aml_thermal 18902 0 - Live 0x0000000000000000 (O)
tb_detect 5521 0 - Live 0x0000000000000000 (O)
mali 191194 26 - Live 0x0000000000000000 (O)
aml_nftl_dev 81488 0 - Live 0x0000000000000000 (PO)
第1列表示模块的名称，第2列表示模块的大小，第3列表示依赖模块的个数，第4列表示依赖模块的内容。
2>cat /proc/meminfo
查看内存信息。
2.2.3 VIM命令
| VIM命令 | 意义 |
|---|---|
| vi fileName | 打开文件 |
| :set nu | 显示行数 |
| / | 检索 |
| :w | 保存修改 |
| :q | 退出 |
| i | 进入编辑模式 |
| Esc | 退出编辑模式 |
| dd | 删除一行 |
2.2.4 GIT命令
| VIM命令 | 意义 |
|---|---|
| git branch | 查看本地分支 |
| git status . | 查看当前目录哪些文件修改过还未提交 |
| git diff filename/folderName | 查看某个文件/文件夹具体修改内容 |
| git log | 查看本地所以修改记录 |
| git log filename/folderName | 查看某个文件/文件夹修改记录 |
| git checkout fileName | 回退某个文件未提交的修改 |
| git pull | 更新本地代码，与服务器同步 |
| git show commitId | 查看某次 commit 内容 |
| git show –-stat commitId | 查看某次提交修改的文件 |
| git clone + gitUrl | 拉取远程代码到本地 |
| git checkout A B | 从分支 A 切换到分支 B |
| git add/rm | 添加到暂存区/删除文件 |
| git commit –m “” | 将修改提交到本地 |
| git push origin branchRemoteName | 将本地分支修改提交到远程分支 |
2.2.5 命令使用小技巧
首先，要尽量将上述ADB命令与" |grep "结合使用，如"ll/ls"与" |grep"使用，可过滤特定名称的文件/文件夹；“getprop"与” |grep "使用，可过滤特定名称的属性；“dumpsys meminfo"与” |grep"使用，可过滤特定名称
应用的内存使用情况；“logcat"与” |grep "使用,可过滤某些特定日志。
其次，多使用模糊搜索/特定目录搜索，如："find frameworks/base –name Window.java"可搜索 frameworks/base 目录下名称中带 Window 的java文件。
再者，在 shell 界面使用 linux 命令时，命令前都要加上"busybox"。
最后，在向机顶盒中 push 文件或从机顶盒向外 pull 文件后，尽量使用一下"adb shell sync"，来确保文件传输完整。
三、积累关键功能调试经验
在以上两个章节中，涵盖了较多的日常机顶盒ROM调试命令。除此之外，还有些命令之外的技巧需要积累，如下：
3.1 功能开关
某些功能，在源码中是已经实现好了的，在检测ROM中是否包含该功能时，只需要检查特定的属性或文件即可。如：
1>海思上的CEC开关
persist.sys.hdmi.cec为true，代表打开该功能；为false，代表关闭该功能。
2>海思上的HDMI待机开关
persist.hdmi.suspend.enable为1，代表打开该功能；为0，代表关闭该功能；
persist.hdmi.suspend.time为具体的待机时间，一般为5。
3>Amlogic静帧功能
system/etc目录下的blackout_whitelist.txt文件，文件内逐行写入要实现静帧功能的应用的包名、类名。
3>Amlogic DHCP重连功能
net.dhcp.repeat为enabled，代表打开DHCP重连功能；
net.dhcp.repeat.count为重试次数。
3.2 调试思路
当某一功能实现出现问题，要遵循"先硬件/环境，再软件"和"先底层，再上层"的排查思路，如下：
1>先硬件/环境，再软件
遇到一个问题时，要先了解问题出现的具体情况，是否与环境、复现问题方式、机顶盒硬件有关，先做对比验证。确定是软件问题后，再从软件侧进行排查。
2>先底层，再上层
遇到一个问题时，可以先用命令从底层了解功能是否OK。如果底层OK，那就是上层调用逻辑出现了问题，再层层向上、逐步缩小debug范围。
至此，常用的调试技巧已介绍完毕。