Kit de Laboratório de Hardware (HLK) para NFC (Comunicação de Campo Próximo)

Artigo
06/20/2023

O HLK para NFC valida que a implementação do driver NFC atende às especificações da Microsoft. Embora os testes possam ser executados manualmente, para testes automatizados, mais rápidos e mais confiáveis para o pacote de testes NFC da HLK, recomendamos que os parceiros adquiram a NITT (Nfc Interoperability Test Tool).

O NITT simula as marcas de fórum nfc tipo 1, 2, 3 e 4. O NITT tem um braço robô que move um escudo RF, simulando operações de toque/desarmamento para cenários de Emulação ponto a ponto e cartão. A imagem a seguir ilustra a configuração do NITT.

Foto do NITT com um braço robô que move um escudo RF

O NITT é alimentado com uma fonte de alimentação externa de 7,5v e está conectado ao computador cliente.

Para adquirir o NITT, use as seguintes informações de contato:

JJG Technologies LLC
1034 231st Pl NE
Sammamish, WA 98074 
Phone: (206) 304-1921 Fax: (208) 298-0623
inquiry@jjgtechnologies.com

Depois de configurar a estrutura de teste do HLK:

Requisitos de hardware

Dispositivo com chip NFC que implementa os DDIs do driver NFC e está sujeito a testes de conformidade (conhecidos como DUT (Dispositivo em Teste))
Computador desktop com porta USB (cliente pc)
Placa NITT (se disponível) conectada ao cliente do computador
Dispositivo com chip NFC que implementa os DDIs de proximidade de campo próximo (cliente NFC)
Leitor de cartão inteligente conectado ao cliente do computador (por USB ou inserido no cliente do computador)

Observação

O cliente do computador requer a instalação do Universal C Runtime. Esse pacote está disponível diretamente no Centro de Download da Microsoft.

Execução de teste

Antes de executar o teste

Verifique se o cliente HLK está implantado no DUT.
Coloque o DUT sobre a antena NFC da placa NITT.
Coloque o cliente NFC ou o leitor de cartão inteligente, dependendo do teste que está sendo executado, abaixo da antena NFC e do escudo RF do NITT.
Verifique se o cliente do computador tem o Universal C Runtime instalado.
Verifique se o cliente DUT, NFC e o cliente pc têm conexões de rede. Se o DUT ou o cliente NFC for um telefone, você precisará da ferramenta Ethernet Virtual para poder se conectar ao telefone.

O estúdio/controlador do HLK implanta e executa casos de teste no DUT, mas alguma intervenção por parte do testador é necessária. Para casos de teste em que a intervenção manual é necessária, os binários auxiliares precisam ser iniciados manualmente. Para fazer isso, os clientes NFC e PC precisam ter a seguinte configuração:

Cliente NFC

Crie uma pasta de trabalho e copie binários TAEF correspondentes à arquitetura do cliente do controlador HLK para o diretório de trabalho. Para uma configuração típica do estúdio HLK, os binários TAEF estarão localizados no seguinte diretório:
```
C:\Program Files (x86)\Windows Kits\10\Testing\Runtimes\TAEF\<arch>\*\MinTE\*
```
Onde <arch> é x86, x64, arm, arm64.
Copie NfcRemotePeerService.dll do seguinte local do HLK Studio para o diretório de trabalho criado acima:
```
C:\Program Files (x86)\Windows Kits\10\Hardware Lab Kit\Tests\<arch>\NFC\NfcRemotePeerService.dll
```
Onde <arch> é x86, amd64, arm, arm64.

Cliente pc (*configuração se estiver usando NITT)

Crie uma pasta de trabalho e copie binários TAEF correspondentes à arquitetura do cliente do controlador HLK para o diretório de trabalho. Para uma configuração típica do estúdio HLK, os binários TAEF estarão localizados no seguinte diretório:
```
C:\Program Files (x86)\Windows Kits\10\Testing\Runtimes\TAEF\<arch>\*\MinTE\*
```
Onde <arch> é x86, x64, arm, arm64.
Copie NfcNittController.exe do seguinte local de estúdio do HLK para o diretório de trabalho criado acima:
```
C:\Program Files (x86)\Windows Kits\10\Hardware Lab Kit\Tests\<arch>\NFC\NfcNittController.exe
```
Onde <arch> é x86, amd64, arm, arm64.
Copie MuttUtil.dll do seguinte local de estúdio do HLK para o diretório de trabalho criado acima:
```
C:\Program Files (x86)\Windows Kits\10\Hardware Lab Kit\Tests\<arch>\usb\MuttTools\MuttUtil.dll
```
Onde <arch> é x86, amd64, arm, arm64.

Cliente pc (*configuração se não estiver usando NITT)

Crie uma pasta de trabalho e copie NfcManualHelper.exe correspondente à arquitetura do cliente do controlador HLK para o diretório de trabalho. Para uma configuração típica do estúdio HLK, NfcManualHelper.exe estará localizado no seguinte diretório:
```
C:\Program Files (x86)\Windows Kits\10\Hardware Lab Kit\Tests\<arch>\NFC\NfcManualHelper.exe
```
Onde <arch> é x86, x64, arm, arm64.

Executando o teste usando HLK

HLK Studio

No HLK Studio, selecione o teste na guia "Testes", de acordo com a imagem a seguir:
Clique em Executar Selecionado
Se você estiver executando os testes manualmente (sem o NITT), altere o valor Parâmetros de nitt para manual, conforme mostrado na imagem a seguir:

Teste com o cliente NFC

Abra o prompt de comando e vá para a pasta de trabalho criada acima
Execute o comando a seguir:
```
TE.exe NfcRemotePeerService.dll /p:server=<ip_of_dut>
```
Onde <ip_of_dut> é o endereço IP do DUT
NfcRemotePeerService.dll se conectará ao teste em execução no DUT e receberá comandos do teste. Esses comandos instruirão NfcRemotePeerService.dll quando criar publicações e assinaturas de Proximidade de Campo Próximo no cliente NFC. Quando o DUT e o cliente NFC forem tocados juntos, as publicações e assinaturas serão acionadas, exercendo os cenários ponto a ponto da NFC.

Teste com o cliente pc (*configuração se estiver usando NITT)

Abra o prompt de comando e vá para a pasta de trabalho criada acima
Execute o comando a seguir:
```
nfcnittcontroller.exe -server <ip_of_dut> -tagIndex <tag_index> -reader <reader_name>
```
Onde <ip_of_dut> é o endereço IP do DUT, <tag_index> é o índice de marca de placa NITT e <reader_name> é o nome do leitor de cartão inteligente conectado ao cliente do computador. Os valores possíveis de <tag_index> são 1, 2, 3 e 4 correspondentes ao T1T, T2T, T3T e T4T em conformidade com o NFC Forum, respectivamente. Para localizar o nome do leitor de cartão inteligente conectado ao cliente do computador, você pode usar a opção -listReaders de NfcManualHelper.exe (veja abaixo).
NfcNittController.exe se conectará ao teste em execução no DUT e receberá comandos do teste. Esses comandos instruirão NfcNittController.exe quando executar ações com o NITT. Essas ações são executadas automaticamente e não precisam de nenhuma interação manual. Ações de exemplo: abrindo e fechando o escudo RF, ativando e desativando uma marca no NITT.

Teste do cliente pc(*setup se não estiver usando NITT)

Abra o prompt de comando e vá para a pasta de trabalho criada acima
Execute o comando a seguir:
```
nfcmanualhelper.exe -server <ip_of_dut> -reader <reader_name>
```
Onde <ip_of_dut> é o endereço IP do DUT e <reader_name> é o nome do leitor de cartão inteligente conectado ao cliente do computador. Para localizar o nome do leitor de cartão inteligente conectado ao cliente do computador, você pode executar o seguinte comando:
```
nfcmanualhelper.exe -listReaders
```
NfcManualHelper.exe se conectará ao teste em execução no DUT e imprimirá instruções sobre o que fazer enquanto o teste estiver em execução. Instruções de exemplo: toque em DUT no cliente NFC, toque em DUT no leitor de cartão inteligente, toque em DUT na marca Proximidade do Campo Próximo.

Compartilhar via