模板: HDMI-Bookworm-Rotate-New
来自Waveshare Wiki
显示旋转
Bookworm系统
GUI 界面旋转
- 1.打开"Screen Configuration"应用程序;
- 2.依次点击菜单"Screen"->"HDMI-A-1"->"Touchscreen" ,勾选"Waveshare Waveshare"
- 3.依次进入"Screen"->"HDMI-A-1"->"Orientation",选择所需的旋转方向,并点击 Apply 应用设置,即可完成显示与触摸方向的同步旋转。
注意:仅 Bookworm 系统支持此方法实现“显示+触摸”同步旋转。Bullseye 及更早版本需分别设置显示与触摸旋转。
lite版本显示旋转(无桌面环境)
编辑启动命令行文件:
sudo nano /boot/firmware/cmdline.txt
在cmdline.txt文件开头添加以下参数(需修改为屏幕实际分辨率) :
video=HDMI-A-1:400x1280M@60,rotate=90
可替换为:
- rotate=90:顺时针旋转90°
- rotate=180:旋转180°
- rotate=270:逆时针旋转90°
注意:HDMI 与其他接口(如 DPI、DSI)共享旋转设置,无法分别单独设置。
Bullseye/Buster系统
GUI 界面旋转
- 1.打开"Screen Configuration"应用程序;
- 2.依次点击菜单"Screen"->"HDMI-A-1"->"Orientation",选择所需的旋转角度,并点击 Apply 应用设置。
lite版本显示旋转
- 1.需要修改/boot/cmdline.txt文件:
sudo nano /boot/cmdline.txt
- 2.在cmdline.txt文件开头添加以下参数(需修改为屏幕实际分辨率) :
video=HDMI-A-1:400x1280M@60,rotate=90
可替换为:
- rotate=90:顺时针旋转90°
- rotate=180:旋转180°
- rotate=270:逆时针旋转90°
注意:HDMI 与其他接口(如 DPI、DSI)共享旋转设置,无法分别单独设置。
- 3.保存并重新启动
sudo reboot
Stretch/Jessie系统
对于较旧系统(不使用 vc4-kms-v3d 或 vc4-fkms-v3d 驱动),请按以下方式设置:
- 1.编辑 config.txt 文件:
sudo nano /boot/config.txt
- 2. 在文件末尾加入语句:
display_rotate=1 #1:90;2: 180; 3: 270
- 3. 保存后重启树莓派即可
sudo reboot
触摸屏旋转设置
部分屏幕可通过长按背面的 Rotate Touch 按键来旋转触摸方向,每次长按可切换一次方向。

Bookworm 系统(命令行方式)
如果使用图形界面进行旋转,可以在屏幕布局编辑器窗口中勾选“Touchscreen”来同步触摸旋转。屏幕旋转方法请参考前面的介绍。命令行旋转方法请参考以下文字:
1. 创建 udev 规则文件:
sudo nano /etc/udev/rules.d/99-waveshare-touch.rules
2. 添加所需旋转角度对应的内容(根据需要取消注释):
#90°:
ENV{ID_INPUT_TOUCHSCREEN}=="1", ENV{LIBINPUT_CALIBRATION_MATRIX}="0 -1 1 1 0 0"
#180°:
#ENV{ID_INPUT_TOUCHSCREEN}=="1", ENV{LIBINPUT_CALIBRATION_MATRIX}="-1 0 1 0 -1 1"
#270°:
#ENV{ID_INPUT_TOUCHSCREEN}=="1", ENV{LIBINPUT_CALIBRATION_MATRIX}="0 1 0 -1 0 1"
3. 保存并重启
sudo reboot
Bullseye/Buster 系统
1. 安装libinput
sudo apt-get install xserver-xorg-input-libinput
- 如果你安装的是Ubuntu系统,或者是Jetson Nano。安装指令为
sudo apt install xserver-xorg-input-synaptics
2. 在/etc/X11/下创建xorg.conf.d目录 (如果该目录已存在,这直接进行第3步)
sudo mkdir /etc/X11/xorg.conf.d
3. 复制40-libinput-conf 文件到刚刚创建的目录下
sudo cp /usr/share/X11/xorg.conf.d/40-libinput.conf /etc/X11/xorg.conf.d/
4. 编辑该文件
sudo nano /etc/X11/xorg.conf.d/40-libinput.conf #找到 touchscreen的部分,在里面添加对应的旋转角度指令,然后保存即可 #90°Right触摸旋转: Option "CalibrationMatrix" "0 1 0 -1 0 1 0 0 1" #180° Inverted触摸旋转: #Option "CalibrationMatrix" "-1 0 1 0 -1 1 0 0 1" #270° Left旋转: #Option "CalibrationMatrix" "0 -1 1 1 0 0 0 0 1" 类似下图位置:
sudo reboot
完成以上步骤后触摸将会进行旋转。

