Harmonica OS 태블릿의 터치스크린 보정 문제 해결: 적합한 Linux 해결 방법을 선택하세요

먼저, 어떤 “Harmonica OS”를 말씀하시는 건지 확인해 주세요.

만약 한국산 리눅스 배포판인 HamoniKR을 말씀하시는 거라면, 터치스크린 동작은 태블릿 하드웨어, 리눅스 커널 드라이버, 입력 스택, 그리고 데스크톱 세션이 모두 합쳐져서 결정됩니다. 모든 모델에 적용 가능한 범용 HamoniKR 태블릿 보정 마법사나 단일 해결 방법은 찾을 수 없었습니다. HamoniKR 프로젝트에서는 버전별 설명서를 제공하고 있지만, 아래 보정 단계는 문서화된 리눅스 입력 도구를 사용하며 태블릿에서 사용하는 드라이버에 따라 달라집니다. 만약 Huawei HarmonyOS나 Harmonica OS라는 다른 제품을 말씀하시는 거라면, 이 리눅스 명령어는 적용되지 않습니다.

실용적인 방법은 보정 프로그램을 설치하거나 시스템 파일을 변경하기 전에 먼저 증상을 진단하는 것입니다. 터치 포인트가 지속적으로 어긋나 있다면 보정이 필요할 수 있습니다. 포인터가 회전했거나, 잘못된 디스플레이에 매핑되었거나, 해상도 변경 후에만 정확도가 떨어지는 경우에는 일반적으로 디스플레이 매핑을 수정해야 합니다. 무작위로 발생하거나, 터치가 누락되거나, 고스트 터치가 발생하는 것은 드라이버 지원이나 하드웨어 문제일 수 있으며, 보정 값을 변경해도 해결되지 않습니다.

HamoniKR의 버전별 사용자 가이드는 설치된 릴리스에 대한 자세한 내용을 확인하기에 가장 좋은 곳입니다. 아래의 입력 레이어 지침은 libinput 구성 문서 와 Ubuntu의 xinput_calibrator 매뉴얼 페이지를 기반으로 합니다 .

어떤 해결책이 증상에 가장 적합합니까?

이러한 구분은 시간을 절약해 줍니다. 보정은 터치 센서의 좌표가 디스플레이에 어떻게 매핑되는지를 조정합니다. 하지만 지원되지 않는 컨트롤러를 작동시키거나 손상된 디지타이저를 복구할 수는 없습니다.

보정값을 변경하기 전에 무엇을 확인해야 할까요?

1. 태블릿 모델과 OS 버전을 기록하세요. 터미널에서 /etc/os-release정확한 기기 모델을 확인하고 기록해 두세요. 설치된 HamoniKR 버전과 태블릿 모델이 호환되는지 확인하세요.
2. 화면을 깨끗하게 닦고 접촉에 영향을 줄 수 있는 모든 것을 제거하십시오. 습기나 먼지를 닦아내고, 테스트를 위해 두껍거나 손상된 화면 보호 필름이 있다면 가능하면 제거하십시오. 손가락으로 테스트하고, 각각 스타일러스 펜으로도 테스트하십시오.
3. 디스플레이를 기본 해상도와 일반적인 방향으로 설정하십시오. 데스크톱 디스플레이 설정을 사용하십시오. 태블릿을 회전하거나, 배율을 변경하거나, 모니터를 연결한 후 정확도가 변경된 경우, 해당 변경 사항을 일시적으로 되돌리고 다시 테스트하십시오.
4. 시스템을 재시작하고 관련 업데이트를 적용하십시오. 업데이트에는 커널 및 입력 드라이버 수정 사항이 포함될 수 있습니다. 특히 업그레이드 후 문제가 발생한 경우 영구 구성을 편집하기 전에 이 작업을 수행하십시오.
5. Linux에서 터치스크린을 인식하는지 확인하려면 다음 명령어를 실행하세요 libinput list-devices. X.Org 세션을 사용 중인 경우, 다음 xinput list명령어를 통해 X 입력 장치를 확인할 수 있습니다. 이 명령어들은 장치를 식별하는 것이지, 보정하는 것은 아닙니다.

세션 유형을 확인하려면 명령어를 실행하세요 echo "$XDG_SESSION_TYPE". 출력 결과가 x11이면 X.Org를 wayland의미하고, 이면 Wayland 컴포지터가 물리적 입력을 관리한다는 의미입니다. X.Org 유틸리티는 Xwayland를 통해 물리적 터치스크린을 안정적으로 구성할 수 없기 때문에 이 점이 중요합니다.

X.Org 보정 유틸리티를 사용해야 할까요?

xinput_calibratorX.Org 세션이 활성화되어 있고 프로그램에서 물리적 터치스크린을 보정 가능한 장치로 인식하는 경우에만 이 옵션을 선택하십시오 . 우분투 설명서에서는 이 기능을 X.Org 유틸리티로 설명하며, 새 값이 저장되는지 여부는 드라이버에 따라 다르다고 설명합니다. 어떤 드라이버의 경우 현재 세션에 값을 적용하거나 구성 스니펫을 출력할 수 있지만, 다른 드라이버의 경우 자동 보정이 불가능합니다.

해당 도구가 이미 설치되어 있다면, 먼저 지원되는 장치 목록을 확인하세요.

xinput_calibrator --list

터치스크린이 목록에 나타나면 화면에 표시된 단계를 따라 진행하고 출력을 검토하십시오. 값을 저장하기 전에 전체 화면에서 결과를 테스트하십시오. 유틸리티에서 출력된 내용을 시스템 디렉터리에 붙여넣지 마십시오. 먼저 출력 내용이 장치 이름과 사용 중인 드라이버와 일치하는지 확인하십시오.

이 방법은 태블릿이 호환되는 X.Org 드라이버를 사용하고 오차가 안정적인 오프셋인 경우에 편리합니다. 하지만 시스템이 Wayland를 사용하거나, 장치가 캘리브레이터 목록에 없거나, 오차가 비선형적이거나 간헐적인 경우에는 적합하지 않습니다. 설명서에는 4점 캘리브레이션으로는 비선형 화면 변형을 보정할 수 없다고 명시되어 있습니다. 프로그램에서 반복적으로 잘못된 클릭이 보고되는 경우, 값을 강제로 설정하기보다는 프로그램을 중지하고 장치 지원 여부를 확인하십시오.

화면 회전이나 잘못된 표시가 문제라면 어떻게 해야 할까요?

보정 작업을 시도하기 전에 디스플레이 설정을 올바르게 조정하십시오. HamoniKR의 디스플레이 설정에서 태블릿의 원래 방향, 해상도 및 배율을 복원하십시오. 외부 모니터가 연결되어 있는 경우 연결을 해제하고 내장 화면만 테스트하십시오. 터치가 다시 정확하게 작동하면 출력 매핑 또는 회전 문제일 가능성이 높습니다.

디스플레이가 두 개 이상인 데스크톱이나 컨버터블 노트북의 경우, 터치스크린이 다른 출력 장치에 할당될 수 있습니다. 일반적으로 Linux 디스플레이 관리자 또는 데스크톱 설정에서 이러한 연결을 수정하는 것이 가장 안전합니다. Wayland 세션에서는 데스크톱 환경의 컨트롤을 사용하십시오. 터미널에서 XInput 속성을 변경하면 Xwayland 애플리케이션에만 영향을 미치고 물리적 장치에는 영향을 주지 않을 수 있습니다.

디스플레이 매핑과 센서 보정은 관련이 있지만 서로 다릅니다. 매핑은 터치 좌표를 어떤 출력으로 전송할지, 그리고 좌표를 어떻게 회전하거나 확대/축소할지를 결정합니다. 보정은 디지타이저가 측정한 터치 위치와 해당 출력에 표시되는 지점 사이의 관계를 수정합니다. 먼저 잘못된 출력이나 방향을 수정한 다음 물리적 오프셋을 다시 확인하십시오.

libinput 보정 행렬은 언제 적절한가요?

기기가 보정 기능을 지원하고 해당 패널에 대한 신뢰할 수 있는 값이 있는 경우에만 libinput 행렬을 사용하십시오. libinput에 따르면 보정 기능은 일부 직접 입력 기기에서만 사용 가능하며 변환 행렬로 표현되고 일반적으로 데스크톱 환경이나 다른 호출자를 통해 제공됩니다. libinput의 libinput list-devices출력은 로컬 기기에서 사용 가능한 구성을 확인하는 데 도움이 될 수 있습니다.

Linux의 영구적인 설정에는 종종 장치별 udev 속성(예: `<matrix>`)이 포함되지만 LIBINPUT_CALIBRATION_MATRIX, 올바른 값은 장치, 방향 및 드라이버에 따라 다릅니다. "Harmonica OS 태블릿"에 사용할 수 있는 안전한 범용 매트릭스는 없습니다. 다른 태블릿의 매트릭스를 복사하거나 계수를 추측하지 마십시오. 잘못된 규칙을 사용하면 화면 사용이 어려워지고 되돌리려면 키보드, 원격 셸 또는 복구 환경이 필요할 수 있습니다.

이 고급 경로는 정확한 입력 장치를 식별하고 필요한 변환 값을 측정했으며 터치 기능이 작동을 멈출 경우 시스템을 복구할 수 있는 관리자에게 적합합니다. 측정 도구나 복구 계획이 없는 단일 장치 가정용 태블릿의 경우, X.Org 호환 도구(해당되는 경우) 또는 드라이버/벤더 수정이 더 안전한 옵션입니다.

결과를 어떻게 확인하나요?

• 중앙과 네 모서리를 여러 번 탭한 다음, 그 사이의 지점들을 테스트하십시오. 모서리는 정확하지만 가장자리가 부정확한 경우 기본적인 보정으로는 해결할 수 없는 문제가 있을 수 있습니다.
• 태블릿을 회전시킨 후 원래 방향으로 되돌려 놓고 테스트를 반복하십시오.
• 손가락 입력과 스타일러스 입력을 별도로 테스트하십시오. 두 입력 방식은 각각 다른 장치로 인식되어 별도의 보정 기능을 지원할 수 있습니다.
• 변경 사항을 영구적으로 적용한 후에는 컴퓨터를 재부팅하고 다시 테스트하십시오. 로그아웃 또는 재부팅 전까지만 유효한 값은 영구적인 값이 아닙니다.
• 고급 설정을 변경하기 전에 정상 작동하는 외부 키보드나 마우스를 사용해 보세요. 이렇게 하면 복구 입력 방법을 확보할 수 있습니다.

문제가 해결되면 화면 전체에서 터치 지점 근처에 정확하게 터치가 이루어지고, 재부팅 후에도 정확한 터치 위치가 유지되며, 다른 방향으로 전환할 때 새로운 오프셋이 발생하지 않아야 합니다. 만약 여전히 터치가 제대로 되지 않거나, 고스트 터치가 발생하거나, 일부 영역이 작동하지 않거나, 기기가 인식되지 않는 문제가 발생한다면 libinput list-devices, 보정값을 높이기보다는 커널 드라이버, 펌웨어, 커넥터 또는 디지타이저를 점검하십시오.

사용 가능한 접근 방식 중에서 선택하기

디스플레이 변경 후 발생한 오프셋의 경우, 먼저 해상도와 방향을 재설정하십시오. 이렇게 하면 빠르고 쉽게 되돌릴 수 있습니다. 호환되는 X.Org 드라이버로 인식되는 터치스크린의 경우, xinput_calibrator드라이버별 출력값을 사용하고 평가하십시오. 이 방법이 더 직접적이지만 모든 최신 입력 스택을 지원하는 것은 아닙니다. 측정값을 제공하는 지원되는 libinput 장치의 경우, 장치별 매트릭스를 사용하면 값을 영구적으로 저장할 수 있지만 구성 및 복구 비용이 가장 높습니다. 간헐적인 입력, 지원되지 않는 하드웨어 또는 물리적 손상의 경우, 보정보다는 드라이버 문제 해결이나 장치 수리가 더 적절합니다.

HamoniKR 버전과 태블릿 모델에 따라 실제로 사용 가능한 경로가 결정됩니다. 보정 소프트웨어를 설치하거나 시스템 수준의 입력 규칙을 변경하기 전에 이러한 세부 정보를 확인하십시오.