Retour aux guides

Commandes NFC brutes : APDU, lectures de pages et ce qu'envoie la Command Console

Les commandes NFC brutes sont des octets envoyés directement à la puce. Voici comment fonctionnent READ, WRITE et les APDU ISO 7816-4, et ce qu'envoie la Command Console.

Publié

Une commande NFC brute est une courte suite d'octets que vous envoyez directement à la puce, sans que rien ne la décode pour vous au passage. Au lieu de demander au tag « l'URL » ou « la carte de contact », vous demandez des octets précis à des adresses précises et vous lisez exactement ce que le silicium renvoie. Il y a en réalité deux langages d'octets en jeu : les commandes de pages courtes que comprennent les tags Type 2, et les APDU ISO 7816-4, plus longues, qu'attendent les cartes à puce. Savoir lequel parle votre tag, c'est l'essentiel du travail.

Ce qu'est vraiment une commande brute

La plupart des applications NFC vous donnent un résultat déjà décodé. Elles gèrent l'échange de bas niveau, analysent les enregistrements NDEF et vous affichent un lien ou un texte propre. Le mode brut supprime cette couche de traduction. Vous écrivez les octets de la commande, le lecteur ajoute le contrôle d'erreurs et la gestion du timing, et le tag répond en octets. Rien n'est interprété pour vous, ce qui est précisément l'intérêt quand vous voulez voir les lock bytes, un capability container ou un compteur que la vue simplifiée masque.

Le jeu de commandes Type 2 : READ, FAST_READ, WRITE

Les tags grand public comme NTAG213, NTAG215 et NTAG216 sont des puces NFC Forum Type 2, et leur mémoire est organisée en pages d'exactement quatre octets chacune, d'après la fiche technique NXP NTAG. Les commandes sont courtes :

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

Le piège classique : READ 0x30 renvoie toujours seize octets (quatre pages consécutives), même si une seule page vous intéressait. FAST_READ 0x3A est le moyen efficace de récupérer un dump mémoire complet en un seul échange : vous indiquez une page de début et une page de fin, et la puce envoie tout ce qui se trouve entre les deux. WRITE 0xA2 fonctionne à l'inverse : elle ne touche qu'une seule page de quatre octets, donc modifier un enregistrement plus long demande plusieurs écritures à la suite.

Les APDU : le format ISO 7816-4

Les cartes à puce et les tags plus évolués parlent un autre format, plus long, appelé APDU. Une APDU de commande commence par un en-tête de quatre octets (CLA, INS, P1, P2), puis peut contenir Lc (le nombre d'octets de données qui suivent), les données elles-mêmes, et Le (le nombre d'octets attendus en retour), comme décrit dans la référence des APDU ISO 7816-4. La réponse est un champ de données facultatif suivi d'un trailer obligatoire de deux octets, SW1 et SW2. Quand vous voyez 90 00 à la fin d'une réponse, c'est le statut conventionnel « commande exécutée avec succès ».

C'est aussi là que la famille MIFARE diverge. MIFARE Classic utilise des blocs de seize octets et exige une étape d'authentification avant toute lecture ou écriture, et certaines puces emploient une séquence COMP_WRITE en deux temps plutôt que la simple écriture de page en une fois. Même principe, plus de cérémonie.

Où l'utiliser : iOS ou Android

Sur Android, l'accès brut est direct : vous ouvrez la classe de la technologie du tag et appelez transceive avec votre tableau d'octets. NfcA, IsoDep, NfcV et l'assistant MifareUltralight le permettent tous, comme le montre la référence Android NfcA. Sur iOS, Core NFC prend aussi en charge les commandes brutes, via des types comme NFCMiFareTag et NFCISO7816Tag, mais la pile lecteur/écriture est plus restreinte que celle d'Android, de sorte que quelques opérations de bas niveau ne sont tout simplement pas disponibles.

Astuces, pièges et mini-tutoriel avec NFCore

Quelques points font gagner du temps. Les commandes Type 2 adressent des pages, pas des octets : multipliez par quatre pour obtenir un décalage. Le lecteur ajoute le CRC et gère le timing, vous n'envoyez donc que les octets de commande indiqués plus haut. Les pages protégées par mot de passe répondent aux lectures par des octets tous à zéro plutôt que par une erreur, ce qui peut ressembler à un tag vierge alors qu'il est simplement verrouillé.

Dans NFCore, la Command Console vous permet de saisir ces octets directement et de voir revenir la réponse brute, en hexadécimal et en ASCII côte à côte. C'est pratique pour confirmer qu'une écriture a bien été prise en compte ou pour vérifier quelles pages sont protégées avant de modifier quoi que ce soit. Limitez-vous aux tags que vous possédez : vos propres autocollants NFC, cartes de visite et déclencheurs domotiques. Essayez-la depuis l'App Store ou Google Play.

FAQ

Quelle est la différence entre une lecture de page et une APDU ? Une lecture de page est une toute petite commande Type 2 (comme 0x30) qui renvoie des pages fixes de quatre octets. Une APDU est le format ISO 7816-4, plus long, avec un en-tête CLA/INS/P1/P2, utilisé par les cartes à puce et les tags plus riches.

Pourquoi mon READ renvoie-t-il 16 octets alors que j'ai demandé une seule page ? C'est voulu. READ 0x30 répond toujours avec quatre pages consécutives (seize octets), à partir de la page que vous avez indiquée.

Puis-je envoyer des commandes brutes depuis un iPhone ? Oui, via Core NFC, mais le jeu de commandes pris en charge est plus restreint que sur Android, donc certaines opérations ne sont possibles que sur Android.

Que signifie 90 00 ? C'est le trailer d'état SW1 SW2 qui signifie conventionnellement que la commande s'est terminée avec succès.