uFR Shell es una interfaz de software de línea de comandos para la ejecución de comandos de hardware de la serie μFR en múltiples sistemas operativos. Como sugiere el título del software, este es un entorno de shell con un conjunto de variables definidas por las bibliotecas de lectores μFR.
Docs & Software Download
Descripción general del software
Funciones del software:
- Un conjunto de funciones definidas por las bibliotecas de la serie μFR y API (Application Programming Interface).
Lenguajes de programación disponibles:
- Software ejecutable
Sistemas operativos, plataformas y entornos compatibles:
- Sistema operativo Windows
- Sistema operativo Linux
- MAC OS
- Raspberry Pi
Etiquetas, etiquetas, tarjetas compatibles:
- MIFARE Mini®
- MIFARE Classic® (1K, 4K, EV1)
- MIFARE Ultraligero®
- MIFARE Ultraligero C®
- MIFARE Plus® (2K, 4K)
- MIFARE DESFire® (Luz, 2K, 4K, 8K, EV1, EV2)
- NXP NTAG® 21x (210, 213, 215, 216, manipulador de etiquetas)
- ADN NXP NTAG® 4xx (413, 424)
Hardware recomendado:
- μFR Nano
- μFR Nano en línea
- μFR Clásico
- μFR Classic CS
- Avance μFR
- μFR XL
- Base HD (modo de compatibilidad μFR)
Descarga de software
Descripción
El software ejecutable uFR Shell permite la ejecución de línea de comandos para dispositivos de la serie μFR en modo de consola.
Software Manual
1. uFR Shell – Instalar y ejecutar
Descargar: ufr-shell
Descargue y descomprima el archivo de software.
La carpeta raíz del archivo extraído contiene las subcarpetas con archivos ejecutivos de software uFR Shell para sistemas operativos compatibles.
La carpeta raíz también contiene la lista de funciones del software e instrucciones adicionales.
Si ha instalado correctamente el hardware y los controladores relacionados, ahora puede seleccionar y ejecutar el archivo ejecutable para su sistema operativo actual.
2. uFR Shell – Interfaz de línea de comandos
Independientemente del sistema operativo, el software uFR Shell se ejecuta como terminal de comandos. La versión del software se muestra en la primera línea de la pantalla.
3. uFR Shell – Funciones de software
Para utilizar el software uFR Shell para la ejecución de los comandos en su dispositivo uFR, debe tener una idea de todas las funciones disponibles. Puede encontrar la lista de funciones en la carpeta raíz del software, el archivo UFR-Shell_list-of-functions.txt.
Por favor, encuentre más detalles, así como instrucciones para la implementación y aplicación de funciones en API Docs.
3.1 – uFR Shell – Ejecución de la línea de comandos
Para seleccionar la función correcta para su línea de comandos, le recomendamos que estudie primero la ayuda de la función con toda la descripción de las funciones.
3.2 – uFR Shell – Ejemplos de ejecución de línea de comandos
Ahora, veamos cómo funciona.
Primero, necesitamos establecer comunicación con el lector μFR conectado. Entonces, nuestro primer comando va a ser ReaderOpen.
Escriba el comando:
- LectorAbrir
Si el estado del lector es CORRECTO, podemos continuar. De lo contrario, compruebe si ha instalado su hardware correctamente.
EXAMPLE 1
Para obtener el número de serie del hardware, utilice el comando:
- GetReaderSerialNumber
Si el comando no tiene parámetros adicionales definidos, la salida predeterminada tiene un formato HEX.
EXAMPLE 2
Para obtener la salida de datos en algún otro formato, debe especificar el modo de formato de salida entre los disponibles:
- Hexadecimal (parámetro h),
- Cadena (parámetro s)
- Decimal (parámetro d).
La línea de comandos para el formato de salida especificado ahora tendrá dos elementos:
- 'Función' 'modo de parámetro'.
EXAMPLE 3
Al igual que con el número de serie del lector, para obtener la salida predeterminada de ID de tarjeta, simplemente use el comando:
- GetCardIdEx
Para esta línea de comandos, la consola mostrará el tipo de tarjeta, UID y la salida UID en formato HEX predeterminado.
EXAMPLE 4
La salida del ID de tarjeta tiene valores de salida de árbol. En el ejemplo anterior se muestra la salida de ID de tarjeta sin modo de parámetro definido en la línea
de comandosEn este ejemplo se explica cómo obtener un formato de salida mixto. uFR Shell le permite definir el modo de parámetro específico para cada valor de salida.
La línea de comandos debería tener este aspecto:
-
- 'Función' '1. modo de parámetro' '2. modo de parámetro' '3. modo de parámetro'
EXAMPLE 5
Si no define todos los parámetros en la línea de comandos, el formato de volumen de salida sin el modo de parámetro asignado mantendrá el formato HEX (predeterminado).
La línea de comandos para los valores de árbol esperados y los modos de dos parámetros predefinidos tiene la siguiente estructura:
- 'Función' '1. modo de parámetro' '2. modo de parámetro'
En la sección 3.2 se explica cómo definir el formato de valor de salida para un parámetro especificado. Sin embargo, si necesita obtener la salida en un formato no hexadecimal con frecuencia, puede cambiar el formato predeterminado para todos los valores de salida en lugar de definir cada parámetro por separado.
Para el cambio permanente de formato de salida (hasta que se cierre la consola actual), ejecute la línea de comandos:
- Establecer salida 'modo de nuevos parámetros'
La captura de pantalla anterior muestra el formato de valor de entrada predeterminado preestablecido en String (parámetro s).
EXAMPLE 1
Ahora ejecutemos la prueba con la línea de comandos simple:
- GetCardIdEx
Ahora los resultados de salida son valores de cadena aunque la línea de comandos no tenga definido el modo de parámetro adicional.
Como puede ver, todos los valores de salida son valores de cadena con el carácter Barra diagonal inversa () en el lugar de su primer carácter. El software agrega automáticamente este carácter a los valores de salida que contienen los caracteres no imprimibles.
EXAMPLE 2
En el siguiente ejemplo se presenta la salida de la cadena cuando el valor se puede imprimir.
Escribamos el contenido en la tarjeta solo con caracteres imprimibles.
La línea de comandos de ejemplo es:
- WriteUserData "Ejemplo-Prueba"
Nota: El contenido de la cadena que se va a grabar se escribe entre comillas en la línea de comandos.
Ahora, lea la salida de contenido. La línea de comandos es:
-
- ReadUserData
En este caso, la salida no tiene carácter de barra diagonal inversa al principio. El resto del contenido de salida (siguiendo el contenido grabado anteriormente) son valores predeterminados: bytes no utilizados que se muestran como valores xFF.
4. uFR Shell – Diferencias de implementación en entornos de SO compatibles
- Sistema operativo Windows : la implementación en el sistema Windows no requiere permisos adicionales para trabajar con las funciones de uFR Shell. Es suficiente instalar correctamente el lector ufr y sus bibliotecas.
- Sistema operativo Linux : como es habitual en el sistema Linux, la funcionalidad completa del software uFR Shell en comunicación con el dispositivo requiere el permiso apropiado del usuario.
- MacOS: para garantizar la funcionalidad instantánea del software en este sistema operativo, copie la biblioteca libuRCoder.dylib en la carpeta de bibliotecas de sistemas.
Este manual presenta ejemplos de software con varias funciones esenciales. Se incluye una lista de todas las funciones compatibles en el paquete de descarga de software.
