Contents
uFR Shell ist eine Befehlszeilen-Softwareschnittstelle für die Ausführung von Hardwarebefehlen der μFR-Serie auf mehreren Betriebssystemen. Wie der Softwaretitel andeutet, handelt es sich um eine Shell-Umgebung mit einer Reihe von Variablen, die von den μFR-Reader-Bibliotheken definiert werden.
Die ausführbare uFR Shell-Software ermöglicht die Befehlszeilenausführung für Geräte der μFR-Serie im Konsolenmodus.
Download: ufr-shell
Laden Sie die Softwaredatei herunter und entpacken Sie sie.
Der extrahierte Dateistammordner enthält die Unterordner mit uFR Shell Software Executive Files für unterstützte Betriebssysteme.
Der Stammordner enthält auch die Liste der Softwarefunktionen und zusätzliche Anweisungen.
Wenn Sie Ihre Hardware und die zugehörigen Treiber korrekt installiert haben, können Sie jetzt die ausführbare Datei für Ihr aktuelles Betriebssystem auswählen und ausführen.
Unabhängig vom Betriebssystem läuft die uFR Shell Software als Command Terminal. Die Softwareversion wird in der ersten Zeile des Bildschirms angezeigt.
Um die uFR Shell Software für die Ausführung der Befehle auf Ihrem uFR-Gerät nutzen zu können, benötigen Sie Einblick in alle verfügbaren Funktionen. Sie finden die Funktionsliste im Software-Stammordner, Datei UFR-Shell_list-of-functions.txt.
Weitere Details sowie Anweisungen zur Implementierung und Anwendung von Funktionen finden Sie in API Docs.
Um die richtige Funktion für Ihre Befehlszeile auszuwählen, empfehlen wir Ihnen, zuerst die Funktionshilfe mit allen Funktionsbeschreibungen zu lesen.
Lassen Sie uns nun sehen, wie es funktioniert.
Zuerst müssen wir die Kommunikation mit dem angeschlossenen μFR-Lesegerät herstellen. Unser erster Befehl wird also ReaderOpen sein.
Geben Sie den folgenden Befehl ein:
Wenn der Leserstatus in Ordnung ist, können wir fortfahren. Ansonsten überprüfen Sie bitte, ob Sie Ihre Hardware korrekt installiert haben.
Verwenden Sie den folgenden Befehl, um die Seriennummer der Hardware abzurufen:
Wenn für den Befehl keine zusätzlichen Parameter definiert sind, hat die Standardausgabe ein HEX-Format.
Um die Datenausgabe in einem anderen Format zu erhalten, müssen Sie den Ausgabeformatmodus unter den verfügbaren angeben:
Die Befehlszeile für das angegebene Ausgabeformat besteht nun aus zwei Elementen:
Wie bei der Seriennummer des Lesegeräts verwenden Sie einfach den folgenden Befehl, um die Standardausgabe der Karten-ID zu erhalten:
Für diese Befehlszeile zeigt die Konsole den Kartentyp, die UID und die UID-Ausgabe im Standard-HEX-Format an.
Die Karten-ID-Ausgabe hat Baumausgabewerte. Das vorherige Beispiel zeigt die Karten-ID-Ausgabe ohne definierten Parametermodus in der Befehlszeile
In diesem Beispiel wird erläutert, wie Sie ein gemischtes Ausgabeformat erhalten. Mit der uFR Shell können Sie den spezifischen Parametermodus für jeden Ausgabewert definieren.
Die Befehlszeile sollte wie folgt aussehen:
Wenn Sie nicht alle Parameter in Ihrer Befehlszeile definieren, behält das Ausgabevolumenformat ohne den zugewiesenen Parametermodus das HEX-Format (Standard) bei.
Die Befehlszeile für erwartete Baumwerte und vordefinierte Modi mit zwei Parametern hat die folgende Struktur:
In Abschnitt 3.2 wird erläutert, wie das Ausgabewertformat für einen angegebenen Parameter definiert wird. Wenn Sie die Ausgabe jedoch häufig in einem nicht-hexadezimalen Format erhalten müssen, können Sie das Standardformat für alle Ausgabewerte ändern, anstatt jeden Parameter separat zu definieren.
Führen Sie für die permanente Änderung des Ausgabeformats (bis die aktuelle Konsole geschlossen ist) die Befehlszeile aus:
Die Abbildung oben zeigt das Standard-Eingabewertformat, das auf String (Parameter s) voreingestellt ist.
Lassen Sie uns nun den Test mit der einfachen Befehlszeile ausführen:
Jetzt sind die Ausgabeergebnisse Zeichenfolgenwerte, obwohl die Befehlszeile keinen zusätzlichen Parametermodus definiert hat.
Wie Sie sehen können, handelt es sich bei allen Ausgabewerten um Zeichenfolgenwerte mit dem umgekehrten Schrägstrich () an der Stelle ihres ersten Zeichens. Die Software fügt dieses Zeichen automatisch zu den Ausgabewerten hinzu, die die nicht druckbaren Zeichen enthalten.
Im nächsten Beispiel wird die Zeichenfolgenausgabe dargestellt, wenn der Wert druckbar ist.
Schreiben wir den Inhalt nur mit druckbaren Zeichen in die Karte.
Die Beispielbefehlszeile lautet:
Hinweis: Der aufzuzeichnende Zeichenfolgeninhalt wird in der Befehlszeile in Anführungszeichen geschrieben.
Lesen Sie nun die Inhaltsausgabe. Die Befehlszeile lautet:
In diesem Fall hat die Ausgabe am Anfang keinen umgekehrten Schrägstrich. Der Rest des Ausgabeinhalts (nach dem zuvor aufgezeichneten Inhalt) sind Standardwerte – nicht verwendete Bytes, die als xFF-Werte angezeigt werden.
Dieses Handbuch stellt Softwarebeispiele mit mehreren wesentlichen Funktionen vor. Eine Liste aller unterstützten Funktionen ist im Software-Download-Paket enthalten.
