Harmonica OSタブレットのタッチスクリーンキャリブレーションの問題を解決する：適切なLinux修正方法を選択する

まず、どの「ハーモニカOS」のことか確認してください。

韓国のLinuxディストリビューションであるHamoniKRのことでしたら、タッチスクリーンの動作はタブレットのハードウェア、Linuxカーネルドライバ、入力スタック、デスクトップセッションが連携して動作します。HamoniKRタブレット用の汎用キャリブレーションウィザードや、すべてのモデルに適用できる単一の修正方法は確認できませんでした。HamoniKRプロジェクトはバージョン管理されたマニュアルを公開していますが、以下のキャリブレーション手順は文書化されたLinux入力ツールを使用するため、タブレットがどのドライバを公開しているかによって異なります。Huawei HarmonyOSやHarmonica OSと呼ばれる別の製品のことでしたら、これらのLinuxコマンドは適用されません。

実用的な選択肢は、キャリブレータをインストールしたりシステムファイルを変更したりする前に、症状を診断することです。タッチポイントが常にずれている場合は、キャリブレーションが必要になる可能性があります。ポインタが回転していたり​​、間違ったディスプレイにマッピングされていたり、解像度変更後にのみ不正確になる場合は、通常、ディスプレイマッピングの修正が必要です。ランダムなタッチ、タッチの欠落、またはゴーストタッチは、ドライバのサポートまたはハードウェアに起因する可能性があり、キャリブレーション値を変更しても解決しません。

HamoniKRのバージョン管理されたユーザーガイドは、インストールされているリリース固有の詳細を確認するのに最適な場所です。以下の入力レイヤーに関するガイダンスは、libinputの設定ドキュメントとUbuntuのxinput_calibratorのマニュアルページに基づいています。

どの解決策が症状に合致するのか？

この区別によって時間を節約できます。キャリブレーションは、タッチセンサーからディスプレイへの座標のマッピング方法を調整するものであり、サポートされていないコントローラーを動作させたり、破損したデジタイザーを修復したりすることはできません。

キャリブレーションを変更する前に、何をチェックすべきですか？

1. タブレットの機種名とOSのリリースバージョンを記録してください。ターミナルで、/etc/os-release正確なデバイスモデルを確認し、メモしてください。インストールされているHamoniKRのリリースバージョンとタブレットの機種が互換性があるかどうかを確認してください。
2. 画面を清掃し、接触を妨げるものはすべて取り除いてください。水分やゴミを拭き取り、テストのために、可能であれば厚手の保護フィルムや破損した保護フィルムを取り外してください。指とスタイラスペンでそれぞれテストしてください。
3. ディスプレイを本来の解像度と通常の向きに設定してください。デスクトップのディスプレイ設定を使用してください。タブレットを回転させたり、スケールを変更したり、モニターを接続したりした後に精度が変わった場合は、その変更を一時的に元に戻して再度テストしてください。
4. 再起動して、関連するシステムアップデートを適用してください。アップデートには、カーネルや入力ドライバの修正が含まれる場合があります。特にアップグレード後に問題が発生した場合は、永続的な設定を編集する前に、必ずこの操作を行ってください。
5. Linuxがタッチスクリーンを認識しているかどうかを確認します。を実行しますlibinput list-devices。 X.Orgセッションを使用している場合は、xinput listX入力デバイスを表示できます。これらのコマンドはデバイスを識別するものであり、キャリブレーションは行いません。

セッションの種類を識別するには、 を実行しますecho "$XDG_SESSION_TYPE"。 の出力はx11X.Org を意味します。waylandは Wayland コンポジタが物理入力を管理していることを意味します。これは、X.Org ユーティリティでは Xwayland を介して物理タッチスクリーンを確実に構成できないため重要です。

X.Orgのキャリブレーションユーティリティを使用すべきでしょうか？

X.Org セッションが実際に実行中で、プログラムが物理的なタッチスクリーンをキャリブレーション可能なデバイスとして認識している場合にのみ選択してくださいxinput_calibrator。Ubuntu のマニュアルでは、これは X.Org ユーティリティとして説明されており、新しい値が保持されるかどうかはドライバによって異なると説明されています。場合によっては、現在のセッションに値を適用したり、設定の抜粋を表示したりできますが、他のドライバでは自動キャリブレーションは利用できません。

ツールが既にインストールされている場合は、まずサポートされているデバイスの一覧を表示します。

xinput_calibrator --list

お使いのタッチスクリーンがそのリストに表示されている場合は、画面上の指示に従って操作し、出力結果を確認してください。値を保存する前に、画面全体で結果をテストしてください。ユーティリティが出力したからといって、そのままシステムディレクトリに貼り付けないでください。まず、出力されたスニペットがデバイス名を正しく認識し、使用しているドライバと一致していることを確認してください。

この方法は、タブレットが互換性のある X.Org ドライバーを使用し、エラーが安定したオフセットである場合に便利です。システムが Wayland を使用している場合、デバイスがキャリブレータのリストにない場合、またはエラーが非線形または断続的な場合は、この方法は適していません。マニュアルには、4 点キャリブレーションでは非線形の画面変形を補正できないと記載されています。プログラムが繰り返し誤クリックを報告する場合は、値を強制的に設定するのではなく、停止してデバイスのサポート状況を確認してください。

回転の問題や、表示が間違っている場合はどうすればよいでしょうか？

キャリブレーションを行う前に、ディスプレイの設定を修正してください。HamoniKRのディスプレイ設定で、タブレット本来の向き、解像度、スケーリングを復元してください。外部モニターが接続されている場合は、それを取り外し、内蔵スクリーンのみでテストしてください。タッチ操作が再び正確になった場合は、出力マッピングまたは回転に問題がある可能性があります。

複数のディスプレイを備えたデスクトップPCまたはコンバーチブルPCの場合、タッチスクリーンが別の出力に割り当てられている可能性があります。通常、Linuxのディスプレイマネージャまたはデスクトップ設定が、この関連付けを修正する最もリスクの低い場所です。Waylandセッションでは、デスクトップ環境のコントロールを使用してください。ターミナルからXInputプロパティを変更しても、物理デバイスではなくXwaylandアプリケーションのみに影響する可能性があります。

ディスプレイマッピングとセンサーキャリブレーションは関連していますが、異なるものです。マッピングは、タッチ座標を受け取る出力と、座標の回転または拡大縮小方法を選択します。キャリブレーションは、デジタイザで測定されたタッチ位置と、その出力上の表示点との間の関係を補正します。まず、誤った出力または向きを修正してから、物理的なオフセットを再確認してください。

libinputのキャリブレーションマトリックスはどのような場合に適切ですか？

libinput マトリックスは、デバイスがキャリブレーションをサポートしており、かつその特定のパネルに対して信頼できる値を持っている場合にのみ使用してください。libinput の説明によると、キャリブレーションは一部の直接入力デバイスでのみ利用可能で、変換マトリックスとして表現され、通常はデスクトップ環境または別の呼び出し元を介して公開されます。そのlibinput list-devices出力は、ローカルデバイスで利用可能な構成を示すのに役立ちます。

永続的な Linux 設定では、多くの場合、デバイスごとの udev プロパティ (例: ) を使用しますLIBINPUT_CALIBRATION_MATRIXが、正しい値はデバイス、向き、およびドライバによって異なります。「Harmonica OS タブレット」用の安全な汎用マトリックスはありません。別のタブレットからマトリックスをコピーしたり、係数を推測したりしないでください。ルールが間違っていると、画面が使いにくくなり、元に戻すためにキーボード、リモート シェル、またはリカバリ環境が必要になる場合があります。

この高度な方法は、入力デバイスを正確に特定し、必要な変換を測定し、タッチ操作が停止した場合にシステムを復旧できる管理者向けです。測定ツールや復旧計画のない、単一デバイスの家庭用タブレットの場合は、X.Org互換ツール（該当する場合）またはドライバ／ベンダーによる修正の方が安全な選択肢です。

結果をどのように検証しますか？

• 中央と四隅を数回タップし、次にそれらの間のポイントをテストしてください。角は正確でも端が不正確な場合は、基本的なキャリブレーションでは修正できない問題がある可能性があります。
• タブレットを回転させてから元の向きに戻した後、再度テストを行ってください。
• 指入力とスタイラス入力は別々にテストしてください。それぞれ異なるデバイスとして認識され、個別のキャリブレーションサポートが提供される場合があります。
• 永続的な変更を加えた後は、必ず再起動して再度テストしてください。ログアウトまたは再起動までしか有効でない値は、永続的な値ではありません。
• 高度な変更を行う前に、正常に動作することが確認されている外付けキーボードまたはマウスを試して、復旧用の入力方法を確保しておきましょう。

修正が成功すれば、画面全体でタップがタッチしたポイントの近くに着地し、再起動後も正しく動作し、別の向きで新たなオフセットが発生しないはずです。それでもランダムなミス、ゴーストタッチ、デッドストリップが発生する場合、またはデバイスが認識されない場合はlibinput list-devices、キャリブレーション調整を増やすのではなく、カーネルドライバ、ファームウェア、コネクタ、またはデジタイザを調査してください。

利用可能なアプローチの中から選択する

表示変更後に発生したオフセットについては、まず解像度と向きをリセットしてください。これは迅速かつ簡単に元に戻すことができます。互換性のある X.Org ドライバで認識されるタッチスクリーンについては、xinput_calibratorドライバ固有の出力を使用して評価してください。これはより直接的ですが、すべての最新の入力スタックを網羅しているわけではありません。測定値を持つサポートされている libinput デバイスについては、デバイスごとのマトリックスを使用すると永続性が得られますが、構成と復旧のコストが最も高くなります。断続的な入力、サポートされていないハードウェア、または物理的な損傷については、キャリブレーションよりもドライバのトラブルシューティングまたはデバイスの修理の方が適切です。

HamoniKRのリリースバージョンとタブレットのモデルによって、実際に利用可能なパスが決まります。キャリブレーションソフトウェアをインストールしたり、システムレベルの入力ルールを変更したりする前に、これらの詳細を確認してください。