Environnement shell uFR – Interpréteur de ligne de commande

Logiciel de ligne de commande NFC RFID Reader Writer

uFR Shell est une interface logicielle en ligne de commande pour l’exécution de commandes matérielles de la série μFR sur plusieurs systèmes d’exploitation. Comme le titre du logiciel le suggère, il s’agit d’un environnement shell avec un ensemble de variables définies par les bibliothèques de lecteurs μFR.

Docs & Software Download

Présentation du logiciel

Fonctions logicielles :
Langages de programmation disponibles :
  • Logiciel exécutable
Systèmes d’exploitation, plates-formes et environnements pris en charge :
  • Système d’exploitation Windows
  • Système d’exploitation Linux
  • MAC OS
  • Pi framboise
Balises, étiquettes, cartes prises en charge :
  • MIFARE Mini®
  • MIFARE Classic® (1K, 4K, EV1)
  • MIFARE Ultraléger®
  • MIFARE Ultralight C®
  • MIFARE Plus® (2K, 4K)
  • MIFARE DESFire® (Léger, 2K, 4K, 8K, EV1, EV2)
  • NXP NTAG® 21x (210, 213, 215, 216, Tag Tamper)
  • ADN NXP NTAG® 4xx (413, 424)
Matériel recommandé :
  • μFR Nano
  • μFR Nano en ligne
  • μFR Classique
  • μFR Classic CS
  • μFR Avance
  • μFR XL
  • HD de base (mode de compatibilité μFR)
ufr shell home screen
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.

Manuel du logiciel

1. uFR Shell – Installer et exécuter

Télécharger: ufr-shell

Téléchargez et décompressez le fichier logiciel.

Le dossier racine du fichier extrait contient les sous-dossiers contenant les fichiers exécutifs du logiciel uFR Shell pour les systèmes d’exploitation pris en charge.

Le dossier racine contient également la liste des fonctions logicielles et des instructions supplémentaires.

Si vous avez correctement installé votre matériel et les pilotes associés, vous pouvez maintenant sélectionner et exécuter le fichier exécutable pour votre système d’exploitation actuel.

urf shell folder

2. uFR Shell – Interface de ligne de commande

Quel que soit le système d’exploitation, le logiciel uFR Shell s’exécute en tant que terminal de commande. La version du logiciel s’affiche dans la première ligne de l’écran.

ufr shell interface

3. uFR Shell – Fonctions logicielles

Pour utiliser le logiciel uFR Shell pour l’exécution des commandes sur votre appareil uFR, vous devez avoir un aperçu de toutes les fonctions disponibles. Vous pouvez trouver la liste des fonctions dans le dossier racine du logiciel, le fichier UFR-Shell_list-of-functions.txt.

Vous trouverez plus de détails, ainsi que des instructions pour l’implémentation et l’application des fonctions dans API Docs.

urf shell functions

3.1 – uFR Shell – Exécution en ligne de commande

Pour sélectionner la fonction adaptée à votre ligne de commande, nous vous recommandons d’étudier d’abord l’aide de la fonction avec toutes les descriptions des fonctions.

urf shell commands 600x342 1

3.2 – uFR Shell – Exemples d’exécution en ligne de commande

Voyons maintenant comment cela fonctionne.

Tout d’abord, nous devons établir une communication avec le lecteur μFR connecté. Donc, notre première commande va être ReaderOpen.
Tapez la commande :

  • ReaderOuvrir
ufr shell rearer open command

Si le statut du lecteur est OK, nous pouvons continuer. Sinon, veuillez vérifier si vous avez installé votre matériel correctement. 

EXAMPLE 1

Pour obtenir le numéro de série du matériel, utilisez la commande :

  • GetReaderSerialNumber
ufr shell rearer sn get command

Si aucun paramètre supplémentaire n’est défini dans la commande, la sortie par défaut a un format HEX.

EXAMPLE 2

Pour obtenir la sortie de données dans un autre format, vous devez spécifier le mode de format de sortie parmi les disponibles:

  • Hexadécimal (paramètre h),
  • Chaîne (paramètre s)
  • Décimal (paramètre d).

La ligne de commande pour le format de sortie spécifié aura maintenant deux éléments :

  • 'Fonction' ' mode paramètre.'
ufr shell rearer sn get modes 1

EXAMPLE 3

Comme pour le numéro de série du lecteur, pour obtenir la sortie par défaut de l’ID de carte, utilisez simplement la commande:

  • GetCardIdEx
ufr shell card id get command

Pour cette ligne de commande, la console affiche le type de carte, l’UID et la sortie UID au format HEX par défaut.

EXAMPLE 4

La sortie CARD ID a des valeurs de sortie d’arborescence. L’exemple précédent montre la sortie Card ID sans mode de paramètre défini dans la ligne
de commande
Cet exemple explique comment obtenir un format de sortie mixte. uFR Shell vous permet de définir le mode de paramètre spécifique pour chaque valeur de sortie.

La ligne de commande doit ressembler à ceci :

    • 'Fonction' '1. mode paramètre' '2. mode paramètre' '3. mode paramètre'
ufr shell card id get modes

EXAMPLE 5

Si vous ne définissez pas tous les paramètres dans votre ligne de commande, le format de volume de sortie sans le mode de paramètre attribué conservera le format HEX (par défaut).
La ligne de commande pour les modes d’arborescence attendus et les modes à deux paramètres prédéfinis a la structure suivante :

  • 'Fonction' '1. mode paramètre' '2. mode paramètre'
ufr shell card id get modes part param

La section 3.2 explique comment définir le format de la valeur de sortie pour un paramètre spécifié. Toutefois, si vous devez obtenir fréquemment la sortie dans un format non hexadécimal, vous pouvez modifier le format par défaut pour toutes les valeurs de sortie au lieu de définir chaque paramètre séparément.

Pour le changement permanent de format de sortie (jusqu’à ce que la console actuelle soit fermée), exécutez la ligne de commande :

  • Définir le mode des nouveaux paramètres de sortie
ufr shell permanent output format change

La capture d’écran ci-dessus montre le format de valeur d’entrée par défaut prédéfini sur String (paramètre s).

EXAMPLE 1

Exécutons maintenant le test avec la ligne de commande simple:

  • GetCardIdEx
ufr shell output format changed example 1

Maintenant, les résultats de sortie sont des valeurs de chaîne même si la ligne de commande n’a pas de mode de paramètre supplémentaire défini.

Comme vous pouvez le voir, toutes les valeurs de sortie sont des valeurs de chaîne avec la barre oblique inverse () à l’endroit de leur premier caractère. Le logiciel ajoute automatiquement ce caractère aux valeurs de sortie contenant les caractères non imprimables.

EXAMPLE 2

L’exemple suivant présente la sortie de chaîne lorsque la valeur est imprimable.
Écrivons le contenu dans la carte avec des caractères imprimables uniquement.

L’exemple de ligne de commande est :

  • WriteUserData « Exemple-Test »
ufr shell write string data

Remarque : Le contenu de la chaîne à enregistrer est écrit entre guillemets dans la ligne de commande.

Maintenant, lisez la sortie de contenu. La ligne de commande est :

    • ReadUserData
ufr shell read data string

Dans ce cas, la sortie n’a pas de barre oblique inverse au début. Le reste du contenu de sortie (après le contenu précédemment enregistré) sont des valeurs par défaut – des octets inutilisés affichés sous forme de valeurs xFF.

4. uFR Shell – Différences d’implémentation dans les environnements de système d’exploitation pris en charge

  • Système d’exploitation Windows – L’implémentation sur le système Windows ne nécessite pas d’autorisations supplémentaires pour fonctionner avec les fonctions uFR Shell. Il suffit d’installer correctement le lecteur ufr et ses bibliothèques.
  • Système d’exploitation Linux – Comme d’habitude dans le système Linux, la fonctionnalité complète du logiciel uFR Shell en communication avec l’appareil nécessite l’autorisation appropriée de l’utilisateur.
  • MacOS – Pour garantir la fonctionnalité logicielle instantanée sur ce système d’exploitation, copiez la bibliothèque libuRCoder.dylib dans le dossier des bibliothèques système.

Ce manuel présente des exemples de logiciels avec plusieurs fonctions essentielles. Une liste de toutes les fonctions prises en charge est incluse dans le package de téléchargement du logiciel.