Por que um cartão DESFire não mostra registros NDEF no seu celular
Um cartão DESFire é uma caixa de ferramentas, não uma tag NDEF pronta. Veja qual layout o celular espera, por que a leitura volta vazia e como corrigir isso em um cartão seu.
Resposta curta
Seu celular não mostra registros NDEF porque o cartão não tem dados NDEF no layout que os celulares procuram. Um cartão MIFARE DESFire é uma caixa de ferramentas de aplicações e arquivos. Ele só se comporta como uma tag NDEF depois que alguém o configura assim. Este guia é para cartões que são seus, como um DESFire virgem que você comprou para um projeto.
Por que o celular não vê nada
O DESFire EV1 é compatível com o formato NFC Forum Type 4, mas só tem uma aplicação NDEF depois de ser configurado. As notas da WakDev sobre o DESFire EV1 dizem que, para ler e gravar NDEF no NFC Tools, o cartão precisa ser formatado antes como Type 4.
Cartões feitos para outras finalidades, como controle de acesso ou transporte, trazem suas próprias aplicações e nenhuma delas é NDEF. O celular detecta o cartão, mas não encontra nada que possa interpretar como mensagem. Para saber o que cada plataforma consegue ou não fazer com esses cartões, veja o que o iPhone e o Android conseguem ler de um cartão DESFire.
Como é um layout legível pelo celular
Um exemplo da comunidade, de um tópico do fórum Dangerous Things, mostra as peças:
- Uma aplicação com AID
000001e DF nameD2760000850101, o nome padrão da aplicação NDEF. - Arquivo
01com ISO IDE103, de 15 bytes: o capability container (CC). - Arquivo
02com ISO IDE104, de 2000 bytes: o próprio arquivo NDEF. - Direitos de acesso livres, ou seja, nenhuma chave é necessária para ler.
O celular seleciona a aplicação NDEF, lê o CC, descobre qual arquivo guarda a mensagem e então lê esse arquivo. Se qualquer etapa falhar, a leitura vem vazia.
Os culpados mais comuns
Falta do capability container
O código de leitura de referência da libfreefare analisa o CC em busca de um NDEF File Control TLV (tag 04) para encontrar o arquivo NDEF e seu tamanho máximo. No tópico do fórum citado acima, o arquivo CC precisou ser gravado para que um registro NDEF funcionasse.
Comprimento errado ou zero
Os dois primeiros bytes do arquivo NDEF são o comprimento da mensagem, conhecido como NLEN. O leitor da libfreefare lê primeiro esses dois bytes, para se o comprimento mais dois exceder o tamanho máximo e só então lê essa quantidade de bytes. Comprimento zero significa mensagem vazia, e um comprimento errado causa falha na leitura.
Mensagem malformada
No mesmo tópico, uma carga de teste curta foi lida sem problemas no NFC Tools, enquanto uma mais longa não foi. Isso aponta para os bytes da mensagem, e não para as configurações do cartão. Confira o cabeçalho do registro, o comprimento do payload e o valor de NLEN uns contra os outros.
IDs diferentes em cartões mais antigos
As tags DESFire versão 0 usam identificadores diferentes dos do EV1 e posteriores. O leitor da libfreefare usa o AID 0xEEEE10 e o arquivo CC 0x03 na versão 0, e o AID 0x000001 e o arquivo CC 0x01 nos demais casos. Uma ferramenta escrita para um layout pode não reconhecer o outro.
Particularidades de versão e do iPhone
No iPhone, o Info.plist de um app pode listar um ID de aplicação para o Core NFC. Um engenheiro da Apple explicou, em uma resposta no fórum de desenvolvedores, que listar D2760000850101 faz o sistema tratar a tag como ISO 7816. Se você deixar de listá-lo, recebe um NFCMiFareTag, em que os comandos nativos passam por sendMiFareCommand. Está criando um app? Escolha o modo que corresponde à forma como você se comunica com o cartão. Está escolhendo a geração do cartão? Vale a pena ver também como o DESFire EV2 e o EV3 se diferenciam.
Como corrigir
- Confirme o que há no cartão. Um app leitor que mostre os dados brutos da tag, como o NFCore, indica se o celular vê algum NDEF.
- Formate o cartão como Type 4 com uma ferramenta que suporte DESFire. Isso normalmente exige as chaves do cartão. Um cartão virgem de fábrica costuma usar chaves padrão. Um cartão que recebeu chaves para o sistema de outra pessoa não é seu para reformatar.
- Grave primeiro uma mensagem de teste curta, como alguns caracteres de texto. Se ela for lida, passe para cargas maiores.
- Se uma mensagem mais longa falhar, confira NLEN, o cabeçalho do registro e o CC uns contra os outros.
Faça isso apenas em cartões que são seus. Reformatar um cartão que pertence a um sistema de transporte, a um empregador ou a um prédio não vai funcionar, e não é algo que se deva tentar.
Conclusão
Uma leitura NDEF vazia em um cartão DESFire quase sempre significa que o layout NDEF está ausente ou incompleto, e não que o cartão esteja com defeito. Verifique, nesta ordem, a aplicação NDEF, o arquivo CC, o arquivo NDEF e um comprimento correto, e teste com uma mensagem curta.
Perguntas frequentes
Meu cartão DESFire está com defeito se o celular não mostra registros NDEF?
Normalmente não. A maioria dos cartões DESFire sai de fábrica para controle de acesso ou transporte, com suas próprias aplicações e sem aplicação NDEF. O celular não está falhando; simplesmente não há dados NDEF no layout que ele procura.
Posso simplesmente gravar uma URL em um cartão DESFire como em um adesivo NTAG?
Não diretamente. Um NTAG tem um mapa de memória fixo, enquanto o DESFire precisa que uma aplicação e arquivos sejam criados antes. Uma ferramenta que formata o cartão como Type 4 faz essa etapa para você, desde que você tenha as chaves do cartão.
Por que uma mensagem de teste curta é lida, mas uma mais longa não?
Isso aponta para os bytes da mensagem, e não para as configurações do cartão. Em um caso da comunidade, uma carga de teste curta foi lida sem problemas enquanto uma mais longa não foi, o que combina com um comprimento errado ou uma mensagem malformada.