Retour aux guides

Le format NDEF expliqué : le format universel qui permet à tout téléphone de lire votre tag

Le NDEF est le format de couche applicative standard du NFC Forum : l'enveloppe que tous les tags NFC grand public utilisent pour que n'importe quel téléphone compatible lise les mêmes octets de la même façon. Voici comment s'articulent messages, enregistrements et valeurs TNF.

Publié

Ce qu'est le NDEF : la réponse en un paragraphe

Le NDEF (NFC Data Exchange Format) est défini par le NFC Forum comme le conteneur universel de couche applicative des tags NFC. Il se place au-dessus de tous les types de tags du NFC Forum (NTAG, MIFARE Ultralight, FeliCa, ICODE), si bien que le même message encodé se lit de façon identique sur iPhone, sur Android et sur un lecteur dédié. Vous avez déjà écrit une URL sur un tag et vu qu'elle s'ouvre sur les deux plateformes sans rien faire de plus ? C'est le NDEF qui fait son travail. La couche radio règle l'échange, le NDEF donne une forme aux octets. Pour le côté radio, consultez comment fonctionne vraiment le NFC ; pour le contexte général, NFC, RFID et Bluetooth : les différences.

Comment un message NDEF est structuré

Un message NDEF est composé d'un ou plusieurs enregistrements (records) mis bout à bout. D'après la spécification du NFC Forum et la référence Android NdefMessage, le premier enregistrement porte un indicateur Message Begin (MB) et le dernier un indicateur Message End (ME). La plupart des tags grand public contiennent un message à enregistrement unique, mais vous pouvez en regrouper plusieurs si besoin.

L'en-tête de chaque enregistrement contient un TNF (Type Name Format, 3 bits), des indicateurs de contrôle (MB, ME, CF, SR, IL), des champs de longueur du type et de la charge utile, une courte chaîne de type, un ID facultatif, puis la charge utile elle-même.

L'aide-mémoire des TNF :

TNFSignification
0x00Enregistrement vide
0x01Type bien connu du NFC Forum : U, T, Sp, Sig
0x02Type de média MIME, selon la RFC 2046
0x03URI absolue, selon la RFC 3986
0x04Type externe du NFC Forum, par ex. android.com:pkg
0x05Inconnu
0x06Inchangé (enregistrements fragmentés)

En théorie, la charge utile d'un enregistrement peut atteindre 2^32 − 1 octets. En pratique, la puce vous limite bien avant : un NTAG213 offre 144 octets de mémoire utilisateur.

Les types d'enregistrements que vous rencontrerez vraiment

Quelques types bien connus font presque tout le travail.

L'enregistrement URI (TNF 0x01, type U) est de loin le plus courant. Sa définition de type d'enregistrement utilise un identifiant de préfixe d'un octet pour abréger le schéma (0x04 pour https://, 0x05 pour tel:, 0x06 pour mailto:), de sorte que le schéma n'est pas stocké en texte brut. Encoder https://nfcore.app coûte un octet de préfixe plus onze pour nfcore.app : douze octets au lieu de dix-neuf. Sur un tag de 144 octets, cela compte.

L'enregistrement Text (type T) transporte de l'UTF-8 avec un court en-tête de code de langue. Le Smart Poster (type Sp) est lui-même un enregistrement NDEF unique dont la charge utile est un message NDEF imbriqué : un sous-enregistrement URI, plus des sous-enregistrements facultatifs Title (Text), Icon (image MIME), Action et Size. Le RTD Smart Poster est le format des tags « touchez pour ouvrir le menu » ; les lecteurs qui ne le comprennent pas se rabattent sur l'URI interne. Les enregistrements MIME (TNF 0x02) transportent des charges utiles typées comme image/png ou application/vnd.bluetooth.ep.oob pour le transfert (handover) Bluetooth. Les enregistrements de type externe (TNF 0x04) dirigent vers l'application d'un éditeur précis.

Comment le téléphone décide quoi faire au contact

Les deux plateformes examinent le type du premier enregistrement pour choisir un gestionnaire. Sur Android, le framework NFC envoie un intent ACTION_NDEF_DISCOVERED et le compare aux filtres d'intent enregistrés ; les tags sans NDEF déclenchent à la place ACTION_TAG_DISCOVERED. Sur iPhone XS et les modèles plus récents, la lecture de tags en arrière-plan (Background Tag Reading) analyse automatiquement le NDEF et dirige un enregistrement URL vers le navigateur par défaut ou vers l'app qui a déclaré un Associated Domain pour cet hôte. À retenir : placez en premier l'enregistrement le plus spécifique. Si vous associez une URI à un enregistrement Text pour qu'une personne voie la destination, l'URI doit venir en premier, sinon le système n'acheminera pas automatiquement le contact.

Ce que NFCore vous montre

Le flux Write Data de NFCore vous permet de créer des enregistrements NDEF URL, Text, vCard, Wi-Fi et personnalisés sans toucher à l'hexadécimal. Après l'écriture, la vue Memory Dump affiche les octets (index, hexadécimal, ASCII) pour vérifier que la compression du préfixe et la structure des enregistrements correspondent à ce que vous attendiez. La Command Console donne accès aux lectures brutes de pages quand vous voulez examiner l'enveloppe NDEF TLV elle-même : l'octet de longueur 0x03 qui ouvre un message NDEF, et le terminateur 0xFE.

Questions fréquentes

Le NDEF est-il identique sur iPhone et sur Android ?

Oui. Le NDEF est défini par le NFC Forum, et le même message encodé se lit de façon identique avec Core NFC sur iOS et android.nfc sur Android. Les différences portent sur ce que chaque système fait du résultat analysé, pas sur la façon dont les octets sont analysés.

Quelle est la différence entre un enregistrement NDEF et un message NDEF ?

Le message est le conteneur ; les enregistrements sont les éléments qu'il contient. Un message NDEF est composé d'un ou plusieurs enregistrements concaténés, le premier portant un indicateur Message Begin et le dernier un indicateur Message End.

Pourquoi mon enregistrement URL prend-il moins d'octets que prévu ?

L'enregistrement URI utilise un identifiant de préfixe d'un octet (0x04 pour https://, 0x05 pour tel:, 0x06 pour mailto:), de sorte que le schéma n'est pas stocké en texte brut. Sur un NTAG213 de 144 octets, cela économise plusieurs octets par enregistrement.

Ai-je vraiment besoin du NDEF ?

Si votre lecteur est votre propre app qui dialogue avec votre propre tag, non. Mais tous les téléphones grand public et tous les gestionnaires par défaut des systèmes attendent du NDEF. Utilisez-le, sauf raison précise de ne pas le faire.

Pour conclure

Une fois le modèle message-et-enregistrements en tête, le reste de l'écosystème NFC s'organise naturellement autour. La capacité du NTAG vous indique quels enregistrements tiennent ; la création d'un Smart Poster devient « un sous-enregistrement URI plus des métadonnées facultatives ». Le NDEF transforme la mémoire d'un tag en quelque chose que tout téléphone sait acheminer, et dès que vous voyez les octets dans le Memory Dump de NFCore, le format cesse de ressembler à de la magie.