rtapi_clock_set_period

NOMBRE
SINTAXIS
ARGUMENTOS
DESCRIPCIÃN
CONSIDERACIONES EN TIEMPO REAL
VALOR DEVUELTO

NOMBRE

rtapi_clock_set_period - establece el intervalo de tiempo básico para tareas en tiempo real

SINTAXIS

rtapi_clock_set_period (long int nsec)

ARGUMENTOS

nsec

El intervalo de tiempo básico deseado para tareas en tiempo real.

DESCRIPCIÃN

rtapi_clock_set_period establece el intervalo de tiempo básico para las tareas en tiempo real. Todas las tareas periódicas se ejecutarán en un múltiplo entero de este perÃodo. La primera llamada a rtapi_clock_set_period con nsec mayor que cero inicia el reloj, usando nsec como el perÃodo del reloj en nano-segundos. Debido a limitaciones de hardware y RTOS, el perÃodo real puede no ser exactamente el pedido. En caso de éxito, la función devolverá el perÃodo de reloj real si está disponible, de lo contrario, devuelve el perÃodo solicitado. Si el perÃodo solicitado está fuera de los lÃmites impuestos por el hardware o RTOS, devuelve -EINVAL y no inicia el reloj. Una vez que se inicia el reloj,llamadas posteriores con un valor distinto de cero en nsec devuelven -EINVAL y no tienen efecto. Llamar a rtapi_clock_set_period con nsec establecido en cero consulta el reloj, devolviendo el perÃodo actual del reloj, o cero si el reloj no se ha iniciado todavÃa.

CONSIDERACIONES EN TIEMPO REAL

Llame solo desde el código de inicio/limpieza, no desde tareas en tiempo real. Esta función no está disponible desde el código de usuario (no en tiempo real).

VALOR DEVUELTO

El perÃodo real proporcionado por el RTOS, que puede ser diferente al perÃodo solicitado, o un código de estado RTAPI.