第3章 UART驱动
如果需要其它实现方法及商业合作,邮件联系[email protected]
3.1 UART封装需求
对于初使化一个UART,我们在定义UART编号后,初使化函数可以自动根据UART编号进行配置对应的gpio引脚,uart参数,dma参数。在定义UART回调函数后,Uart中断函数可以自动触发并响应。如果定义485控制引脚,不论发送函数或是接收函数可以根据发送或是接收情况自动设置485控制引脚的电平。我们只需要注重发送数据及接收数据的功能。
3.2 UART引脚编号
为使所有的UART编号唯一,我们需要对所有的UART(可以扩展)进行统一编号。
typedef enum {
wPIN_U1_A9A10 = (wuint)0xf011u,
wPIN_U1_B6B7 = (wuint)0xf012u,
wPIN_U2_A2A3 = (wuint)0xf021u,
wPIN_U2_D5D6 = (wuint)0xf022u,
wPIN_U3_B10B11 = (wuint)0xf031u,
wPIN_U3_C10C11 = (wuint)0xf032u,
wPIN_U3_D8D9 = (wuint)0xf033u,
wPIN_U4_C10C11 = (wuint)0xf041u,
wPIN_U5_C12D2 = (wuint)0xf042u,
…… …… ……
}
3.3 UART结构体引用
typedef void (*UartRxCpltFnct_Idle)(UART_HandleTypeDef *huart,uint32_t length);//接收空闲回调函数
typedef void (*UartTxCpltFnct )(UART_HandleTypeDef *huart);//发送完成回调函数
typedef struct wUart_def wUart_Def;
struct wUart_def{
UART_HandleTypeDef huart;
DMA_HandleTypeDef hdma_tx;
DMA_HandleTypeDef hdma_rx;
wGpio_Def CSS;
wUart_Def* NextPtr;
UartRxCpltFnct_Idle RxCplt_IdlePtr;
UartTxCpltFnct TxCpltPtr;
};
3.4 UART变量定义
wUart_Def* wUart_ListPtr;//起始链表指针
UART_HandleTypeDef* Int_huart[wUart_Num];
3.5 UART链表函数
static void wUart_List(wUart_Def *p_Uart)
{
//需要查询原有的链表中是否已经注册,如已经注册过,则无需再次注册
wUart_Def* p_list = wUart_ListPtr;
while(p_list != (wUart_Def *)NULL)
{
if(p_list == p_Uart){break;}
else{p_list = p_list->NextPtr;}
}
if(p_list != p_Uart)
{
//如还未注册过,则需注册
if( wUart_ListPtr == (wUart_Def *)NULL )
{
p_Uart->NextPtr = (wUart_Def *)NULL;
wUart_ListPtr = p_Uart;
}
else
{
p_Uart->NextPtr = wUart_ListPtr;
wUart_ListPtr = p_Uart;
}
}
}
3.6 UART(直接)初使化函数
UART_HandleTypeDef* wUart_Init(wUart_Def *p_Uart,wPin Pin,uint32_t BaudRate,uint32_t StopBits,uint32_t Parity,uint32_t Trans)
{
UART_HandleTypeDef* huart = &p_Uart->huart;
uint32_t Preempt = NoUse_Pri;
IRQn_Type IRQn;
if((Pin==wPIN_U1_A9A10) || (Pin==wPIN_U1_B6B7))
{
huart->Instance=USART1;
__HAL_RCC_USART1_CLK_ENABLE();
if(Pin==wPIN_U1_A9A10)
{
wGpio_Init(wPIN_A9,GPIO_MODE_AF_PP,GPIO_NOPULL,GPIO_SPEED_FREQ_HIGH,GPIO_AF7_USART1);
wGpio_Init(wPIN_A10,GPIO_MODE_AF_PP,GPIO_NOPULL,GPIO_SPEED_FREQ_HIGH,GPIO_AF7_USART1);
}else
{
wGpio_Init(wPIN_B6,GPIO_MODE_AF_PP,GPIO_NOPULL,GPIO_SPEED_FREQ_HIGH,GPIO_AF7_USART1);
wGpio_Init(wPIN_B7,GPIO_MODE_AF_PP,GPIO_NOPULL,GPIO_SPEED_FREQ_HIGH,GPIO_AF7_USART1);
}
Preempt = USART1_Pri;
IRQn = USART1_IRQn;
Int_huart[0] = huart;
}
else if((Pin==wPIN_U2_A2A3) || (Pin==wPIN_U2_D5D6))
{
huart->Instance=USART2;
__HAL_RCC_USART2_CLK_ENABLE();
if(Pin==wPIN_U2_A2A3)
{
wGpio_Init(wPIN_A2,GPIO_MODE_AF_PP,GPIO_NOPULL,GPIO_SPEED_FREQ_HIGH,GPIO_AF7_USART2);
wGpio_Init(wPIN_A3,GPIO_MODE_AF_PP,GPIO_NOPULL,GPIO_SPEED_FREQ_HIGH,GPIO_AF7_USART2);
}else
{
wGpio_Init(wPIN_D5,GPIO_MODE_AF_PP,GPIO_NOPULL,GPIO_SPEED_FREQ_HIGH,GPIO_AF7_USART2);
wGpio_Init(wPIN_D6,GPIO_MODE_AF_PP,GPIO_NOPULL,GPIO_SPEED_FREQ_HIGH,GPIO_AF7_USART2);
}
Preempt = USART2_Pri;
IRQn = USART2_IRQn;
Int_huart[1] = huart;
}
else if((Pin==wPIN_U3_B10B11) || (Pin==wPIN_U3_C10C11) || (Pin==wPIN_U3_D8D9))
{
huart->Instance=USART3;
__HAL_RCC_USART3_CLK_ENABLE();
if(Pin==wPIN_U3_B10B11)
{
wGpio_Init(wPIN_B10,GPIO_MODE_AF_PP,GPIO_NOPULL,GPIO_SPEED_FREQ_HIGH,GPIO_AF7_USART3);
wGpio_Init(wPIN_B11,GPIO_MODE_AF_PP,GPIO_NOPULL,GPIO_SPEED_FREQ_HIGH,GPIO_AF7_USART3);
}else if(Pin==wPIN_U3_C10C11)
{
wGpio_Init(wPIN_C10,GPIO_MODE_AF_PP,GPIO_NOPULL,GPIO_SPEED_FREQ_HIGH,GPIO_AF7_USART3);
wGpio_Init(wPIN_C11,GPIO_MODE_AF_PP,GPIO_NOPULL,GPIO_SPEED_FREQ_HIGH,GPIO_AF7_USART3);
}else
{
wGpio_Init(wPIN_D8,GPIO_MODE_AF_PP,GPIO_NOPULL,GPIO_SPEED_FREQ_HIGH,GPIO_AF7_USART3);
wGpio_Init(wPIN_D9,GPIO_MODE_AF_PP,GPIO_NOPULL,GPIO_SPEED_FREQ_HIGH,GPIO_AF7_USART3);
}
Preempt = USART3_Pri;
IRQn = USART3_IRQn;
Int_huart[2] = huart;
}
else if(Pin==wPIN_U4_C10C11)
{
huart->Instance=UART4;
__HAL_RCC_UART4_CLK_ENABLE();
wGpio_Init(wPIN_C10,GPIO_MODE_AF_PP,GPIO_NOPULL,GPIO_SPEED_FREQ_HIGH,GPIO_AF8_UART4);
wGpio_Init(wPIN_C11,GPIO_MODE_AF_PP,GPIO_NOPULL,GPIO_SPEED_FREQ_HIGH,GPIO_AF8_UART4);
Preempt = UART4_Pri;
IRQn = UART4_IRQn;
Int_huart[3] = huart;
}
else if(Pin==wPIN_U5_C12D2)
{
huart->Instance=UART5;
__HAL_RCC_UART5_CLK_ENABLE();
wGpio_Init(wPIN_C12,GPIO_MODE_AF_PP,GPIO_NOPULL,GPIO_SPEED_FREQ_HIGH,GPIO_AF8_UART5);
wGpio_Init(wPIN_D2,GPIO_MODE_AF_PP,GPIO_NOPULL,GPIO_SPEED_FREQ_HIGH,GPIO_AF8_UART5);
Preempt = UART5_Pri;
IRQn = UART5_IRQn;
Int_huart[4] = huart;
}
else
{return NULL;}
if(Preempt != NoUse_Pri)
{
HAL_NVIC_SetPriority(IRQn, Preempt, 0);
HAL_NVIC_EnableIRQ(IRQn);
}
wUart_List(p_Uart);
huart->Init.BaudRate = BaudRate;
if(StopBits==2)
{
huart->Init.StopBits = UART_STOPBITS_2;
}
else
{
huart->Init.StopBits = UART_STOPBITS_1;
}
if(IS_UART_PARITY(Parity))
{
huart->Init.Parity = Parity;
}
else
{
huart->Init.Parity = UART_PARITY_NONE;
}
if(huart->Init.Parity == UART_PARITY_NONE)
{
huart->Init.WordLength = UART_WORDLENGTH_8B;
}
else
{
huart->Init.WordLength = UART_WORDLENGTH_9B;
}
huart->Init.HwFlowCtl = UART_HWCONTROL_NONE;
huart->Init.OverSampling = UART_OVERSAMPLING_16; //在波特率较大切换UART_OVERSAMPLING_8
huart->Init.Mode = Trans & 0x00ff;
if (HAL_UART_Init(huart) != HAL_OK)
{
return NULL;
}
return huart;
}
3.7 UART(带DMA)初使化函数
UART_HandleTypeDef* wUart_DMAInit(wUart_Def *p_Uart,wPin Pin,uint32_t BaudRate,uint32_t StopBits,uint32_t Parity,uint32_t Trans)
{
UART_HandleTypeDef* huart = wUart_Init(p_Uart,Pin,BaudRate,StopBits,Parity,Trans);
if(huart== NULL) {return NULL;}
if((Trans & UART_MODE_TX) == UART_MODE_TX)
{//发送
__HAL_LINKDMA(huart,hdmatx,p_Uart->hdma_tx);
if(huart->Instance==USART1)
{
huart->hdmatx->Instance = DMA_USART1_TX_Instance;
wDma_Init(huart->hdmatx,DMA_USART1_TX_Instance,DMA_CHANNEL_4,DMA_MEMORY_TO_PERIPH,DMA_PDATAALIGN_BYTE,DMA_NORMAL,DMA_PRIORITY_HIGH);
}else if(huart->Instance==USART2)
{
huart->hdmatx->Instance = DMA_USART2_TX_Instance;
wDma_Init(huart->hdmatx,DMA_USART2_TX_Instance,DMA_CHANNEL_4,DMA_MEMORY_TO_PERIPH,DMA_PDATAALIGN_BYTE,DMA_NORMAL,DMA_PRIORITY_HIGH);
}else if(huart->Instance==USART3)
{
huart->hdmatx->Instance = DMA_USART3_TX_Instance;
wDma_Init(huart->hdmatx,DMA_USART3_TX_Instance,DMA_CHANNEL_7,DMA_MEMORY_TO_PERIPH,DMA_PDATAALIGN_BYTE,DMA_NORMAL,DMA_PRIORITY_HIGH);
}else if(huart->Instance==UART4)
{
huart->hdmatx->Instance = DMA_USART4_TX_Instance;
wDma_Init(huart->hdmatx,DMA_USART2_TX_Instance,DMA_CHANNEL_4,DMA_MEMORY_TO_PERIPH,DMA_PDATAALIGN_BYTE,DMA_NORMAL,DMA_PRIORITY_HIGH);
}
}
if((Trans & UART_MODE_RX) == UART_MODE_RX)
{
__HAL_LINKDMA(huart,hdmarx,p_Uart->hdma_rx);
#if defined(STM32F4)
huart->hdmarx->Init.Channel = DMA_CHANNEL_4;
#endif
if(huart->Instance==USART1)
{
huart->hdmarx->Instance = DMA_USART1_RX_Instance;
wDma_Init(huart->hdmarx,DMA_USART1_RX_Instance,DMA_CHANNEL_4,DMA_PERIPH_TO_MEMORY,DMA_PDATAALIGN_BYTE,DMA_CIRCULAR,DMA_PRIORITY_LOW);
}else if(huart->Instance==USART2)
{
huart->hdmarx->Instance = DMA_USART2_RX_Instance;
wDma_Init(huart->hdmarx,DMA_USART2_RX_Instance,DMA_CHANNEL_4,DMA_PERIPH_TO_MEMORY,DMA_PDATAALIGN_BYTE,DMA_CIRCULAR,DMA_PRIORITY_LOW);
}else if(huart->Instance==USART3)
{
huart->hdmarx->Instance = DMA_USART3_RX_Instance;
wDma_Init(huart->hdmarx,DMA_USART3_RX_Instance,DMA_CHANNEL_4,DMA_PERIPH_TO_MEMORY,DMA_PDATAALIGN_BYTE,DMA_CIRCULAR,DMA_PRIORITY_LOW);
}else if(huart->Instance==UART4)
{
huart->hdmarx->Instance = DMA_USART4_RX_Instance;
wDma_Init(huart->hdmarx,DMA_USART4_RX_Instance,DMA_CHANNEL_4,DMA_PERIPH_TO_MEMORY,DMA_PDATAALIGN_BYTE,DMA_CIRCULAR,DMA_PRIORITY_LOW);
}
}
/* Enable the UART Error Interrupt: (Frame error, noise error, overrun error) */
//__HAL_UART_ENABLE_IT(huart, UART_IT_ERR);
return huart ;
}
3.8 UART控制引脚配置(用于485传输)
void wUart_CSSCreate(wUart_Def *p_Uart,wPin pin,wGpio_Level level)
{
wGpio_putInit(&p_Uart->CSS,pin,GPIO_MODE_OUTPUT_PP,GPIO_NOPULL,GPIO_SPEED_FREQ_HIGH,level);
wGpio_putWrite(&p_Uart->CSS,Set_INACTIVE);
}
void wUart_CSSEnable( wUart_Def *p_Uart,uint8_t xEnable )
{
if (p_Uart->CSS.EN==ENABLE)
{
if(xEnable == wTxEnable)
{
wGpio_putWrite(&p_Uart->CSS,Set_INACTIVE);
}
else
{
wGpio_putWrite(&p_Uart->CSS,Set_ACTIVE);
}
}
}
static void wUart_CSSEnable_Handle( UART_HandleTypeDef *huart,uint8_t xEnable )
{
wUart_Def *p_Uart = wUart_ListPtr;
while (p_Uart != (wUart_Def *)NULL)
{
if(huart == &p_Uart->huart)
{
wUart_CSSEnable( p_Uart, xEnable );
break;
}
p_Uart = p_Uart->NextPtr;
}
}
3.9 UART中调回调函数配置
void wUart_SetCallback(wUart_Def *p_Uart,UartTxCpltFnct TxCpltPtr,UartRxCpltFnct_Idle RxCplt_IdlePtr)
{
if(p_Uart != (wUart_Def *)NULL)
{
p_Uart->TxCpltPtr = TxCpltPtr;
p_Uart->RxCplt_IdlePtr = RxCplt_IdlePtr;
}
}
3.10 UART(带DMA)发送函数
HAL_StatusTypeDef wUart_DMATransmit(UART_HandleTypeDef *huart, uint8_t *pData, uint16_t Size)
{
wUart_CSSEnable_Handle( huart,wTxEnable );
return HAL_UART_Transmit_DMA(huart,pData,Size);//开始接收数据
}
void wUart_AbortTransmit(UART_HandleTypeDef *huart)
{
wUart_CSSEnable_Handle( huart,wRxEnable );
__HAL_UART_CLEAR_FLAG(huart, UART_IT_TC | UART_IT_TXE);//清中断
}
3.11 UART(带DMA)接收函数
HAL_StatusTypeDef wUart_DMAReceive(UART_HandleTypeDef *huart, uint8_t *pData, uint16_t Size)
{
/* Clean the input path */
//__HAL_UART_FLUSH_DRREGISTER(huart);
__HAL_UART_CLEAR_FLAG(huart, UART_IT_RXNE);
__HAL_UART_CLEAR_IDLEFLAG(huart);
__HAL_UART_ENABLE_IT(huart,UART_IT_RXNE); //使能接收中断
__HAL_UART_ENABLE_IT(huart,UART_IT_IDLE); //使能空闲中断
wUart_CSSEnable_Handle( huart,wRxEnable );
return HAL_UART_Receive_DMA(huart,pData,Size);//开始接收数据
}
void wUart_AbortReceive(UART_HandleTypeDef *huart)
{
//__HAL_UART_DISABLE_IT(huart,UART_IT_RXNE); //关闭空闲中断
__HAL_UART_DISABLE_IT(huart,UART_IT_IDLE); //关闭空闲中断
__HAL_UART_CLEAR_FLAG(huart, UART_IT_RXNE);
__HAL_UART_CLEAR_IDLEFLAG(huart); //清空闲中断
HAL_UART_AbortReceive_IT(huart); //停止uart接收功能
}
3.12 UART中断处理函数
void USART1_IRQHandler(void)
{
OSIntEnter();
if(Int_huart[0] != NULL)
{
HAL_UART_RxCpltCallback_Idle(Int_huart[0]);
HAL_UART_IRQHandler(Int_huart[0]);
}
else
{
HAL_NVIC_ClearPendingIRQ(USART1_IRQn);
}
OSIntExit();
}
void USART2_IRQHandler(void)
{
OSIntEnter();
if(Int_huart[1] != NULL)
{
HAL_UART_RxCpltCallback_Idle(Int_huart[1]);
HAL_UART_IRQHandler(Int_huart[1]);
}
else
{
HAL_NVIC_ClearPendingIRQ(USART2_IRQn);
}
OSIntExit();
}
void USART3_IRQHandler(void)
{
OSIntEnter();
if(Int_huart[2] != NULL)
{
HAL_UART_RxCpltCallback_Idle(Int_huart[2]);
HAL_UART_IRQHandler(Int_huart[2]);
}
else
{
HAL_NVIC_ClearPendingIRQ(USART3_IRQn);
}
OSIntExit();
}
void UART4_IRQHandler(void)
{
OSIntEnter();
if(Int_huart[3] != NULL)
{
HAL_UART_RxCpltCallback_Idle(Int_huart[3]);
HAL_UART_IRQHandler(Int_huart[3]);
}
else
{
HAL_NVIC_ClearPendingIRQ(UART4_IRQn);
}
OSIntExit();
}
void UART5_IRQHandler(void)
{
OSIntEnter();
if(Int_huart[4] != NULL)
{
HAL_UART_RxCpltCallback_Idle(Int_huart[4]);
HAL_UART_IRQHandler(Int_huart[4]);
}
else
{
HAL_NVIC_ClearPendingIRQ(UART5_IRQn);
}
OSIntExit();
}
3.13 UART中断回调函数—发送完成
void HAL_UART_TxCpltCallback(UART_HandleTypeDef *huart)
{
wUart_Def *p_Uart = wUart_ListPtr;
wUart_AbortTransmit(huart);
while (p_Uart != (wUart_Def *)NULL)
{
if(huart == &p_Uart->huart)
{
if( p_Uart->TxCpltPtr != (UartTxCpltFnct )NULL)
{
p_Uart->TxCpltPtr(huart);
}
break;
}
p_Uart = p_Uart->NextPtr;
}
}
3.14 UART中断回调函数—空闲接收
void HAL_UART_RxCpltCallback_Idle(UART_HandleTypeDef *huart)
{
wUart_Def *p_Uart = wUart_ListPtr;
if(__HAL_UART_GET_FLAG(huart,UART_FLAG_IDLE) != RESET)
{
#if defined(STM32F1)
uint32_t length = huart->RxXferSize - huart->hdmarx->Instance->CNDTR;
#elif defined(STM32F4)
uint32_t length = huart->RxXferSize - huart->hdmarx->Instance->NDTR;
#endif
wUart_AbortReceive(huart);
while (p_Uart != (wUart_Def *)NULL)
{
if(huart == &p_Uart->huart)
{
if( p_Uart->RxCplt_IdlePtr != (UartRxCpltFnct_Idle )NULL)
{
p_Uart->RxCplt_IdlePtr(huart,length);
}
break;
}
p_Uart = p_Uart->NextPtr;
}
}
}