uFR Shell je softversko sučelje naredbenog retka za izvršavanje hardverskih naredbi serije μFR na više operacijskih sustava. Kao što naslov softvera sugerira, ovo je okruženje ljuske s nizom varijabli definiranih bibliotekama čitača μFR.
Docs & Software Download
Pregled softvera
Softverske funkcije:
- Skup funkcija definiranih bibliotekama serije μFR i API-jem (Sučelje za programiranje aplikacija).
Dostupni programski jezici:
- Izvršni softver
Podržani operativni sustavi, platforme i okruženja:
- Windows OS
- Linux OS
- MAC OS
- Malina Pi
Podržane oznake, naljepnice, kartice:
- MIFARE Mini®
- MIFARE Classic® (1K, 4K, EV1)
- MIFARE ultralaka svjetiljka®
- MIFARE Ultralight C®
- MIFARE Plus® (2K, 4K)
- MIFARE DESFire® (Light, 2K, 4K, 8K, EV1, EV2)
- NXP NTAG® 21x (210, 213, 215, 216, Tag Tamper)
- NXP NTAG® 4xx DNA (413, 424)
Preporučeni hardver:
- μFR Nano
- μFR Nano Online
- μFR Classic
- μFR Classic CS
- μFR Advance
- μFR XL
- Base HD (način kompatibilnosti s μFR-om)
Preuzimanje softvera
Opis
izvršni softver uFR Shell omogućuje izvršavanje naredbenog retka za uređaje serije μFR u konzolnom načinu rada.
Priručnik za softver
1. uFR Shell – Instalirajte i izvršite
Preuzimanje: ufr-shell
Preuzmite i raspakirajte softversku datoteku.
Mapa korijena izdvojene datoteke sadrži podmape s izvršnim datotekama softvera UFR Shell za podržane operativne sustave.
Korijenska mapa također sadrži popis softverskih funkcija i dodatne upute.
Ako ste ispravno instalirali hardver i povezane upravljačke programe , sada možete odabrati i pokrenuti izvršnu datoteku za trenutni operacijski sustav.
2. uFR Shell – Sučelje naredbenog retka
Bez obzira na operativni sustav, softver uFR Shell radi kao zapovjedni terminal. Verzija softvera prikazuje se u prvom retku zaslona.
3. uFR Shell – Softverske funkcije
Da biste koristili softver uFR Shell za izvršavanje naredbi na vašem uFR uređaju, morate imati uvid u sve dostupne funkcije. Popis funkcija možete pronaći u korijenskoj mapi softvera, datoteci UFR-Shell_list funkcija.txt.
Molimo, pronađite više detalja, kao i upute za implementaciju funkcija i primjenu u API docs.
3.1 – uFR Shell – Izvršavanje naredbenog retka
Da biste odabrali pravu funkciju za naredbeni redak, preporučujemo da najprije proučite pomoć za funkciju sa svim opisom funkcija.
3.2 – uFR Shell – Primjeri izvršenja naredbenog retka
Da vidimo kako to ide.
Prvo moramo uspostaviti komunikaciju s povezanim μFR čitačem. Dakle, naša prva zapovijed će biti ReaderOpen.
Upišite naredbu:
- ReaderOpen
Ako je status čitatelja u redu, možemo nastaviti. U suprotnom provjerite jeste li ispravno instalirali hardver.
EXAMPLE 1
Da biste dobili serijski broj hardvera, koristite naredbu:
- GetReaderSerialNumber
Ako naredba nema definiranih dodatnih parametara, zadani izlaz ima HEX oblik.
EXAMPLE 2
Da biste dobili izlaz podataka u nekom drugom formatu, morate navesti način izlaznog oblika među dostupnim:
- Heksadecimal (parametar h),
- Niz (parametar s)
- Decimalni broj (parametar d).
Naredbeni redak za navedeni izlazni oblik sada će imati dva elementa:
- 'Funkcija' ' način parametra.'
EXAMPLE 3
Kao i kod serijskog broja čitača, da biste dobili zadani izlaz ID kartice, jednostavno upotrijebite naredbu:
- GetCardIdEx
Za ovaj naredbeni redak konzola će prikazati izlaz vrste kartice, UID-a i UID-a u zadanom HEX formatu.
EXAMPLE 4
Izlaz ID kartice ima izlazne vrijednosti stabla. Prethodni primjer prikazuje izlaz ID kartice bez definiranog načina parametra u naredbenom retku
Ovaj primjer objašnjava kako dobiti mješoviti izlazni format.
Naredbeni redak trebao bi izgledati ovako:
-
- 'Funkcija' '1. način parametra' '2. način parametra' '3. način parametra"
EXAMPLE 5
Ako ne definirate sve parametre u naredbenom retku, oblik izlazne glasnoće bez dodijeljenog načina parametra zadržat će HEX format (zadano).
Očekivani naredbeni redak za vrijednosti stabla i unaprijed definirane načine rada s dva parametra ima sljedeću strukturu:
- 'Funkcija' '1. način parametra' '2. način parametra"
Odjeljak 3.2 objašnjava kako definirati oblik izlazne vrijednosti za određeni parametar. Međutim, ako trebate često dobivati izlaz u ne-heksadecimalnom formatu, možete promijeniti zadani oblik za sve izlazne vrijednosti umjesto da svaki parametar definirate zasebno.
Za trajnu promjenu izlaznog oblika (dok se trenutna konzola ne zatvori), pokrenite naredbeni redak:
- Postavi izlaz "novi način rada s parametrima"
Gornja snimka zaslona prikazuje zadani oblik ulazne vrijednosti unaprijed postavljen na Niz (parametri s).
EXAMPLE 1
Pokrenimo sada test jednostavnim naredbenim retkom:
- GetCardIdEx
Sada su izlazni rezultati vrijednosti niza iako naredbeni redak nema definiran dodatni parametarski način rada.
Kao što možete vidjeti, sve izlazne vrijednosti su vrijednosti niza sa znakom obrnute kose crte () na mjestu prvog znaka. Softver automatski dodaje ovaj znak izlaznim vrijednostima koje sadrže znakove koji se ne mogu ispisati.
EXAMPLE 2
Sljedeći primjer predstavlja izlaz niza kada se vrijednost može ispisati.
Napišimo sadržaj u karticu samo s ispisivim znakovima.
Primjer naredbenog retka je:
- WriteUserData "Primjer-test"
Napomena: Sadržaj niza koji treba snimiti zapisuje se navodnicima u naredbenom retku.
Sada pročitajte izlaz sadržaja. Naredbeni redak je:
-
- ReadUserData
U ovom slučaju, izlaz na početku nema znak obrnute kose crte. Ostatak izlaznog sadržaja ( nakon prethodno snimljenog sadržaja) zadane su vrijednosti – neiskorišteni bajtovi prikazani kao xFF vrijednosti.
4. uFR Shell – Razlike u implementaciji u podržanim okruženjima OS-a
- Windows OS – Implementacija na Windows sustavu ne zahtijeva dodatne dozvole za rad s funkcijama uFR Shell. Dovoljno je pravilno instalirati čitač ufr-a i njegove knjižnice.
- Linux OS – Kao i obično u Linux sustavu, puna funkcionalnost uFR Shell softvera u komunikaciji s uređajem zahtijeva odgovarajuće dopuštenje korisnika.
- MacOS – Da biste osigurali trenutnu funkcionalnost softvera na ovom OS-u, kopirajte biblioteku libuRCoder.dylib u mapu biblioteke sustava.
Ovaj priručnik predstavlja softverske primjere s nekoliko bitnih funkcija. Popis svih podržanih funkcija uključen je u paket za preuzimanje softvera.
