互斥鎖的概念

互斥鎖是一種特殊的二值信號量，因為它解決了優(yōu)先級翻轉(zhuǎn)的問題?？梢酝ㄟ^優(yōu)先級繼承機制來解決：當(dāng)另外一個的任務(wù)試圖獲取同一個互斥鎖時，已經(jīng)獲得互斥鎖的任務(wù)將繼承該任務(wù)的優(yōu)先級。

互斥鎖有一個比較明顯的特點，即它必須哪一個線程申請，就由該線程來釋放。而在二值信號量中，釋放和獲取token的線程可以不一致。因此，在處理線程之間占用同一硬件資源的問題時首先考慮使用互斥鎖。

API Description 【互斥鎖不能在中斷中使用】

①創(chuàng)建互斥鎖

在CMSIS-RTOS中，互斥鎖通過 ***osMutexNew() *** 函數(shù)和配置結(jié)構(gòu)體 *osMutexAttr_t *建立。

1）配置結(jié)構(gòu)體osMutexAttr_t

在osMutexAttr_t 中功能參數(shù) *attr_bits ***用于配置互斥鎖的功能特性，相當(dāng)重要;參數(shù)相關(guān)定義包括: **

1.* osMutexRecursive * - 創(chuàng)建遞歸互斥鎖。當(dāng)上鎖開鎖的程序段遞歸時，會出現(xiàn)多重加鎖的情況，并從深處向外解鎖。此時應(yīng)當(dāng)引入對遞歸的支持。本參數(shù)配置了一個遞歸計數(shù)機制，允許同一個線程多重加鎖；調(diào)用一次計數(shù)+1，釋放-1；當(dāng)計數(shù)回到0時此鎖解開。

2.osMutexPrioInherit - 優(yōu)先級繼承機制?？梢苑乐箖?yōu)先級翻轉(zhuǎn)。

3. *osMutexRobust * - 互斥鎖回收機制。當(dāng)加鎖的線程被 osThreadExit() 或 *osThreadTerminate() *終止而未能解鎖時，鎖將會自動回收。

上述三個參數(shù)可以通過邏輯或( | )組合傳入結(jié)構(gòu)體。

typedef struct {
  const char                   *name;   ///名稱，僅標(biāo)識用
  uint32_t                 attr_bits;   ///功能參數(shù)；重要
  void                       *cb_mem;   /// memory for control block；Default ==NULL
  uint32_t                   cb_size;   /// Default==0U
} osMutexAttr_t;

@param    attr_bits:  -參數(shù)配置；可通過邏輯或 輸入復(fù)數(shù)的參數(shù)
        / osMutexPrioInherit  -使用優(yōu)先級繼承
        / osMutexRecursive    -遞歸互斥鎖
        / osMutexRobust       -自回收;當(dāng)線程終止時自動釋放持有的token

2. 通過 ***osMutexNew() ***創(chuàng)建目標(biāo)互斥鎖

osMutexId_t osMutexNew (const osMutexAttr_t *attr);/*創(chuàng)建互斥鎖
@param    *attr    -osMutexAttr_t互斥鎖配置結(jié)構(gòu)體
@retval    －句柄(地址)
            ==NULL   創(chuàng)建失敗*/

**②刪除互斥鎖 **osMutexDelete()

osStatus_t osMutexDelete( osMutexId_t  mutex_id );/*刪除互斥鎖
@retval:    -osOK //成功
            -osErrorParameter: parameter mutex_id is NULL or invalid.
            -osErrorResource: the mutex is in an invalid state.(其他錯誤)
            -osErrorISR: 在中斷調(diào)用導(dǎo)致的錯誤
*/

③獲取互斥鎖token osMutexAcquire()

互斥鎖token的獲取與二值信號量基本一致。 線程調(diào)用該函數(shù)時，當(dāng)鎖中無token時，線程進入BLOCK狀態(tài)等待消息量被放入token；。在此期間當(dāng)任務(wù)檢測到消息量放入token時，將自動由****BLOCK態(tài)轉(zhuǎn)移為READY態(tài)。當(dāng)?shù)却臅r間超過了指定的阻塞時間，即使隊列中尚無數(shù)據(jù)，任務(wù)也會自動從阻塞態(tài)轉(zhuǎn)移為READY態(tài)。此時程序會返回osErrorTimeout錯誤。若沒有設(shè)置阻塞超時且參數(shù)正確，返回osErrorResource錯誤**。**

osStatus_t osMutexAcquire (osMutexId_t mutex_id, uint32_t timeout);/*取得token;
@param      timeout      阻塞等待時間
@retval    -osOK: the mutex has been obtained.
           -osErrorTimeout: the mutex could not be obtained in the given time.
           -osErrorResource: the mutex could not be obtained when no timeout was specified.
           -osErrorParameter: parameter mutex_id is NULL or invalid.
           -osErrorISR: cannot be called from interrupt service routines.
*/

timeout參數(shù)：

== 0U //不設(shè)置阻塞超時時間，若出現(xiàn)異常函數(shù)將直接報錯返回
== osWaitForever //任務(wù)將一直阻塞直到鎖中token被相應(yīng)線程歸還
== Ticks //設(shè)置具體等待時間，單位為RTOS心跳數(shù)(Ticks)

④歸還互斥鎖tokenosMutexRelease() ****

注意互斥鎖的token歸還只能由獲取的線程進行，否則系統(tǒng)會報Resource錯誤。

osStatus_t osMutexRelease (osMutexId_t mutex_id);/*歸還互斥鎖
@retval      -osOK: 成功
             -osErrorResource: 無法歸還(當(dāng)前token沒有被獲取 或 本線程不持有互斥鎖的token)
             -osErrorParameter: parameter mutex_id is NULL or invalid.
             -osErrorISR: 在中斷中調(diào)用了本函數(shù)
*/
```**⑤查詢當(dāng)前互斥鎖token的擁有者(線程)****  ***osMutexGetOwner()*********

osThreadId_t osMutexGetOwner (osMutexId_t mutex_id)/*
@retval -持有互斥鎖token的線程句柄(ID);
若token未被持有或 發(fā)生錯誤，則返回NULL
*/