# 调试

Source: [https://docs.qualcomm.com/doc/80-70014-18Y/topic/debug.html](https://docs.qualcomm.com/doc/80-70014-18Y/topic/debug.html)

调试章节涵盖了调试和分析各种段（如 DSI 面板时钟、DPU 和 Weston）所需的信息。

## DSI 面板和时钟信息

Source: [https://docs.qualcomm.com/doc/80-70014-18Y/topic/debug.html](https://docs.qualcomm.com/doc/80-70014-18Y/topic/debug.html)

后续章节提供有关所选面板的信息和 DSI 时钟信息。
Note: 您必须在 Permissive 模式下启用 SSH 才能安全地访问您的主机设备。相关说明，可参见 [SSH 使用指南](https://docs.qualcomm.com/bundle/publicresource/topics/80-70014-254/how_to.html#how-to-ssh-)。

Note: 确保挂载 `debugfs` 文件系统以访问显示子系统的 `debugfs` 详细信息。使用以下命令挂载 `debugfs` 文件系统：

    mount -o remount,rw /Copy to clipboard

    mount -t debugfs none /sys/kernel/debugCopy to clipboard

### 检查所选面板

若要检查选择了哪个面板，请运行以下命令：

    cat /sys/kernel/debug/qcom,mdss_dsi_ext_bridge_4k30p/dump_infoCopy to clipboard

**示例输出：**

name = qcom,mdss_dsi_ext_bridge_4k30p
                       Resolution = 1920(148|88|44|1)x1080(36|4|5|1)@60fps 0 Hz
                       CTRL_0:
                              ctrl = dsi-ctrl-0
                              phy = dsi-phy-0
                       Panel = ext video mode dsi bridge
                       Clock master = dsi-ctrl-0	Copy to clipboard

### 查看 DSI 时钟信息

若要检查 DSI 时钟信息，请运行以下命令：

    cat /sys/kernel/debug/qcom,mdss_dsi_ext_bridge_4k30p/dsi-ctrl-0/state_infoCopy to clipboard

**示例输出：**

Current State:
            CTRL_ENGINE = ON
            VIDEO_ENGINE = ON
            COMMAND_ENGINE = OFF
    Clock Info:
            BYTE_CLK = 111375000, PIXEL_CLK = 148500000, ESC_CLK = 19200000Copy to clipboard

## 调压器和时钟信息

Source: [https://docs.qualcomm.com/doc/80-70014-18Y/topic/debug.html](https://docs.qualcomm.com/doc/80-70014-18Y/topic/debug.html)

要检查调压器状态和电压，请运行以下命令：

    cat /sys/kernel/debug/regulator/regulator_summaryCopy to clipboard

## 显示接口信息

Source: [https://docs.qualcomm.com/doc/80-70014-18Y/topic/debug.html](https://docs.qualcomm.com/doc/80-70014-18Y/topic/debug.html)

以下是调试 dump 输出：显示接口编号、VSync 计数、欠载运行计数和接口模式。

    cat /sys/kernel/debug/dri/0/encoder*/status
    intf:1    vsync:  192124     underrun:       0    mode: video
     Copy to clipboard

## SDE 层混合器和层信息

Source: [https://docs.qualcomm.com/doc/80-70014-18Y/topic/debug.html](https://docs.qualcomm.com/doc/80-70014-18Y/topic/debug.html)

SDE 层混合器信息目前可供对 Qualcomm Linux 附带的专有软件具有完全访问权限的用户使用。有关详细信息，请参阅 [Qualcomm Linux Display Guide - Addendum](https://docs.qualcomm.com/bundle/resource/topics/80-70014-18A/debug.html)

## 常规 DPU 调试信息

Source: [https://docs.qualcomm.com/doc/80-70014-18Y/topic/debug.html](https://docs.qualcomm.com/doc/80-70014-18Y/topic/debug.html)

此处提供了常见的 DPU 调试信息。

### DPU 时钟频率

Note: 您必须在 Permissive 模式下启用 SSH 才能安全地访问您的主机设备。相关说明，可参见 [SSH 使用指南](https://docs.qualcomm.com/bundle/publicresource/topics/80-70014-254/how_to.html#how-to-ssh-)。

要检查 DPU 时钟频率，请运行以下命令：

    cat /sys/kernel/debug/clk/clk_summary | grep disp_ccCopy to clipboard

### 将 DPU 设置为性能模式

要将 DPU 设置为性能模式，请运行以下命令：

    cd /sys/kernel/debug/dri/0/debug/core_perf/Copy to clipboard

    echo 1 > perf_modeCopy to clipboard

## 用户模式/Weston 调试

Source: [https://docs.qualcomm.com/doc/80-70014-18Y/topic/debug.html](https://docs.qualcomm.com/doc/80-70014-18Y/topic/debug.html)

### Weston 自动启动

当设备开机时，Weston 屏幕会自动启动。以下脚本文件包含用于设置 Weston 屏幕自动启动的 Weston 配置及其命令行参数： `/etc/initscripts/init_qti_display`
Note: 您必须在 Permissive 模式下启用 SSH 才能安全地访问您的主机设备。相关说明，可参见 [SSH 使用指南](https://docs.qualcomm.com/bundle/publicresource/topics/80-70014-254/how_to.html#how-to-ssh-)。

    mount -o remount,rw /Copy to clipboard

    cat /etc/initscripts/init_qti_displayCopy to clipboard

### Weston 显示配置

Weston 使用 `weston.ini` 配置文件。当 Weston 启动时，它会从 Weston 初始化脚本中搜索 `weston.ini` 文件，形式为 `--config=/etc/xdg/weston/weston.ini`，并配置 Weston 显示管道。详细配置详见 [https://manpages.ubuntu.com/manpages/focal/en/man5/weston.ini.5.html](https://manpages.ubuntu.com/manpages/focal/en/man5/weston.ini.5.html)。

运行以下命令以获取 Weston 配置文件：

    mount -o remount,rw /Copy to clipboard

    cat /etc/xdg/weston/weston.iniCopy to clipboard

运行这些命令时，您会看到以下 `weston.ini` 配置示例输出：

configuration file for Weston
    [core]
    idle-time=0
    backend=sdm-backend.so
    repaint-window=10
     
    [output]
    name=DSI-1
    mode=on
     
    [output]
    name=DP-1
    mode=on
     
    [shell]
    clock-format=secondsCopy to clipboard

### 重新启动 Weston

以下是终止 Weston 进程并手动重新启动 Weston 服务器的步骤：
Note: 您必须在 Permissive 模式下启用 SSH 才能安全地访问您的主机设备。相关说明，可参见 [SSH 使用指南](https://docs.qualcomm.com/bundle/publicresource/topics/80-70014-254/how_to.html#how-to-ssh-)。

1. 若要标识 Weston 进程的 ID，请运行以下命令：

        mount -o remount,rw /Copy to clipboard

        ps -A | grep westonCopy to clipboard

**示例输出：**

        824 ?        00:00:12 weston
           1090 ?        00:00:00 weston-keyboard
           1092 ?        00:00:01 weston-desktop-Copy to clipboard
2. 若要终止 Weston 进程，请运行以下命令：

        killall westonCopy to clipboard
3. 若要重新启动 Weston 服务器，请运行以下命令：

        mount -o remount,rw /Copy to clipboard

        suCopy to clipboard

        . /etc/profileCopy to clipboard

        export XDG_RUNTIME_DIR=/dev/socket/westonCopy to clipboard

        mkdir --parents $XDG_RUNTIME_DIRCopy to clipboard

        chmod 0700 $XDG_RUNTIME_DIRCopy to clipboard

        cd /usr/binCopy to clipboard

        ./weston --tty=2 --continue-without-inputCopy to clipboard

## HDMI 故障排除

Source: [https://docs.qualcomm.com/doc/80-70014-18Y/topic/debug.html](https://docs.qualcomm.com/doc/80-70014-18Y/topic/debug.html)

LT9611uxc 是 DSI toHDMI 桥接芯片固件。推荐的固件版本为 `LT9611UXC_DSI_PortA_HDCP_Disable_V5.0.21.bin`。

如果您在 HDMI 上遇到屏幕无显示的情况，建议升级固件。

### Lontium 固件升级

以下是 Lontium 固件升级步骤：

1. 从 [http://www.lontiumsemi.com/download](http://www.lontiumsemi.com/download) 下载推荐的 LT9611uxc 固件版本 `LT9611UXC_DSI_PortA_HDCP_Disable_V5.0.21.bin`，然后转到 Qualcomm 部分。
Note: 在 Permissive 模式下启用 SSH 以安全地访问您的主机设备。有关详细信息，请参阅 [SSH 使用指南](https://docs.qualcomm.com/bundle/publicresource/topics/80-70014-254/how_to.html#how-to-ssh-)。

Note: 提示输入密码时，输入 *oelinux123*。
2. 要升级固件，请运行以下 Linux shell 命令：

        mount -o rw,remount /Copy to clipboard

        setenforce 0Copy to clipboard

        scp <LT firmware bin> root@<IP of the device>:/lib/firmware/lt9611uxc_fw.binCopy to clipboard

        syncCopy to clipboard

        echo 0 > /sys/bus/i2c/devices/0-002b/lt9611uxc_firmwareCopy to clipboard

Note: 请等待至少三分钟，以便固件升级完成。
3. 若要获取 lt9611 日志，请运行以下命令：

        dmesg | grep lt9611Copy to clipboard

以下日志表示固件升级成功： `Firmware updates successfully`

为确保新固件生效，建议硬重启（重新插拔电源线）设备。

### 已知问题

在打开设备或热插拔 HDMI 电缆时，您可能会遇到屏幕无显示的情况。

若要获取 UART 串口日志，请单击 [UART 串行控制台](https://docs.qualcomm.com/bundle/publicresource/topics/80-70014-254/how_to.html#how-to-connect-to-a-uart-shell-)。获取 UART 日志后，您可能会遇到以下两种已知问题场景之一：

Table : 已知问题的解决方法

| 已知问题 | 解决方法 |
| --- | --- |
| 如果发生以下 EDID 超时日志错误：<br><br>    lt9611uxc 0-002b: wait for EDID timeout<br>    lt9611uxc 0-002b: wait for EDID timeout<br>    lt9611uxc 0-002b: wait for EDID timeout<br>    lt9611uxc 0-002b: wait for EDID timeout<br>    lt9611uxc 0-002b: wait for EDID timeout<br>    lt9611uxc 0-002b: wait for EDID timeout<br>    Copy to clipboard | <ol class="ol"><br>                                    <li class="li">在没有 HDMI 电缆的情况下打开开发套件的电源。</li><br><br>                                    <li class="li">只有在设备成功开机后才插入 HDMI 电缆（等待两分钟）。</li><br><br>                                </ol> |
| 如果连续出现以下断开连接和连接的日志：<br><br>    lt9611uxc 0-002b: [name=HDMI-A-1]:[status=connected]<br>    lt9611uxc 0-002b: wait for EDID timeout<br>    lt9611uxc 0-002b: wait for EDID timeout<br>    lt9611uxc 0-002b: release edid<br>    lt9611uxc 0-002b: [name=HDMI-A-1]:[status=disconnected]<br>    lt9611uxc 0-002b: [name=HDMI-A-1]:[status=connected]<br>    lt9611uxc 0-002b: release edid<br>    lt9611uxc 0-002b: [name=HDMI-A-1]:[status=disconnected]<br>    lt9611uxc 0-002b: [name=HDMI-A-1]:[status=connected]<br>    Copy to clipboard | 终止 Weston 服务器并手动重新启动 Weston 服务器。有关详细信息，请参阅[重新启动 Weston](https://docs.qualcomm.com/doc/80-70014-18Y/topic/debug.html#user_mode_weston_debug__section_mr4_fkl_xbc)。 |

Last Published: Aug 22, 2024

[Previous Topic
验证](https://docs.qualcomm.com/bundle/publicresource/80-70014-18Y/topics/verify_0.md) [Next Topic
参考资料](https://docs.qualcomm.com/bundle/publicresource/80-70014-18Y/topics/references.md)