系统调试

串口调试

如果正在进行 U-Boot 或内核开发,USB 串口适配器( USB 转串口 TTL 适配器的简称)对于检查系统启动日志非常有用,特别是在没有图形桌面显示的情况下。

选购适配器

网店上有许多 USB 转串口的适配器,按芯片来分,推荐以下串口:

串口 最高波特率 是否推荐 评价 购买链接
CP2102 2Mbps 推荐 支持高波特率通信,稳定性好耐用 点击购买

注意: LKD3588 默认的波特率是 1500000,有些USB转串口芯片波特率无法达到 1500000,同一芯片的不同系列也可能会有差异,所以在选购之前一定要确认是否支持。

硬件连接

串口转 USB 适配器,有四个引脚:

  • 3.3V 电源(NC),不需要连接

  • GND,串口的地线,接开发板串口的 GND 针

  • TXD,串口的输出线,接开发板串口的 TX 针

  • RXD,串口的输入线,接开发板串口的 RX 针

  • 注意:如使用其它串口适配器遇到 TX 和 RX 不能输入和输出的问题,可以尝试对调 TX 和 RX 的连接。

LKS3588 串口连接图:

../_images/debug.png

Windows 串口工具

1、将开发板的Debug口连接到PC端的USB口,打开设备管理器获取USB Serial Port的端口号,如下图所示:

../_images/SecureCRT_list.png

2、安装 MobaXterm串口工具

3、点击 session 选择 Serial

4、Serial port 修改为设备管理器获取到的 COM 端口。

5、 Speed (bsp) 修改为 1500000。

6、 点击 OK 按钮。

../_images/MobaXterm.png

Linux 串口工具

1、安装minicom: sudo apt-get install minicom。

2、将开发板的Debug口连接到主机端的USB口。

3、以root权限打开minicom: sudo minicom -s。

4、打开Minicom菜单:输入CTRL-A + z。

5、进入Minicom配置界面:输入“O”选择“Configure Minicom”。

6、进入串口设置:选择“Serial port setup”。

7、设置串口设备:输入“A”,写入“/dev/ttyUSB0”,按回车确定。

8、禁止流控:输入“F”,按回车确定。

9、设置波特率:输入“E”,再输入“A”直到显示“Current 1500000 8N1”,然后回车确定。

10、保存设置:选择“Save setup as dfl”。

11、退出设置:选择“Exit”。

adb调试

Adb 介绍

Adb 是 Android Debug Bridge 的简称,是 Android 的命令行调试工具,可以完成多种功能,如跟踪系统日志、上传下载文件、安装应用等。

Adb 在 Windows 下的安装

  1. 安装 USB驱动DriverAssitant_v5.11

  2. 下载 adb.zip, 解压出来的adb.exe、AdbWinApi.dll和AdbWinUsbApi.dll在C:\Windows\System32C:\Windows\SysWOW64目录各拷贝一份。

打开 cmd 窗口然后运行:

adb shell

若成功就会进入 adb shell 。

Adb 在 Ubuntu 下的安装

  1. 安装 adb 工具:

    sudo apt-get install android-tools-adb
    
  2. 添加设备 ID:

    mkdir -p ~/.android
    vi ~/.android/adb_usb.ini
    # add the following line:
    0x2207
    
  3. 为非 root 用户添加 udev 规则:

    sudo vi /etc/udev/rules.d/51-android.rules
    # add the following line:
    SUBSYSTEM=="usb", ATTR{idVendor}=="2207", MODE="0666"
    
  4. 重载 udev 规则:

    sudo udevadm control --reload-rules
    sudo udevadm trigger
    
  5. 普通用户下重启 adb:

    sudo adb kill-server
    adb start-server
    

然后就可以直接使用 adb 了, 如:

adb shell

常用 Adb 命令

连接管理

列出所有连接设备以及它们的序列号:

adb devices

若没有多连接设备,就必须用序列号来区分:

export ANDROID_SERIAL=<device serial number>
adb shell ls

也可以用 TCP/IP 网络连接 Adb :

adb tcpip 5555

Adb 会在设备上重启并监听 5555 TCP 端口, 这个时候就可以拔出 USB 线了。

如果设备的 IP 地址为 192.168.1.100,执行以下命令连接:

adb connect 192.168.1.100:5555

一旦连接,就可以执行 adb 命令了:

adb shell ps
adb logcat

直到断开 adb 连接:

adb disconnect 192.168.1.100:5555

调试

查询系统日志

用法:

adb logcat [option] [Application label]

示例:

# 查看所有日志
adb logcat

# 仅查看部分日志
adb logcat -s WifiStateMachine StateMachine

收集 Bug 报告

adb bugreport 用来收集错误报告和一些系统信息。

adb bugreport

# 保存到本地,易于编辑和查看
adb bugreport > bugreport.txt

运行 shell

打开一个交互的 shell:

adb shell

执行 shell 命令:

adb shell ps

Apk 管理

安装 Apk
adb install [option] example.apk

选项:
-l 转发锁定
-r 重新安装应用程序以保留原始数据
-s 安装到SD卡而不是内部存储

示例:

# 安装 facebook.apk
adb install facebook.apk

# 升级 twitter.apk
adb install -r twitter.apk

若安装失败,检查下常见原因:

  • INSTALL_FAILED_ALREADY_EXISTS: 尝试添加 -r 参数再次安装。

  • INSTALL_FAILED_SIGNATURE_ERROR: APK 签名不一致,这可能是由于签名和调试版本的不同导致的。如果确认APK文件签名是正常的,可以使用 adb uninstall 命令卸载旧的应用程序,然后重新安装。

  • INSTALL_FAILED_INSUFFICIENT_STORAGE: 存储空间不够。

卸载 Apk
adb uninstall apk_name

示例:

adb uninstall com.android.chrome

apk 包的名称可以用下面的命令列出:

adb shell pm list packages -f
...
package:/system/app/Bluetooth.apk=com.android.bluetooth
...