Contents
- 1 uFR Shell Environment – Interpreter komandne linije
uFR Shell je softverski interfejs komandne linije za izvršavanje hardverskih komandi μFR serije na više operativnih sistema. Kao što naslov softvera sugeriše, ovo je shell okruženje sa skupom varijabli definisanih μFR bibliotekama čitača.
Docs & Software Download
Pregled softvera
Softverske funkcije:
- Skup funkcija definisanih bibliotekama μFR serije i API-jem (Application Programming Interface).
Dostupni programski jezici:
- Izvršni softver
Podržani operativni sistemi, platforme i okruženja:
- Windows OS
- Linux OS
- MAC OS
- Raspberry Pi
Podržane oznake, oznake, kartice:
- MIFARE Mini®
- MIFARE Classic® (1K, 4K, EV1)
- MIFARE Ultralight®
- 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 DNK (413, 424)
Preporučena oprema:
- μFR Nano
- μFR Nano Online
- μFR Classic
- μFR Classic CS
- μFR Advance
- μFR XL
- Osnovni HD (μFR režim kompatibilnosti)
Preuzimanje softvera
Opis
uFR Shell izvršni softver omogućava izvršavanje komandne linije za μFR Series uređaje u konzolnom režimu.
Priručnik za softver
1. uFR Shell – Instalacija i izvršavanje
Download: ufr-shell
Preuzmite i raspakujte softversku datoteku.
Izdvojena korijenska fascikla datoteke sadrži podfascikle sa uFR Shell softverskim izvršnim datotekama za podržane operativne sisteme.
Korijenska fascikla također sadrži listu softverskih funkcija i dodatne instrukcije.
Ako ste ispravno instalirali hardver i srodne pogonske programe , sada možete odabrati i pokrenuti izvršnu datoteku za vaš trenutni operativni sistem.
2. uFR Shell – Interfejs komandne linije
Bez obzira na operativni sistem, uFR Shell softver radi kao komandni terminal. Verzija softvera prikazuje se u prvoj liniji ekrana.
uFR Shell – Softverske funkcije
Da biste koristili uFR Shell softver za izvršavanje komandi na uFR uređaju, morate imati uvid u sve dostupne funkcije. Listu funkcija možete pronaći u osnovnoj fascikli softvera, datoteci UFR-Shell_list-of-functions.txt.
Molimo vas da pronađete više detalja, kao i uputstva za implementaciju funkcija i primenu u API dokumentima.
3.1 – uFR Shell – Izvršavanje komandne linije
Da biste izabrali pravu funkciju za komandnu liniju, preporučujemo da prvo proučite pomoć funkcije sa svim opisom funkcija.
3.2 – uFR Shell – Primjeri izvršavanja komandne linije
Da vidimo kako to ide.
Prvo, moramo uspostaviti komunikaciju sa povezanim μFR čitačem. Dakle, naša prva komanda će biti ReaderOpen.
Ukucajte komandu:
- Otvori čitač
Ako je status čitaoca u redu, možemo nastaviti. U suprotnom, molimo vas da proverite da li ste ispravno instalirali hardver.
EXAMPLE 1
Da biste dobili serijski broj hardvera, koristite komandu:
- GetReaderSerialNumber
Ako komanda nema definisane dodatne parametre, podrazumevani izlaz ima HEX format.
EXAMPLE 2
Da biste dobili izlaz podataka u nekom drugom formatu, potrebno je da navedete režim izlaznog formata među dostupnim:
- heksadecimalni (parametar h),
- String (parametar s)
- Decimalni (parametar d).
Komandna linija za navedeni format izlaza sada će imati dva elementa:
- 'Funkcija' ' parametarski mod.'
EXAMPLE 3
Kao i kod serijskog broja čitača, da biste dobili podrazumevani izlaz ID kartice, jednostavno koristite komandu:
- GetCardIdEx
Za ovu komandnu liniju, konzola će prikazati tip kartice, UID i UID izlaz u podrazumevanom HEX formatu.
EXAMPLE 4
Izlaz ID kartice ima izlazne vrijednosti stabla. Prethodni primer prikazuje izlaz ID kartice bez definisanog režima parametara u komandnoj liniji
Ovaj primer objašnjava kako da dobijete mešoviti izlazni format. uFR Shell vam omogućava da definišete određeni režim parametara za svaku izlaznu vrednost.
Komandna linija treba da izgleda ovako:
-
- 'Funkcija' '1. parametarski mod' '2. parametarski mod' '3. parametarski mod'
EXAMPLE 5
Ako ne definišete sve parametre u komandnoj liniji, format izlaznog volumena bez dodeljenog režima parametara će zadržati HEX format (podrazumevano).
Komandna linija za očekivane vrednosti stabla i unapred definisane režime sa dva parametra ima sledeću strukturu:
- 'Funkcija' '1. parametarski mod' '2. parametarski mod'
Odeljak 3.2 objašnjava kako definisati format izlazne vrednosti za određeni parametar. Međutim, ako želite da često dobijate izlaz u neheksadecimalnom formatu, možete da promenite podrazumevani format za sve izlazne vrednosti umesto da svaki parametar definišete zasebno.
Za stalnu promjenu formata izlaza (dok se trenutna konzola ne zatvori), pokrenite komandnu liniju:
- Postavi Izlaz 'novi način parametara'
Snimak ekrana iznad prikazuje podrazumevani format ulazne vrednosti unapred podešen na String (parametar s).
EXAMPLE 1
Pokrenite test sa jednostavnom komandnom linijom:
- GetCardIdEx
Sada su izlazni rezultati vrednosti niza, iako komandna linija nema definisan dodatni režim parametara.
Kao što vidite, sve izlazne vrednosti su vrednosti niza sa znakom Backslash () na mestu njihovog prvog karaktera. Softver automatski dodaje ovaj znak izlaznim vrijednostima koje sadrže znakove koji se ne mogu ispisati.
EXAMPLE 2
Sledeći primer prikazuje izlaz niske kada se vrednost može odštampati.
Upišite sadržaj na karticu samo sa karakterima koji se mogu štampati.
Primjer komandne linije je:
- Članci tagovani sa: "Example-Test"
Napomena: Sadržaj niske koji se snima zapisan je navodnicima u komandnoj liniji.
Procitaj proizvodjac sadrzaja. Komandna linija je:
-
- ReadUserData
U ovom slučaju, izlaz nema Backslash karakter na početku. Ostali izlazni sadržaj ( prateći prethodno snimljeni sadržaj) su zadane vrijednosti – neiskorišteni bajtovi prikazani kao xFF vrijednosti.
4. uFR Shell – Razlike u implementaciji u podržanim OS okruženjima
- Windows OS – Implementacija na Windows sistemu ne zahtijeva dodatne dozvole za rad sa funkcijama uFR Shell. Dovoljno je pravilno instalirati ufr čitač i njegove biblioteke.
- Linux OS – Kao i obično u Linux sistemu, puna funkcionalnost uFR Shell softvera u komunikaciji sa uređajem zahtijeva odgovarajuću korisničku dozvolu.
- MacOS – Da biste osigurali trenutnu funkcionalnost softvera na ovom OS-u, kopirajte libuRCoder.dylib biblioteku u fasciklu sistemskih biblioteka.
Ovaj priručnik predstavlja softverske primere sa nekoliko osnovnih funkcija. Popis svih podržanih funkcija uključen je u paket za preuzimanje softvera.