Az uFR Shell egy parancssori szoftver interfész a μFR sorozatú hardveres parancsok végrehajtásához több operációs rendszeren. Ahogy a szoftver címe is sugallja, ez egy shell környezet, amely a μFR olvasókönyvtárak által meghatározott változók halmazával rendelkezik.
Docs & Software Download
A szoftver áttekintése
Szoftver funkciók:
- A μFR sorozatú könyvtárak és az API (Application Programming Interface) által meghatározott függvények halmaza.
Elérhető programozási nyelvek:
- Végrehajtható szoftver
Támogatott operációs rendszerek, platformok és környezetek:
- Windows operációs rendszer
- Linux operációs rendszer
- MAC operációs rendszer
- Málna Pi
Támogatott címkék, címkék, kártyák:
- MIFARE Mini®
- MIFARE Classic® (1K, 4K, EV1)
- MIFARE ultrakönnyű®
- MIFARE Ultrakönnyű C®
- MIFARE Plusz® (2K, 4K)
- MIFARE DESFire® (Könnyű, 2K, 4K, 8K, EV1, EV2)
- NXP NTAG® 21x (210, 213, 215, 216, Tag Szabotázs)
- NXP NTAG® 4xx DNS (413, 424)
Ajánlott hardver:
- μFR Nano
- μFR Nano Online
- μFR Classic
- μFR Klasszikus CS
- μFR Előre
- μFR XL
- Alap HD (μFR kompatibilitási mód)
Szoftver letöltése
Leírás
Az uFR Shell futtatható szoftver lehetővé teszi a parancssori végrehajtást a μFR sorozatú eszközök számára konzol módban.
Szoftver kézikönyv
1. uFR Shell – Telepítés és végrehajtás
Letöltés: ufr-shell
Töltse le és csomagolja ki a szoftverfájlt.
A kibontott fájl gyökérmappája tartalmazza az almappákat az uFR Shell szoftver végrehajtó fájljaival a támogatott operációs rendszerekhez.
A gyökérmappa tartalmazza a szoftverfunkciók listáját és további utasításokat is.
Ha helyesen telepítette a hardvert és a kapcsolódó illesztőprogramokat , most kiválaszthatja és futtathatja az aktuális operációs rendszer végrehajtható fájlját.
2. uFR Shell – parancssori felület
Az operációs rendszertől függetlenül az uFR Shell szoftver parancsterminálként fut. A szoftververzió a képernyő első sorában jelenik meg.
3. uFR Shell – Szoftver funkciók
Ahhoz, hogy az uFR Shell szoftvert használhassa az uFR eszközön lévő parancsok végrehajtásához, betekintést kell nyernie az összes elérhető funkcióba. A funkciólistát a szoftver gyökérmappájában találja, az UFR-Shell_list-of-functions.txt fájlban.
További részleteket, valamint a függvények implementációjára és alkalmazására vonatkozó utasításokat az API-dokumentumokban találja.
3.1 – uFR Shell – Parancssori végrehajtás
A parancssornak megfelelő függvény kiválasztásához javasoljuk, hogy először tanulmányozza a Függvény súgóját az összes függvény leírásával.
3.2 – uFR Shell – Parancssori végrehajtási példák
Most nézzük meg, hogyan működik.
Először is kommunikációt kell kialakítanunk a csatlakoztatott μFR olvasóval. Tehát az első parancsunk a ReaderOpen lesz.
Írja be a parancsot:
- ReaderOpen
Ha az olvasó állapota rendben van, folytathatjuk. Ellenkező esetben ellenőrizze, hogy megfelelően telepítette-e a hardvert.
EXAMPLE 1
A hardver sorozatszámának lekéréséhez használja a következő parancsot:
- GetReaderSerialNumber
Ha a parancs nem tartalmaz további paramétereket, az alapértelmezett kimenet HEX formátumú.
EXAMPLE 2
Ahhoz, hogy az adatkimenetet más formátumban kapja meg, meg kell adnia a kimeneti formátum módot a rendelkezésre álló lehetőségek között:
- Hexadecimális (h paraméter),
- Karakterlánc (s paraméter)
- Decimális (d paraméter).
A megadott kimeneti formátum parancssora mostantól két elemből áll:
- 'Funkció' paraméter mód."
EXAMPLE 3
Az olvasó sorozatszámához hasonlóan a kártyaazonosító alapértelmezett kimenetének megszerzéséhez egyszerűen használja a következő parancsot:
- GetCardIdEx
Ebben a parancssorban a konzol megjeleníti a kártya típusát, az UID-t és az UID kimenetet alapértelmezett HEX formátumban.
EXAMPLE 4
A Kártyaazonosító kimenet fakimeneti értékekkel rendelkezik. Az előző példa a Kártyaazonosító kimenetet mutatja be meghatározott paramétermód nélkül a parancssorban
Ez a példa bemutatja, hogyan kaphat vegyes kimeneti formátumot. Az uFR Shell lehetővé teszi, hogy minden kimeneti értékhez meghatározza az adott paramétermódot.
A parancssornak így kell kinéznie:
-
- "Funkció" "1. paraméter üzemmód" '2. paraméter üzemmód" '3. paraméter mód"
EXAMPLE 5
Ha nem határozza meg az összes paramétert a parancssorban, a kimeneti kötet formátuma a hozzárendelt paramétermód nélkül megtartja a HEX formátumot (alapértelmezett).
A várt faértékek és az előre definiált kétparaméteres módok parancssorának szerkezete a következő:
- "Funkció" "1. paraméter üzemmód" '2. paraméter mód"
A 3.2. szakasz elmagyarázza, hogyan kell meghatározni egy adott paraméter kimeneti értékformátumát. Ha azonban gyakran nem hexadecimális formátumban kell beszereznie a kimenetet, módosíthatja az összes kimeneti érték alapértelmezett formátumát ahelyett, hogy az egyes paramétereket külön-külön definiálná.
Az állandó kimeneti formátumváltáshoz (amíg az aktuális konzol be nem záródik) futtassa a parancssort:
- Állítsa be a kimenet ' új paraméterek módját'
A fenti képernyőképen az alapértelmezett bemeneti érték formátuma látható Karakterlánc (s paraméter) értékre állítva.
EXAMPLE 1
Most futtassuk a tesztet az egyszerű parancssorral:
- GetCardIdEx
Most a kimeneti eredmények karakterláncértékek, annak ellenére, hogy a parancssorban nincs meghatározva további paramétermód.
Mint látható, az összes kimeneti érték karakterlánc-érték, amelynek első karakterének helyén a Backslash karakter () található. A szoftver automatikusan hozzáadja ezt a karaktert a nem nyomtatható karaktereket tartalmazó kimeneti értékekhez.
EXAMPLE 2
A következő példa a sztring kimenetét mutatja be, amikor az érték nyomtatható.
Írjuk be a tartalmat a kártyára csak nyomtatható karakterekkel.
A példa parancssor a következő:
- WriteUserData "Példa-teszt"
Megjegyzés: A rögzítendő karakterlánc tartalma idézőjelbe van írva a parancssorban.
Most olvassa el a tartalom kimenetét. A parancssor a következő:
-
- ReadUserData
Ebben az esetben a kimenet elején nincs fordított perjel karakter. A kimeneti tartalom többi része (a korábban rögzített tartalmat követve) alapértelmezett érték– a fel nem használt bájtok xFF értékként jelennek meg.
4. uFR Shell – Megvalósítási különbségek a támogatott operációs rendszerek környezeteiben
- Windows operációs rendszer – A Windows rendszeren történő megvalósítás nem igényel további engedélyeket az uFR Shell funkciókkal való együttműködéshez. Elég, ha megfelelően telepíti az ufr olvasót és könyvtárait.
- Linux operációs rendszer – A Linux rendszerben szokásos módon az uFR Shell szoftver teljes funkcionalitása az eszközzel való kommunikáció során megfelelő felhasználói engedélyt igényel.
- MacOS – Az operációs rendszer azonnali szoftverfunkciójának biztosítása érdekében másolja a libuRCoder.dylib könyvtárat a rendszerkönyvtárak mappájába.
Ez a kézikönyv számos alapvető funkcióval rendelkező szoftveres példákat mutat be. Az összes támogatott funkció listáját a szoftverletöltési csomag tartalmazza.