Mutexes

Collaboration diagram for Mutexes:

Functions
err_t	sys_mutex_new (sys_mutex_t *mutex)
void	sys_mutex_lock (sys_mutex_t *mutex)
void	sys_mutex_unlock (sys_mutex_t *mutex)
void	sys_mutex_free (sys_mutex_t *mutex)
int	sys_mutex_valid (sys_mutex_t *mutex)
void	sys_mutex_set_invalid (sys_mutex_t *mutex)

Detailed Description

Mutexes are recommended to correctly handle priority inversion, especially if you use LWIP_CORE_LOCKING .

Function Documentation

sys_mutex_new()

err_t sys_mutex_new

(

sys_mutex_t *

mutex

)

Create a new mutex. Note that mutexes are expected to not be taken recursively by the lwIP code, so both implementation types (recursive or non-recursive) should work.

Parameters

mutex

pointer to the mutex to create

Returns

ERR_OK if successful, another err_t otherwise

                                        {
 
  osMutexDef(MUTEX);
 
  *mutex = osMutexCreate(osMutex(MUTEX));
 
 
  //*mutex = xSemaphoreCreateMutex();
  if(*mutex == NULL)
  {
#if SYS_STATS
    ++lwip_stats.sys.mutex.err;
#endif /* SYS_STATS */
    return ERR_MEM;
  }
 
#if SYS_STATS
  ++lwip_stats.sys.mutex.used;
  if (lwip_stats.sys.mutex.max < lwip_stats.sys.mutex.used) {
    lwip_stats.sys.mutex.max = lwip_stats.sys.mutex.used;
  }
#endif /* SYS_STATS */
  return ERR_OK;
}

Here is the call graph for this function:

Here is the caller graph for this function:

sys_mutex_lock()

void sys_mutex_lock

(

sys_mutex_t *

mutex

)

Lock a mutex

Parameters

mutex

the mutex to lock

{
  osMutexWait (*mutex, osWaitForever);
}

Here is the call graph for this function:

Here is the caller graph for this function:

sys_mutex_unlock()

void sys_mutex_unlock

(

sys_mutex_t *

mutex

)

Unlock a mutex

Parameters

mutex

the mutex to unlock

{
  osMutexRelease(*mutex);
}

Here is the call graph for this function:

Here is the caller graph for this function:

sys_mutex_free()

void sys_mutex_free

(

sys_mutex_t *

mutex

)

Delete a semaphore

Parameters

mutex

the mutex to delete

{
#if SYS_STATS
      --lwip_stats.sys.mutex.used;
#endif /* SYS_STATS */
 
  osMutexDelete(*mutex);
}

Here is the call graph for this function:

sys_mutex_valid()

int sys_mutex_valid

(

sys_mutex_t *

mutex

)

Check if a mutex is valid/allocated: return 1 for valid, 0 for invalid

sys_mutex_set_invalid()

void sys_mutex_set_invalid

(

sys_mutex_t *

mutex

)

Set a mutex invalid so that sys_mutex_valid returns 0