# HDMI ***Copyright © Quectel Wireless Solutions Co., Ltd. 2026. All rights reserved.*** --- 本文档详细介绍了 **Quectel Pi H1** 智能主控板的 **HDMI** 显示接口识别、显示屏连接方法、系统配置及常见问题解决方案，以 **10.1英寸HDMI显示屏** 为例进行详细说明。 # HDMI屏幕连接 按照下图进行连接： ```{image} images/image_ZkXvbV48JoJkFExUahicFEo5ngc.webp :width: 1496px :height: 1120px ```
10.1英寸HDMI显示屏
```{image} images/image_JsBpba59LoTyeyxxzxhcookPnDg.webp :width: 1710px :height: 1279px ```
HDMI显示屏连接示意图
具体的登录操作请参考 [系统登录](<../../../操作系统/Debian/系统登录/系统登录.md>) ```{image} images/image_KlLMbYpIxo7LqvxZLCGcFqDRnTd.webp :width: 1263px :height: 784px ```
屏幕显示效果
# 功能使用 ## 调整屏幕亮度和音量 注：接入 **HDMI** 显示器后，分辨率是自适应的，不可更改。目前所支持的 **HDMI** 分辨率是 **3840 × 2160**、**1920 × 1080**、**1280 × 720**、**720 × 480** 在连接 **HDMI** 显示器并且上电开机后，进入 **GNOME** 桌面，点击右上角的电池图标，滑动声音栏和亮度栏来调整音量和亮度。 以下为调整屏幕亮度和音量的操作图。 ```{image} images/image_MMmJb4GrloEkiXxGuBtcOFd0nVc.webp :width: 1035px :height: 653px ```
亮度和音量调整操作
## 触摸功能的使用方法 在连接 **HDMI** 显示器并且上电开机后，需要将 **USB** 口连接到HDMI屏幕。 注：此功能需要带有触摸功能的 **HDMI** 屏幕。 按照下图进行连接： ```{image} images/image_Pwkebz6aso4wfnxzMeWcueJtnXh.webp :width: 2658px :height: 1279px ```
触摸功能连接效果
## 视频播放功能的使用方法 **可视化界面的视频播放功能**：打开 **Gnome** 桌面，在 **Gnome** 桌面的 **文件管理器** 中，找到视频文件，点击视频文件即可播放视频。 注：双击边框即可全屏播放视频。 ```{image} images/image_Ir6DbiFtyoLtpRxt7VycHNGnn7b.webp :width: 1075px :height: 650px ```
桌面打开操作步骤
```{image} images/image_OiPSbjvoPol6iexYrnLcy2j0n2e.webp :width: 1256px :height: 760px ```
视频播放显示效果
**VLC命令行操作的视频播放功能**：在使用命令行播放时，需要按照下列步骤输入相应的命令。 ```shell export LIBGL_ALWAYS_SOFTWARE=1 #修改本窗口的环境变量，在播放视频时切换到CPU渲染 VLC test.mp4 #播放视频 ``` 以下为播放视频的效果图。 ```{image} images/image_ZHZAbwzvZorreYxq1EOcMGIcnsb.webp :width: 1256px :height: 760px ```
视频播放显示效果
**GST命令行操作的视频播放功能**：在使用命令行播放时，需要输入下面相应的命令。 ```shell 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* 等。 以下为播放视频的效果图。 ```{image} images/image_MBg0bSw8koUTHRxRVOqcPfuWniJ.webp :width: 1277px :height: 794px ```
视频播放显示效果
## 音频播放功能的使用方法 **可视化界面的音频播放功能**：打开 **Gnome** 桌面，在 **Gnome** 桌面的 **文件管理器** 中，找到音频文件，点击音频文件即可播放音频。 注：播放音频需要在Quectel Pi H1智能主控板上连接喇叭。 ```{image} images/image_Hhn9bt6LHo8xjax2njPc2u5EnBb.webp :width: 1037px :height: 651px ```
桌面打开操作步骤
```{image} images/image_IbB8bNU2fodIIGxljuacQ47Wnwd.webp :width: 1272px :height: 796px ```
音频播放显示效果
**VLC命令行操作的音频播放功能**：在使用命令行播放时，需要按照下列步骤输入相应的命令。 ```shell export LIBGL_ALWAYS_SOFTWARE=1 #修改本窗口的环境变量，在播放音频时切换到CPU渲染 VLC 1.mp3 #播放音频 ``` 以下为播放音频的效果图。 ```{image} images/image_Hsi6b6bhHoRt0Cxfx90c3c4en1U.webp :width: 1272px :height: 796px ```
音频播放显示效果
**GST命令行操作的音频播放功能**：在使用命令行播放时，需要按照下列步骤输入相应的命令。 注：在输入完相应的命令后，在终端上会显示播放音频的进度。 ```shell gst-launch-1.0 uridecodebin uri=file:///home/pi/test.mp3 ! audioconvert ! audioresample ! autoaudiosink #其中uri后的参数应根据实际视频路径进行修改 ``` 命令参数说明： - *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或其他可用的音频后端。 以下为播放音频的效果图。 ```{image} images/image_W07UbdCH9oNglmxZErqc2BCunph.webp :width: 1277px :height: 794px ```
音频播放显示效果
# 进阶功能 ## HDMI屏幕的热插拔 HDMI屏幕支持热插拔功能，你可以在系统运行过程中插拔HDMI屏幕，系统会自动识别并显示画面。 ## 热插拔使用方法 1.在系统运行状态下，直接将HDMI屏幕插入智能主控板的HDMI接口。 2.系统会自动检测到HDMI设备并启动显示输出。 3.如需断开HDMI屏幕，可直接拔出HDMI线缆，系统会自动切换显示输出。 ## 热插拔注意事项 1.热插拔功能仅支持通过HDMI接口连接的显示屏。 2.使用DP转HDMI适配器连接的屏幕可能无法正常支持热插拔。 3.在插拔过程中请避免频繁操作，建议每次插拔间隔不少于5秒。 # 应用场景 - **媒体娱乐终端**: 使用 **Quectel Pi H1** 智能主控板作为媒体娱乐终端，可以播放视频、音乐、查看图片等。 - **工业数据可视化平台**: 使用 **Quectel Pi H1** 智能主控板作为工业数据可视化平台，可以显示工业数据、监控设备运行情况、进行数据处理等。 - **智能交互终端**：使用 **Quectel Pi H1** 智能主控板作为智能交互终端，可以使用于各类的人机交互应用。 # 疑难解答 ## 如何查看系统日志 查看系统日志，需要将串口线接至电脑，并使用串口工具查看日志。 ## 黑屏问题 在正常连接好设备后，开机后显示 **黑屏**，可能是以下的情况： 1.电源连接问题 检查显示屏的供电接口是否正确连接，确认电源适配器已正确连接并供电。 2.连接线路问题 检查 **HDMI** 线缆是否正确连接并牢固插入，确认 **HDMI** 线缆方向是否正确，避免插反，检查连接器是否有物理损坏。 3.系统启动问题 确认系统已正常启动并加载显示服务，查看系统日志确认显示驱动是否正常加载。 4.分辨率兼容问题 检查显示器支持的分辨率是否与系统输出分辨率匹配，必要时手动调整分辨率设置。 ## 花屏问题 在正常连接好设备后，开机后显示 **花屏**，可能是以下的情况： 1.信号干扰 检查HDMI线缆是否过长或质量不佳，确认线缆周围是否有强电磁干扰源，尝试更换高质量的HDMI线缆。 2.硬件兼容性问题 确认使用的显示屏型号与 **Quectel Pi H1** 完全兼容，检查显示屏固件版本是否为最新版本。 3.接口接触不良 检查HDMI接口是否存在松动或氧化现象，重新插拔HDMI线缆确保连接牢固。