Harmonica OS 平板電腦觸控螢幕對齊的正確設置

如果點擊操作落在 Harmonica OS 平板電腦的按鈕旁邊，請先將顯示器調整到預期方向，並確認觸控裝置已被偵測到。僅當螢幕上的誤差一致且會話的輸入堆疊支援時，才套用校準矩陣。由於公開文件中未確認 Harmonica OS 特有的校準選單和支援的平板電腦型號，因此以下步驟使用上游 Linux 工具，並解釋哪些行為取決於已安裝的桌面環境。

校準前選擇正確的校正方法

看似相似的觸控問題可能由不同的原因造成。指針旋轉或鏡像通常表示顯示器方向或裝置對映有問題。整個面板上持續存在的小幅偏移可能需要校準。而觸控失靈、螢幕出現死區、隨機跳動或僅在喚醒後出現螢幕故障等問題，則更可能與硬體、韌體、核心支援或電源管理有關；校準矩陣無法修復這些故障。

首先進行最簡單的檢查：清潔並擦乾螢幕，暫時取下較厚或損壞的保護膜，重啟平板電腦，並在桌面顯示設定中選擇正確的螢幕旋轉方向。如果旋轉後觸控仍然沿用先前的方向，請登出並重新登錄，或重新啟動一次。校準是單獨的座標變換，不能取代校正螢幕旋轉。

一個通用的Linux顯示設定窗口，已為平板電腦選擇縱向顯示方向。 — 變更觸控螢幕校準前，請檢查平板電腦的顯示方向。此介面僅供參考；Harmonica OS 的螢幕可能有所不同。

識別會話和觸控螢幕

開啟終端機並檢查桌面會話是 X11 還是 Wayland：

echo "$XDG_SESSION_TYPE"

然後列出偵測到的輸入設備：

libinput list-devices

找到觸控螢幕條目，並記下其確切名稱和事件節點，例如/dev/input/eventN。名稱和事件編號可能有所不同，因此請勿複製其他平板電腦的值。如果該命令不可用，請檢查 Harmonica OS 配置的軟體包管理器或桌面設備資訊；請勿安裝未經驗證的下載的校準實用程式。如果觸控螢幕未顯示，則校準尚不成熟：檢查裝置是否已啟用，如果適用，請重新連接連接的硬件，並與您的系統管理員或平板電腦供應商一起查找驅動程式或韌體錯誤。

一個通用的 Linux 終端機視圖，其中突出顯示了觸控螢幕輸入設備以及其他輸入設備。 — 請確認觸控螢幕設備，以便校準變更能夠影響正確的輸入設備。此介面僅供參考；Harmonica OS 的螢幕可能有所不同。

使用與您的圖形堆疊相符的方法。

韋蘭會議

Wayland 合成器和輸入堆疊控制觸控座標如何對應到顯示器。上游 libinput 文件將校準描述為絕對設備的變換矩陣，而 Canonical 的 Mir 文件提供了一個具體的流程，該流程使用libinput.calibrate-touchscreenudev 規則。但 Mir 的流程並不能證明 Harmonica OS 上安裝了相同的校準工具或合成器。在應用流程之前，請檢查您的建置實際提供了哪些合成器和工具。如果缺少校準工具，請不要假設xinput_calibratorWayland 下存在可以直接替代的方案。

當有受支援的校準工具可用時，請按照螢幕上的目標指示操作，記錄其計算出的矩陣，並僅將其應用於已識別的觸控螢幕。請準備好鍵盤或遠端 shell，以防觸控映射難以使用。對於持久性 libinput 校準，規則必須與實際設備標識匹配，並使用測量的矩陣；通用範例係數不可直接複製。依照平台文件的說明重新載入設備或重新連接設備，然後驗證校準是否生效。

對於 X11 會話

xinput_calibrator這是一個 X.Org 觸控螢幕校準工具。它僅適用於 X 伺服器支援的裝置和驅動程式。如果 Harmonica OS 的可信任軟體倉庫中提供了該工具，請以已登入的桌面使用者身分執行它，仔細觸摸顯示的目標，並儲存它為該裝置提供的輸出結果。sudo除非文件明確要求，否則請勿使用 root 使用者啟動圖形化的 X11 校準程序；root 使用者可能無法存取活動的顯示會話。如果該工具報告裝置不受支援或未顯示任何目標，請停止操作並確認驅動程式/會話，然後再嘗試其他方法。

一個通用的觸控螢幕測試窗口，顯示四個角落目標和一個與其中一個目標的觸控點偏移量。 — 將觸控點與角標進行比較，以區分校準偏移和旋轉映射。此介面僅供參考；Harmonica OS 螢幕可能有所不同。

謹慎地保留更改並進行驗證

單次會話調整有助於診斷，但註銷後可能會遺失。持久配置取決於驅動程式：libinput 通常讀取名為 `<device-name>` 的裝置級 udev 屬性LIBINPUT_CALIBRATION_MATRIX，而較舊的 X.Org 設定可能使用特定於裝置的配置片段。不要盲目地創建兩種配置。首先確認目前使用的驅動程序，並使用其文件中規定的格式。備份您更改的檔案並保留原始值，以便在問題惡化時可以恢復。

套用變更後，請按照相關文件的說明重新載入或重新連接觸控屏，如果桌面無法重新讀取輸入設置，請重新啟動電腦。然後，在觸控螢幕的每個角落、中心以及常用控制項（例如螢幕鍵盤）附近進行緩慢點擊測試。在縱向和橫向模式下，觸控的控制都應該在手指正下方啟動。在全新登入後也進行測試；這有助於區分永久性修復和臨時會話變更。

通用觸控螢幕驗證網格，藍色觸控點位於目標中心。 — 應用修正後，測試面板上的幾個點。此介面僅供參考；Harmonica OS 的螢幕可能有所不同。

何時改變策略

如果誤差隨旋轉而變化，請重新檢查顯示映射，而不是調整新的矩陣。如果觸控僅在邊緣不準確，請收集觸控螢幕型號、核心版本、會話類型、裝置名稱和相關係統日誌；面板或驅動程式可能需要針對特定裝置進行校正。如果觸控出現跳動、停止回應或在恢復原始配置後仍然錯誤，請撤銷變更並尋求 Harmonica OS 或硬體供應商的驅動程式更新。本文參考的公開資料記錄的是通用的 Linux 校準行為，而非經過驗證的 Harmonica OS 平板電腦專用步驟。