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:
- Un insieme di funzioni definite dalle librerie della serie μFR e dall'API (Application Programming Interface).
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)
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.
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.
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.
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.
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
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
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.'
EXAMPLE 3
Come per il numero di serie del lettore, per ottenere l'output predefinito dell'ID carta, è sufficiente utilizzare il comando:
- GetCardIdEx
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'
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'
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à'
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
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"
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
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.
Copyright © 2010-2025 Digital Logic Ltd . All rights reserved