Résolution des problèmes d'étalonnage de l'écran tactile sur les tablettes Harmonica OS : choisissez la solution Linux appropriée

Tout d'abord, veuillez confirmer de quelle version d'« Harmonica OS » vous parlez.

Si vous faites référence à HamoniKR, la distribution Linux sud-coréenne, le comportement de l'écran tactile dépend à la fois du matériel de la tablette, du pilote du noyau Linux, de la pile d'entrée et de la session de bureau. Je n'ai pas pu vérifier l'existence d'un assistant de calibration universel pour les tablettes HamoniKR ni d'une solution unique applicable à tous les modèles. Le projet HamoniKR publie des manuels versionnés, mais les étapes de calibration ci-dessous utilisent des outils d'entrée Linux documentés et dépendent du pilote exposé par votre tablette. Si vous faites référence à Huawei HarmonyOS ou à un autre produit appelé Harmonica OS, ces commandes Linux ne s'appliquent pas.

Il est préférable de diagnostiquer le problème avant d'installer un calibrateur ou de modifier les fichiers système. Un point de contact constamment décalé peut nécessiter un étalonnage. Un pointeur pivoté, mal configuré sur un écran ou imprécis uniquement après un changement de résolution nécessite généralement une correction de la configuration de l'affichage. Les contacts aléatoires, manqués ou fantômes peuvent provenir des pilotes ou du matériel et ne seront pas résolus par la modification des valeurs d'étalonnage.

Le guide utilisateur de HamoniKR, version par version , est la meilleure source d'information pour les détails spécifiques à votre version installée. Les instructions relatives à la couche d'entrée ci-dessous sont basées sur la documentation de configuration de libinput et la page de manuel Ubuntu pour xinput_calibrator .

Quelle solution correspond au symptôme ?

Cette distinction permet de gagner du temps : l’étalonnage ajuste la correspondance entre les coordonnées du capteur tactile et celles de l’écran. Il ne peut pas faire fonctionner une manette non prise en charge ni réparer un numériseur endommagé.

Que devez-vous vérifier avant de modifier l'étalonnage ?

1. Notez le modèle de la tablette et la version du système d'exploitation. Dans un terminal, vérifiez /etc/os-releaseet notez le modèle exact de l'appareil. Assurez-vous que la version de HamoniKR installée et le modèle de la tablette sont compatibles.
2. Nettoyez l'écran et retirez tout élément susceptible de modifier le contact. Essuyez l'humidité et les poussières. Pour les tests, retirez si possible une protection d'écran épaisse ou endommagée. Testez avec le doigt, puis séparément avec le stylet.
3. Configurez l'écran sur sa résolution native et son orientation normale. Utilisez les paramètres d'affichage du bureau. Si la précision a changé après avoir fait pivoter la tablette, modifié l'échelle ou connecté un moniteur, annulez temporairement cette modification et effectuez un nouveau test.
4. Redémarrez le système et appliquez les mises à jour nécessaires. Celles-ci peuvent inclure des correctifs pour le noyau et les pilotes d'entrée. Procédez ainsi avant de modifier la configuration persistante, surtout si le problème est apparu après une mise à niveau.
5. Vérifiez si Linux détecte un écran tactile. Exécutez la commande suivante libinput list-devices. Si vous utilisez une session X.Org, xinput listvous pouvez afficher les périphériques d'entrée X. Ces commandes identifient les périphériques ; elles ne les calibrent pas.

Pour identifier le type de session, exécutez la commande suivante : [commande à insérer echo "$XDG_SESSION_TYPE"]. Un résultat de [résultat x11à insérer] signifie X.Org ; [résultat waylandà insérer] signifie que le compositeur Wayland gère l’entrée physique. Ceci est important car un utilitaire X.Org ne peut pas configurer de manière fiable un écran tactile physique via Xwayland.

Faut-il utiliser un utilitaire d'étalonnage X.Org ?

N'utilisez cette option xinput_calibratorque si vous êtes dans une session X.Org active et que le programme reconnaît votre écran tactile comme un périphérique calibrable. La documentation Ubuntu le décrit comme un utilitaire X.Org et précise que la persistance des nouvelles valeurs dépend du pilote. Dans certains cas, il peut appliquer des valeurs pour la session en cours ou afficher un extrait de configuration ; pour d'autres pilotes, le calibrage automatique est indisponible.

Si l'outil est déjà installé, commencez par lister les appareils pris en charge :

xinput_calibrator --list

Si votre écran tactile figure dans la liste, suivez les instructions à l'écran et vérifiez le résultat. Testez-le sur tout l'écran avant d'enregistrer les valeurs. Ne copiez pas directement le résultat dans un répertoire système simplement parce que l'utilitaire en a affiché un : assurez-vous d'abord que le nom de votre périphérique et le pilote utilisé sont corrects.

Cette méthode est pratique lorsque la tablette utilise un pilote X.Org compatible et que l'erreur correspond à un décalage stable. Elle est déconseillée si le système utilise Wayland, si le périphérique est absent de la liste du calibrateur ou si l'erreur est non linéaire ou intermittente. Le manuel précise qu'un étalonnage en quatre points ne peut corriger une déformation non linéaire de l'écran. Si le programme signale des clics erronés à répétition, arrêtez-le et vérifiez la compatibilité du périphérique plutôt que de forcer les valeurs.

Et si le problème venait de la rotation ou d'un affichage incorrect ?

Avant de procéder à un étalonnage, corrigez la configuration d'affichage. Rétablissez l'orientation, la résolution et la mise à l'échelle par défaut de la tablette dans les paramètres d'affichage de HamoniKR. Si un moniteur externe est connecté, déconnectez-le et testez uniquement l'écran intégré. Si la sensibilité tactile redevient précise, le problème provient probablement du mappage de sortie ou de la rotation.

Sur un ordinateur de bureau ou convertible doté de plusieurs écrans, l'écran tactile peut être associé à une sortie différente. Le gestionnaire d'affichage Linux ou les paramètres du bureau constituent généralement le moyen le plus sûr de corriger cette association. Sous Wayland, utilisez les commandes de l'environnement de bureau ; la modification des propriétés XInput depuis un terminal peut n'affecter que les applications Xwayland, et non le périphérique physique.

Le mappage d'affichage et l'étalonnage des capteurs sont liés mais différents. Le mappage détermine la sortie qui reçoit les coordonnées tactiles et comment ces coordonnées sont pivotées ou mises à l'échelle. L'étalonnage corrige la relation entre la position tactile mesurée par le numériseur et le point visible sur cette sortie. Corrigez d'abord une sortie ou une orientation incorrecte, puis vérifiez le décalage physique.

Quand une matrice d'étalonnage libinput est-elle appropriée ?

N'utilisez une matrice libinput que si votre périphérique prend en charge l'étalonnage et que vous disposez de valeurs fiables pour ce panneau spécifique. Libinput explique que l'étalonnage est disponible uniquement pour certains périphériques à entrée directe, qu'il est représenté par une matrice de transformation et qu'il est généralement accessible via un environnement de bureau ou un autre programme. Son libinput list-devicesrésultat peut indiquer la configuration disponible sur un périphérique local.

Une configuration Linux persistante implique souvent une propriété udev spécifique à chaque périphérique LIBINPUT_CALIBRATION_MATRIX, mais les valeurs correctes dépendent du périphérique, de son orientation et du pilote. Il n'existe pas de matrice universelle sûre pour les tablettes Harmonica OS. Ne copiez pas une matrice depuis une autre tablette et n'essayez pas de deviner les coefficients : une règle incorrecte peut rendre l'écran plus difficile à utiliser et nécessiter l'utilisation d'un clavier, d'un shell distant ou d'un environnement de récupération pour être corrigée.

Cette méthode avancée convient à un administrateur ayant identifié le périphérique d'entrée précis, mesuré la transformation nécessaire et capable de restaurer le système en cas de dysfonctionnement tactile. Pour une tablette personnelle sans outil de mesure ni plan de restauration, l'utilisation d'un outil compatible X.Org (le cas échéant) ou la mise à jour du pilote/du fournisseur est une option plus sûre.

Comment vérifie-t-on le résultat ?

• Tapotez plusieurs fois le centre et les quatre coins, puis testez les points situés entre eux. Des coins précis mais des bords imprécis peuvent indiquer un problème qu'un étalonnage de base ne peut corriger.
• Répétez le test après avoir fait pivoter la tablette et l'avoir remise dans son orientation normale.
• Testez séparément la saisie au doigt et au stylet. Elles peuvent apparaître comme des périphériques différents nécessitant des étalonnages distincts.
• Redémarrez l'ordinateur après toute modification permanente et testez à nouveau. Une valeur qui n'est valable que jusqu'à la déconnexion ou le redémarrage n'est pas considérée comme persistante.
• Avant d'effectuer une modification avancée, essayez un clavier ou une souris externe dont le fonctionnement est avéré, afin de disposer d'une méthode de saisie de secours.

Une correction réussie devrait permettre aux appuis de se positionner précisément au point touché sur tout l'écran, de conserver cette précision après un redémarrage et d'éviter la création d'un nouveau décalage dans une autre orientation. Si vous constatez toujours des appuis manqués aléatoires, des appuis fantômes, des zones mortes ou si le périphérique est absent libinput list-devices, examinez le pilote du noyau, le micrologiciel, le connecteur ou le numériseur plutôt que d'ajuster les paramètres de calibration.

Choisir parmi les approches disponibles

En cas de décalage survenu après un changement d'affichage, commencez par réinitialiser la résolution et l'orientation ; cette opération est rapide et facile à annuler. Pour un écran tactile reconnu par un pilote X.Org compatible, utilisez xinput_calibratoret analysez la sortie spécifique au pilote ; cette méthode est plus directe, mais ne couvre pas toutes les piles d'entrée modernes. Pour un périphérique libinput pris en charge avec des valeurs mesurées, une matrice par périphérique assure la persistance des données, mais elle engendre les coûts de configuration et de récupération les plus élevés. En cas d'entrée intermittente, de matériel non pris en charge ou de dommages physiques, il est préférable de dépanner le pilote ou de réparer le périphérique plutôt que de procéder à un étalonnage.

La version de la tablette HamoniKR et son modèle déterminent le chemin d'accès disponible. Vérifiez ces informations avant d'installer le logiciel d'étalonnage ou de modifier les règles d'entrée système.