為Raspberry Pi 樹莓派 安裝觸控螢幕與觸控校正程式
2025/11/6 更新| By G小編
Raspberry Pi 樹莓派由於其小巧的體積、低廉的價格、開源多元的軟體、豐富的社群教學資源,已經成為創客的首選入門機。樹莓派的本意雖然是以協助學生的電腦科學教育為主,但由於Linus、Python等開源軟體的快速進步,眾多Raspberry Pi愛好者也為樹莓派創造出自造機器人、伺服器、IOT監控、工控聯網裝置,甚至是串聯多個樹莓派成為超級電腦等應用。
隨著新一代樹莓派5的效能強化,以及新版Linux對圖形介面的支援更為完整,樹莓派與觸控螢幕的應用性也更加便利!本文將詳細說明如何為樹莓派安裝外接式電容觸控螢幕,同時安裝與執行觸控校正程式,以便獲得更靈敏精準的觸控操作。
1. 連接觸控螢幕
不同世代的樹莓派機型具備不同的I/O 埠配置, 但一定都具備HDMI 與USB埠(參見下表),樹莓派4與樹莓派5由於耗電量較大,必須使用其標配的變壓器來供電,而樹莓派3 的最大耗電量為2.5A,一般情況下,可以透過T1系列的USB-A埠為其供電。
🎗️實際測試後發現,即使是樹莓派5依然可以透過T1系列的USB-A埠供電起電,並操作一般性的應用程式。
| 型號 | 樹莓派3B | 樹莓派4B | 樹莓派5 |
| CPU | 1.4G | 1.5G | 2.4G |
| HDMI埠 | HDMI-A*1 | Micro-HDMI*2 | Micro-HDMI*2 |
| USB埠 | USB2.0*4 | USB2.0*2+USB3.0*2 | USB2.0*2+USB3.0*2 |
| 電源 | 5V-2.5A | 5V-3A | 5V-5A |
在此我們使用Raspberry Pi 3 Model B 與T111B觸控螢幕示範連接方式—如何由T111B供電予樹莓派3使用:
② 將HDMI線分別插入T111B觸控螢幕 與樹莓派
③ 將USB-A轉USB-C觸控訊號線插至樹莓派的USB-A埠與T111B的USB-C埠,以傳輸觸控訊號
④ 將樹莓派用的電源線插至樹莓派電源孔與T111B的USB-A擴充埠,為樹莓派供電
⑤ 插入T111B內附的12V電源供應器,為螢幕供電
2. 螢幕顯示設定
樹莓派3/4/5均已支援最新的Debian 13與新型桌面環境,建議直接安裝64位元附桌面環境的樹莓派作業系統,2025新版的樹莓派作業系統 (Debian Trixie) 支援USB觸控螢幕隨插即用;當系統開機成功後,觸控螢幕即可正常操作使用。
本版本的顯示器設定方式如下:
① 開啟Control Centre
點選樹莓派圖示 ➝點選Preferences ➝點選Control Centre
② 點選Screens
選擇已連接的顯示器,即出現顯示設定選單
③ 解析度設定
點選Resolution:選擇合適的解析度,以T1為例,請選擇1920x1080
👀 閱讀舒適度設定
設定解析度1920x1080後,若視窗文字太小不易閱讀,可至Defaults➝點選 For Large Screens “Set Defaults”,視窗顯示文字將會變大
④ 直式顯示設定
如需旋轉螢幕,改為直式顯示,點選Orientation➝依需求點選”Left”或”Right”➝點選”Apply”➝螢幕即改為直式顯示
📢 RPI OS支援垂直觸控螢幕
新版的Raspberry Pi Desktop已經全面採用wayland與labwc,顯示方向旋轉後,觸控映對位置也會自動旋轉,無須再做任何設定!!
⑤ 觸控設定
Raspberry Pi Desktop亦提供彈性的觸控模式選擇,點選Touchscreen➝點選Mode➝選擇單點觸控的”Mouse Emulation” 或是多點觸控辨識的”Multitouch”
( 註:T1系列觸控螢幕支援十點多點觸控)
3. 安裝觸控校正程式
一般情況下,Raspberry Pi OS桌面會自動辨識觸控螢幕設定,即使設定顯示方向旋後,觸控亦可正常正常,不需要使用觸控校正程式。
由於2025 Raspberry Pi桌面採用xwayland server,與X視窗系統運作於不同層級,不會讀取xinput_calibrator程式所產生的校正值設定。如果安裝觸控螢幕後,有觸控位置不正確的情況,建議使用libinput來設定觸控起始值。以下為Raspberry Pi OS (Trixie)的觸控值設定方式:
① 開啟labwc設定檔rc.xml
Raspberry Pi OS(Trixie)全新採用labwc作為圖形管理器,手動設定觸控映射值須編輯至labwc的設定檔
點選左上角 Terminal 圖示,輸入下列指令:
sudo nano ~/.config/labwc/rc.xml
② 輸入libinput觸控校正值
新增一段語法指定所需的觸控起始值:輸入下列指令: (Gechic觸控螢幕的名稱為ILITEK ILITEK-TP)
<libinput> <device device=”ILITEK ILITEK-TP”>
<calibrationMatrix>1 0 0 0 1 0</calibrationMatrix>
</device>
</libinput>
③ 重啟系統的桌面管理器
輸入下列指令:桌面系統重啟後,觸控的反應即會依新的設定值生效
sudo systemctl restart lightdm
📢 libinput 的calibration Matrix 設定值
注意: LIBINPUT的CALIBRATION_MATRIX依顯示方向而有不同的起始值設定:
calibrationMatrix="1 0 0 0 1 0" # 預設值-水平顯示
calibrationMatrix ="0 -1 1 1 0 0" # 90 度順時針旋轉
calibrationMatrix ="-1 0 1 0 -1 1" # 180 度順時針旋轉
calibrationMatrix ="0 1 0 -1 0 1" # 270 度順時針旋轉
xinput觸控校正程式
若是使用非wayland 的桌面環境(關閉wayland 改用X11環境),依然可以使用xinput calibrator 校正程式,使用方式如下:
① 下載並安裝xinput_calibrator程式
點選桌面左上角的Termianl圖示打開Terminal
在Terminal 中輸入 sudo apt-get install ximput-calibrator
② 執行xinput_calibrator程式
在Terminal 中輸入 xinput_calibrator
在觸控螢幕上點選紅色十字游標
③ 選取獲得的觸控數值(如圖之紅框範圍),按滑鼠右鍵>>Copy複製
④ 在/etc/X11/中,創建一個xorg.conf.d資料夾 與一個99-calibration.conf檔案
在Terminal 中輸入 sudo mkdir /etc/X11/xorg.conf.d [請留意大小寫]
輸入 sudo nano /etc/X11/xorg.conf.d/99-calibration.conf
⑤ 貼上觸控值
按滑鼠右鍵,選擇Paste貼上>>按ctrol+O 儲存 >>enter確認
⑥ 重新開機, 完成!
補充說明:如何安裝Raspbian
Raspberry Pi 支援多種行動作業系統,但最推薦初學者使用的是樹莓派基金會基於Debian開發作業系統—Raspberry Pi OS (亦稱為Raspbian)。初學者可以簡單透過樹莓派基金會所提供的程式—Raspberry Pi Imager,下載並安裝Raspbian。
當您購買樹莓派後,請先準備一張8G以上的SD記憶卡,依下列步驟進行Raspbian安裝。
① 筆電安裝Raspberry Pi Imager
至https://www.raspberrypi.org/software/
選擇下載Windows版或Mac版 Raspberry Pi Imager,點選imager執行檔進行安裝
② 將SD卡插入筆電中並開啟Raspberry Pi Imager
③ 選擇樹莓派型號
④ 選擇欲安裝的OS
⑤ 選擇欲使用的SD卡
⑥ 設定帳號與網路等
⑦ 燒錄完成後即可使用



