Docs & Software Download
Présentation pas à pas de l’exemple de logiciel de console MIFARE DESFire ® C.
1. Présentation du logiciel
Lien : /code/nfc-rfid-reader-sdk/ufr-ds-examples-c.git
Lorsque vous lancez le logiciel, il apparaît comme suit :
La clé pour l’authentification, l’AID, le numéro de clé AID pour l’authentification, l’ID de fichier et l’index de clé interne sont tous récupérés à partir du fichier config.txt.
1.1. Explication du fichier de configuration (config.txt)
Le fichier de configuration config.txt est chargé au démarrage du logiciel. Il inclut une clé d’authentification, un nombre ordinal de clés dans l’aide pour l’authentification, un ID de fichier et un index de clé interne (lorsque la clé est stockée dans le lecteur).
Structure du fichier :
Clé DES : 0000000000000000000
AID 3 octets hexadécimaux : 000000
Numéro de clé AID pour l’authentification : 0
ID de fichier: 1
Numéro de clé interne : 0
La première ligne spécifie le type de clé et sa valeur hexadécimale.
Si le type de clé est DES (8 octets), 16 caractères doivent être entrés (clé DES: 0102030405060708)
Si le type de clé est 2K3DES (16 octets), 32 caractères doivent être entrés (clé 2K3DES : 01020304050607080910111213141516)
Si le type de clé est 3K3DES (24 octets), 48 caractères doivent être entrés (clé 3K3DES : 010203040506070809101112131415161718192021222324)
Si le type de clé est AES (16 octets), 32 caractères doivent être entrés (clé AES : 01020304050607080910111213141516)
La deuxième ligne contient AID, 6 caractères doivent être saisis (AID 3 octets hexadécimaux: 010203)
La troisième ligne contient un numéro ordinal dans l’application d’authentification (0 au nombre maximal de clés d’application – 1)
La quatrième ligne contient un index de l’ID de fichier dans l’application. Si la fonction n’utilise pas ce paramètre, cette valeur est ignorée.
La cinquième ligne contient un nombre ordinal de clés d’authentification stockées dans le lecteur.
Le fichier de configuration peut être modifié à partir de l’application lorsque vous appuyez sur 't' (Modifier les paramètres de configuration).
Tout d’abord, vous verrez le fichier config.txt actuel avec les options 1 à 5 pour la modification et ESC pour revenir au menu principal.
Pour changer de touche, appuyez sur '1'. Il existe quatre types de clés pour l’authentification.
Par exemple, appuyez sur '3' pour la touche 3K3DES. Entrez 24 octets au format hexadécimal (48 caractères).
Lorsque la modification est terminée, appuyez sur le bouton ÉCHAP pour revenir dans le menu principal, puis appuyez sur 't' pour vérifier les modifications.
Le type et la valeur de la clé d’authentification ont été modifiés.
1.2. Modifier le mode d’authentification (0)
Pour basculer entre l'authentification interne ou l'authentification par clé fournie, appuyez sur ' 0' sur le clavier.
Cela ressemble à ceci (voici '0' pressé deux fois):
1.3. Authentification par clé principale (1)
Pour basculer entre l'authentification par touche principale, appuyez sur ' 1' sur le clavier.
Cela ressemble à ceci (voici '1' pressé deux fois):
Que l’authentification soit requise ou non dépend de la clé principale de la carte ou des paramètres de l’application.
1.4. Obtenir l’UID de la carte (2)
Pour l’UID de la carte (7 octets), appuyez sur '2'. Une authentification valide avec une clé principale ou d’application est requise.
1.5. Format de la carte (3)
Appuyez sur le chiffre '3' sur votre clavier pour provoquer le formatage de la carte (suppression de toutes les applications et fichiers sauf AID avec le numéro: 000000).
Selon le mode d’authentification que vous avez choisi, il recherchera la clé AES dans le lecteur (CLÉ INTERNE) ou dans le fichier config.txt (CLÉ FOURNIE).
1.6. DES à AES (4)
Modification de la clé principale de la carte de la clé DES d’usine 0x0000000000000000 à la clé AES 0x00000000000000000000000000000000.
1.7. AES à DES (5)
Modification de la clé principale de la carte de la clé AES 0x00000000000000000000000000000000 à la clé DES 0x0000000000000000.
1.8. Obtenez de la mémoire libre (6)
Lisez la quantité de mémoire disponible sur la carte.
1.9. Définir un IDENTIFIANT aléatoire (7)
Activation des options de carte d’identité aléatoire par le bouton Définir l’ID aléatoire. Authentification requise à l’aide d’une clé principale de carte.
La carte renvoie un ID aléatoire de 4 octets au lieu d’un ID unique de 7 octets.
Attention : cette opération est irréversible.
Lorsque cette option est activée, l’UID peut être lu par une commande spéciale qui nécessite une authentification à l’aide d’une clé valide.
1.10. Serrure à clé interne (8)
Vous devez entrer un mot de passe (8 caractères) pour l’inscription à la clé de verrouillage. Le mot de passe d’usine est « 11111111 ».
1.11. Déverrouillage de la clé interne (9)
Pour déverrouiller la possibilité d’inscrire des clés dans le lecteur, vous devez entrer le même mot de passe pour déverrouiller les clés qui sont entrées pour verrouiller l’inscription des clés. Le mot de passe d’usine est « 11111111 »
1.12. Définir le débit en bauds (a)
Après avoir activé l'option 'Définir le débit en bauds'en appuyant sur 'a' sur le clavier, vous verrez plusieurs choix à choisir pour l'émetteur-récepteur et la réception du débit en bauds. Entrez simplement le numéro à côté de l’option que vous souhaitez choisir.
1.13. Obtenir un débit en bauds (b)
Lire les valeurs d’émission et de réception du débit en bauds du lecteur.
1.14. Stocker la clé dans le lecteur (c)
Le premier choix est le type de clé.
Par exemple, choisissez la touche 3K3DES. 0x010203040506070809101112131415161718192021222324 clés.
L’index de clé interne est 0. Pour les clés 3K3DES, deux champs clés du lecteur seront occupés. Dans ce cas 0 et 1. Le premier index de clé libre est 2. Pour les autres types de clés, un seul champ de clé sera utilisé.
1.15. Changer la clé (d)
Modification du maître de carte, du maître d’application et des clés utilisateur. Lorsque vous modifiez la clé principale, modifiez peut-être le type de clé et la valeur de la clé. Dans l’application, toutes les clés sont du même type et les types de clés ne sont pas modifiés.
Par exemple, remplacez la clé principale par le type 3K3DES et la valeur 0x010203040506070809101112131415161718192021222324.
1.16. Modifier le paramètre de clé (e)
Pour modifier les paramètres de clé, lisez attentivement les paramètres disponibles et choisissez-en un. Faites attention au réglage que vous avez choisi, certains d’entre eux ne peuvent plus être modifiables. Si vous modifiez les paramètres de AID 000000 – IL NE PEUT PAS ÊTRE FORMATÉ.
1.17. Obtenir le paramètre clé (f)
Lire les paramètres de la clé principale de la carte ou de la clé principale de l’application et un nombre maximal de clés d’application. Par exemple, lisez les paramètres de la clé principale de la carte.
1.18. Présenter une demande (g)
Par exemple, créez une application avec des clés AES. AID = 0xA10000. Clé maximale numéro 3.
1.19. Supprimer la demande h)
Entrez AID à supprimer.
1.20. Créer un fichier (j)
Dans le fichier de configuration, définissez l’AID et la clé principale de l’application.
Par exemple, créez un fichier de données standard, taille 100 octets, une communication chiffrée.
Exemple : Créez un fichier de valeurs. La limite inférieure est 0, la limite supérieure est 200 et la valeur initiale est 100. Mode de communication chiffré.
Exemple : Créez un fichier d’enregistrement linéaire. La taille de l’enregistrement est de 100 et le nombre maximal d’enregistrements est de 3, mode de communication chiffré.
1.21. Supprimer le fichier (k)
Dans le fichier de configuration, définissez l’AID et la clé principale de l’application. Entrez l’ID de fichier pour la suppression.
1.22. Écrire un fichier Std ou un enregistrement (l)
Dans le fichier de configuration, définissez l’AID, la clé d’application pour l’accès en écriture ou en lecture et en écriture et l’ID de fichier.
Par exemple, écrivez du texte dans un fichier de données standard, mode de communication chiffré. Le texte est lu à partir du fichier write.txt. La taille du texte doit être inférieure ou égale à la taille du fichier.
Exemple : Écrivez un fichier d’enregistrement.
1.23. Lire le fichier Std ou les enregistrements (m)
Dans le fichier de configuration, définissez l’AID, la clé principale de l’application et l’ID de fichier.
Par exemple, lire des données à partir de fichiers de données standard, mode de communication chiffré. Les données lues seront enregistrées dans le fichier read.txt.
Exemple : Lire deux enregistrements.
1.24. Fichier de valeur de lecture (n)
Dans le fichier de configuration, définissez la clé d’authentification, AID, le numéro de clé AID pour la lecture et l’ID de fichier.
1.25. Augmenter le fichier de valeur (o)
Dans le fichier de configuration, définissez la clé d’authentification, AID, le numéro de clé AID pour l’accès en lecture et en écriture et l’ID de fichier.
Exemple : Augmentez le fichier de valeurs de 20.
1.26. Fichier de valeur de diminution (p)
Dans le fichier de configuration, définissez la clé d’authentification, AID, le numéro de clé AID pour la lecture, l’accès en écriture ou en lecture&écriture et l’ID de fichier.
Exemple : Diminuez le fichier de valeurs de 20.
1.27. Effacer le fichier d’enregistrement (r)
Dans le fichier de configuration, définissez la clé d’authentification, AID, le numéro de clé AID pour l’accès en lecture et en écriture et l’ID de fichier. Tous les enregistrements du fichier d’enregistrement linéaire ou cyclique seront supprimés.
1.28. Obtenir le(s) DID(s) d’application
Dans le fichier de configuration, définissez la clé d’authentification principale de la carte, AID = 0x000000.
Liens supplémentaires:
Pour parcourir ou télécharger d’autres exemples de logiciels, visitez notre référentiel Gitlab Software.
Pour acheter nos appareils, visitez notre boutique en ligne officielle.
N’hésitez pas à contacter notre support technique si vous avez des questions sur nos exemples de logiciels.
Téléchargement de logiciels
Description
Le logiciel exécutable uFR Shell permet l’exécution en ligne de commande pour les périphériques de la série μFR en mode console.