Rozwiązywanie problemów z kalibracją ekranu dotykowego w tabletach Harmonica OS: Wybierz odpowiednie rozwiązanie dla systemu Linux

Najpierw sprawdź, o jakim systemie operacyjnym „Harmonica OS” mówisz

Jeśli masz na myśli HamoniKR, południowokoreańską dystrybucję Linuksa, zachowanie ekranu dotykowego wynika z połączenia sprzętu tabletu, sterownika jądra Linuksa, stosu wejściowego i sesji pulpitu. Nie udało mi się zweryfikować uniwersalnego kreatora kalibracji tabletu HamoniKR ani pojedynczej poprawki, która pasowałaby do każdego modelu. Projekt HamoniKR publikuje wersjonowane instrukcje, ale poniższe kroki kalibracji korzystają z udokumentowanych narzędzi wejściowych Linuksa i zależą od sterownika udostępnianego przez tablet. Jeśli masz na myśli Huawei HarmonyOS lub inny produkt o nazwie Harmonica OS, te polecenia Linuksa nie mają zastosowania.

Praktycznym rozwiązaniem jest zdiagnozowanie problemu przed zainstalowaniem kalibratora lub zmianą plików systemowych. Punkt dotyku, który stale się przesuwa, może wymagać kalibracji. Wskaźnik, który jest obrócony, zmapowany na niewłaściwy wyświetlacz lub działa nieprecyzyjnie dopiero po zmianie rozdzielczości, zazwyczaj wymaga korekty mapowania wyświetlacza. Przypadkowe, pominięte lub niewidoczne dotknięcia mogą być spowodowane przez obsługę sterowników lub sprzęt i nie zostaną naprawione przez zmianę wartości kalibracji.

Wersjonowany podręcznik użytkownika HamoniKR to najlepsze miejsce do sprawdzenia szczegółów dotyczących zainstalowanej wersji. Poniższe wskazówki dotyczące warstwy wejściowej oparte są na dokumentacji konfiguracji libinput oraz stronie podręcznika Ubuntu dla xinput_calibrator .

Które rozwiązanie jest odpowiednie dla tego objawu?

To rozróżnienie oszczędza czas: kalibracja dostosowuje sposób mapowania współrzędnych z czujnika dotykowego na wyświetlacz. Nie pozwala na działanie nieobsługiwanego kontrolera ani naprawę uszkodzonego digitizera.

Co należy sprawdzić przed zmianą kalibracji?

1. Zapisz model tabletu i wersję systemu operacyjnego. W terminalu sprawdź /etc/os-releasei zanotuj dokładny model urządzenia. Sprawdź, czy zainstalowana wersja HamoniKR i model tabletu są obsługiwane razem.
2. Wyczyść ekran i usuń wszystko, co może mieć kontakt z ekranem. Wytrzyj wilgoć i zanieczyszczenia, a w razie potrzeby zdejmij grubą lub uszkodzoną folię ochronną ekranu. Przetestuj palcem i, osobno, rysikiem.
3. Ustaw wyświetlacz na jego natywną rozdzielczość i normalną orientację. Użyj ustawień wyświetlania pulpitu. Jeśli dokładność uległa zmianie po obróceniu tabletu, zmianie skali lub podłączeniu monitora, tymczasowo cofnij tę zmianę i przetestuj ponownie.
4. Uruchom ponownie i zainstaluj odpowiednie aktualizacje systemu. Aktualizacje mogą obejmować poprawki jądra i sterowników wejściowych. Zrób to przed edycją trwałej konfiguracji, zwłaszcza jeśli problem pojawił się po aktualizacji.
5. Sprawdź, czy Linux widzi ekran dotykowy. Uruchom libinput list-devices. Jeśli używasz sesji X.Org, xinput listmożesz wyświetlić urządzenia wejściowe X. Te polecenia identyfikują urządzenia, ale ich nie kalibrują.

Aby zidentyfikować typ sesji, uruchom polecenie echo "$XDG_SESSION_TYPE". Wyjście x11oznacza X.Org; waylandkompozytor Wayland zarządza fizycznym wejściem. Ma to znaczenie, ponieważ narzędzie X.Org nie może niezawodnie skonfigurować fizycznego ekranu dotykowego za pośrednictwem Xwayland.

Czy warto używać narzędzia kalibracji X.Org?

Wybierz tę opcję xinput_calibratortylko wtedy, gdy jesteś w rzeczywistej sesji X.Org, a program wyświetla Twój fizyczny ekran dotykowy jako urządzenie, które można kalibrować. W podręczniku Ubuntu opisano to jako narzędzie X.Org i wyjaśniono, że to, czy nowe wartości zostaną zachowane, zależy od sterownika. W niektórych przypadkach może zastosować wartości dla bieżącej sesji lub wydrukować fragment kodu konfiguracji; w przypadku innych sterowników automatyczna kalibracja jest niedostępna.

Jeśli narzędzie jest już zainstalowane, zacznij od wypisania obsługiwanych urządzeń:

xinput_calibrator --list

Jeśli Twój ekran dotykowy pojawia się na tej liście, postępuj zgodnie z poleceniami wyświetlanymi na ekranie i sprawdź wynik. Przetestuj wynik na pełnym ekranie przed zapisaniem jakichkolwiek wartości. Nie wklejaj fragmentu kodu do katalogu systemowego tylko dlatego, że narzędzie go wydrukowało: najpierw upewnij się, że fragment kodu nadał nazwę Twojemu urządzeniu i jest zgodny z używanym sterownikiem.

Ta metoda jest wygodna, gdy tablet korzysta ze zgodnego sterownika X.Org, a błąd jest stabilnym przesunięciem. Jest to jednak zły wybór, gdy system korzysta z Wayland, gdy urządzenie nie znajduje się na liście kalibratorów lub gdy błąd jest nieliniowy lub sporadyczny. W instrukcji zaznaczono, że czteropunktowa kalibracja nie jest w stanie skorygować nieliniowej deformacji ekranu. Jeśli program wielokrotnie zgłasza błędy kliknięcia, należy zatrzymać program i sprawdzić obsługę urządzenia, zamiast wymuszać wartości.

A co jeśli problemem jest obrót lub niewłaściwy wyświetlacz?

Przed próbą kalibracji popraw ustawienia wyświetlacza. Przywróć tabletowi prawidłową orientację, rozdzielczość i skalowanie w ustawieniach wyświetlacza HamoniKR. Jeśli podłączony jest monitor zewnętrzny, odłącz go i przetestuj sam wbudowany ekran. Jeśli dotyk znów będzie działał poprawnie, problem prawdopodobnie leży w mapowaniu lub obrocie wyjścia.

W przypadku komputera stacjonarnego lub konwertowalnego z więcej niż jednym wyświetlaczem, ekran dotykowy może być przypisany do innego wyjścia. Menedżer wyświetlania systemu Linux lub ustawienia pulpitu to zazwyczaj najmniej ryzykowne miejsce do skorygowania tego powiązania. W sesji Wayland należy korzystać z elementów sterujących środowiska graficznego; zmiana właściwości XInput z poziomu terminala może mieć wpływ tylko na aplikacje Xwayland, a nie na urządzenie fizyczne.

Mapowanie wyświetlacza i kalibracja czujnika są ze sobą powiązane, ale różnią się. Mapowanie decyduje, które wyjście odbiera współrzędne dotyku oraz w jaki sposób współrzędne są obracane lub skalowane. Kalibracja koryguje zależność między zmierzoną pozycją dotyku przez digitizer a widocznym punktem na tym wyjściu. Najpierw należy poprawić nieprawidłowe wyjście lub orientację, a następnie ponownie sprawdzić przesunięcie fizyczne.

Kiedy macierz kalibracyjna libinput jest odpowiednia?

Używaj macierzy libinput tylko wtedy, gdy Twoje urządzenie obsługuje kalibrację i dysponujesz wiarygodnymi wartościami dla danego panelu. Libinput wyjaśnia, że ​​kalibracja jest dostępna tylko dla niektórych urządzeń z bezpośrednim wejściem, jest reprezentowana jako macierz transformacji i zazwyczaj jest udostępniana za pośrednictwem środowiska graficznego lub innego programu wywołującego. Jej libinput list-devicesdane wyjściowe mogą pomóc w ustaleniu, jaka konfiguracja jest dostępna na urządzeniu lokalnym.

Trwała konfiguracja systemu Linux często obejmuje właściwość udev dla każdego urządzenia, taką jak LIBINPUT_CALIBRATION_MATRIX, ale prawidłowe wartości zależą od urządzenia, orientacji i sterownika. Nie ma bezpiecznej, uniwersalnej macierzy dla „tabletów z systemem Harmonica OS”. Nie kopiuj macierzy z innego tabletu ani nie zgaduj współczynników: niepoprawna reguła może utrudnić korzystanie z ekranu i może wymagać użycia klawiatury, zdalnej powłoki lub środowiska odzyskiwania, aby ją cofnąć.

Ta zaawansowana ścieżka jest odpowiednia dla administratora, który zidentyfikował dokładne urządzenie wejściowe, zmierzył wymaganą transformację i może odzyskać system, jeśli dotyk przestanie działać. W przypadku tabletu domowego z jednym urządzeniem, bez narzędzia pomiarowego ani planu odzyskiwania, bezpieczniejszą opcją jest narzędzie zgodne z X.Org (jeśli dotyczy) lub poprawka sterownika/dostawcy.

Jak weryfikujesz wynik?

• Stuknij kilkakrotnie w środek i wszystkie cztery rogi, a następnie sprawdź punkty między nimi. Dokładne rogi z niedokładnymi krawędziami mogą wskazywać na problem, którego nie da się rozwiązać za pomocą podstawowej kalibracji.
• Powtórz test po obróceniu tabletki i przywróceniu jej normalnej pozycji.
• Przetestuj wprowadzanie danych palcem i rysikiem oddzielnie. Mogą one być wyświetlane jako oddzielne urządzenia z oddzielną obsługą kalibracji.
• Po każdej trwałej zmianie uruchom ponownie i przetestuj ponownie. Wartość, która działa tylko do wylogowania lub ponownego uruchomienia, nie jest trwała.
• Przed wprowadzeniem zaawansowanych zmian wypróbuj sprawdzoną, działającą zewnętrzną klawiaturę lub mysz, aby móc odzyskać dane wejściowe.

Skuteczne rozwiązanie powinno sprawić, że dotknięcia będą trafiać w punkt dotknięcia na całym ekranie, pozostaną poprawne po ponownym uruchomieniu i zapobiegną tworzeniu nowego przesunięcia w innej orientacji. Jeśli nadal występują przypadkowe błędy, przypadkowe dotknięcia, martwe paski lub urządzenie jest nieobecne libinput list-devices, sprawdź sterownik jądra, oprogramowanie układowe, złącze lub digitizer, zamiast zwiększać zakres regulacji kalibracji.

Wybór pomiędzy dostępnymi podejściami

W przypadku przesunięcia, które nastąpiło po zmianie wyświetlacza, należy najpierw zresetować rozdzielczość i orientację; można to szybko i łatwo odwrócić. W przypadku ekranu dotykowego rozpoznawanego przez zgodny sterownik X.Org należy użyć xinput_calibratori ocenić dane wyjściowe specyficzne dla sterownika; są one bardziej bezpośrednie, ale nie obejmują wszystkich współczesnych stosów wejściowych. W przypadku obsługiwanego urządzenia libinput z wartościami pomiarowymi, macierz per-device zapewnia trwałość, ale wiąże się z najwyższym kosztem konfiguracji i odzyskiwania. W przypadku przerywanego sygnału wejściowego, nieobsługiwanego sprzętu lub uszkodzenia fizycznego, rozwiązywanie problemów ze sterownikiem lub naprawa urządzenia są bardziej odpowiednie niż kalibracja.

Wersja HamoniKR i model tabletu określają, która ścieżka jest faktycznie dostępna. Sprawdź te dane przed zainstalowaniem oprogramowania kalibracyjnego lub zmianą reguł wprowadzania danych na poziomie systemu.