Behebung von Touchscreen-Kalibrierungsproblemen auf Harmonica OS-Tablets: Die richtige Linux-Lösung auswählen

Zunächst sollten Sie bestätigen, welches „Harmonica OS“ Sie meinen.

Wenn Sie HamoniKR, die südkoreanische Linux-Distribution, meinen, hängt das Verhalten des Touchscreens vom Zusammenspiel der Tablet-Hardware, des Linux-Kernel-Treibers, des Eingabe-Stacks und der Desktop-Sitzung ab. Ich konnte weder einen universellen Kalibrierungsassistenten für HamoniKR-Tablets noch eine allgemeingültige Lösung für alle Modelle finden. Das HamoniKR-Projekt veröffentlicht versionierte Handbücher, die folgenden Kalibrierungsschritte verwenden jedoch dokumentierte Linux-Eingabetools und sind abhängig vom Treiber Ihres Tablets. Falls Sie Huawei HarmonyOS oder ein anderes Produkt namens Harmonica OS meinen, sind diese Linux-Befehle nicht anwendbar.

Es empfiehlt sich, die Symptome zu diagnostizieren, bevor ein Kalibrator installiert oder Systemdateien geändert werden. Ein dauerhaft versetzter Berührungspunkt muss möglicherweise kalibriert werden. Ein gedrehter Mauszeiger, der dem falschen Bildschirm zugeordnet ist oder erst nach einer Auflösungsänderung ungenau reagiert, erfordert in der Regel eine Korrektur der Bildschirmzuordnung. Zufällige, ausgelassene oder Geisterberührungen können durch Treiber- oder Hardwareprobleme verursacht werden und lassen sich nicht durch Ändern der Kalibrierungswerte beheben.

Die versionierte Benutzeranleitung von HamoniKR ist die beste Quelle für Details zu Ihrer installierten Version. Die folgenden Hinweise zur Eingabeschicht basieren auf der Konfigurationsdokumentation von libinput und der Ubuntu-Manpage für xinput_calibrator .

Welche Lösung passt zum Symptom?

Diese Unterscheidung spart Zeit: Die Kalibrierung passt die Zuordnung der Koordinaten vom Berührungssensor zum Display an. Sie kann jedoch weder einen nicht unterstützten Controller zum Laufen bringen noch einen beschädigten Digitizer reparieren.

Was sollten Sie vor einer Kalibrierungsänderung überprüfen?

1. Notieren Sie sich das Tablet-Modell und die Betriebssystemversion. Überprüfen Sie in einem Terminal /etc/os-releasedas genaue Gerätemodell und notieren Sie es. Stellen Sie sicher, dass die installierte HamoniKR-Version und das Tablet-Modell kompatibel sind.
2. Reinigen Sie den Bildschirm und entfernen Sie alles, was den Kontakt beeinträchtigen könnte. Wischen Sie Feuchtigkeit und Schmutz ab und entfernen Sie zum Testen gegebenenfalls eine dicke oder beschädigte Displayschutzfolie. Testen Sie die Funktion zunächst mit dem Finger und anschließend separat mit dem Stift.
3. Stellen Sie die Anzeige auf die native Auflösung und normale Ausrichtung ein. Verwenden Sie die Desktop-Anzeigeeinstellungen. Falls sich die Genauigkeit nach dem Drehen des Tablets, dem Ändern des Maßstabs oder dem Anschließen eines Monitors verändert hat, machen Sie diese Änderung vorübergehend rückgängig und testen Sie erneut.
4. Starten Sie das System neu und installieren Sie die relevanten Systemaktualisierungen. Diese können Kernel- und Treiberkorrekturen enthalten. Führen Sie diese Schritte durch, bevor Sie die persistente Konfiguration bearbeiten, insbesondere wenn das Problem nach einem Upgrade aufgetreten ist.
5. Prüfen Sie, ob Linux einen Touchscreen erkennt. Führen Sie dazu den Befehl aus libinput list-devices. Wenn Sie eine X.Org-Sitzung verwenden, xinput listkönnen Sie mit dem Befehl die X-Eingabegeräte anzeigen lassen. Diese Befehle identifizieren Geräte, kalibrieren sie aber nicht.

Um den Sitzungstyp zu ermitteln, führen Sie den Befehl aus echo "$XDG_SESSION_TYPE". Die Ausgabe „“ x11bedeutet X.Org; „“ waylandbedeutet, dass der Wayland-Compositor die physische Eingabe verwaltet. Dies ist wichtig, da ein X.Org-Dienstprogramm einen physischen Touchscreen nicht zuverlässig über Xwayland konfigurieren kann.

Sollten Sie ein X.Org-Kalibrierungsprogramm verwenden?

Wählen Sie diese Option xinput_calibratornur, wenn Sie sich in einer aktiven X.Org-Sitzung befinden und das Programm Ihren physischen Touchscreen als kalibrierbares Gerät erkennt. Das Ubuntu-Handbuch beschreibt es als X.Org-Dienstprogramm und erklärt, dass die Speicherung neuer Werte vom Treiber abhängt. In manchen Fällen kann es Werte für die aktuelle Sitzung anwenden oder einen Konfigurationsausschnitt ausgeben; bei anderen Treibern ist die automatische Kalibrierung nicht verfügbar.

Falls das Tool bereits installiert ist, beginnen Sie mit der Auflistung der unterstützten Geräte:

xinput_calibrator --list

Wenn Ihr Touchscreen in dieser Liste erscheint, folgen Sie den Anweisungen auf dem Bildschirm und überprüfen Sie die Ausgabe. Testen Sie das Ergebnis im Vollbildmodus, bevor Sie Werte speichern. Kopieren Sie keine Ausgabedatei in ein Systemverzeichnis, nur weil das Dienstprogramm eine ausgegeben hat: Vergewissern Sie sich zuerst, dass die Ausgabedatei Ihr Gerät benennt und mit dem verwendeten Treiber übereinstimmt.

Diese Vorgehensweise ist geeignet, wenn das Tablet einen kompatiblen X.Org-Treiber verwendet und der Fehler eine stabile Abweichung ist. Sie ist ungeeignet, wenn das System Wayland nutzt, das Gerät nicht in der Liste des Kalibrators aufgeführt ist oder der Fehler nichtlinear oder intermittierend auftritt. Im Handbuch wird darauf hingewiesen, dass eine Vierpunktkalibrierung nichtlineare Bildschirmverzerrungen nicht korrigieren kann. Meldet das Programm wiederholt Fehlklicks, sollte es die Geräteunterstützung überprüfen, anstatt Werte zu erzwingen.

Was, wenn das Problem an der Bildschirmausrichtung oder dem falschen Display liegt?

Korrigieren Sie die Anzeigeeinstellungen, bevor Sie eine Kalibrierung durchführen. Stellen Sie in den Anzeigeeinstellungen von HamoniKR die gewünschte Ausrichtung, Auflösung und Skalierung des Tablets wieder her. Falls ein externer Monitor angeschlossen ist, trennen Sie diesen und testen Sie nur den integrierten Bildschirm. Funktioniert die Touch-Funktion dann wieder präzise, ​​liegt das Problem wahrscheinlich an der Ausgabebelegung oder der Bildschirmdrehung.

Bei Desktop-PCs oder Convertibles mit mehreren Bildschirmen kann der Touchscreen einem anderen Ausgang zugewiesen sein. Die Linux-Anzeigeverwaltung oder die Desktop-Einstellungen sind in der Regel der sicherste Ort, um diese Zuordnung zu korrigieren. Verwenden Sie in einer Wayland-Sitzung die Steuerelemente der Desktop-Umgebung; Änderungen an den XInput-Eigenschaften über ein Terminal wirken sich möglicherweise nur auf Xwayland-Anwendungen aus, nicht aber auf das physische Gerät.

Display-Mapping und Sensorkalibrierung sind zwar verwandt, aber nicht identisch. Beim Mapping wird festgelegt, welcher Ausgang die Berührungskoordinaten empfängt und wie diese gedreht oder skaliert werden. Die Kalibrierung korrigiert die Beziehung zwischen der vom Digitizer gemessenen Berührungsposition und dem sichtbaren Punkt auf diesem Ausgang. Korrigieren Sie zunächst einen falschen Ausgang oder eine falsche Ausrichtung und überprüfen Sie anschließend den physischen Versatz.

Wann ist eine libinput-Kalibrierungsmatrix angebracht?

Verwenden Sie eine Libinput-Matrix nur, wenn Ihr Gerät die Kalibrierung unterstützt und Sie über verlässliche Werte für das jeweilige Panel verfügen. Libinput erklärt, dass die Kalibrierung nur für einige Direct-Input-Geräte verfügbar ist, als Transformationsmatrix dargestellt wird und üblicherweise über eine Desktop-Umgebung oder einen anderen Aufrufer bereitgestellt wird. Die libinput list-devicesAusgabe kann Aufschluss darüber geben, welche Konfigurationen auf einem lokalen Gerät verfügbar sind.

Eine dauerhafte Linux-Konfiguration erfordert oft eine gerätespezifische udev-Eigenschaft LIBINPUT_CALIBRATION_MATRIX, deren korrekte Werte jedoch vom Gerät, der Ausrichtung und dem Treiber abhängen. Es gibt keine universelle Matrix für „Harmonica OS-Tablets“. Kopieren Sie keine Matrix von einem anderen Tablet und raten Sie die Koeffizienten nicht: Eine falsche Regel kann die Bedienung des Bildschirms erschweren und unter Umständen den Einsatz einer Tastatur, einer Remote-Shell oder einer Wiederherstellungsumgebung erfordern, um die Änderungen rückgängig zu machen.

Diese fortgeschrittene Vorgehensweise eignet sich für Administratoren, die das genaue Eingabegerät identifiziert, die erforderliche Transformation gemessen und das System wiederherstellen können, falls die Touch-Funktion ausfällt. Für ein einzelnes Heim-Tablet ohne Messwerkzeug oder Wiederherstellungsplan ist ein X.Org-kompatibles Tool (sofern verfügbar) oder eine Treiber-/Herstellerkorrektur die sicherere Option.

Wie überprüft man das Ergebnis?

• Klopfen Sie mehrmals auf die Mitte und alle vier Ecken und testen Sie anschließend die Punkte dazwischen. Korrekte Ecken bei ungenauen Rändern können auf ein Problem hinweisen, das sich durch eine einfache Kalibrierung nicht beheben lässt.
• Wiederholen Sie den Test, nachdem Sie das Tablet gedreht und wieder in die normale Ausrichtung gebracht haben.
• Testen Sie die Eingabe per Finger und Stift separat. Möglicherweise werden sie als unterschiedliche Geräte mit separater Kalibrierungsunterstützung angezeigt.
• Starten Sie das System nach jeder dauerhaften Änderung neu und testen Sie erneut. Ein Wert, der nur bis zur Abmeldung oder zum Neustart gültig ist, ist nicht dauerhaft.
• Bevor Sie eine erweiterte Änderung vornehmen, versuchen Sie es mit einer nachweislich funktionierenden externen Tastatur oder Maus, damit Sie eine alternative Eingabemethode zur Verfügung haben.

Eine erfolgreiche Korrektur sollte dafür sorgen, dass Berührungen auf dem gesamten Bildschirm nahe am Berührungspunkt landen, nach einem Neustart korrekt bleiben und keine neuen Abweichungen in einer anderen Bildschirmausrichtung entstehen. Falls weiterhin zufällige Fehlberührungen, Geisterberührungen, tote Streifen oder ein fehlendes Gerät auftreten libinput list-devices, untersuchen Sie den Kernel-Treiber, die Firmware, den Anschluss oder den Digitizer, anstatt die Kalibrierungseinstellungen zu erhöhen.

Auswahl zwischen den verfügbaren Ansätzen

Bei einer durch eine Änderung der Anzeige verursachten Abweichung sollten Sie zunächst Auflösung und Ausrichtung zurücksetzen; dies lässt sich schnell und einfach rückgängig machen. Bei einem Touchscreen, der von einem kompatiblen X.Org-Treiber erkannt wird, verwenden xinput_calibratorund bewerten Sie die treiberspezifische Ausgabe; diese ist direkter, deckt aber nicht alle modernen Eingabemethoden ab. Für ein unterstütztes libinput-Gerät mit Messwerten bietet eine gerätespezifische Matrix dauerhafte Ergebnisse, verursacht jedoch den höchsten Konfigurations- und Wiederherstellungsaufwand. Bei zeitweiligen Eingabeproblemen, nicht unterstützter Hardware oder physischen Schäden ist die Fehlerbehebung am Treiber oder die Reparatur des Geräts sinnvoller als eine Kalibrierung.

Die HamoniKR-Version und das Tablet-Modell bestimmen, welcher Pfad tatsächlich verfügbar ist. Überprüfen Sie diese Details, bevor Sie Kalibrierungssoftware installieren oder systemweite Eingaberegeln ändern.