uFR Shell környezet – parancssori értelmező

NFC RFID olvasó író parancssori szoftver

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.

Szoftver

Készülékszoftver

Könyvtárak

COM-jegyzőkönyv

Oktatóvideó

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 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

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. 

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ú.

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."

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.

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"

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.

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.

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.

Otthon

HARDVER TERMÉKEK

SDK SZOFTVER