HDMI
本文档详细介绍了Quectel-Pi-H1单板电脑的HDMI显示接口识别、显示屏连接方法、系统配置及常见问题解决方案，以11.6英寸HDMI显示屏为例进行详细说明。
HDMI 屏连接
按照下图进行连接：
11.6寸HDMI显示屏
连接上HDMI显示屏后的QuecPi
连接上 HDMI 显示器并上电开机后，启动显示服务，选择默认用户：pi ,密码：quecpi，HDMI 屏会显示 Gnome 桌面。
显示效果如下图：
屏幕显示效果
功能使用
调整屏幕亮度和音量
注：接入HDMI 显示器后，分辨率是自适应的，不可更改。目前所支持的HDMI分辨率是3840 × 2160、1920 × 1080、1280 × 720、720 × 480
在连接上HDMI 显示器并且上电开机后，进入 Gnome 桌面，点击右上角的电池图标，滑动声音栏和滑动亮度栏，进行调整亮度和音量。
以下为调整屏幕亮度和音量的操作图。
亮度和音量调整操作
触摸功能的使用方法
在连接上 HDMI 显示器并且上电开机后，需要将USB口连接到HDMI屏幕。
注：此功能需要带有触摸功能的HDMI屏幕。
按照下图进行连接：
触摸功能连接效果
视频播放功能的使用方法
可视化界面的视频播放功能：打开 Gnome 桌面，在 Gnome 桌面的 文件管理器 中，找到视频文件，点击视频文件即可播放视频。
注：双击边框即可全屏播放视频。
桌面打开操作步骤
视频播放显示效果
VLC命令行操作的视频播放功能：在使用命令行播放时，需要按照下列步骤输入相应的命令。
export LIBGL_ALWAYS_SOFTWARE=1 #修改本窗口的环境变量，在播放视频时切换到CPU渲染
VLC test.mp4 #播放视频
以下为播放视频的效果图。
视频播放显示效果
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等。
以下为播放视频的效果图。
视频播放显示效果
音频播放功能的使用方法
可视化界面的音频播放功能：打开 Gnome 桌面，在 Gnome 桌面的 文件管理器 中，找到音频文件，点击音频文件即可播放音频。
注：播放音频需要在SG565D单板电脑上将喇叭链接。
桌面打开操作步骤
音频播放显示效果
VLC命令行操作的音频播放功能：在使用命令行播放时，需要按照下列步骤输入相应的命令。
export LIBGL_ALWAYS_SOFTWARE=1 #修改本窗口的环境变量，在播放音频时切换到CPU渲染
VLC 1.mp3 #播放音频
以下为播放音频的效果图。
音频播放显示效果
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 或其他可用的音频后端。
以下为播放音频的效果图。
音频播放显示效果
进阶功能
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.电源连接问题
检查显示屏的供电接口是否正确连接，确认4个供电接口中至少有一个已正确连接，确保供电螺丝已拧紧，顶针与40PIN接触良好。
2.连接线路问题
检查MIPI排线是否正确插入并牢固连接，确认排线方向是否正确，避免插反，检查连接器是否有物理损坏。
3.系统启动问题
确认系统已正常启动并加载显示服务，检查登录凭证是否正确（默认用户：pi，密码：quecpi），查看系统日志确认显示驱动是否正常加载。
花屏问题
在正常连接好设备后，开机后显示花屏，可能是以下的情况：
1.信号干扰
检查MIPI排线是否过长或质量不佳，确认排线周围是否有强电磁干扰源，尝试更换高质量的MIPI排线。
2.硬件兼容性问题
确认使用的显示屏型号与Quectel-Pi-H1完全兼容，检查显示屏固件版本是否为最新版本。
触摸功能异常
触摸功能异常，可能是以下情况：
1.驱动问题
确认系统已正确加载触摸屏驱动，检查I2C通信是否正常建立。
2.校准问题
如触摸位置不准确，可能需要重新校准触摸屏，通过系统设置中的触摸屏校准工具进行校准。