外设问题¶

为什么显示屏不亮？¶

检查是否为Quectel Pi H1支持的显示屏；
检查显示屏供电是否正常；
检查MIPI排线是否连接牢固，确认排线方向是否正确；
检查内核日志，确认系统是否正确识别到该屏幕。可执行以下命令进行过滤排查：

dmesg | grep -iE 'display|hdmi|dsi'

摄像头无法加载怎么办？¶

检查是否为Quectel Pi H1支持的摄像头；
检查MIPI排线是否连接牢固，确认排线方向是否正确；
检查cam-server服务是否正常。可执行以下命令查询服务状态：

# 查询服务状态，正常状态是active (running)
systemctl status cam-server

# 若不正常，重启服务
systemctl restart cam-server

检查内核日志，确认系统是否正确识别并打印probe信息。执行如下命令进行排查：

dmesg | grep cam | grep -i probe

例如，以下日志说明IMX577和OV9282传感器已成功上电probe：

CAM_INFO: CAM-SENSOR:cam_sensor_driver_cmd: 938: Probe success,slot:0,slave_addr: 0x34,sensor_id:0x577, is always on:0
CAM_INFO: CAM-SENSOR:cam_sensor_driver_cmd: 938: Probe success,slot:1,slave_addr: 0xc0,sensor_id:0x9281, is always on:0

若无probe信息，需检查传感器I2C地址或上电时序是否有误。

显示屏分辨率异常怎么办？¶

检查硬件是否能正确识别显示器¶

首先需确认内核是否成功读取显示器的EDID（扩展显示器识别数据），这是分辨率协商的基础。

# 1. 查看所有显示接口的连接状态
for p in /sys/class/drm/card0-*/status; do echo -n "$p: "; cat $p; done

# 2. 查看EDID是否成功读取（文件大小非0表示识别成功）
cat /sys/class/drm/card0-*/edid > /tmp/edid.bin
ls -lh /tmp/edid.bin

如果EDID文件大小为0，说明显示器未正确提供EDID信息。此问题常见于非标准显示器、HDMI线缆质量差或接口接触不良。

查看当前可用的分辨率模式¶

# 查看内核DRM层当前支持的模式
cat /sys/class/drm/card0-*/modes

如果输出中不包含目标分辨率（如1920x1080），说明EDID中未提供该模式，或驱动未正确解析。

分析日志定位故障原因¶

dmesg | grep -i -E "drm|hdmi|msm|dpu|edid|mode"
journalctl -b | grep -Ei 'drm|dsi|dp|edid|panel|gdm|wayland' | tail -100

摄像头无法识别怎么办？¶

检查MIPI排线是否连接牢固，确认排线方向是否正确。
检查内核日志，确认系统是否正确识别并输出probe信息。可执行以下命令进行排查：

dmesg | grep cam | grep -i probe

例如，以下日志说明IMX577和OV9282传感器已成功上电probe：

CAM_INFO: CAM-SENSOR:cam_sensor_driver_cmd: 938: Probe success,slot:0,slave_addr: 0x34,sensor_id:0x577, is always on:0
CAM_INFO: CAM-SENSOR:cam_sensor_driver_cmd: 938: Probe success,slot:1,slave_addr: 0xc0,sensor_id:0x9281, is always on:0

若无probe信息，需检查传感器I2C地址或上电时序是否有误。

dmesg | grep cam | grep -i probe

若为自行添加的摄像头传感器，请咨询移远通信技术支持获取指导。

没有声音怎么办？¶

检查硬件与连接¶

检查扬声器或耳机是否连接牢固。

确认声卡硬件识别状态¶

执行以下命令，列出系统识别到的所有声卡：

# 列出所有声卡
cat /proc/asound/cards

查看输出设备设置是否正确¶

# 查看默认输出设备
pactl info | grep -i default

# 设置默认输出设备
pactl set-default-sink low-latency0

# 设置输出设备端口（speaker：扬声器，headset：耳机）
pactl set-sink-port low-latency0 speaker
pactl set-sink-port low-latency0 headset

# 设置非静音(0：非静音，1：静音)
pactl set-sink-mute low-latency0 0

# 设置音量80%
pactl set-sink-volume low-latency0 80%

播放测试音频¶

gst-launch-1.0 audiotestsrc ! pulsesink