三、cmsis_os2的API互斥鎖（Mutex）介面簡介

struct osMutexAttr_t //互斥鎖的屬性結構體

巨集定義:
#define osMutexRecursive 0x00000001U //遞迴互斥鎖

#define osMutexPrioInherit 0x00000002U //優先順序繼承協議

#define osMutexRobust 0x00000008U //強健的互斥鎖

函式:
osMutexId_tosMutexNew (const osMutexAttr_t *attr) //建立並初始化一個互斥鎖物件。

互斥鎖作用：相互排斥（廣為人知的互斥鎖）在各種作業系統中用於資源管理。

微控制器器件中的許多資源可以重複使用，但一次只能使用一個執行緒（例如通訊通道，記憶體和檔案）。

互斥鎖用於保護對共享資源的訪問。互斥體被建立並在執行緒之間傳遞（它們可以獲取並釋放互斥鎖）

不能從中斷服務程式（ISR）呼叫互斥鎖管理函式，這與可以從 ISR 釋放的二進位制訊號不同。有關 RTX5 配置選項，請參閱互斥鎖配置。

同一個執行緒可以多次使用互斥鎖，而不會自行鎖定。每當擁有的執行緒獲取互斥鎖時，鎖定計數就會增加。互斥鎖必須多次釋放，

直到鎖計數達到零。在達到零時，互斥鎖實際上被釋放並且可以被其他執行緒獲取。

案例程式碼：

#include <stdio.h>
#include <string.h>
#include <unistd.h>

#include "ohos_init.h"
#include "cmsis_os2.h"

osMutexId_t mutex_id;

void HighPrioThread(void)
{
  // wait 1s until start actual work
  osDelay(100U);
  while (1)
  {
    // try to acquire mutex
    osMutexAcquire(mutex_id, osWaitForever);

    printf("HighPrioThread is runing.\r\n");
    osDelay(300U);
    osMutexRelease(mutex_id);
  }
}

void MidPrioThread(void)
{
  // wait 1s until start actual work
  osDelay(100U);

  while (1)
  {
    printf("MidPrioThread is runing.\r\n");
    osDelay(100);
  }
}

void LowPrioThread(void)
{
  while (1)
  {
    osMutexAcquire(mutex_id, osWaitForever);
    printf("LowPrioThread is runing.\r\n");

    // block mutex for 3s
    osDelay(300U);
    osMutexRelease(mutex_id);
  }
}

void Mutex_example(void)
{
  osThreadAttr_t attr;

  attr.attr_bits = 0U;
  attr.cb_mem = NULL;
  attr.cb_size = 0U;
  attr.stack_mem = NULL;
  attr.stack_size = 1024 * 4;

  attr.name = "HighPrioThread";
  attr.priority = 24;
  if (osThreadNew((osThreadFunc_t)HighPrioThread, NULL, &attr) == NULL)
  {
    printf("Falied to create HighPrioThread!\n");
  }

  
  attr.name = "MidPrioThread";
  attr.priority = 25;
  if (osThreadNew((osThreadFunc_t)MidPrioThread, NULL, &attr) == NULL)
  {
    printf("Falied to create MidPrioThread!\n");
  }

  attr.name = "LowPrioThread";
  attr.priority = 26;
  if (osThreadNew((osThreadFunc_t)LowPrioThread, NULL, &attr) == NULL)
  {
    printf("Falied to create LowPrioThread!\n");
  }
  mutex_id = osMutexNew(NULL);
  if (mutex_id == NULL)
  {
    printf("Falied to create Mutex!\n");
  }
}
APP_FEATURE_INIT(Mutex_example);