MIPI

2025-11-26

本文档详细介绍了Quectel-Pi-H1单板电脑的MIPI—DSI显示接口识别、显示屏连接方法、系统配置及常见问题解决方案，以微雪8inch DSI接口ISP电容触摸屏为例进行详细说明。

MIPI 屏连接

按照下图进行连接：
注：此屏幕共有4处接口可供电，任选一处即可，示例选择“1”处供电。

  1. 即 type-C 接口。
  2. I2C 通讯与供电接口。
  3. 5V 输入输出接口。
  4. I2C 通讯与供电接口，需将螺丝孔对准 Quectel-Pi-H1 单板电脑拧紧，让顶针与 40PIN 连接牢固。
图片1

微雪8寸MIPI显示屏背面

图片3

连接上MIPI显示屏后的QuecPi

连接上 MIPI 显示器并上电开机后，启动显示服务，选择默认用户：pi ,密码：quecpi，MIPI 屏会显示 Gnome 桌面。

显示效果如下图：

图片3

屏幕显示效果

功能使用

调整屏幕亮度和音量

注：接入MIPI 显示器后，分辨率是不可调整的，是由开发人员配置的，不可更改。

在连接上MIPI 显示器并且上电开机后，进入 Gnome 桌面，点击右上角的电池图标，滑动声音栏和滑动亮度栏，进行调整亮度和音量。

以下为调整屏幕亮度和音量的操作图。

图片3

亮度和音量调整操作

触摸功能的使用方法

连接上 MIPI 显示器并且上电开机后，可以直接使用触摸功能。

视频播放功能的使用方法

可视化界面的视频播放功能：打开 Gnome 桌面，在 Gnome 桌面的 文件管理器 中，找到视频文件，点击视频文件即可播放视频。
注：双击边框即可全屏播放视频。

图片1

桌面打开操作步骤

图片3

视频播放显示效果

VLC命令行操作的视频播放功能：在使用命令行播放时，需要按照下列步骤输入相应的命令。

export LIBGL_ALWAYS_SOFTWARE=1 #修改本窗口的环境变量，在播放视频时切换到CPU渲染
VLC test.mp4                   #播放视频

以下为播放视频的效果图。

图片3

视频播放显示效果

GST命令行操作的视频播放功能：在使用命令行播放时，需要输入下面相应的命令。

gst-launch-1.0 filesrc location=/home/pi/test.mp4 ! qtdemux ! h264parse ! avdec_h264 ! autovideosink    ##其中location后的参数根据实际视频路径进行修改

命令参数说明：

  • gst-launch-1.0: 这是 GStreamer 的命令行工具，用于构建和运行一个 GStreamer 管道（pipeline）。
  • filesrc location=/home/pi/test.mp4: 使用 filesrc 元素从指定路径 /home/pi/test.mp4 读取视频文件。
  • ! qtdemux: 通过 ! 符号将前一个元素的输出连接到下一个元素的输入。qtdemux 负责解复用 MP4 容器格式，分离出其中的音频流和视频流。
  • ! h264parse: 对分离出来的 H.264 视频流进行解析，将其重新组织为适合解码器处理的格式。
  • ! avdec_h264: 使用软件解码器 avdec_h264 解码 H.264 视频流。这是基于 FFmpeg 的一个 GStreamer 插件元素。
  • ! autovideosink: 自动选择合适的视频输出组件来显示视频内容。根据系统环境的不同，它会选择最合适的 sink，比如在 Wayland 环境下可能是 waylandsink，在 X11 下可能是 ximagesink 等。

以下为播放视频的效果图。

图片3

视频播放显示效果

音频播放功能的使用方法

可视化界面的音频播放功能：打开 Gnome 桌面，在 Gnome 桌面的 文件管理器 中，找到音频文件，点击音频文件即可播放音频。
注：播放音频需要在SG565D单板电脑上将喇叭链接。

图片1

桌面打开操作步骤

图片3

音频播放显示效果

VLC命令行操作的音频播放功能：在使用命令行播放时，需要按照下列步骤输入相应的命令。

export LIBGL_ALWAYS_SOFTWARE=1 #修改本窗口的环境变量，在播放音频时切换到CPU渲染
VLC 1.mp3                     #播放音频

以下为播放音频的效果图。

图片3

音频播放显示效果

GST命令行操作的音频播放功能：在使用命令行播放时，需要按照下列步骤输入相应的命令。
注：在输入完相应的命令后，在终端上会显示播放音频的进度。

gst-launch-1.0 uridecodebin uri=file:///home/pi/test.mp3 ! audioconvert ! audioresample ! autoaudiosink #其中location后的参数根据实际视频路径进行修改

命令参数说明：

  • gst-launch-1.0: 这是 GStreamer 的命令行工具，用于构建和运行一个 GStreamer 管道（pipeline）。

  • uridecodebin uri=file:///home/pi/test.mp3: 使用 uridecodebin 元素从指定 URI 路径 file:///home/pi/test.mp3 读取并自动解码音频文件。这是一个高级元素，能够自动检测媒体类型并选择合适的解复用器和解码器。

  • ! audioconvert: 通过 ! 符号将前一个元素的输出连接到下一个元素的输入。audioconvert 用于转换音频格式，确保前后元素之间的音频格式兼容。

  • ! audioresample: 对音频进行重采样，调整音频的采样率以匹配后续元素的要求。

  • ! autoaudiosink: 自动选择合适的音频输出组件来播放音频内容。根据系统环境的不同，它会选择最合适的音频输出设备，比如 ALSA、PulseAudio 或其他可用的音频后端。

以下为播放音频的效果图。

图片3

音频播放显示效果

进阶功能

双屏显示的连接方法

双屏显示功能，即在单板电脑上同时显示 MIPI 屏和 HDMI 屏。
注：双屏显示此功能的接法是使用 MIPI 屏的接法和使用DP口接法转接的 HDMI 屏幕。

按照下图进行连接：

双屏显示配置说明

连接好硬件后，系统会自动识别两个显示屏设备。默认情况下：
MIPI 屏幕作为主显示屏，显示完整的桌面环境， HDMI 屏幕作为扩展显示屏，可以进行扩展显示。
用户可以通过以下方式切换双屏显示模式：
1.打开 设置 → 显示 选项。
2.在显示设置中可以看到两个屏幕的标识。

两个屏幕的标识效果如下图：


3.选择需要的显示模式：

  • 扩展显示：两个屏幕显示不同的内容，可以独立操作。
  • 镜像显示：两个屏幕显示相同的内容。

双屏显示注意事项

1.双屏显示时，建议使用性能较好的电源适配器。
2.当两个屏幕分辨率不同时，可能会出现显示效果差异。
3.部分应用程序可能需要重新调整窗口位置以适应双屏环境。

应用场景

  • 媒体娱乐终端: 使用 Quectel-Pi-H1 单板电脑作为媒体娱乐终端，可以播放影视视频、音乐、查看图片等。
  • 工业数据可视化平台: 使用 Quectel-Pi-H1 单板电脑作为工业数据可视化平台，可以显示工业数据、监控设备运行情况、进行数据处理等。
  • 智能交互终端：使用 Quectel-Pi-H1 单板电脑作为智能交互终端，可以使用于各类的人机交互应用。

疑难解答

如何查看系统日志

查看系统日志，需要将串口线接至电脑，并使用串口工具查看日志。

黑屏问题

在正常连接好设备后，开机后显示黑屏，可能是以下的情况：
1.电源连接问题
检查显示屏的供电接口是否正确连接，确认4个供电接口中至少有一个已正确连接，确保供电螺丝已拧紧，顶针与40PIN接触良好。
2.连接线路问题
检查MIPI排线是否正确插入并牢固连接，确认排线方向是否正确，避免插反，检查连接器是否有物理损坏。
3.系统启动问题
确认系统已正常启动并加载显示服务，检查登录凭证是否正确（默认用户：pi，密码：quecpi），查看系统日志确认显示驱动是否正常加载。

花屏问题

在正常连接好设备后，开机后显示花屏，可能是以下的情况：
1.信号干扰
检查MIPI排线是否过长或质量不佳，确认排线周围是否有强电磁干扰源，尝试更换高质量的MIPI排线。
2.硬件兼容性问题
确认使用的显示屏型号与Quectel-Pi-H1完全兼容，检查显示屏固件版本是否为最新版本。

触摸功能异常

触摸功能异常，可能是以下情况：
1.驱动问题
确认系统已正确加载触摸屏驱动，检查I2C通信是否正常建立。
2.校准问题
如触摸位置不准确，可能需要重新校准触摸屏，通过系统设置中的触摸屏校准工具进行校准。