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:
- Een reeks functies die worden gedefinieerd door bibliotheken uit de μFR-serie en API (Application Programming Interface).
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)
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.
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.
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.
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.
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
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
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.'
EXAMPLE 3
Net als bij het serienummer van de lezer, gebruikt u de opdracht om de standaarduitvoer van de kaart-ID te krijgen:
- GetCardIdEx
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"
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"
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
De bovenstaande schermafbeelding toont de standaardinvoerwaarde-indeling voorinstelling string (parameter s).
EXAMPLE 1
Laten we nu de test uitvoeren met de eenvoudige opdrachtregel:
- GetCardIdEx
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"
Opmerking: De tekenreeksinhoud die moet worden vastgelegd, wordt tussen aanhalingstekens op de opdrachtregel geschreven.
Lees nu de inhoudsuitvoer. De opdrachtregel is:
-
- ReadUserData
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.
