halsampler - muestrea datos de HAL en tiempo real
halsampler [opciones]
sampler(9) y halsampler se utilizan juntos para muestrear datos HAL en tiempo real y almacenarlos en un archivo. sampler es un componente HAL en tiempo real que exporta pines HAL y crea una FIFO en la memoria compartida. Luego comienza a muestrear los datos de HAL y los almacena en la FIFO. halsampler es un programa de espacio de usuario que copia los datos de la FIFO a la salida estandar, donde pueden ser redirigidos a un archivo o canalizados a algun otro programa.
-c CHAN
Instruye a halsampler para leer de la FIFO CHAN. Las FIFO se numeran desde cero y el valor predeterminado es cero, por lo que esta opcion no es necesaria a menos que se hayan creado multiples FIFOs.
-n COUNT
Instruye a halsampler para leer COUNT muestras de la FIFO y luego salir. Si -n no se especifica, halsampler Leera continuamente hasta que se mate.
|
-t |
Instruye a halsampler para etiquetar cada linea imprimiendo el numero de muestra en la primera columna. |
FILENAME
Instruye a halsampler para escribir en FILENAME en lugar de en stdout.
Debe crearse primero una FIFO, cargando sampler(9) con halcmd loadrt o con un comando loadrt en un archivo .hal. Despues halsampler se puede invocar para comenzar a imprimir datos desde la FIFO a la salida estandar.
Los datos se imprimen una linea por muestra. Si se especifico -t , el numero de muestra se imprime primero. Siguen los datos, en el orden que los pines fueron definidos en la cadena de configuracion. Por ejemplo, si la cadena de configuracion de sampler era "ffbs", entonces una linea tipica de salida (sin -t) se veria como
123.55 33.4 0 -12
halsampler imprime los datos lo mas rapido posible hasta que la FIFO queda vacia, luego reintenta a intervalos regulares, hasta que se elimina o se imprime COUNT muestras solicitadas por -n. Por lo general, pero no siempre, los datos impresos por halsampler seran redirigido a un archivo o canalizados a algun otro programa.
El tamaño de la FIFO debe elegirse para absorber las muestras capturadas durante cualquier interrupcion momentanea en el flujo de datos, como busquedas en disco, desplazamiento del terminal o limitaciones de procesamiento del programa posterior en una tuberia. Si la FIFO se llena, y sampler queda obligado a sobrescribir los datos antiguos, halsampler imprimira ’sobrepasado’ en una linea para marcar cada gap en el muestreo de datos. Si se especifico -t , los gaps en los numeros de muestra secuenciales en la primera columna se pueden usar para determinar exactamente cuantas muestras se perdieron.
El formato de datos de salida de halsampler es el mismo que el de entrada de halstreamer(1) , por lo que ’formas de onda’ capturadas con halsampler se puede reproducir utilizando halstreamer. La opcion -t no debe ser utilizada en este caso.
Si se encuentra un problema durante la inicializacion, halsampler imprime un mensaje a stderr y devuelve el error.
Al imprimir COUNT muestras (si -n fue especificado) se cerrara y devolvera exito. Si es terminado antes de imprimir el numero especificado de muestras, devuelve error. Esto significa que cuando -n no se especifica, siempre devolvera un error cuando termine.
sampler(9) streamer(9) halstreamer(1)
Version original de John Kasunich, como parte del proyecto LinuxCNC. Mejoras de varios otros miembros del equipo de desarrollo de LinuxCNC.
Informar errores a jmkasunich AT usuarios DOT sourceforge DOT net
Copyright
© 2006 John Kasunich.
Este es un software libre; ver las fuentes para condiciones
de copia. No hay garantia; ni siquiera para COMERCIABILIDAD
o APTITUD PARA UN PROPoSITO PARTICULAR.