Contents
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.
Il software eseguibile uFR Shell consente l'esecuzione da riga di comando per i dispositivi della serie μFR in modalità console.
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.
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.
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.
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.
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:
Se lo stato del lettore è OK, possiamo procedere. Altrimenti, controlla se hai installato correttamente l'hardware.
Per ottenere il numero di serie dell'hardware, utilizzare il comando:
Se il comando non ha parametri aggiuntivi definiti, l'output predefinito ha un formato HEX.
Per ottenere l'output dei dati in un altro formato, è necessario specificare la modalità del formato di output tra i disponibili:
La riga di comando per il formato di output specificato avrà ora due elementi:
Come per il numero di serie del lettore, per ottenere l'output predefinito dell'ID carta, è sufficiente utilizzare il comando:
Per questa riga di comando, la console visualizzerà il tipo di scheda, l'UID e l'output UID nel formato HEX predefinito.
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:
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:
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:
Lo screenshot sopra mostra il formato predefinito del valore di input preimpostato su String (parametro s).
Eseguiamo ora il test con la semplice riga di comando:
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.
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 è:
Nota: il contenuto della stringa da registrare è scritto tra virgolette nella riga di comando.
Ora, leggi l'output del contenuto. La riga di comando è:
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.
Questo manuale presenta esempi di software con diverse funzioni essenziali. Un elenco di tutte le funzioni supportate è incluso nel pacchetto di download del software.
