调试 Yocto 构建 - Qualcomm Dragonwing Documentation

本节说明如何解决常见的 Yocto 构建失败并调试 Qualcomm Linux 工作区中的问题。

调试工具

packagegroup-core-tools-debug 定义在 <workspace>/layers/poky/meta 目录中，可将调试工具添加到 rootfs 中。<workspace>/layers/meta-qcom-hwe/recipes-devtools 目录包含追加的软件包组配方 packagegroup-core-tools-debug.bbappend。该追加文件将 ltrace、perf、sysstat 和 valgrind 工具添加到此软件包组中。有关更多信息，请参阅调试 Linux 用户空间问题。

常见 Yocto 构建失败

有关与 QA 问题（例如版本回退）相关的常见构建失败，请参阅验证 QA 问题：版本回退。

层排除问题

如果 BitBake 没有解析新添加的层，则该层中的配方不会包含在镜像中。

运行以下命令，并确认在输出中能看到该层：
bitbake -e | grep ^BBLAYERS=
如果找不到该层，请检查 conf/bblayers.conf 文件的内容，确保其中包含了该层。

调试构建

要生成调试构建，请运行以下命令：

kas shell meta-qcom/ci/<machine-name>.yml:meta-qcom/ci/<distro-name>.yml:meta-qcom/ci/debug.yml
bitbake qcom-multimedia-image

要了解当 DEBUG_BUILD 设置为 1 时使用哪些内核 defconfig 和配置片段，请参阅内核配方下的”内核配方”。以下来自 recipes-kernel/linux/linux-qcom_6.18.bb 的代码片段为正在构建的内核启用调试配置片段：

KBUILD_CONFIG_EXTRA:append = " ${@oe.utils.vartrue('DEBUG_BUILD', '${S}/kernel/configs/debug.config', '', d)}"

有关专门的调试构建指南，请参阅创建用于调试的构建。

工具与日志

验证 QDL 和 ModemManager

如果您使用的是带有 systemd 的 Linux 发行版，请使用 systemctl 命令停止 ModemManager。以下是 Ubuntu 22.04 上的示例：

要查看 ModemManager 的状态，请运行以下命令：

systemctl status ModemManager

输出：

ModemManager.service - Modem Manager
Loaded: loaded (/lib/systemd/system/ModemManager.service; enabled; vendor preset: enabled)
Active: active (running) since Tue 2023-11-28 16:28:15 IST; 3 months 4 days ago
Main PID: 1338 (ModemManager)
Tasks: 3 (limit: 4915)
CGroup: /system.slice/ModemManager.service
        └─1338 /usr/sbin/ModemManager --filter-policy=strict

ps aux | grep -i modemmanager

输出：

root      1338  0.0  0.0 434332  9544 ?        Ssl   2023  10:39 /usr/sbin/ModemManager --filter-policy=strict

要停止 ModemManager，请运行以下命令：

systemctl stop ModemManager
systemctl status ModemManager

输出：

ModemManager.service - Modem Manager
Loaded: loaded (/lib/systemd/system/ModemManager.service; enabled; vendor preset: enabled)
Active: inactive (dead) since Sun 2024-03-03 20:08:32 IST; 4s ago
Process: 1338 ExecStart=/usr/sbin/ModemManager --filter-policy=strict (code=exited, status=0/SUCCESS)
Main PID: 1338 (code=exited, status=0/SUCCESS)

ps aux 命令不会显示任何 /usr/sbin/ModemManager 的条目。如果您需要 ModemManager，必须在刷写完成后重新启动它，并验证它是否已启动：

systemctl start ModemManager
systemctl status ModemManager

输出：

ModemManager.service - Modem Manager
Loaded: loaded (/lib/systemd/system/ModemManager.service; enabled; vendor preset: enabled)
Active: active (running) since Sun 2024-03-03 20:11:46 IST; 43s ago
Main PID: 14785 (ModemManager)
Tasks: 3 (limit: 4915)
CGroup: /system.slice/ModemManager.service
        └─14785 /usr/sbin/ModemManager --filter-policy=strict

ps aux | grep -i modemmanager

输出：

root     14785  4.6  0.0 434332  9160 ?        Ssl  20:11   0:00 /usr/sbin/ModemManager --filter-policy=strict

​调试工具

​常见 Yocto 构建失败

​层排除问题

​调试构建

​工具与日志

​验证 QDL 和 ModemManager