Correcte touchscreen-uitlijning op Harmonica OS-tablets

Als aanrakingen naast knoppen op een Harmonica OS-tablet terechtkomen, stel dan eerst het scherm in op de gewenste oriëntatie en controleer of het aanraakapparaat wordt gedetecteerd. Pas alleen een kalibratiematrix toe als de fout consistent is over het hele scherm en de invoerstack van uw sessie dit ondersteunt. Specifieke kalibratiemenu's voor Harmonica OS en ondersteunde tabletmodellen konden niet worden bevestigd in de openbare documentatie. Daarom maken de onderstaande stappen gebruik van upstream Linux-tools en wordt uitgelegd waar het gedrag afhangt van de geïnstalleerde desktopomgeving.

Kies de juiste oplossing voordat u kalibreert.

Aanraakproblemen die op elkaar lijken, hebben verschillende oorzaken. Een aanwijzer die gedraaid of gespiegeld is, duidt meestal op een probleem met de schermoriëntatie of de apparaatmapping. Een constante, kleine afwijking over het hele paneel vereist mogelijk kalibratie. Gemiste aanrakingen, dode zones, willekeurige sprongen of een scherm dat pas na het ontwaken uitvalt, hebben waarschijnlijk te maken met hardware, firmware, kernelondersteuning of energiebeheer; een kalibratiematrix zal deze fouten niet verhelpen.

Begin met de eenvoudigste controles: maak het scherm schoon en droog, verwijder tijdelijk een dikke of beschadigde screenprotector, herstart de tablet en selecteer de juiste schermrotatie in de weergave-instellingen van de desktop. Als het touchscreen na de rotatie de oude oriëntatie behoudt, log dan uit en weer in of herstart de tablet eenmaal. Kalibratie is een aparte coördinatentransformatie, geen vervanging voor het corrigeren van de schermrotatie.

Identificeer de sessie en het touchscreen

Open een terminal en controleer of de desktopsessie X11 of Wayland is:

echo "$XDG_SESSION_TYPE"

Vervolgens worden de gedetecteerde invoerapparaten weergegeven:

libinput list-devices

Zoek de touchscreen-vermelding en noteer de exacte naam en het gebeurtenisknooppunt, bijvoorbeeld /dev/input/eventN. Namen en gebeurtenisnummers variëren, dus kopieer niet de waarden van een andere tablet. Als de opdracht niet beschikbaar is, controleer dan de geconfigureerde pakketbeheerder van Harmonica OS of de apparaatinformatie op uw desktop; installeer geen kalibratieprogramma via een niet-geverifieerde download. Als er geen touchscreen verschijnt, is kalibratie te vroeg: controleer of het apparaat is ingeschakeld, sluit indien van toepassing de aangesloten hardware opnieuw aan en zoek naar driver- of firmwarefouten in overleg met uw systeembeheerder of de tabletfabrikant.

Gebruik de methode die overeenkomt met je grafische stack.

Voor een Wayland-sessie

Wayland-compositors en inputstacks bepalen hoe touchcoördinaten worden toegewezen aan displays. De upstream libinput-documentatie beschrijft kalibratie als een transformatiematrix voor absolute apparaten, en Canonical's Mir-documentatie geeft een concrete workflow met libinput.calibrate-touchscreeneen udev-regel. Die Mir-workflow is echter geen bewijs dat dezelfde kalibratiehulpprogramma of compositor is geïnstalleerd op Harmonica OS. Controleer welke compositor en tools uw build daadwerkelijk biedt voordat u deze toepast. Als het kalibratiehulpprogramma ontbreekt, ga er dan niet van uit dat xinput_calibratorhet een directe vervanging is onder Wayland.

Als er een ondersteunde kalibratietool beschikbaar is, volg dan de aanwijzingen op het scherm, noteer de berekende matrix en pas deze alleen toe op het geïdentificeerde touchscreen. Houd een toetsenbord of een externe shell bij de hand voor het geval de touchmapping moeilijk te gebruiken is. Voor permanente libinput-kalibratie moet de regel overeenkomen met de daadwerkelijke apparaatidentiteit en de gemeten matrix gebruiken; generieke voorbeeldcoëfficiënten kunnen niet veilig worden gekopieerd. Herlaad het apparaat of sluit het opnieuw aan zoals aangegeven in de platformdocumentatie en controleer vervolgens of de kalibratie actief is.

Voor een X11-sessie

xinput_calibratorDit is een X.Org-hulpprogramma voor touchscreenkalibratie. Het is alleen van toepassing als het apparaat en de driver worden ondersteund door de X-server. Als het beschikbaar is in de vertrouwde repositories van Harmonica OS, voer het dan uit als de ingelogde desktopgebruiker, raak de weergegeven doelen voorzichtig aan en sla de uitvoer op die het programma voor dat apparaat genereert. Start geen grafisch X11-kalibratieprogramma met dit hulpprogramma, sudotenzij de documentatie dit expliciet vereist; root heeft mogelijk geen toegang tot de actieve schermsessie. Als het hulpprogramma meldt dat het apparaat niet wordt ondersteund of dat er geen doelen verschijnen, stop het dan en controleer de driver/sessie voordat u een andere methode probeert.

Sla wijzigingen zorgvuldig op en controleer ze.

Een eenmalige aanpassing is handig voor diagnose, maar kan verdwijnen bij het uitloggen. Permanente configuratie is afhankelijk van het stuurprogramma: libinput leest doorgaans een apparaatspecifieke udev-eigenschap met de naam LIBINPUT_CALIBRATION_MATRIX, terwijl oudere X.Org-configuraties mogelijk een apparaatspecifiek configuratiefragment gebruiken. Maak niet blindelings beide configuraties aan. Controleer eerst welk stuurprogramma actief is en gebruik het gedocumenteerde formaat. Maak een back-up van het bestand dat u wijzigt en bewaar de oorspronkelijke waarden, zodat u kunt terugkeren naar de oorspronkelijke instellingen als de problemen verergeren.

Nadat u een wijziging hebt aangebracht, laadt u het touchscreen opnieuw of maakt u opnieuw verbinding zoals aangegeven in de betreffende documentatie, of start u de computer opnieuw op als de desktop de invoerinstellingen niet opnieuw leest. Test vervolgens een langzame tik in de buurt van elke hoek, in het midden en op veelgebruikte bedieningselementen zoals het virtuele toetsenbord. Het aangeraakte bedieningselement moet direct onder uw vinger activeren, zowel in portret- als landschapsmodus. Test dit ook na een nieuwe aanmelding; dit onderscheidt een permanente oplossing van een tijdelijke wijziging tijdens de sessie.

Wanneer moet je van aanpak veranderen?

Als de fout verandert bij rotatie, controleer dan de schermmapping opnieuw in plaats van een nieuwe matrix af te stellen. Als aanraakgevoeligheden alleen aan de randen onnauwkeurig zijn, verzamel dan het touchscreenmodel, de kernelversie, het sessietype, de apparaatnaam en relevante systeemlogboeken; het paneel of de driver heeft mogelijk een apparaatspecifieke correctie nodig. Als aanraakgevoeligheden verspringen, niet meer worden geregistreerd of onjuist blijven na het herstellen van de oorspronkelijke configuratie, draai dan de wijziging terug en zoek naar een update voor Harmonica OS of de driver van de hardwarefabrikant. Openbare bronnen die voor dit artikel zijn geraadpleegd, documenteren algemeen Linux-kalibratiegedrag, geen geverifieerde, tabletspecifieke procedure voor Harmonica OS.

Bronnen

• libinput-documentatie: Absolute assen en kalibratie
• Canonical Mir 2.17: Een touchscreenapparaat kalibreren
• Freedesktop.org: xinput_calibrator voor X.Org