Mailboxen:introductie en basisservices

Het kiezen van een waarde die niet nul is, is de "master enable" voor mailboxen. Dit heeft tot gevolg dat sommige datastructuren dienovereenkomstig worden gedefinieerd en gedimensioneerd, waarover meer in het volgende artikel. Het activeert ook de instellingen voor het inschakelen van de API.

API ingeschakeld

Elke API-functie (serviceaanroep) in Nucleus SE heeft een activerende #define symbool in nuse_config.h . Voor mailboxen zijn dit:

NUSE_MAILBOX_SEND
NUSE_MAILBOX_RECEIVE
NUSE_MAILBOX_RESET
NUSE_MAILBOX_INFORMATION
NUSE_MAILBOX_COUNT

Standaard zijn deze allemaal ingesteld op FALSE , waardoor elke serviceoproep wordt uitgeschakeld en het opnemen van implementatiecodes wordt voorkomen. Om mailboxen voor een toepassing te configureren, moet u de API-aanroepen selecteren die u wilt gebruiken en hun activeringssymbolen instellen op TRUE .

Hier is een uittreksel van de standaard nuse_config.h bestand.

/* Aantal mailboxen in de  systeem - 0-16 */ #define NUSE_MAILBOX_NUMBER 0  /* Mogelijkheden voor serviceoproepen:*/ #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  

Er treedt een compileerfout op als een mailbox-API-functie is ingeschakeld en er geen mailboxen zijn geconfigureerd (behalve voor NUSE_Mailbox_Count() wat altijd is toegestaan). Als uw code een API-aanroep gebruikt, die niet is ingeschakeld, zal er een linktime-fout optreden, omdat er geen implementatiecode in de applicatie is opgenomen.

Mailboxserviceoproepen

Nucleus RTOS ondersteunt negen service calls die horen bij mailboxen, die de volgende functionaliteit bieden:

• Stuur een bericht naar een mailbox. Geïmplementeerd door NUSE_Mailbox_Send() in Nucleus SE.

• Ontvang een bericht uit een mailbox. Geïmplementeerd door NUSE_Mailbox_Receive() in Nucleus SE.

• Herstel een mailbox in de ongebruikte staat, zonder dat taken worden onderbroken (reset). Geïmplementeerd door NUSE_Mailbox_Reset() in Nucleus SE.

• Geef informatie over een opgegeven mailbox. Geïmplementeerd door NUSE_Mailbox_Information() in Nucleus SE.

• Retourneer een telling van het aantal mailboxen dat (momenteel) is geconfigureerd voor de toepassing. Geïmplementeerd door NUSE_Mailbox_Count() in Nucleus SE.

• Voeg een nieuwe mailbox toe aan de applicatie (maken). Niet geïmplementeerd in Nucleus SE.

• Verwijder een mailbox uit de applicatie (verwijderen). Niet geïmplementeerd in Nucleus SE.

• Retour verwijzingen naar alle mailboxen (momenteel) in de applicatie. Niet geïmplementeerd in Nucleus SE.

• Stuur een bericht naar alle taken die op een mailbox zijn geschorst (uitzending). Niet geïmplementeerd in Nucleus SE.

De implementatie van elk van deze service calls wordt in detail onderzocht.

Mailbox schrijf- en leesservices

De fundamentele bewerkingen die op een mailbox kunnen worden uitgevoerd, zijn het schrijven van gegevens ernaar - wat soms verzenden wordt genoemd of posten – en er gegevens uit lezen – wat ook wel ontvangen wordt genoemd . Nucleus RTOS en Nucleus SE bieden elk twee basis-API-aanroepen voor deze bewerkingen, die hier worden besproken.

Schrijven naar een mailbox

De Nucleus RTOS API-aanroep voor het schrijven naar een mailbox is zeer flexibel, waardoor u voor onbepaalde tijd of met een time-out kunt opschorten als de bewerking niet onmiddellijk kan worden voltooid; d.w.z. u probeert naar een volle mailbox te schrijven. Nucleus SE biedt dezelfde service, behalve dat taakonderbreking optioneel is en time-out niet is geïmplementeerd.

Nucleus RTOS biedt ook de mogelijkheid om uit te zenden naar een mailbox, maar dit wordt niet ondersteund door Nucleus SE. Het wordt beschreven onder Niet-geïmplementeerde API's in het volgende artikel.

Nucleus RTOS API-oproep voor verzending naar een mailbox

Serviceoproep prototype:

if (NUSE_Mailbox_Status[mailbox]) /* mailbox vol */{ return_value =NUSE_MAILBOX_FULL;}else /* mailbox leeg */{ NUSE_Mailbox_Data[mailbox] =*bericht; NUSE_Mailbox_Status[mailbox] =WAAR; return_value =NUSE_SUCCESS;}

doe{ if (!NUSE_Mailbox_Status[mailbox]) /* mailbox leeg */ { NUSE_Mailbox_Data[mailbox] =*bericht; NUSE_Mailbox_Status[mailbox] =WAAR; if (NUSE_Mailbox_Blocking_Count[mailbox] !=0) { U8 index; /* controleer of een taak is geblokkeerd */ /* op deze mailbox */ NUSE_Mailbox_Blocking_Count[mailbox]--; for (index=0; index 

 Enige uitleg kan nuttig zijn:
 

 De code is ingesloten in een do…while loop, die doorgaat terwijl de parameter suspend heeft de waarde NUSE_SUSPEND .
 

 Als de mailbox leeg is, wordt het aangeleverde bericht opgeslagen en wordt de mailboxstatus gewijzigd om aan te geven dat deze vol is. Er wordt gecontroleerd of er taken op de mailbox zijn opgeschort (wacht op ontvangst). Als er nog taken wachten, wordt de eerste gewekt. De opschorten variabele is ingesteld op NUSE_NO_SUSPEND en de API-aanroep wordt afgesloten met NUSE_SUCCESS .
 

 Als de mailbox vol is en onderbreken is ingesteld op NUSE_NO_SUSPEND , wordt de API-aanroep afgesloten met NUSE_MAILBOX_FULL . Als opschorten was ingesteld op NUSE_SUSPEND , wordt de taak opgeschort. Bij terugkeer (d.w.z. wanneer de taak wordt gewekt), als de geretourneerde waarde NUSE_SUCCESS is , wat aangeeft dat de taak is gewekt omdat een bericht is gelezen (in tegenstelling tot een reset van de mailbox), loopt de code terug naar boven.