Online Store

uFR Shell-omgeving – Command Line Interpreter

NFC RFID Reader Writer Command Line Software

uFR Shell is een opdrachtregelsoftware-interface voor de uitvoering van hardwareopdrachten uit de μFR-serie op meerdere besturingssystemen. Zoals de softwaretitel al doet vermoeden, is dit een shell-omgeving met een set variabelen die zijn gedefinieerd door de μFR-lezersbibliotheken.

Docs & Software Download

Software Overzicht

Software functies:
Beschikbare programmeertalen:
  • Uitvoerbare software
Ondersteunde besturingssystemen, platforms en omgevingen:
  • Windows-besturingssysteem
  • Linux-besturingssysteem
  • MAC OS
  • Framboos Pi
Ondersteunde tags, labels, kaarten:
  • Mifare Mini®
  • MIFARE Classic® (1K, 4K, EV1)
  • MIFARE Ultralicht®
  • MIFARE Ultralicht C®
  • MIFARE Plus® (2K, 4K)
  • MIFARE DESFire® (Licht, 2K, 4K, 8K, EV1, EV2)
  • NXP NTAG® 21x (210, 213, 215, 216, Tag Tamper)
  • NXP NTAG® 4xx DNA (413, 424)
Aanbevolen hardware:
  • Nano μFR
  • μFR Nano Online |
  • μFR Klassiek
  • μFR Klassieke CS
  • μFR Voorschot
  • μFR XL
  • Base HD (μFR-compatibiliteitsmodus)
ufr shell home screen
Software downloaden
Beschrijving

uFR Shell uitvoerbare software maakt uitvoering van de opdrachtregel mogelijk voor apparaten uit de μFR-serie in consolemodus.

Software handleiding

1. uFR Shell – Installeren en uitvoeren

Downloaden: ufr-shell

Download en pak het softwarebestand uit.

De hoofdmap van het uitgepakte bestand bevat de submappen met uFR Shell-softwarebeheerbestanden voor ondersteunde besturingssystemen.

De hoofdmap bevat ook de lijst met softwarefuncties en aanvullende instructies.

Als u uw hardware en gerelateerde stuurprogramma's correct hebt geïnstalleerd, kunt u nu het uitvoerbare bestand voor uw huidige besturingssysteem selecteren en uitvoeren.

urf shell folder

2. uFR Shell – Opdrachtregelinterface

Ongeacht het besturingssysteem wordt uFR Shell-software uitgevoerd als de commandoterminal. De softwareversie wordt weergegeven in de eerste regel van het scherm.

ufr shell interface

3. uFR Shell – Softwarefuncties

Om de uFR Shell software te gebruiken voor de uitvoering van de commando's op uw uFR apparaat, moet u inzicht hebben in alle beschikbare functies. U kunt de functielijst vinden in de hoofdmap van de software, het bestand UFR-Shell_list-of-functions.txt.

Hier vindt u meer informatie en instructies voor de implementatie en toepassing van functies in API Docs.

urf shell functions

3.1 – uFR Shell – Uitvoering van de opdrachtregel

Als u de juiste functie voor uw opdrachtregel wilt selecteren, raden we u aan eerst de functie help met alle functies beschrijving te bestuderen.

urf shell commands 600x342 1

3.2 – uFR Shell – Voorbeelden van opdrachtregeluitvoering

Laten we nu eens kijken hoe het werkt.

Eerst moeten we communicatie tot stand brengen met de aangesloten μFR-lezer. Dus onze eerste opdracht wordt ReaderOpen.
Typ de opdracht:

  • ReaderOpen
ufr shell rearer open command

Als de lezersstatus OK is, kunnen we doorgaan. Controleer anders of u uw hardware correct hebt geïnstalleerd. 

EXAMPLE 1

Als u het serienummer van de hardware wilt ophalen, gebruikt u de opdracht:

  • GetReaderSerialNumber
ufr shell rearer sn get command

Als voor de opdracht geen aanvullende parameters zijn gedefinieerd, heeft de standaarduitvoer een HEX-indeling.

EXAMPLE 2

Om de gegevensuitvoer in een ander formaat te krijgen, moet u de uitvoerformaatmodus opgeven die beschikbaar is:

  • Hexadecimaal (parameter h),
  • Tekenreeks (parameter s)
  • Decimaal (parameter d).

De opdrachtregel voor het opgegeven uitvoerformaat heeft nu twee elementen:

  • 'Functie' ' parametermodus.'
ufr shell rearer sn get modes 1

EXAMPLE 3

Net als bij het serienummer van de lezer, gebruikt u de opdracht om de standaarduitvoer van de kaart-ID te krijgen:

  • GetCardIdEx
ufr shell card id get command

Voor deze opdrachtregel geeft de console het kaarttype, de UID- en UID-uitvoer weer in de standaard HEX-indeling.

EXAMPLE 4

De uitvoer van de kaart-ID heeft tree-uitvoerwaarden. In het vorige voorbeeld wordt de kaart-ID-uitvoer weergegeven zonder gedefinieerde parametermodus op de opdrachtregel
In dit voorbeeld wordt uitgelegd hoe u een gemengd uitvoerformaat kunt krijgen. uFR Shell stelt u in staat om de specifieke parametermodus voor elke uitvoerwaarde te definiëren.

De opdrachtregel zou er als volgt uit moeten zien:

    • 'Functie' '1. parametermodus' '2. parametermodus' '3. parametermodus"
ufr shell card id get modes

EXAMPLE 5

Als u niet alle parameters op uw opdrachtregel definieert, behoudt de uitvoervolumeindeling zonder de toegewezen parametermodus de HEX-indeling (standaard).
De opdrachtregel voor verwachte boomwaarden en vooraf gedefinieerde modus met twee parameters heeft de volgende structuur:

  • 'Functie' '1. parametermodus' '2. parametermodus"
ufr shell card id get modes part param

In paragraaf 3.2 wordt uitgelegd hoe u de uitvoerwaardenotatie voor een opgegeven parameter definieert. Als u de uitvoer echter vaak in een niet-hexadecimale indeling moet ophalen, kunt u de standaardindeling voor alle uitvoerwaarden wijzigen in plaats van elke parameter afzonderlijk te definiëren.

Voor de wijziging van het permanente uitvoerformaat (totdat de huidige console is gesloten), voert u de opdrachtregel uit:

  • Stel output 'nieuwe parameters modus' in
ufr shell permanent output format change

De bovenstaande schermafbeelding toont de standaardinvoerwaarde-indeling voorinstelling string (parameter s).

EXAMPLE 1

Laten we nu de test uitvoeren met de eenvoudige opdrachtregel:

  • GetCardIdEx
ufr shell output format changed example 1

Nu zijn de uitvoerresultaten tekenreekswaarden, ook al is er op de opdrachtregel geen extra parametermodus gedefinieerd.

Zoals u kunt zien, zijn alle uitvoerwaarden tekenreekswaarden met het backslashteken () op de plaats van het eerste teken. De software voegt dit teken automatisch toe aan de uitvoerwaarden die de niet-afdrukbare tekens bevatten.

EXAMPLE 2

In het volgende voorbeeld wordt de tekenreeksuitvoer weergegeven wanneer de waarde afdrukbaar is.
Laten we de inhoud op de kaart schrijven met alleen afdrukbare tekens.

De voorbeeld opdrachtregel is:

  • WriteUserData "Voorbeeld-Test"
ufr shell write string data

Opmerking: De tekenreeksinhoud die moet worden vastgelegd, wordt tussen aanhalingstekens op de opdrachtregel geschreven.

Lees nu de inhoudsuitvoer. De opdrachtregel is:

    • ReadUserData
ufr shell read data string

In dit geval heeft de uitvoer aan het begin geen Backslash-teken. De rest van de uitvoerinhoud (na de eerder opgenomen inhoud) zijn standaardwaarden: ongebruikte bytes die worden weergegeven als xFF-waarden.

4. uFR Shell – Implementatieverschillen in ondersteunde OS-omgevingen

  • Windows-besturingssysteem : implementatie op het Windows-systeem vereist geen extra machtigingen om met uFR Shell-functies te werken. Het is voldoende om de ufr-lezer en zijn bibliotheken correct te installeren.
  • Linux OS – Zoals gebruikelijk in het Linux-systeem, vereist de volledige functionaliteit van de uFR Shell-software in communicatie met het apparaat de juiste toestemming van de gebruiker.
  • MacOS – Om de directe softwarefunctionaliteit op dit besturingssysteem te garanderen, kopieert u de libuRCoder.dylib-bibliotheek naar de map systeembibliotheken.

Deze handleiding presenteert softwarevoorbeelden met verschillende essentiële functies. Een lijst met alle ondersteunde functies is opgenomen in het softwaredownloadpakket.