Functions
static void	AUXSMPHAcquire (uint32_t ui32Semaphore)
	Acquire an AUX semaphore. More...

static bool	AUXSMPHTryAcquire (uint32_t ui32Semaphore)
	Try to acquire an AUX semaphore. More...

static void	AUXSMPHRelease (uint32_t ui32Semaphore)
	Release an AUX semaphore by System CPU master. More...

Detailed Description

Function Documentation

§ AUXSMPHAcquire()

static void AUXSMPHAcquire ( uint32_t ui32Semaphore )

inlinestatic

Acquire an AUX semaphore.

This function acquires the given AUX semaphore, blocking the call until the semaphore is available.

Note: The semaphore can also be acquired by the dedicated Sensor Controller. The System CPU master can thus be competing for the shared resource, i.e. the specified semaphore.

Parameters

ui32Semaphore

is the semaphore number.

Returns: None

See also: AUXSMPHTryAcquire(), AUXSMPHRelease()

 {
     // Check the arguments.
     ASSERT((ui32Semaphore == AUX_SMPH_0) ||
            (ui32Semaphore == AUX_SMPH_1) ||
            (ui32Semaphore == AUX_SMPH_2) ||
            (ui32Semaphore == AUX_SMPH_3) ||
            (ui32Semaphore == AUX_SMPH_4) ||
            (ui32Semaphore == AUX_SMPH_5) ||
            (ui32Semaphore == AUX_SMPH_6) ||
            (ui32Semaphore == AUX_SMPH_7));
 
     // Wait for semaphore to be released such that it can be claimed
     // Semaphore register reads 1 when lock was acquired otherwise 0
     // (i.e. AUX_SMPH_CLAIMED).
     while(HWREG(AUX_SMPH_BASE + AUX_SMPH_O_SMPH0 + 4 * ui32Semaphore) ==
             AUX_SMPH_CLAIMED)
     {
     }
 }

§ AUXSMPHRelease()

static void AUXSMPHRelease ( uint32_t ui32Semaphore )

inlinestatic

Release an AUX semaphore by System CPU master.

This function releases the given AUX semaphore.

Note: It is up to the application to provide the convention for clearing semaphore.; The semaphore can also be acquired by the dedicated Sensor Controller. The System CPU master can thus be competing for the shared resource, i.e. the specified semaphore.

Parameters

ui32Semaphore

is the semaphore number.

Returns: None

See also: AUXSMPHAcquire(), AUXSMPHTryAcquire()

 {
     // Check the arguments.
     ASSERT((ui32Semaphore == AUX_SMPH_0) ||
            (ui32Semaphore == AUX_SMPH_1) ||
            (ui32Semaphore == AUX_SMPH_2) ||
            (ui32Semaphore == AUX_SMPH_3) ||
            (ui32Semaphore == AUX_SMPH_4) ||
            (ui32Semaphore == AUX_SMPH_5) ||
            (ui32Semaphore == AUX_SMPH_6) ||
            (ui32Semaphore == AUX_SMPH_7));
 
     // No check before release. It is up to the application to provide the
     // conventions for who and when a semaphore can be released.
     HWREG(AUX_SMPH_BASE + AUX_SMPH_O_SMPH0 + 4 * ui32Semaphore) =
         AUX_SMPH_FREE;
 }

§ AUXSMPHTryAcquire()

static bool AUXSMPHTryAcquire ( uint32_t ui32Semaphore )

inlinestatic

Try to acquire an AUX semaphore.

This function tries to acquire the given AUX semaphore, if the semaphore could not be claimed the function returns false.

Note: The semaphore can also be acquired by the dedicated Sensor Controller. The System CPU master can thus be competing for the shared resource, i.e. the specified semaphore.

Parameters

ui32Semaphore

is the semaphore number.

Returns: Returns true if semaphore was acquired, false otherwise

See also: AUXSMPHAcquire(), AUXSMPHRelease()

 {
     uint32_t ui32SemaReg;
 
     // Check the arguments.
     ASSERT((ui32Semaphore == AUX_SMPH_0) ||
            (ui32Semaphore == AUX_SMPH_1) ||
            (ui32Semaphore == AUX_SMPH_2) ||
            (ui32Semaphore == AUX_SMPH_3) ||
            (ui32Semaphore == AUX_SMPH_4) ||
            (ui32Semaphore == AUX_SMPH_5) ||
            (ui32Semaphore == AUX_SMPH_6) ||
            (ui32Semaphore == AUX_SMPH_7));
 
     // AUX Semaphore register reads 1 if lock was acquired
     // (i.e. SMPH_FREE when read) but subsequent reads will read 0.
     ui32SemaReg = HWREG(AUX_SMPH_BASE + AUX_SMPH_O_SMPH0 + 4 * ui32Semaphore);
 
     return (ui32SemaReg == AUX_SMPH_FREE);
 }