Contents
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.
El software ejecutable uFR Shell permite la ejecución de línea de comandos para dispositivos de la serie μFR en modo de consola.
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.
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.
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.
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.
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:
Si el estado del lector es CORRECTO, podemos continuar. De lo contrario, compruebe si ha instalado su hardware correctamente.
Para obtener el número de serie del hardware, utilice el comando:
Si el comando no tiene parámetros adicionales definidos, la salida predeterminada tiene un formato HEX.
Para obtener la salida de datos en algún otro formato, debe especificar el modo de formato de salida entre los disponibles:
La línea de comandos para el formato de salida especificado ahora tendrá dos elementos:
Al igual que con el número de serie del lector, para obtener la salida predeterminada de ID de tarjeta, simplemente use el comando:
Para esta línea de comandos, la consola mostrará el tipo de tarjeta, UID y la salida UID en formato HEX predeterminado.
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:
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:
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:
La captura de pantalla anterior muestra el formato de valor de entrada predeterminado preestablecido en String (parámetro s).
Ahora ejecutemos la prueba con la línea de comandos simple:
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.
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:
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:
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.
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.
