Voltar aos guias

Comandos NFC brutos: APDUs, leitura de páginas e o que o Command Console envia

Comandos NFC brutos são bytes enviados direto ao chip. Veja como funcionam READ, WRITE e APDUs ISO 7816-4, e o que o Command Console envia.

Publicado

Um comando NFC bruto é uma pequena sequência de bytes que você envia direto ao chip, sem nada decodificando o resultado no caminho. Em vez de pedir à tag "a URL" ou "o cartão de contato", você pede bytes específicos de endereços específicos e lê exatamente o que o silício devolve. Na prática, há duas "linguagens de bytes" em jogo: os comandos curtos de página que as tags Type 2 entendem e os APDUs ISO 7816-4, mais longos, que os cartões inteligentes esperam. Saber qual das duas a tag fala é a maior parte do trabalho.

O que é, de fato, um comando bruto

A maioria dos apps de NFC entrega um resultado já decodificado. Eles executam a conversa de baixo nível, interpretam os registros NDEF e mostram um link ou texto organizado. O modo bruto remove essa camada de tradução. Você escreve os bytes do comando, o leitor acrescenta a verificação de erros e a temporização, e a tag responde em bytes. Nada é interpretado por você, e é exatamente isso que se quer ao examinar bytes de bloqueio, um capability container ou um contador que a visualização amigável esconde.

O conjunto de comandos Type 2: READ, FAST_READ, WRITE

Tags de consumo como NTAG213, NTAG215 e NTAG216 são chips NFC Forum Type 2, e a memória deles é organizada em páginas de exatamente quatro bytes cada, segundo o datasheet da NXP para NTAG. Os comandos são curtos:

READ       0x30 <page>              -> 16 bytes (four pages)
FAST_READ  0x3A <start> <end>       -> every page in that range
WRITE      0xA2 <page> <4 bytes>    -> writes one page
GET_VERSION 0x60                    -> chip product/version bytes

A pegadinha que confunde muita gente: READ 0x30 sempre retorna dezesseis bytes (quatro páginas consecutivas), mesmo que você só quisesse uma. FAST_READ 0x3A é a forma eficiente de puxar um dump de memória inteiro em uma única troca, porque você informa a página inicial e a final e ele transmite tudo que está entre elas. WRITE 0xA2 é o oposto: mexe em exatamente uma página de quatro bytes, então alterar um registro maior exige várias escritas seguidas.

APDUs: o formato ISO 7816-4

Cartões inteligentes e as tags mais capazes falam um formato diferente e mais longo, chamado APDU. Um APDU de comando começa com um cabeçalho de quatro bytes (CLA, INS, P1, P2) e, opcionalmente, traz Lc (quantos bytes de dados vêm a seguir), os próprios dados e Le (quantos bytes você espera de volta), conforme descrito na referência de APDU ISO 7816-4. A resposta é um campo de dados opcional seguido de um trailer obrigatório de dois bytes, SW1 e SW2. Quando você vê 90 00 no fim de uma resposta, esse é o status convencional de "comando executado com sucesso".

É também aqui que a família MIFARE se separa. O MIFARE Classic usa blocos de dezesseis bytes e exige uma etapa de autenticação antes de ler ou gravar, e alguns chips usam uma sequência COMP_WRITE em duas partes em vez da simples gravação de página em um só passo. A mesma ideia, com mais cerimônia.

Onde você vai ver isso: iOS vs Android

No Android, o acesso bruto é direto: abra a classe da tecnologia da tag e chame transceive com o seu array de bytes. NfcA, IsoDep, NfcV e o helper MifareUltralight expõem isso, como mostra a referência do NfcA no Android. No iOS, o Core NFC também aceita comandos brutos, por meio de tipos como NFCMiFareTag e NFCISO7816Tag, mas a pilha de leitura e gravação é mais restrita que a do Android, então algumas operações de baixo nível simplesmente não estão disponíveis.

Dicas, pegadinhas e um passo a passo rápido com o NFCore

Algumas coisas poupam tempo. Os comandos Type 2 endereçam páginas, não bytes, então multiplique por quatro para achar um deslocamento. O leitor acrescenta o CRC e cuida da temporização, então você envia apenas os bytes de comando mostrados acima. Páginas protegidas por senha respondem às leituras com bytes todos zerados em vez de um erro, o que pode parecer uma tag em branco quando ela só está bloqueada.

No NFCore, o Command Console permite digitar esses bytes diretamente e ver a resposta bruta chegar, em hexadecimal e ASCII lado a lado, o que ajuda a confirmar que uma gravação foi feita ou a checar quais páginas estão protegidas antes de mudar qualquer coisa. Use apenas em tags que são suas: seus adesivos, cartões de visita e gatilhos de casa inteligente. Experimente pela App Store ou pelo Google Play.

FAQ

Qual é a diferença entre uma leitura de página e um APDU? Uma leitura de página é um comando Type 2 minúsculo (como 0x30) que retorna páginas fixas de quatro bytes. Um APDU é o formato ISO 7816-4, mais longo, com cabeçalho CLA/INS/P1/P2, usado por cartões inteligentes e tags mais completas.

Por que meu READ retorna 16 bytes se pedi uma página? É assim por projeto. READ 0x30 sempre responde com quatro páginas consecutivas (dezesseis bytes), começando pela página que você indicou.

Posso enviar comandos brutos em um iPhone? Sim, pelo Core NFC, mas o conjunto de comandos aceitos é mais restrito que o do Android, então algumas operações só funcionam no Android.

O que significa 90 00? É o trailer de status SW1 SW2 que, por convenção, indica que o comando foi concluído com sucesso.