# 调试

此信息提供了对各种组件（如 DSI 面板时钟、DPU 和 Weston）进行故障排除和分析的必要详细信息。

Tab QCS6490/QCS5430
Tab QCS9075

- *class* tabincludedirective

    - ## 显示面板和时钟

> 
> 
> Note
> 
> 
> - 您必须启用 SSH 才能访问您的主机设备。有关说明，请参阅 [使用 SSH](https://docs.qualcomm.com/bundle/publicresource/topics/80-70015-254/how_to.html#use-ssh)。
> - 要挂载 `debugfs` 文件系统以访问 `debugfs` 显示子系统的详细信息，请运行以下命令：
> 
> 
> 
> > 
> > 
> > mount -o remount,rw /
> >         Copy to clipboard
> > 
> > 
> > mount -t debugfs none /sys/kernel/debug
> >         Copy to clipboard

**查看显示面板信息**

若要检查选定的显示面板，请运行以下命令：

cat /sys/kernel/debug/qcom,mdss_dsi_ext_bridge_rb3gen2/dump_info
    Copy to clipboard

**示例输出**：

name = qcom,mdss_dsi_ext_bridge_rb3gen2
                        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_rb3gen2/dsi-ctrl-0/state_info
>     Copy to clipboard

**示例输出**：

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

## 检查调压器信息

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

cat /sys/kernel/debug/regulator/regulator_summary
    Copy to clipboard

## 显示接口信息

要检索调试dump输出（显示接口编号、VSync 计数、欠载计数和接口模式），请运行以下命令：

cat /sys/kernel/debug/dri/0/encoder*/status
    Copy to clipboard

**示例输出**：

intf:1    vsync:  192124     underrun:       0    mode: video
    Copy to clipboard

## SDE 层混合器和层信息

Snapdragon 显示引擎 (SDE) 层混合器信息可供具有授权访问权限的许可开发者使用。有关详细信息，请参阅 [Qualcomm Linux Display Guide - Addendum](https://docs.qualcomm.com/bundle/resource/topics/80-70015-18A/debug.html)。

## 常规 DPU 调试信息

常见的 DPU 调试信息说明如下：

> 
> 
> **DPU 时钟频率**
> 
> 
> Note
> 
> 
> 您必须启用 SSH 才能访问您的主机设备。有关说明，请参阅 [使用 SSH](https://docs.qualcomm.com/bundle/publicresource/topics/80-70015-254/how_to.html#use-ssh)。
> 
> 
> 要检查 DPU 时钟速率，请运行以下命令：
> 
> 
> 
> > 
> > 
> > cat /sys/kernel/debug/clk/clk_summary | grep disp_cc
> >     Copy to clipboard
> 
> 
> 
> **将 DPU 设置为性能模式**
> 
> 
> 若要将 DPU 设置为性能模式，请运行以下命令：
> 
> 
> 
> > 
> > 
> > cd /sys/kernel/debug/dri/0/debug/core_perf/
> >     Copy to clipboard
> > 
> > 
> > echo 1 > perf_mode
> >     Copy to clipboard

## 用户模式/Weston 调试

**Weston 自动启动**

设备通电时，Weston 屏幕会自动启动。`/etc/initscripts/init_qti_display` 脚本文件包含 Weston 配置参数，以及用于设置 Weston 屏幕自动启动的命令行参数。

Note

您必须启用 SSH 才能访问您的主机设备。有关说明，请参阅 [使用 SSH](https://docs.qualcomm.com/bundle/publicresource/topics/80-70015-254/how_to.html#use-ssh)。

mount -o remount,rw /
    Copy to clipboard

cat /etc/initscripts/init_qti_display
    Copy to clipboard

**Weston 显示配置**

Weston 使用 `weston.ini` 配置文件。当 Weston 启动时，
它从 Weston 初始化脚本中搜索 `weston.ini` 文件作为
`--config=/etc/xdg/weston/weston.ini` ，并配置 Weston
显示pipeline。详细配置详见
[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.ini
    Copy 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=seconds
    Copy to clipboard

**重新启动 Weston**

若要终止 Weston 进程并手动重新启动 Weston 服务器，请执行以下操作：

Note

您必须启用 SSH 才能访问您的主机设备。有关说明，请参阅 [使用 SSH](https://docs.qualcomm.com/bundle/publicresource/topics/80-70015-254/how_to.html#use-ssh)。

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

> 
> 
> mount -o remount,rw /
>     Copy to clipboard
> 
> 
> ps -A | grep weston
>     Copy 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 weston
>     Copy to clipboard

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

> 
> 
> mount -o remount,rw /
>     Copy to clipboard
> 
> 
> su
>     Copy to clipboard
> 
> 
> ./etc/profile
>     Copy to clipboard
> 
> 
> export XDG_RUNTIME_DIR=/dev/socket/weston
>     Copy to clipboard
> 
> 
> mkdir --parents $XDG_RUNTIME_DIR
>     Copy to clipboard
> 
> 
> chmod 0700 $XDG_RUNTIME_DIR
>     Copy to clipboard
> 
> 
> cd /usr/bin
>     Copy to clipboard
> 
> 
> ./weston --tty=2 --continue-without-input
>     Copy to clipboard

## HDMI 故障排除

LT9611uxc 是 DSI-to-HDMI 桥接芯片固件。推荐的固件版本为 `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
> 
>     - 启用 SSH 以访问您的主机设备。有关详细信息，请参阅 [使用 SSH](https://docs.qualcomm.com/bundle/publicresource/topics/80-70015-254/how_to.html#use-ssh)。
>     - 提示输入密码时，输入 oelinux123。
2. 要升级固件，请运行以下 Linux shell 命令：

> 
> 
> mount -o rw,remount /
>         Copy to clipboard
> 
> 
> scp <LT firmware bin> root@<IP of the device>:/lib/firmware/lt9611uxc_fw.bin
>         Copy to clipboard
> 
> 
> sync
>         Copy to clipboard
> 
> 
> echo 0 > /sys/bus/i2c/devices/0-002b/lt9611uxc_firmware
>         Copy to clipboard
> 
> 
> Note
> 
> 
> 等待至少 3 分钟以完成固件升级。
3. 要获取 lt9611 日志，请运行以下命令：

> 
> 
> dmesg | grep lt9611
>         Copy to clipboard

`Firmware updates successfully` 日志确认固件升级成功。为确保新固件生效，建议硬重启（重新插拔电源线）设备。

**已知问题**

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

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

表：已知问题的解决方法

| 已知问题 | 解决方法 |
| --- | --- |
| 如果发生以下 EDID 超时日志错误：<br><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 | 1.在没有连接HDMI 线的情况下打开开发套件的电源。<br><br><br>2.设备开机后，等待 2 分钟再连接 HDMI 线。 |
| 如果连续出现以下断开和连接的日志：<br><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-70015-18SC/topic/debug.html#relaunch-weston-kodiaq)。 |

- *class* tabincludedirective

    - ## DisplayPort 面板和时钟

> 
> 
> Note
> 
> - 您必须启用 SSH 才能访问您的主机设备。有关说明，请参阅 [使用 SSH](https://docs.qualcomm.com/bundle/publicresource/topics/80-70015-254/how_to.html#use-ssh)。
> - 要挂载 `debugfs` 文件系统以访问显示子系统的 `debugfs` 详细信息，请运行以下命令：
> 
> 
> 
> > 
> > 
> > mount -o remount,rw /
> >         Copy to clipboard
> > 
> > 
> > mount -t debugfs none /sys/kernel/debug
> >         Copy to clipboard

**查看 DisplayPort 面板信息**

要检查选定的 DisplayPort 面板，请运行以下命令：

cat  /sys/kernel/debug/dri/0/msm_dp-DP-1/dp_debug
    Copy to clipboard

**示例输出**：

name = msm_dp
    drm_dp_link
            rate = 270000
            num_lanes = 4
            capabilities = 1
    dp_panel_info：
            active = 3840x2160
            back_porch = 80x23
            front_porch = 48x3
            sync_width = 32x5
            active_low = 0x0
            h_skew = 0
            refresh rate = 30
            pixel clock khz = 262750
            BPP = 30
    dp_link：
            test_requested = 512
            num_lanes = 4
            bw_code = 10
            lclk = 270000000
            v_level = 1
            p_level = 0
    Copy to clipboard

**查看 DisplayPort 线的状态**

要检查 DisplayPort 线是否已连接，请运行以下命令：

cat  /sys/class/drm/card0-DP-1/status
    Copy to clipboard

**示例输出**：

已连接
    Copy to clipboard

**检查 EDID 模式**

要检查已连接的 DisplayPort 面板的 EDID 模式，请运行以下命令：

cat  /sys/class/drm/card0-DP-1/modes
    Copy to clipboard

**示例输出**：

3840x2160
    2048x1080
    1920x1080
    1280x720
    Copy to clipboard

## 检查调压器信息

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

cat /sys/kernel/debug/regulator/regulator_summary
    Copy to clipboard

## 显示接口信息

以下是调试dump-outs：显示接口编号，VSync
计数、欠载计数和接口模式。

cat /sys/kernel/debug/dri/0/encoder*/status
    Copy to clipboard

**示例输出**：

intf:1    vsync:  192124     underrun:       0    mode: video
    Copy to clipboard

## Snapdragon Display Engine (SDE) 图层混合器和图层信息

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

## 常规 DPU 调试信息

常见的 DPU 调试信息说明如下：

> 
> 
> **DPU 时钟频率**
> 
> 
> Note
> 
> 
> 您必须启用 SSH 才能安全地访问您的主机设备。有关说明，请参阅 [使用 SSH](https://docs.qualcomm.com/bundle/publicresource/topics/80-70015-254/how_to.html#use-ssh)。
> 
> 
> 要检查 DPU 时钟频率，请运行以下命令：
> 
> 
> cat /sys/kernel/debug/clk/clk_summary | grep disp_cc
>     Copy to clipboard
> 
> 
> **将 DPU 设置为性能模式**
> 
> 
> 若要将 DPU 设置为性能模式，请运行以下命令：
> 
> 
> cd /sys/kernel/debug/dri/0/debug/core_perf/
>     Copy to clipboard
> 
> 
> echo 1 > perf_mode
>     Copy to clipboard

## 用户模式/Weston 调试

**Weston 自动启动**

设备通电时，Weston 屏幕会自动启动。`/etc/initscripts/init_qti_display` 脚本文件包含 Weston 配置参数，以及用于设置 Weston 屏幕自动启动的命令行参数。

Note

您必须启用 SSH 才能访问您的主机设备。有关说明，请参阅 [使用 SSH](https://docs.qualcomm.com/bundle/publicresource/topics/80-70015-254/how_to.html#use-ssh)。

mount -o remount,rw /
    Copy to clipboard

cat /etc/initscripts/init_qti_display
    Copy to clipboard

**重新启动 Weston**

若要终止 Weston 进程并手动重新启动 Weston 服务器，请执行以下操作：

> 
> 
> Note
> 
> 
> 您必须启用 SSH 才能访问您的主机设备。有关说明，请参阅 [使用 SSH](https://docs.qualcomm.com/bundle/publicresource/topics/80-70015-254/how_to.html#use-ssh)。

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

> 
> 
> mount -o remount,rw /
>         Copy to clipboard
> 
> 
> ps -A | grep weston
>         Copy 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 weston
>         Copy to clipboard
3. 若要重新启动 Weston 服务器，请运行以下命令：

> 
> 
> mount -o remount,rw /
>         Copy to clipboard
> 
> 
> su
>         Copy to clipboard
> 
> 
> ./etc/profile
>         Copy to clipboard
> 
> 
> export XDG_RUNTIME_DIR=/dev/socket/weston
>         Copy to clipboard
> 
> 
> mkdir --parents $XDG_RUNTIME_DIR
>         Copy to clipboard
> 
> 
> chmod 0700 $XDG_RUNTIME_DIR
>         Copy to clipboard
> 
> 
> cd /usr/bin
>         Copy to clipboard
> 
> 
> ./weston --tty=2 --continue-without-input
>         Copy to clipboard

Last Published: Dec 10, 2024

[Previous Topic
配置](https://docs.qualcomm.com/bundle/publicresource/80-70015-18SC/topics/configure.md) [Next Topic
参考资料](https://docs.qualcomm.com/bundle/publicresource/80-70015-18SC/topics/references.md)