xSemaphoreGiveFromISR

[Semaphores]

semphr. h

xSemaphoreGiveFromISR( xSemaphoreHandle xSemaphore, signed portBASE_TYPE *pxHigherPriorityTaskWoken )

　セマフォをリリースするマクロ。
　セマフォはそれ以前にvSemaphoreCreateBinary () あるいは xSemaphoreCreateCounting () で作成したものです。
Mutex タイプセマフォ（xSemaphoreCreateMutex () で作成されたもの）はこのマクロでは使用できません。このマクロは ISR から使用できます。

パラメータ：
xSemaphore
　リリースするセマフォへのハンドル。 セマフォを作成されたとき、返されるハンドルです。

pxHigherPriorityTaskWoken
　もし セマフォをgivingしたことがタスクのブロック解除を起こしたなら、 xSemaphoreGiveFromISR () は*pxHigherPriorityTaskWoken を pdTRUE にセットする。そしてブロック解除されたタスクは現在走っているタスクより高い優先権を持っています。 もし xSemaphoreGiveFromISR () がこの値を pdTRUE にセットしたなら、割り込み処理終了前に、コンテキストスイッチを求めるべきです。

リターン：
pdTRUE 　もしセマフォが成功裏にgivenしたなら、
さもなければ
errQUEUE_FULL 。

使用例：

#define LONG_TIME 0xffff
#define TICKS_TO_WAIT    10

xSemaphoreHandle xSemaphore = NULL;

/* Repetitive task. */
void vATask( void * pvParameters )
{
    /* We are using the semaphore for synchronisation so we create a binary
    semaphore rather than a mutex.  We must make sure that the interrupt
    does not attempt to use the semaphore before it is created! */
    vSemaphoreCreateBinary( xSemaphore );

    for( ;; )
    {
        /* We want this task to run every 10 ticks of a timer.  The semaphore 
        was created before this task was started.
        
        Block waiting for the semaphore to become available. */
        if( xSemaphoreTake( xSemaphore, LONG_TIME ) == pdTRUE )
        {
            /* It is time to execute. */
            
            ...
            
            /* We have finished our task.  Return to the top of the loop where
            we will block on the semaphore until it is time to execute 
            again.  Note when using the semaphore for synchronisation with an
            ISR in this manner there is no need to 'give' the semaphore back. */
        }
    }
}

/* Timer ISR */
void vTimerISR( void * pvParameters )
{
static unsigned portCHAR ucLocalTickCount = 0;
static signed portBASE_TYPE xHigherPriorityTaskWoken; 
 
    /* A timer tick has occurred. */
    
    ... Do other time functions.
    
    /* Is it time for vATask() to run? */
    xHigherPriorityTaskWoken = pdFALSE;
    ucLocalTickCount++;
    if( ucLocalTickCount >= TICKS_TO_WAIT )
    {
        /* Unblock the task by releasing the semaphore. */
        xSemaphoreGiveFromISR( xSemaphore, &xHigherPriorityTaskWoken );
        
        /* Reset the count so we release the semaphore again in 10 ticks time. */
        ucLocalTickCount = 0;
    }
    
    /* If xHigherPriorityTaskWoken was set to true you
    we should yield.  The actual macro used here is 
    port specific. */
    portYIELD_FROM_ISR( xHigherPriorityTaskWoken );
}