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.

Docs & Software Download

Prezentare generală a software-ului

Functii software:
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)
ufr shell home screen
Descărcare software
Descrierea /

Software-ul executabil uFR Shell permite executarea liniei de comandă pentru dispozitivele din seria μFR în modul consolă.

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.

urf shell folder

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.

ufr shell interface

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.

urf shell functions

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.

urf shell commands 600x342 1

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

Acum, să vedem cum funcționează.

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

  • ReaderDeschide
ufr shell rearer open command

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

EXAMPLE 1

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

  • GetReaderSerialNumber
ufr shell rearer sn get command

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

EXAMPLE 2

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."
ufr shell rearer sn get modes 1

EXAMPLE 3

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
ufr shell card id get command

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

EXAMPLE 4

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'
ufr shell card id get modes

EXAMPLE 5

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'
ufr shell card id get modes part param

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"
ufr shell permanent output format change

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

EXAMPLE 1

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

  • GetCardIdEx
ufr shell output format changed example 1

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.

EXAMPLE 2

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"
ufr shell write string data

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
ufr shell read data string

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