Buzones de correo:introducción y servicios básicos

La elección de un valor distinto de cero es la "habilitación maestra" para los buzones de correo. Esto da como resultado que algunas estructuras de datos se definan y dimensionen en consecuencia, de las cuales hablaremos más en el próximo artículo. También activa la configuración de habilitación de API.

API habilitadas

Cada función de API (llamada de servicio) en Nucleus SE tiene un #define habilitante símbolo en nuse_config.h . Para los buzones de correo, estos son:

NUSE_MAILBOX_SEND
NUSE_MAILBOX_RECEIVE
NUSE_MAILBOX_RESET
NUSE_MAILBOX_INFORMATION
NUSE_MAILBOX_COUNT

De forma predeterminada, todos estos están configurados como FALSO . , deshabilitando así cada llamada de servicio e inhibiendo la inclusión de cualquier código de implementación. Para configurar buzones de correo para una aplicación, debe seleccionar las llamadas a la API que desea usar y establecer sus símbolos de habilitación en TRUE .

A continuación, se muestra un extracto del nuse_config.h predeterminado. archivo.

  / * Número de buzones de correo en el   sistema - 0-16 * /   #define NUSE_MAILBOX_NUMBER 0   / * Habilitadores de llamadas de servicio:* /   #define NUSE_MAILBOX_SEND FALSE   #define NUSE_MAILBOX_RECEIVE FALSE   #define NUSE_MAILBOX_RESET FALSE   #define NUSE_MAILBOX_INFORMATION FALSE   #define NUSE_MAILBOX_COUNT FALSE  

Se producirá un error de tiempo de compilación si se habilita una función de API de buzón de correo y no se configuran buzones de correo (excepto NUSE_Mailbox_Count () que siempre está permitido). Si su código utiliza una llamada a la API, que no se ha habilitado, se producirá un error de tiempo de enlace, ya que no se habrá incluido ningún código de implementación en la aplicación.

Llamadas de servicio del buzón

Nucleus RTOS admite nueve llamadas de servicio que pertenecen a los buzones de correo, que brindan la siguiente funcionalidad:

• Envía un mensaje a un buzón. Implementado por NUSE_Mailbox_Send () en Nucleus SE.

• Reciba un mensaje de un buzón. Implementado por NUSE_Mailbox_Receive () en Nucleus SE.

• Restaura un buzón al estado no utilizado, sin tareas suspendidas (restablecer). Implementado por NUSE_Mailbox_Reset () en Nucleus SE.

• Proporciona información sobre un buzón específico. Implementado por NUSE_Mailbox_Information () en Nucleus SE.

• Devuelve un recuento de cuántos buzones de correo están (actualmente) configurados para la aplicación. Implementado por NUSE_Mailbox_Count () en Nucleus SE.

• Agregar un nuevo buzón a la aplicación (crear). No implementado en Nucleus SE.

• Eliminar un buzón de la aplicación (eliminar). No implementado en Nucleus SE.

• Devuelve punteros a todos los buzones (actualmente) de la aplicación. No implementado en Nucleus SE.

• Envía un mensaje a todas las tareas que están suspendidas en un buzón (difusión). No implementado en Nucleus SE.

La implementación de cada una de estas llamadas de servicio se examina en detalle.

Servicios de lectura y escritura del buzón

Las operaciones fundamentales, que se pueden realizar en un buzón, son escribir datos en él, lo que a veces se denomina envío o publicar - y leer datos de él, lo que también se denomina recibir . Nucleus RTOS y Nucleus SE proporcionan dos llamadas API básicas para estas operaciones, que se analizarán aquí.

Escribir en un buzón

La llamada a la API de Nucleus RTOS para escribir en un buzón es muy flexible, lo que le permite suspender indefinidamente, o con un tiempo de espera, si la operación no se puede completar de inmediato; es decir, intenta escribir en un buzón lleno. Nucleus SE proporciona el mismo servicio, excepto que la suspensión de tareas es opcional y el tiempo de espera no está implementado.

Nucleus RTOS también ofrece la posibilidad de transmitir a un buzón de correo, pero Nucleus SE no lo admite. Se describirá en API no implementadas . en el próximo artículo.

Llamada a la API Nucleus RTOS para enviar a un buzón

Prototipo de llamada de servicio:

STATUS NU_Send_To_Mailbox (NU_MAILBOX * buzón, mensaje VOID *, SUSPENDER SIN FIRMAR);

Parámetros:

buzón - puntero al buzón que se utilizará

mensaje - un puntero al mensaje que se va a enviar que tiene cuatro sin firmar elementos

suspender - especificación para la suspensión de tareas; puede ser NU_NO_SUSPEND o NU_SUSPEND o un valor de tiempo de espera

Devoluciones:

NU_SUCCESS - la llamada se completó con éxito

NU_INVALID_MAILBOX - el puntero del buzón no es válido

NU_INVALID_POINTER - el puntero del mensaje es NULL

NU_INVALID_SUSPEND - se intentó suspender desde un hilo que no es de tarea

NU_MAILBOX_FULL - el buzón está lleno y no se especificó la suspensión

NU_TIMEOUT - el buzón aún está lleno incluso después de suspenderlo durante el período especificado

NU_MAILBOX_DELETED - el buzón se eliminó mientras la tarea estaba suspendida

NU_MAILBOX_WAS_RESET - el buzón se reinició mientras la tarea estaba suspendida

Llamada a la API de Nucleus SE para enviar a un buzón

Esta llamada a la API admite la funcionalidad clave de la API Nucleus RTOS.

Prototipo de llamada de servicio:

STATUS NUSE_Mailbox_Send (buzón NUSE_MAILBOX, mensaje ADDR *, U8 suspender);

Parámetros:

buzón - el índice (ID) del buzón que se utilizará

mensaje - un puntero al mensaje que se va a enviar, que es una única variable de tipo ADDR

suspender - especificación para la suspensión de tareas; puede ser NUSE_NO_SUSPEND o NUSE_SUSPEND

Devoluciones:

NUSE_SUCCESS - la llamada se completó con éxito

NUSE_INVALID_MAILBOX - el índice del buzón no es válido

NUSE_INVALID_POINTER - el puntero del mensaje es NULL

NUSE_INVALID_SUSPEND - se intentó suspender desde un hilo que no es de tarea o cuando el bloqueo de llamadas a la API no estaba habilitado

NUSE_MAILBOX_FULL - el buzón está lleno y no se especificó la suspensión

NUSE_MAILBOX_WAS_RESET - el buzón se reinició mientras la tarea estaba suspendida

Implementación de Nucleus SE de Mailbox Send

La mayor parte del código de NUSE_Mailbox_Send () La función API, después de la verificación de parámetros, se selecciona mediante compilación condicional, dependiendo de si está habilitada la compatibilidad con el bloqueo (suspensión de tareas) de las llamadas a la API. Veremos las dos variantes por separado aquí.

Si el bloqueo no está habilitado, la lógica para esta llamada a la API es bastante simple y el código requiere poca explicación:

 if (NUSE_Mailbox_Status [buzón]) / * buzón lleno * / {return_value =NUSE_MAILBOX_FULL;} else / * buzón vacío * / {NUSE_Mailbox_Data [buzón] =* mensaje; NUSE_Mailbox_Status [buzón] =TRUE; return_value =NUSE_SUCCESS;} 

El mensaje se almacena en el elemento apropiado de NUSE_Mailbox_Data [] y el buzón marcado como en uso.

Cuando el bloqueo está habilitado, el código se vuelve más complejo:

 hacer {if (! NUSE_Mailbox_Status [buzón]) / * buzón vacío * / {NUSE_Mailbox_Data [buzón] =* mensaje; NUSE_Mailbox_Status [buzón] =TRUE; if (NUSE_Mailbox_Blocking_Count [buzón]! =0) {índice U8; / * comprobar si una tarea está bloqueada * / / * en este buzón * / NUSE_Mailbox_Blocking_Count [buzón] -; for (index =0; index  

 Alguna explicación puede ser útil:
 

 El código está encerrado en  do… while  bucle, que continúa mientras el parámetro  suspender  tiene el valor  NUSE_SUSPEND  . 
 

 Si el buzón está vacío, el mensaje proporcionado se almacena y el estado del buzón cambia para indicar que está lleno. Se comprueba si hay tareas suspendidas (en espera de recibir) en el buzón. Si hay tareas esperando, se despierta la primera. El  suspender  la variable está establecida en  NUSE_NO_SUSPEND  y la llamada a la API finaliza con  NUSE_SUCCESS  . 
 

 Si el buzón está lleno y  suspender  está configurado en  NUSE_NO_SUSPEND  , la llamada a la API finaliza con  NUSE_MAILBOX_FULL  . Si  suspender  se configuró en  NUSE_SUSPEND  , la tarea está suspendida. Al regresar (es decir, cuando se despierta la tarea), si el valor de retorno es  NUSE_SUCCESS  , lo que indica que la tarea se despertó porque se había leído un mensaje (a diferencia de un restablecimiento del buzón), el código vuelve a la parte superior. 
 

            


            

               La arquitectura de los sistemas de firmware basados ​​en ARMv8        
                Semáforos:servicios públicos y estructuras de datos