比如串口，串口类型UART_HandleTypeDef的定义有Lock这个变量，其类型是下面这个枚举。
typedef enum
{
  HAL_UNLOCKED = 0x00,
  HAL_LOCKED   = 0x01  
} HAL_LockTypeDef;

串口接收/发送，或者中断模式接收/发送，都是先设置__HAL_LOCK()，然后配置huart，配置完后再__HAL_UNLOCK()。但感觉这个Lock没什么用啊。
接受过程中及中断里都没有涉及到这个变量，也许是我没找到。

以STM32F4系列为例
__HAL_LOCK和__HAL_UNLOCK定义在Drivers/STM32F4xx_HAL_driver/Inc/stm32f4xx_hal_def.h头文件中（假设是Cube生成的工程）。

1.   #define __HAL_LOCK(__HANDLE__)                                           \
   
2.                                 do{                                        \
   
3.                                     if((__HANDLE__)->Lock == HAL_LOCKED)   \
   
4.                                     {                                      \
   
5.                                        return HAL_BUSY;                    \
   
6.                                     }                                      \
   
7.                                     else                                   \
   
8.                                     {                                      \
   
9.                                        (__HANDLE__)->Lock = HAL_LOCKED;    \
   
10.                                     }                                      \
    
11.                                   }while (0)
    
12. 
    
13.   #define __HAL_UNLOCK(__HANDLE__)                                          \
    
14.                                   do{                                       \
    
15.                                       (__HANDLE__)->Lock = HAL_UNLOCKED;    \
    
16.                                     }while (0)

复制代码

通过代码可以看出__HAL_LOCK的作用是判断被操作的__HANDLE__是否已经加锁，如果已经加锁那么返回忙，并立即推出函数，如果未加锁，那么执行加锁。__HAL_UNLOCK则是解锁。

举个DMA操作的例子，调用HAL_DMA_Start启动一次DMA传输，在本次传输结束前不允许开始第二次DMA传输，因此HAL_DMA_Start操作执行了__HAL_LOCK进行加锁，在解锁前调用HAL_DMA_Start会返回HAL_BUSY而不会执行DMA操作。接下来调用HAL_DMA_PollForTransfer来轮询DMA是否操作完成，一旦HAL_DMA_PollForTransfer函数检测到DMA操作完成或发生错误，那么会调用__HAL_UNLOCK解锁，解锁之后才能进行下一次DMA请求。

1. HAL_StatusTypeDef HAL_DMA_Start(...)
   
2. {
   
3.   HAL_StatusTypeDef status = HAL_OK;
   
4.   
   
5.   /* Check the parameters */
   
6.   assert_param(IS_DMA_BUFFER_SIZE(DataLength));
   
7. 
   
8.   /* Process locked */
   
9.   __HAL_LOCK(hdma);
   
10. ...
    
11. }

复制代码

调用HAL_DMA_Start会在函数的开头调用__HAL_LOCK，假如DMA已经被开启了，那么这条语句将立即返回HAL_BUSY，否则标记DMA为加锁状态，并继续下面的代码。

1. HAL_StatusTypeDef HAL_DMA_PollForTransfer(...)
   
2. {
   
3. ...
   
4. 
   
5.   if(HAL_DMA_STATE_BUSY != hdma->State)
   
6.   {
   
7.     /* No transfer ongoing */
   
8.     hdma->ErrorCode = HAL_DMA_ERROR_NO_XFER;
   
9.     __HAL_UNLOCK(hdma);
   
10.     return HAL_ERROR;
    
11.   }
    
12. 
    
13. ...
    
14.   
    
15.   while(((tmpisr & mask_cpltlevel) == RESET) && ((hdma->ErrorCode & HAL_DMA_ERROR_TE) == RESET))
    
16.   {
    
17.     /* Check for the Timeout (Not applicable in circular mode)*/
    
18.     if(Timeout != HAL_MAX_DELAY)
    
19.     {
    
20.       if((Timeout == 0)||((HAL_GetTick() - tickstart ) > Timeout))
    
21.       {
    
22.         /* Update error code */
    
23.         hdma->ErrorCode = HAL_DMA_ERROR_TIMEOUT;
    
24. 
    
25.         /* Process Unlocked */
    
26.         __HAL_UNLOCK(hdma);
    
27.         
    
28.         /* Change the DMA state */
    
29.         hdma->State = HAL_DMA_STATE_READY;
    
30.         
    
31.         return HAL_TIMEOUT;
    
32.       }
    
33.     }
    
34. 
    
35. ...
    
36.   }
    
37.   
    
38.   if(hdma->ErrorCode != HAL_DMA_ERROR_NONE)
    
39.   {
    
40.     if((hdma->ErrorCode & HAL_DMA_ERROR_TE) != RESET)
    
41.     {
    
42.       HAL_DMA_Abort(hdma);
    
43.    
    
44.       /* Clear the half transfer and transfer complete flags */
    
45.       regs->IFCR = (DMA_FLAG_HTIF0_4 | DMA_FLAG_TCIF0_4) << hdma->StreamIndex;
    
46.    
    
47.       /* Process Unlocked */
    
48.       __HAL_UNLOCK(hdma);
    
49. 
    
50.       /* Change the DMA state */
    
51.       hdma->State= HAL_DMA_STATE_READY;
    
52. 
    
53.       return HAL_ERROR;
    
54.    }
    
55. 
    
56.   }
    
57. 
    
58.   /* Get the level transfer complete flag */
    
59.   if(CompleteLevel == HAL_DMA_FULL_TRANSFER)
    
60.   {
    
61.     /* Clear the half transfer and transfer complete flags */
    
62.     regs->IFCR = (DMA_FLAG_HTIF0_4 | DMA_FLAG_TCIF0_4) << hdma->StreamIndex;
    
63.    
    
64.     /* Process Unlocked */
    
65.     __HAL_UNLOCK(hdma);
    
66. 
    
67.     hdma->State = HAL_DMA_STATE_READY;
    
68.   }
    
69.   else
    
70.   {
    
71.     /* Clear the half transfer and transfer complete flags */
    
72.     regs->IFCR = (DMA_FLAG_HTIF0_4) << hdma->StreamIndex;
    
73.   }
    
74.   
    
75.   return status;
    
76. }

复制代码

HAL_DMA_PollForTransfer会根据当前的DMA状态在适当的时机调用__HAL_UNLOCK解锁。

有用的，不知道你用过F0系列没有，F0的HAL库里面调用更新时间函数后时间不更新，就是由于这个锁，我开始还以为是硬件问题呢。应该和RTOS里面的互斥量差不多吧

之所以这么问，是之前看到creep大神给的DMA+空闲中断里的空闲回调函数里有个
__HAL_UNLOCK(huart->hdmarx);
之前一直不明白为什么这里有个UNLOCK，而没有找到对应的LOCK。今天修改这部分时，没有加这句，结果接收数组一直是第一次接收的数据。现在想想，应该是后来DMA就没有再使能。
但我没找到根据Lock位做判断的地方。

估计是一个标志位？停止没完成当前的工作，然后又重复操作？

是一个什么的锁来着吧

zoomdy 发表于 2017-1-20 15:48
以STM32F4系列为例
__HAL_LOCK和__HAL_UNLOCK定义在Drivers/STM32F4xx_HAL_driver/Inc/stm32f4xx_hal_def.h ...

能否指明下，__HAL_LOCK()这个函数，在已被锁的情况下被调用后，返回量return HAL_BUSY，这个值，在什么地方被用到？

额，明白了，，__HAL_LOCK()是个宏，如果执行return HAL_BUSY；则直接退出上级函数了。感谢指教。