uFR Shell Environment – Interprete della riga di comando

Software a riga di comando NFC RFID Reader Writer

uFR Shell è un'interfaccia software a riga di comando per l'esecuzione di comandi hardware della serie μFR su più sistemi operativi. Come suggerisce il titolo del software, questo è un ambiente shell con un insieme di variabili definite dalle librerie di lettori μFR.

Docs & Software Download

Panoramica del software

Funzioni del software:
Linguaggi di programmazione disponibili:
  • Software eseguibile
Sistemi operativi, piattaforme e ambienti supportati:
  • Sistema operativo Windows
  • Sistema operativo Linux
  • MAC OS
  • Raspberry Pi
Tag, etichette, schede supportati:
  • MIFARE Mini®
  • MIFARE Classic® (1K, 4K, EV1)
  • MIFARE Ultraleggero®
  • MIFARE Ultralight C |®
  • MIFARE Plus® (2K, 4K)
  • MIFARE DESFire® (Luce, 2K, 4K, 8K, EV1, EV2)
  • NXP NTAG® 21x (210, 213, 215, 216, Tag Tamper)
  • NXP NTAG® 4xx DNA (413, 424)
Hardware consigliato:
  • μFR Nano
  • μFR Nano Online
  • μFR Classico
  • μFR Classico CS
  • μFR Advance
  • μFR XL
  • Base HD (modalità di compatibilità μFR)
ufr shell home screen
Download del software
Descrizione

Il software eseguibile uFR Shell consente l'esecuzione da riga di comando per i dispositivi della serie μFR in modalità console.

Manuale del software

1. uFR Shell – Installare ed eseguire

Scarica: ufr-shell

Scaricare e decomprimere il file del software.

La cartella principale del file estratto contiene le sottocartelle con i file esecutivi del software uFR Shell per i sistemi operativi supportati.

La cartella principale contiene anche l'elenco delle funzioni software e istruzioni aggiuntive.

Se l'hardware e i relativi driver sono stati installati correttamente, è ora possibile selezionare ed eseguire il file eseguibile per il sistema operativo corrente.

urf shell folder

2. uFR Shell – Interfaccia a riga di comando

Indipendentemente dal sistema operativo, il software uFR Shell viene eseguito come terminale di comando. La versione del software viene visualizzata nella prima riga dello schermo.

ufr shell interface

3. uFR Shell – Funzioni software

Per utilizzare il software uFR Shell per l'esecuzione dei comandi sul dispositivo uFR, è necessario avere informazioni su tutte le funzioni disponibili. È possibile trovare l'elenco delle funzioni nella cartella principale del software, file UFR-Shell_list-of-functions.txt.

Per ulteriori dettagli, nonché per le istruzioni per l'implementazione e l'applicazione delle funzioni in API Docs.

urf shell functions

3.1 – uFR Shell – Esecuzione a riga di comando

Per selezionare la funzione giusta per la tua riga di comando, ti consigliamo di studiare prima la guida della funzione con tutte le descrizioni delle funzioni.

urf shell commands 600x342 1

3.2 – uFR Shell – Esempi di esecuzione da riga di comando

Ora, vediamo come funziona.

In primo luogo, dobbiamo stabilire una comunicazione con il lettore μFR collegato. Quindi, il nostro primo comando sarà ReaderOpen.
Digita il comando:

  • ReaderOpen
ufr shell rearer open command

Se lo stato del lettore è OK, possiamo procedere. Altrimenti, controlla se hai installato correttamente l'hardware. 

EXAMPLE 1

Per ottenere il numero di serie dell'hardware, utilizzare il comando:

  • GetReaderSerialNumber
ufr shell rearer sn get command

Se il comando non ha parametri aggiuntivi definiti, l'output predefinito ha un formato HEX.

EXAMPLE 2

Per ottenere l'output dei dati in un altro formato, è necessario specificare la modalità del formato di output tra i disponibili:

  • Esadecimale (parametro h),
  • Stringa (parametro s)
  • Decimale (parametro d).

La riga di comando per il formato di output specificato avrà ora due elementi:

  • 'Funzione' ' modalità parametro.'
ufr shell rearer sn get modes 1

EXAMPLE 3

Come per il numero di serie del lettore, per ottenere l'output predefinito dell'ID carta, è sufficiente utilizzare il comando:

  • GetCardIdEx
ufr shell card id get command

Per questa riga di comando, la console visualizzerà il tipo di scheda, l'UID e l'output UID nel formato HEX predefinito.

EXAMPLE 4

L'output card ID ha valori di output ad albero. Nell'esempio precedente viene illustrato l'output dell'ID scheda senza modalità parametro definita nella riga di comandoIn questo esempio viene illustrato come ottenere un formato di output misto. uFR Shell consente di definire la modalità dei parametri specifici per ogni valore di output.

La riga di comando dovrebbe essere simile alla seguente:

    • 'Funzione' '1. modalità parametro' '2. modalità parametro' '3. modalità parametro'
ufr shell card id get modes

EXAMPLE 5

Se non si definiscono tutti i parametri nella riga di comando, il formato del volume di output senza la modalità parametro assegnato manterrà il formato HEX (impostazione predefinita).
La riga di comando per i valori ad albero previsti e le modalità a due parametri predefinite ha la seguente struttura:

  • 'Funzione' '1. modalità parametro' '2. modalità parametro'
ufr shell card id get modes part param

La sezione 3.2 spiega come definire il formato del valore di output per un parametro specificato. Tuttavia, se è necessario ottenere frequentemente l'output in un formato non esadecimale, è possibile modificare il formato predefinito per tutti i valori di output anziché definire ciascun parametro separatamente.

Per la modifica permanente del formato di output (fino alla chiusura della console corrente), eseguire la riga di comando:

  • Imposta output 'nuovi parametri modalità'
ufr shell permanent output format change

Lo screenshot sopra mostra il formato predefinito del valore di input preimpostato su String (parametro s).

EXAMPLE 1

Eseguiamo ora il test con la semplice riga di comando:

  • GetCardIdEx
ufr shell output format changed example 1

Ora i risultati di output sono valori stringa anche se la riga di comando non ha alcuna modalità di parametro aggiuntiva definita.

Come puoi vedere, tutti i valori di output sono valori stringa con il carattere Barra rovesciata () al posto del loro primo carattere. Il software aggiunge automaticamente questo carattere ai valori di output contenenti i caratteri non stampabili.

EXAMPLE 2

Nell'esempio seguente viene presentato l'output della stringa quando il valore è stampabile.
Scriviamo il contenuto nella scheda solo con caratteri stampabili.

La riga di comando di esempio è:

  • WriteUserData "Esempio-test"
ufr shell write string data

Nota: il contenuto della stringa da registrare è scritto tra virgolette nella riga di comando.

Ora, leggi l'output del contenuto. La riga di comando è:

    • Metodo ReadUserData
ufr shell read data string

In questo caso, l'output non ha carattere Barra rovesciata all'inizio. Il resto del contenuto di output (dopo il contenuto registrato in precedenza) sono valori predefiniti: byte inutilizzati visualizzati come valori xFF.

4. uFR Shell – Differenze di implementazione negli ambienti OS supportati

  • Sistema operativo Windows – L'implementazione sul sistema Windows non richiede autorizzazioni aggiuntive per funzionare con le funzioni della shell uFR. È sufficiente installare correttamente il lettore ufr e le sue librerie.
  • Sistema operativo Linux – Come al solito nel sistema Linux, la piena funzionalità del software uFR Shell in comunicazione con il dispositivo richiede l'autorizzazione dell'utente appropriata.
  • MacOS – Per garantire la funzionalità software istantanea su questo sistema operativo, copiare la libreria libuRCoder.dylib nella cartella delle librerie di sistema.

Questo manuale presenta esempi di software con diverse funzioni essenziali. Un elenco di tutte le funzioni supportate è incluso nel pacchetto di download del software.