模板: 系统烧录调用模板

用于Trixie和Bookworm系统

方法一：使用Raspberry Pi Imager烧写最新官方镜像

1. 将TF卡连接到PC，下载并使用Raspberry Pi Imager进行烧录对应系统镜像。

2. 镜像烧写完成后，打开TF卡根目录的config.txt文件，在config.txt最后加入以下代码，保存并安全弹出TF卡。

注意：由于Pi5/CM5/CM4/CM3+/CM3具有两个mipi DSI接口，请注意使用正确的DSI接口和指令，默认推荐使用DSI1。

dtoverlay=vc4-kms-v3d
#DSI1 Use
dtoverlay=vc4-kms-dsi-waveshare-panel,8_0_inch
#DSI0 Use
#dtoverlay=vc4-kms-dsi-waveshare-panel,8_0_inch,dsi0

3. 将TF卡插入树莓派，给树莓派上电，正常等待几秒后可以进入显示，系统启动后可以正常触摸。

方法二：使用预安装镜像

1.选择对应的树莓派版本镜像，下载并解压为.img文件。
树莓派3/4B/CM4/5版本下载：Waveshare DSI LCD Bookworm- Pi3/4B/CM4/5预安装镜像
2.将TF卡连接到PC，使用SDFormatter格式化TF卡。
3.打开Win32DiskImager，选择准备好的系统镜像，点击“Write”开始烧录。
4.烧录完成后，打开TF卡根目录的config.txt文件，找到"[all]"这一行，根据自己的屏幕型号，取消注释相关行，以使能DSI屏，然后保存并安全弹出TF卡。

注意：对于Pi5/CM4/CM3+/CM3，由于有两个MIPI DSI显示接口，请确保使用正确的显示接口和指令，默认推荐使用DSI1显示接口。

下面以8.8inch DSI LCD为例：
使用DSI1接口：

#8.8inch DSI LCD
dtoverlay=vc4-kms-dsi-waveshare-panel,8_8_inch

使用DSI0接口：

#8.8inch DSI LCD
dtoverlay=vc4-kms-dsi-waveshare-panel,8_8_inch,dsi0

5.将TF卡插入树莓派，通电启动，等待几秒即可进入系统显示，触控功能也可正常工作。

用于Bullseye系统和Buster系统

方法一：手动安装驱动

1. 在树莓派官网下载最新版本的镜像，将压缩文件下载到PC上，并解压得到.img文件。
2. TF卡连接到PC，使用SDFormatter软件格式化TF卡。
3. 打开Win32DiskImager软件，选择第1步准备的系统镜像，点击write烧写系统镜像。
4. 烧写完成后，将TF卡接入到树莓派上，并启动树莓派，登录树莓派的终端（可以将树莓派接到HDMI显示器或用ssh远程登录）。

#第一步：下载并进入Waveshare-DSI-LCD驱动文件夹
git clone https://github.com/waveshare/Waveshare-DSI-LCD
cd Waveshare-DSI-LCD
 
#第二步：终端输入uname -a查看内核版本，并cd到对应文件目录
#6.1.21则运行下面指令
cd 6.1.21
 
#第三步：请确定当前使用的系统是多少位的，32位系统进入32目录，64位系统进入64目录
cd 32
#cd 64
 
#第四步：输入您对应的型号指令进行安装驱动，注意I2C拨码开关的选择
#4inch DSI LCD 480×800驱动：
sudo bash ./WS_xinchDSI_MAIN.sh 40 I2C0
 
#第五步：等待几秒，当驱动安装完成，没有提示任何报错时，进行重启加载DSI驱动即可正常使用
sudo reboot
#注意：以上步骤需要确保树莓派可以正常连接到互联网。

5.等待系统重启，将可以正常显示和触摸。

方法二：烧写预安装镜像

1.选择您对应的树莓派版本镜像，下载并解压为.img文件
树莓派4B/CM4版本下载：Waveshare DSI LCD - Pi4预安装镜像
树莓派3B/3B+/CM3版本下载：Waveshare DSI LCD - Pi3预安装镜像
2.TF卡连接到PC，使用SDFormatter软件格式化TF卡。
3.打开Win32DiskImager软件，选择第1步准备的系统镜像，点击write烧写系统镜像。
4.烧写完成后，打开TF卡根目录的config.txt文件，在[all]下方加入以下代码，保存并安全弹出TF卡。

dtoverlay=WS_xinchDSI_Screen,SCREEN_type=1,I2C_bus=10
dtoverlay=WS_xinchDSI_Touch,invertedx,swappedxy,I2C_bus=10

5.将TF卡接入到树莓派上，并启动树莓派，等待30秒左右即可正常显示和触摸。