Apêndice (touchpad-appendix)

O apêndice do Guia de Validação do Touchpad de Precisão do Windows fornece informações sobre mensagens de erro comuns, juntamente com algumas específicas de HID.

Mensagens de erro

Nº da mensagem de erro	Mensagem de erro	Explicação
1	Falha explícita do usuário.	Falha do operador na iteração/no teste por meio da tecla de atalho.
2	Falha em várias iterações:	falha em um número muito grande de iterações. Inclui o número de iterações com falha.
3	Recebimento de uma entrada em um momento inesperado.	O teste não esperava receber dados, mas eles foram recebidos. Por exemplo, isso pode acontecer no teste de Detecção de Altura Z.
5	Recebimento de um número muito grande de contatos:	O operador colocou poucos contatos na superfície. Inclui o número de contatos detectados.
6	Recebimento de um número muito pequeno de contatos:	O operador colocou muitos contatos na superfície. Inclui o número de contatos detectados.
7	O teste não recebeu dados suficientes.	Se o erro ocorrer no momento da elevação do contato, isso indicará que o teste exigiu que os contatos durassem por um tempo determinado, mas essa duração não foi cumprida. Se ele ocorrer no momento do pressionamento de contato, isso indicará que o teste recebeu um quadro de contato zero como os primeiros dados, que pode ser causado por um pressionamento de botão não capacitivo. No entanto, é mais provável que esse seja um erro de protocolo (um dispositivo que envia um quadro vazio).
9	Recebimento de um contato inesperado.	Em um teste que exige um número específico de contatos, isso indica que um contato foi pressionado depois que um contato foi elevado. Todos os pressionamentos de contatos devem ocorrer antes de todas as elevações de contatos.
10	Dados de geometria fora do intervalo esperado:	Somente em Test.Geometry. A largura e/ou a altura estavam fora do intervalo esperado pelo teste. Inclui a largura e a altura detectadas em unidades himétricas.
11	Deslocamento muito grande de contato:	O deslocamento x/y geral do contato foi muito grande. Inclui o deslocamento detectado em unidades himétricas.
12	Interação muito curta:	A duração da interação (o tempo do primeiro até o último contato) foi muito curta. Inclui a duração de interação detectada em milissegundos.
13	Interação muito longa:	A duração da interação (o tempo do primeiro até o último contato) foi muito longa. Inclui a duração de interação detectada em milissegundos.
14	Pacote muito longe da borda:	Indica que o primeiro pacote estava muito longe da borda do touchpad. Inclui a distância da borda em unidades himétricas.
15	O contato não se moveu em linha reta:	O contato desviou demais de uma linha de melhor ajuste. Inclui o desvio máximo detectado da linha em unidades himétricas.
16	A linha desviou muito do eixo:	Aplica-se somente à família Test.Linearity de testes. O deslocamento do contato em X ou Y era muito grande. Inclui o desvio em unidades himétricas.
17	Não há separação suficiente de pontos:	Aplica-se somente à família Test.ConvergeDiverge de testes. Se eles são convergentes, os pontos iniciais estavam muito próximos um do outro. Se eles são divergentes, os pontos finais estavam muito próximos um do outro.
18	Excesso de separação de pontos:	Aplica-se somente à família Test.ConvergeDiverge de testes. Se eles são convergentes, os pontos finais estavam muito próximos um do outro. Se eles são divergentes, os pontos iniciais estavam muito próximos um do outro. Inclui a distância entre os pontos em unidades himétricas.
20	Delta posicional muito grande:	O delta de posição entre dois pacotes era muito grande para o teste. Inclui o delta detectado em unidades himétricas.
23	O dispositivo não dá suporte ao número mínimo de contatos:	O dispositivo não dá suporte ao número mínimo necessário de contatos. Inclui o número de contatos com suporte.
24	O dispositivo dá suporte a um número excessivo de contatos:	O dispositivo dá suporte a mais do que o número máximo necessário de contatos. Inclui o número de contatos com suporte.
25	Pacote não localizado na posição esperada:	Aplica-se somente à família Test.PositionalAccuracy de testes. Indica que o local do pacote não estava na posição obrigatória. Inclui a localização do pacote em unidades himétricas.
26	Nenhum pacote fora da região da borda.	Nos testes que envolvem o desenho de uma linha reta com a plataforma de contato de precisão, isso indica que toda a linha estava na região da borda do touchpad.
27	Observação de viagem regressiva de pacotes.	Aplica-se somente à família Test.Linearity de testes. Indica que um pacote foi observado em viagem regressiva em relação ao restante do fluxo de pacotes.
28	DPI muito baixo:	Somente em Test.InputResolution. Indica que o intervalo lógico de X/Y no touchpad, combinado com as dimensões físicas, não dá suporte ao DPI necessário. Inclui o DPI calculado.
29	Observação do bit de confiança definido após limpeza.	Somente em Test.Confidence. Indica que um contato foi observado definindo o bit de confiança depois de ele ter sido limpo para esse contato.
30	Conjunto de bits de confiança muito longo:	Somente em Test.Confidence. Indica que o bit de confiança não foi limpo cedo o suficiente no tempo de vida dos contatos. Inclui o período de tempo em que o bit de confiança foi definido em milissegundos.
31	Porcentagem muito baixa de coordenadas lógicas encontradas:	Somente em Test.InputResolution. A coordenada X ou Y nos pacotes recebidos em uma determinada iteração precisa incluir uma porcentagem mínima do intervalo total. Inclui o percentual realmente encontrado.
32	Você precisa executar esse teste com privilégios elevados.	O PTLogo deveria ter sido iniciado com privilégios elevados para esse teste.
33	O dispositivo não dá suporte a relatórios seletivos.	O dispositivo não dá suporte a relatórios seletivos.
34	Pacotes duplicados:	Aplica-se somente à família Test.Linearity de testes. Indica que dois pacotes consecutivos tinham o mesmo local X/Y, mesmo que o contato estivesse se movendo. Inclui o tempo de verificação do pacote duplicado detectado.
35	Coordenada lógica não encontrada:	Somente em Test.InputResolution. Indica que uma coordenada X ou Y obrigatória nunca foi relatada por nenhum pacote durante a iteração. Inclui a coordenada obrigatória em unidades lógicas.
36	Confiança sempre definida.	Somente em Test.Confidence. Indica que o bit de confiança nunca foi limpo.
37	Falha via automação.	O teste falhou via automação.
38	Deslocamento de contato muito pequeno.	O deslocamento inicial x/y do contato era muito pequeno. Inclui o deslocamento detectado em unidades himétricas.
39	Alteração inesperada do estado do botão.	Somente em Test.RightClickReliability. Ocorre quando um relatório de entrada somente do botão é recebido do touchpad.
40	Altura do dispositivo muito pequena.	Somente em Test.DeviceHeight. A altura do touchpad é muito pequena. Inclui a altura detectada em milímetros.
41	Largura do dispositivo muito pequena.	Somente em Test.DeviceWidth. A largura do touchpad é muito pequena. Inclui a largura detectada em milímetros.

Mensagens de erro específicas do HID

Esta é uma tabela das mensagens de erro específicas do HID relacionadas aos testes de dispositivo touchpad de precisão do Windows.

Nº do erro do HID	Mensagem de erro	Explicação
1	Tamanho de bit X inválido.	A contagem de bits para Tx/Cx está fora do intervalo [1,32]. Verificado somente se C está presente.
2	Tamanho de bit Y inválido.	A contagem de bits para Ty/Cy está fora do intervalo [1,32]. Verificado somente se C está presente.
3	Transição de pacote inválida.	Essa mensagem de erro pode ser apresentada junto com uma destas outras: o “Local da última movimentação diferente” As coordenadas do relatório “limpeza de opção de ponta” de determinado contato não são iguais às coordenadas do relatório “última definição de opção de ponta”. o “Ponta ativada ausente” O primeiro relatório não tinha a opção de ponta definida ou havia dois pacotes em uma linha sem a opção de ponta definida. o “Ponta ausente” Um contato presente no quadro relatado anteriormente, com a opção de ponta definida, não foi encontrado no quadro atual.
4	Tempo de verificação inválido.	Essa mensagem de erro pode ser apresentada junto com uma destas outras: o “(Não presente)” O dispositivo não dá suporte ao uso do tempo de verificação no descritor. o “(Intervalo)” O tempo de verificação relatado está fora do intervalo lógico. o “(Delta > 10ms mais de 1% do tempo)” O delta no tempo de verificação de quadro para quadro excede 10ms mais de 1% do tempo. o “(Delta > 16,7ms)” O delta no tempo de verificação de quadro para quadro foi maior que 16,7 ms. o “(Duplicado)” O tempo de verificação foi duplicado em dois quadros sequenciais. o “(Valores diferentes no quadro)” O valor de tempo de verificação não era idêntico para todos os contatos relatados de um determinado quadro. o “(Desvio do relógio de parede)” Os deltas no tempo de verificação desviaram muito do tempo do sistema. Os deltas no tempo de verificação foram maiores que 5% do tempo do relógio.
5	X, Y inválido.	Essa mensagem de erro pode ser apresentada junto com uma destas outras: o “(T inválido)” Com C, Width ou Height presentes, Tx e/ou Ty não estavam presentes ou não estavam dentro do intervalo lógico. o “(C inválido)” Com T, Width ou Height presentes, Cx e/ou Cy não estavam presentes ou não estavam dentro do intervalo lógico. o “(Combinação T/C inválida)” T não estava contido na caixa delimitadora formada por C, Width e Height.
6	Largura ou altura inválida.	Essa mensagem de erro pode ser apresentada junto com uma destas outras: o “” A largura e/ou a altura estavam presentes e uma delas não estava presente ou uma delas/ambas estavam fora do intervalo lógico. o “(0)” A largura e/ou a altura estavam presentes, mas o valor lógico de um delas/ambas era zero.
8	ID de contato inválida.	Essa mensagem de erro pode ser apresentada junto com uma destas outras: o “(Não presente)” O dispositivo não dá suporte ao uso de ContactID no descritor. o “(Duplicata no quadro)” Uma ID de contato foi duplicada em um só quadro (às vezes, causado por um relatório de quadro incompleto).
14	Nenhum dado no quadro.	Não havia nenhum contato no quadro e o botão físico não está pressionado, mas não estava liberado anteriormente.
16	Nº de contatos inválidos no quadro.	O número de contatos no quadro não correspondeu à Contagem Real relatada.
17	Número máximo de contatos excedido no quadro.	O número de contatos no quadro excedeu o número máximo de contatos que o dispositivo dá suporte por MAX COUNT.
18	Taxa de amostragem fora do intervalo.	A taxa de amostragem não estava no intervalo permitido para o número de contatos relatados.
21	Contagem real inválida.	O dispositivo não dá suporte ao uso ActualCount no descritor.
22	Confiança inválida.	A opção de confiança não foi definida (e o teste não era o teste de confiança).

Opções de linha de comando do PTLogo

Essas opções podem ser combinadas e são úteis apenas para fins de depuração. Essas opções não são permitidas para uma execução de teste de certificação.

Comutador	Uso	Finalidade
-startat #	“Ptlogo.exe –startat # test.foo.json” (sendo que # indica a iteração específica a ser iniciada para um determinado teste .json)	Usado para ir para uma iteração específica em um determinado teste.
-NoHIDValidation	“Ptlogo.exe –noHidValidation test.foo.json”	Usado para desabilitar a validação do HID em segundo plano para um teste específico.
-noDesktop	“Ptlogo.exe –noDesktop test.foo.json”	Usado para iniciar o teste no mesmo desktop de entrada em que ele foi iniciado; útil para executar digiinfo em segundo plano ou outras ferramentas de depuração.
-alliters	“Ptlogo.exe –alliters test.foo.json”	Usado para permitir que o operador percorra todas as iterações de um teste mesmo que tenha ocorrido mais do que o número máximo de iterações com falha permitidas
-EnableHIDLogging	“Ptlogo.exe –enableHIDLogging test.foo.json”	Usado para habilitar o log do HID durante um teste específico a fim de gerar um arquivo HID.log para depuração detalhada de falhas.