# 外设问题

***Copyright © Quectel Wireless Solutions Co., Ltd. 2026. All rights reserved.***

---

# 为什么显示屏不亮？

1. 检查是否为Quectel Pi H1支持的显示屏；

2. 检查显示屏供电是否正常；

3. 检查MIPI排线是否连接牢固，确认排线方向是否正确；

4. 检查内核日志，确认系统是否正确识别到该屏幕。可执行以下命令进行过滤排查：

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

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

1. 检查是否为Quectel Pi H1支持的摄像头；

2. 检查MIPI排线是否连接牢固，确认排线方向是否正确；

3. 检查cam-server服务是否正常。可执行以下命令查询服务状态：

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

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

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

```bash
dmesg | grep cam | grep -i probe
```

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

```bash
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（扩展显示器识别数据），这是分辨率协商的基础。

```bash
# 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线缆质量差或接口接触不良。

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

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

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

## 分析日志定位故障原因

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

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

1. 检查MIPI排线是否连接牢固，确认排线方向是否正确。

2. 检查内核日志，确认系统是否正确识别并输出probe信息。可执行以下命令进行排查：

```bash
dmesg | grep cam | grep -i probe
```

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

```bash
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地址或上电时序是否有误。

```bash
dmesg | grep cam | grep -i probe
```

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

# 没有声音怎么办？

## 检查硬件与连接

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

## 确认声卡硬件识别状态

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

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

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

```bash
# 查看默认输出设备
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%
```

## 播放测试音频

```bash
gst-launch-1.0 audiotestsrc ! pulsesink
```