Contents
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.
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.
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.
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.
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.
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.
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:
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:
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:
A megadott kimeneti formátum parancssora mostantól két elemből áll:
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:
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:
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ő:
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:
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:
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ő:
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ő:
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.
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.
