使用教程
操作步骤
支持树莓派的 Raspberry Pi OS / Ubuntu / Kali 和 Retropie 系统。
当 LCD 工作于树莓派这些系统时,必须手动设置分辨率,否则会导致显示分辨率不正确,影响体验。
请在 树莓派官网 下载最新版本的镜像。
-
将压缩文件下载到 PC 上,并解压得到。img 文件。
-
TF 卡连接到 PC,使用 SDFormatter 软件格式化 TF 卡。
-
打开 Win32DiskImager 软件,选择第 1 步准备的系统镜像,点击 write 烧写系统镜像。
-
烧写完成后,打开 TF 卡根目录的 config.txt 文件,在 config.txt 最后加入以下代码,保存并安全弹出 TF 卡。
hdmi_force_hotplug=1config_hdmi_boost=10hdmi_group=2hdmi_mode=87hdmi_cvt 1024 600 60 6 0 0 0 -
将 TF 卡插入树莓派,将 LCD 的 Touch 接口连接到树莓派的 USB 接口,将 LCD 的 HDMI 接口连接到树莓派的 HDMI 接口。
-
给树莓派上电,正常等待几秒后可正常显示。
注 1:当树莓派 4 同时连接多个显示器的时候,触摸效果默认作用在主屏上,如需指定触摸到副屏,参见 树莓派指定触控屏。
注 2:在 2021 年 12 月 2 日,树莓派的 Raspberry Pi OS 分成了两个分支,分别是 Buster 分支和 Bullseye 分支。
其中 Buster 分支是老系统的延续,更为稳定。Bullseye 分支则添加了一些新的功能,使用了开源的库和新的接口。当前 Bullseye 分支刚发布不久,还不太稳定。
如果你是工业用户,强烈建议使用 Buster 分支。
如果你使用的 Buster 分支的系统,则按上面的配置即可使用。如果使用的是 Bullseye 分支的系统,需要将默认的 KMS 驱动修改为 FKMS 驱动才可以正常显示系统桌面。
修改方法:打开 TF 卡根目录的 config.txt 文件,在 config.txt 中将
dtoverlay=vc4-kms-v3d
修改为
dtoverlay=vc4-fkms-v3d
如果你需要在 Bullseye 分支的系统下使用 CSI 摄像头。由于该分支默认使用 libcamera 摄像头库,该库不支持 FKMS 驱动。
所以除了上面修改外,还需要安装 Raspicam 摄像头库。
安装方法如下:
在终端运行以下指令:
cd ~
sudo apt install cmake
git clone https://github.com/raspberrypi/userland
cd userland
./buildme
sudo cp build/bin/* /bin/
之后执行以下指令关机:
poweroff
在将树莓派摄像头连接到树莓派的 CSI 接口上,重新给树莓派上电,系统启动后,执行以下命令即可:
拍照
raspistill -o image.jpg
摄像
raspivid -o video.h264 -t 10000
树莓派指定触控屏
- 在树莓派终端输入 xrandr,查看主屏所在的 HDMI-ID(大部分是 HDMI-1);

- 在树莓派终端输入 xinput,查看主屏所在的触摸 ID(有 2 个触摸 ID,如果不知道哪个是主屏,可以都试一下);

- 运行指令:xinput map-to-output <touch ID> <HDMI-ID>
(把 ID 值对应后运行指令即可指定触摸到主屏上,如:xinput map-to-output 7 HDMI-1 )
-
由于每次开机都需要重新输入指令,可以将此指令添加到开机自启中去:
sudo nano /etc/xdg/lxsession/LXDE-pi/autostart添加:xinput map-to-output 7 HDMI-1 (记得改成自己对应 ID),然后重启即可。