Corrigir problemas de calibração da tela sensível ao toque em tablets com Harmonica OS: escolha a solução Linux adequada.

Primeiro, confirme a qual “Harmonica OS” você se refere.

Se você se refere ao HamoniKR, a distribuição Linux sul-coreana, o comportamento da tela sensível ao toque é resultado da interação entre o hardware do tablet, o driver do kernel Linux, a pilha de entrada e a sessão da área de trabalho. Não consegui verificar um assistente de calibração universal para tablets HamoniKR ou uma solução única que se aplique a todos os modelos. O projeto HamoniKR publica manuais versionados, mas as etapas de calibração descritas abaixo utilizam ferramentas de entrada Linux documentadas e dependem do driver que seu tablet utiliza. Se você se refere ao Huawei HarmonyOS ou a outro produto chamado Harmonica OS, esses comandos Linux não se aplicam.

A opção mais prática é diagnosticar o sintoma antes de instalar um calibrador ou alterar arquivos do sistema. Um ponto de toque que esteja constantemente desalinhado pode precisar de calibração. Um ponteiro que esteja rotacionado, mapeado para a tela errada ou que apresente imprecisão apenas após uma alteração de resolução geralmente precisa de correção no mapeamento da tela. Toques aleatórios, perdidos ou fantasmas podem ser causados ​​por problemas de drivers ou hardware e não serão corrigidos alterando os valores de calibração.

O guia do usuário versionado do HamoniKR é o melhor lugar para verificar detalhes específicos da sua versão instalada. As orientações da camada de entrada abaixo são baseadas na documentação de configuração do libinput e na página de manual do Ubuntu para xinput_calibrator .

Qual solução se adequa ao sintoma?

Essa distinção economiza tempo: a calibração ajusta como as coordenadas são mapeadas do sensor de toque para a tela. Ela não pode fazer um controlador não compatível funcionar nem reparar um digitalizador danificado.

O que você deve verificar antes de alterar a calibração?

1. Anote o modelo do tablet e a versão do sistema operacional. Em um terminal, verifique /etc/os-releasee anote o modelo exato do dispositivo. Verifique se a versão do HamoniKR instalada é compatível com o modelo do tablet.
2. Limpe a tela e remova qualquer coisa que possa interferir no contato. Seque a umidade ou detritos e, para o teste, remova uma película protetora grossa ou danificada, se possível. Teste com o dedo e, separadamente, com a caneta stylus.
3. Configure a tela para sua resolução nativa e orientação normal. Use as configurações de exibição da área de trabalho. Se a precisão mudar após girar o tablet, alterar a escala ou conectar um monitor, desfaça essa alteração temporariamente e teste novamente.
4. Reinicie o sistema e aplique as atualizações relevantes. As atualizações podem incluir correções para o kernel e para os drivers de entrada. Faça isso antes de editar a configuração persistente, principalmente se o problema começou após uma atualização.
5. Verifique se o Linux reconhece uma tela sensível ao toque. Execute o comando `x-touchscreen`. libinput list-devicesSe estiver usando uma sessão X.Org, xinput listo comando `x-touchscreen` pode exibir os dispositivos de entrada X. Esses comandos identificam os dispositivos, mas não os calibram.

Para identificar o tipo de sessão, execute o comando echo "$XDG_SESSION_TYPE". Uma saída como x11`X.Org` significa X.Org; wayland`Xwayland` significa que o compositor Wayland gerencia a entrada física. Isso é importante porque um utilitário X.Org não pode configurar de forma confiável uma tela sensível ao toque física por meio do Xwayland.

Você deve usar um utilitário de calibração do X.Org?

Selecione esta opção xinput_calibratorsomente quando estiver em uma sessão X.Org ativa e o programa listar sua tela sensível ao toque física como um dispositivo calibrável. O manual do Ubuntu o descreve como um utilitário X.Org e explica que a persistência dos novos valores depende do driver. Em alguns casos, ele pode aplicar valores para a sessão atual ou imprimir um trecho de configuração; para outros drivers, a calibração automática não está disponível.

Se a ferramenta já estiver instalada, comece listando os dispositivos compatíveis:

xinput_calibrator --list

Se a sua tela sensível ao toque aparecer na lista, siga as indicações na tela e revise a saída. Teste o resultado em tela cheia antes de salvar quaisquer valores. Não cole um trecho da saída em um diretório do sistema apenas porque o utilitário o gerou: primeiro, confirme se o trecho identifica o seu dispositivo e corresponde ao driver em uso.

Essa abordagem é conveniente quando o tablet usa um driver X.Org compatível e o erro é um deslocamento estável. É uma escolha inadequada quando o sistema usa Wayland, quando o dispositivo não está na lista do calibrador ou quando o erro é não linear ou intermitente. O manual observa que uma calibração de quatro pontos não pode corrigir a deformação não linear da tela. Se o programa relatar cliques incorretos repetidamente, pare e verifique a compatibilidade do dispositivo em vez de forçar valores.

E se o problema for rotação ou a exibição incorreta?

Antes de tentar calibrar, corrija a configuração de exibição. Restaure a orientação, a resolução e a escala originais do tablet nas configurações de tela do HamoniKR. Se um monitor externo estiver conectado, desconecte-o e teste apenas a tela integrada. Se o toque voltar a funcionar corretamente, o problema provavelmente está no mapeamento de saída ou na rotação.

Em computadores desktop ou conversíveis com mais de uma tela, a tela sensível ao toque pode estar atribuída a uma saída diferente. O gerenciador de telas do Linux ou as configurações da área de trabalho geralmente são os locais de menor risco para corrigir essa associação. Em uma sessão Wayland, use os controles do ambiente de área de trabalho; alterar as propriedades do XInput a partir de um terminal pode afetar apenas os aplicativos Xwayland, e não o dispositivo físico.

O mapeamento da tela e a calibração do sensor são processos relacionados, mas distintos. O mapeamento define qual saída receberá as coordenadas do toque e como essas coordenadas serão rotacionadas ou escaladas. A calibração corrige a relação entre a posição do toque medida pelo digitalizador e o ponto visível nessa saída. Corrija primeiro uma saída ou orientação incorreta e, em seguida, verifique novamente o deslocamento físico.

Quando é apropriada uma matriz de calibração libinput?

Use uma matriz libinput somente se o seu dispositivo suportar calibração e você tiver valores confiáveis ​​para esse painel específico. A libinput explica que a calibração está disponível apenas para alguns dispositivos de entrada direta, é representada como uma matriz de transformação e normalmente é exposta por meio de um ambiente de desktop ou outro chamador. Sua libinput list-devicessaída pode ajudar a mostrar qual configuração está disponível em um dispositivo local.

Uma configuração Linux persistente geralmente envolve uma propriedade udev por dispositivo, como `<nome_da_propriedade>` LIBINPUT_CALIBRATION_MATRIX, mas os valores corretos dependem do dispositivo, da orientação e do driver. Não existe uma matriz universal segura para tablets com "Harmonica OS". Não copie uma matriz de outro tablet nem tente adivinhar os coeficientes: uma regra incorreta pode dificultar o uso da tela e pode exigir um teclado, um shell remoto ou um ambiente de recuperação para desfazer a alteração.

Este método avançado é apropriado para um administrador que identificou o dispositivo de entrada exato, mediu a transformação necessária e pode recuperar o sistema caso o toque pare de funcionar. Para um tablet doméstico com um único dispositivo, sem ferramenta de medição ou plano de recuperação, uma ferramenta compatível com X.Org (quando aplicável) ou uma correção de driver/fornecedor é a opção mais segura.

Como você verifica o resultado?

• Toque várias vezes no centro e em todos os quatro cantos e, em seguida, teste os pontos entre eles. Cantos precisos com bordas imprecisas podem indicar um problema que uma calibração básica não consegue corrigir.
• Repita o teste após girar o tablet e retorná-lo à orientação normal.
• Teste a entrada do dedo e da caneta separadamente. Elas podem aparecer como dispositivos diferentes com suporte de calibração independente.
• Reinicie o sistema após qualquer alteração persistente e teste novamente. Um valor que funciona apenas até o logout ou reinicialização não é persistente.
• Antes de fazer uma alteração mais complexa, experimente usar um teclado ou mouse externo que você saiba que funciona, para ter um método de entrada alternativo.

Uma correção bem-sucedida deve fazer com que os toques sejam registrados próximos ao ponto tocado em toda a tela, permaneçam corretos após a reinicialização e evitem a criação de novos deslocamentos em outra orientação. Se você ainda observar falhas aleatórias, toques fantasmas, faixas mortas ou se o dispositivo estiver ausente libinput list-devices, investigue o driver do kernel, o firmware, o conector ou o digitalizador em vez de aumentar os ajustes de calibração.

Escolher entre as abordagens disponíveis

Para um deslocamento que começou após uma alteração na tela, redefina primeiro a resolução e a orientação; isso é rápido e fácil de reverter. Para uma tela sensível ao toque reconhecida por um driver X.Org compatível, use xinput_calibratore avalie a saída específica do driver; é mais direto, mas não abrange todas as pilhas de entrada modernas. Para um dispositivo libinput compatível com valores medidos, uma matriz por dispositivo oferece persistência, mas tem o maior custo de configuração e recuperação. Para entrada intermitente, hardware não compatível ou danos físicos, solucionar problemas com o driver ou reparar o dispositivo é mais apropriado do que a calibração.

A versão do HamoniKR e o modelo do tablet determinam qual caminho está realmente disponível. Verifique esses detalhes antes de instalar o software de calibração ou alterar as regras de entrada do sistema.