uFR Shell Environment – Interpretor de linie de comandă

NFC RFID Reader Writer Linie de comandă Software-ul

uFR Shell este o interfață software de linie de comandă pentru executarea comenzilor hardware din seria μFR pe mai multe sisteme de operare. După cum sugerează și titlul software-ului, acesta este un mediu shell cu un set de variabile definite de bibliotecile de cititori μFR.

Software

Firmware

Biblioteci

Protocolul COM

Video Tutorial

Prezentare generală a software-ului

Functii software:

• Un set de funcții definite de bibliotecile din seria μFR și API (Application Programming Interface).

Limbaje de programare disponibile:

• Software executabil

Sisteme de operare, platforme și medii acceptate:

• Sistem de operare Windows
• Sistem de operare Linux
• MAC OS
• Zmeura Pi

Etichete, etichete, carduri acceptate:

• MIFARE Mini®
• MIFARE Classic® (1K, 4K, EV1)
• MIFARE Ultralight®
• MIFARE Ultralight C®
• MIFARE Plus® (2K, 4K)
• MIFARE DESFire® (Ușor, 2K, 4K, 8K, EV1, EV2)
• NXP NTAG® 21x (210, 213, 215, 216, Tag Tamper)
• NXP NTAG® 4xx ADN (413, 424)

Hardware recomandat:

• μFR Nano
• μFR Nano Online
• μFR Clasic
• μfr Clasic CS
• μFR Advance
• μfr XL
• Base HD (modul de compatibilitate μFR)

Software Manual

1. uFR Shell – Instalați și executați

Descarca: ufr-shell

Descărcați și despachetați fișierul software.

Folderul rădăcină de fișier extras conține subfolderele cu fișiere executive software uFR Shell pentru sistemele de operare acceptate.

Folderul rădăcină conține, de asemenea, lista de funcții software și instrucțiuni suplimentare.

Dacă ați instalat corect hardware-ul și driverele asociate, acum puteți selecta și rula fișierul executabil pentru sistemul de operare curent.

2. uFR Shell – interfață de linie de comandă

Indiferent de sistemul de operare, software-ul uFR Shell rulează ca terminal de comandă. Versiunea software se afișează în prima linie a ecranului.

3. uFR Shell – Funcții software

Pentru a utiliza software-ul uFR Shell pentru executarea comenzilor de pe dispozitivul uFR, trebuie să aveți o perspectivă asupra tuturor funcțiilor disponibile. Puteți găsi lista de funcții în folderul rădăcină al software-ului, fișierul UFR-Shell_list-of-functions.txt.

Vă rugăm să găsiți mai multe detalii, precum și pentru instrucțiuni pentru implementarea și aplicarea funcțiilor în DOCUMENTELE API.

3.1 – uFR Shell – Executarea liniei de comandă

Pentru a selecta funcția potrivită pentru linia de comandă, vă recomandăm să studiați mai întâi ajutorul funcției cu toate funcțiile descrise.

3.2 – uFR Shell – Exemple de execuție a liniei de comandă

În primul rând, trebuie să stabilim comunicarea cu cititorul μFR conectat. Deci, prima noastră comandă va fi ReaderOpen.
Tastați comanda:

• ReaderDeschide

Dacă starea cititorului este OK, putem continua. În caz contrar, vă rugăm să verificați dacă ați instalat corect hardware-ul. 

Pentru a obține numărul de serie hardware, utilizați comanda:

• GetReaderSerialNumber

Dacă comanda nu are parametri suplimentari definiți, ieșirea implicită are un format HEX.

Pentru a obține ieșirea datelor într-un alt format, trebuie să specificați modul de format de ieșire dintre cele disponibile:

• hexazecimal (parametrul h),
• Șir (parametrul s)
• Zecimal (parametrul d).

Linia de comandă pentru formatul de ieșire specificat va avea acum două elemente:

• 'Funcție' ' modul parametru."

Ca și în cazul numărului de serie Reader, pentru a obține ieșirea implicită a ID-ului cardului, pur și simplu utilizați comanda:

• GetCardIdEx

Pentru această linie de comandă, consola va afișa tipul cardului, UID și ieșirea UID în format HEX implicit.

Ieșirea ID card are valori de ieșire arborescente. Exemplul anterior arată ieșirea ID card fără modul parametru definit în linia
de comandăAcest exemplu explică cum să obțineți un format de ieșire mixt. uFR Shell vă permite să definiți modul parametru specific pentru fiecare valoare de ieșire.

Linia de comandă ar trebui să arate astfel:

• • "Funcția" "1. modul parametrului" "2. modul parametrului" "3. mod parametru'

Dacă nu definiți toți parametrii din linia de comandă, formatul volumului de ieșire fără modul parametru atribuit va păstra formatul HEX (implicit).
Linia de comandă pentru valorile arborescente așteptate și modurile predefinite cu doi parametri are următoarea structură:

• "Funcția" "1. modul parametrului" "2. mod parametru'

Secțiunea 3.2 explică modul de definire a formatului valorii de ieșire pentru un parametru specificat. Cu toate acestea, dacă trebuie să obțineți frecvent ieșirea într-un format non-hexazecimal, puteți modifica formatul implicit pentru toate valorile de ieșire în loc să definiți fiecare parametru separat.

Pentru modificarea permanentă a formatului de ieșire (până când consola curentă este închisă), executați linia de comandă:

• Setați ieșirea "modul de parametri noi"

Captura de ecran de mai sus arată formatul implicit al valorii de intrare presetat la Șir (parametrul s).

Să rulăm acum testul cu linia de comandă simplă:

• GetCardIdEx

Acum, rezultatele de ieșire sunt valori șir, chiar dacă linia de comandă nu are nici un parametru suplimentare modul definit.

După cum puteți vedea, toate valorile de ieșire sunt valori șir cu caracterul Bară oblică inversă () în locul primului lor caracter. Software-ul adaugă automat acest caracter la valorile de ieșire care conțin caracterele non-imprimabile.

Următorul exemplu prezintă ieșirea șirului atunci când valoarea este imprimabilă.
Să scriem conținutul în carte doar cu caractere imprimabile.

Exemplu de linie de comandă este:

• WriteUserData "Exemplu-test"

Notă: Conținutul șirului care trebuie înregistrat este scris între ghilimele în linia de comandă.

Acum, citiți ieșirea de conținut. Linia de comandă este:

• • ReadUserData

În acest caz, ieșirea nu are caracter Bară oblică inversă la început. Restul conținutului de ieșire (după conținutul înregistrat anterior) sunt valori implicite– octeți nefolosiți afișați ca valori xFF.

4. uFR Shell – Diferențe de implementare în mediile de sistem de operare acceptate

• Sistem de operare Windows – Implementarea pe sistemul Windows nu necesită permisiuni suplimentare pentru a lucra cu funcții uFR Shell. Este suficient să instalați corect cititorul ufr și bibliotecile sale.
• Sistemul de operare Linux – Ca de obicei în sistemul Linux, funcționalitatea completă a software-ului uFR Shell în comunicarea cu dispozitivul necesită permisiunea utilizatorului corespunzătoare.
• MacOS – Pentru a asigura funcționalitatea software instantanee pe acest sistem de operare, copiați biblioteca libuRCoder.dylib în folderul bibliotecilor de sisteme.

Acest manual prezintă exemple de software cu mai multe funcții esențiale. O listă a tuturor funcțiilor acceptate este inclusă în pachetul de descărcare a software-ului.

Acasă

PRODUSE HARDWARE

SDK SOFTWARE