countsem.h File Reference

Go to the source code of this file.

Functions
void	vStartCountingSemaphoreTasks (void)
portBASE_TYPE	xAreCountingSemaphoreTasksStillRunning (void)

---

Function Documentation

void vStartCountingSemaphoreTasks

(

void

)

Definition at line 133 of file countsem.c.

References configMINIMAL_STACK_SIZE, countMAX_COUNT_VALUE, countSTART_AT_MAX_COUNT, portCHAR, prvCountingSemaphoreTask(), tskIDLE_PRIORITY, COUNT_SEM_STRUCT::uxExpectedStartCount, COUNT_SEM_STRUCT::uxLoopCounter, vQueueAddToRegistry, COUNT_SEM_STRUCT::xSemaphore, xSemaphoreCreateCounting, and xTaskCreate.

{
    /* Create the semaphores that we are going to use for the test/demo.  The
    first should be created such that it starts at its maximum count value,
    the second should be created such that it starts with a count value of zero. */
    xParameters[ 0 ].xSemaphore = xSemaphoreCreateCounting( countMAX_COUNT_VALUE, countMAX_COUNT_VALUE );
    xParameters[ 0 ].uxExpectedStartCount = countSTART_AT_MAX_COUNT;
    xParameters[ 0 ].uxLoopCounter = 0;

    xParameters[ 1 ].xSemaphore = xSemaphoreCreateCounting( countMAX_COUNT_VALUE, 0 );
    xParameters[ 1 ].uxExpectedStartCount = 0;
    xParameters[ 1 ].uxLoopCounter = 0;

    /* vQueueAddToRegistry() adds the semaphore to the registry, if one is
    in use.  The registry is provided as a means for kernel aware 
    debuggers to locate semaphores and has no purpose if a kernel aware debugger
    is not being used.  The call to vQueueAddToRegistry() will be removed
    by the pre-processor if configQUEUE_REGISTRY_SIZE is not defined or is 
    defined to be less than 1. */
    vQueueAddToRegistry( ( xQueueHandle ) xParameters[ 0 ].xSemaphore, ( signed portCHAR * ) "Counting_Sem_1" );
    vQueueAddToRegistry( ( xQueueHandle ) xParameters[ 1 ].xSemaphore, ( signed portCHAR * ) "Counting_Sem_2" );


    /* Were the semaphores created? */
    if( ( xParameters[ 0 ].xSemaphore != NULL ) || ( xParameters[ 1 ].xSemaphore != NULL ) )
    {
        /* Create the demo tasks, passing in the semaphore to use as the parameter. */
        xTaskCreate( prvCountingSemaphoreTask, ( signed portCHAR * ) "CNT1", configMINIMAL_STACK_SIZE, ( void * ) &( xParameters[ 0 ] ), tskIDLE_PRIORITY, NULL );
        xTaskCreate( prvCountingSemaphoreTask, ( signed portCHAR * ) "CNT2", configMINIMAL_STACK_SIZE, ( void * ) &( xParameters[ 1 ] ), tskIDLE_PRIORITY, NULL );      
    }
}

portBASE_TYPE xAreCountingSemaphoreTasksStillRunning

(

void

)

Definition at line 276 of file countsem.c.

References pdFAIL, pdFALSE, pdPASS, portBASE_TYPE, COUNT_SEM_STRUCT::uxLoopCounter, and xErrorDetected.

{
static unsigned portBASE_TYPE uxLastCount0 = 0, uxLastCount1 = 0;
portBASE_TYPE xReturn = pdPASS;

    /* Return fail if any 'give' or 'take' did not result in the expected
    behaviour. */
    if( xErrorDetected != pdFALSE )
    {
        xReturn = pdFAIL;
    }

    /* Return fail if either task is not still incrementing its loop counter. */
    if( uxLastCount0 == xParameters[ 0 ].uxLoopCounter )
    {
        xReturn = pdFAIL;
    }
    else
    {
        uxLastCount0 = xParameters[ 0 ].uxLoopCounter;
    }

    if( uxLastCount1 == xParameters[ 1 ].uxLoopCounter )
    {
        xReturn = pdFAIL;
    }
    else
    {
        uxLastCount1 = xParameters[ 1 ].uxLoopCounter;
    }

    return xReturn;
}