串口轮询数据收发实现
1.硬件原理图分析

通过电脑 USB 与开发板的连接示意图如下图所示。虽然电脑使用的是 USB 接口,但对于软件应用来讲其实是串口,这是为了解决现在多数电脑都没有标配串口的问题。

2.需求分析
1.由上位机通过USB转串口向MCU发送数据,发送并成功接收
2.由MCU将刚刚接收到的数据发送给上位机,发送并成功并在串口工具,将LED电平转换,提示接收成功
3.工程配置
DAP Link是⼀种调试器硬件,而SWD是⼀种调试通信协议;DAP Link通过SWD协议与目标芯片通信。

时钟源选用外部高速晶振HSE

然后对时钟树进行下面的配置

LED配置,选择开漏输出默认低电平,即LED点亮


串口配置,选择异步,9位,1位校验位,奇校验,8位数据位,波特率115200

最后选择编译工具和文件路径,生成文件

4.代码编写
cs
/* USER CODE BEGIN Includes */
#include<stdint.h>
/* USER CODE END Includes */
/* USER CODE BEGIN PV */
uint8_t recv_byte = 0;
uint32_t cnt = 0;
/* USER CODE END PV */
/* USER CODE BEGIN WHILE */
while (1)
{
if (HAL_OK == HAL_UART_Receive(&huart1, &recv_byte, 1, HAL_MAX_DELAY))
{
HAL_UART_Transmit(&huart1, &recv_byte, 1, 0);
cnt++;
}
if (cnt >= 10)
{
cnt = 0;
HAL_GPIO_TogglePin(GPIOF, GPIO_PIN_8);
}
/* USER CODE END WHILE */
/* USER CODE BEGIN 3 */
}
/* USER CODE END 3 */
}
串口工具下载
下载链接:https://sourceforge.net/projects/comtool/,选择3.4.0版本
选择中文

收发配置MCU配置一样的

4.1代码分析
cs
HAL_StatusTypeDef HAL_UART_Receive(UART_HandleTypeDef
*huart,
uint8_t *pData,
uint16_t Size,
uint32_t Timeout)
-
huart:指向UART_HandleTypeDef结构体的指针。它包含了指定 UART 外设(如 USART1、USART2)的配置信息,决定了你要从哪个串口接收数据。 -
pData:指向接收数据缓冲区的指针。函数会把收到的数据存放到这个地址开始的内存中。数据类型通常为uint8_t*(字节),但在特定字长配置下可视为uint16_t*。 -
Size:要接收的数据元素个数。这里指的是元素数量 ,而非字节数。在常规 8 位数据模式下,1 个元素就是 1 个字节;如果配置了 9 位字长且未开启校验,则 1 个元素对应 2 个字节(u16)。 -
Timeout:超时时间,单位通常为毫秒(ms)。这是防止程序永久卡死的关键参数。如果在指定时间内没有收满Size个数据,函数会强制返回超时状态(HAL_TIMEOUT)。 -
huart:指向UART_HandleTypeDef结构体的指针。它包含了指定 UART 外设(如 USART1、USART2)的配置信息,决定了你要从哪个串口接收数据。 -
pData:指向接收数据缓冲区的指针。函数会把收到的数据存放到这个地址开始的内存中。数据类型通常为uint8_t*(字节),但在特定字长配置下可视为uint16_t*。 -
Size:要接收的数据元素个数。这里指的是元素数量 ,而非字节数。在常规 8 位数据模式下,1 个元素就是 1 个字节;如果配置了 9 位字长且未开启校验,则 1 个元素对应 2 个字节(u16)。 -
Timeout:超时时间,单位通常为毫秒(ms)。这是防止程序永久卡死的关键参数。如果在指定时间内没有收满Size个数据,函数会强制返回超时状态(HAL_TIMEOUT)。
1. 阻塞特性与超时机制
该函数采用轮询方式。在等待数据期间,CPU 无法处理其他任务。例如,若你请求接收 5 个字节,但对方只发了 3 个字节,程序会一直阻塞直到 Timeout 时间耗尽,然后返回 HAL_TIMEOUT 错误。因此,它仅适合数据量少、且接收时机确定的简单场景,不建议在需要同时处理多任务的系统中使用。
2. 返回值含义
调用后应检查返回值以确认接收状态:
-
HAL_OK:成功接收到了指定数量的数据。 -
HAL_TIMEOUT:在超时时间内未收满数据。 -
HAL_ERROR:发生通信错误(如校验错误、帧错误等)。 -
HAL_BUSY:串口当前正被其他进程占用(例如正在发送或已被中断/DMA 接收占用)。
cs
HAL_StatusTypeDef HAL_UART_Transmit(UART_HandleTypeDef *huart,
uint8_t *pData,
uint16_t Size,
uint32_t Timeout);
-
huart:指向UART_HandleTypeDef结构体的指针,指定了要使用的串口外设(如&huart1)。 -
pData:指向待发送数据缓冲区的指针。通常为uint8_t*类型,因为串口一般按字节发送。 -
Size:要发送的数据元素个数 。在常规 8 位数据模式下,1 个元素即 1 个字节。特殊注意 :如果串口配置为 9 位字长且无校验,pData需按uint16_t对齐,Size表示u16的数量。 -
Timeout:超时时间(单位:ms)。这是防止程序因硬件故障永久卡死的关键。若在设定时间内未能发送完所有数据,函数会中止并返回HAL_TIMEOUT。
1. 阻塞机制
该函数内部通过轮询发送数据寄存器空标志(TXE)来逐字节发送。在发送期间,程序会停留在函数内部。因此,它仅适合数据量小、发送频率低的场景。如果波特率较低而 Size 较大,Timeout 设置过短会导致发送未完成就提前超时返回。
2. 返回值含义
-
HAL_OK:数据已全部成功发送。 -
HAL_TIMEOUT:在超时时间内未发送完数据。 -
HAL_BUSY:串口当前正忙(例如正被其他发送/接收进程占用)。 -
HAL_ERROR:传入参数错误(如pData为NULL或Size为 0)。
4.2测试
USB转串口烧录,需要下载一个软件,CH340工具,去识别串口

当收发超过10个字节LED将会进行反转,由初始亮转成灭

5.源码分析
UART初始化
cs
MX_USART1_UART_Init();
static void MX_USART1_UART_Init(void)
{
/* USER CODE BEGIN USART1_Init 0 */
/* USER CODE END USART1_Init 0 */
/* USER CODE BEGIN USART1_Init 1 */
/* USER CODE END USART1_Init 1 */
huart1.Instance = USART1;
huart1.Init.BaudRate = 115200;
huart1.Init.WordLength = UART_WORDLENGTH_9B;
huart1.Init.StopBits = UART_STOPBITS_1;
huart1.Init.Parity = UART_PARITY_ODD;
huart1.Init.Mode = UART_MODE_TX_RX;
huart1.Init.HwFlowCtl = UART_HWCONTROL_NONE;
huart1.Init.OverSampling = UART_OVERSAMPLING_16;
if (HAL_UART_Init(&huart1) != HAL_OK)
{
Error_Handler();
}
/* USER CODE BEGIN USART1_Init 2 */
/* USER CODE END USART1_Init 2 */
}
其中的huart1,是一个UART_HandleTypeDef句柄
cs
UART_HandleTypeDef huart1;
typedef struct __UART_HandleTypeDef
{
USART_TypeDef *Instance; /*!< UART registers base address */
UART_InitTypeDef Init; /*!< UART communication parameters */
const uint8_t *pTxBuffPtr; /*!< Pointer to UART Tx transfer Buffer */
uint16_t TxXferSize; /*!< UART Tx Transfer size */
__IO uint16_t TxXferCount; /*!< UART Tx Transfer Counter */
uint8_t *pRxBuffPtr; /*!< Pointer to UART Rx transfer Buffer */
uint16_t RxXferSize; /*!< UART Rx Transfer size */
__IO uint16_t RxXferCount; /*!< UART Rx Transfer Counter */
__IO HAL_UART_RxTypeTypeDef ReceptionType; /*!< Type of ongoing reception */
__IO HAL_UART_RxEventTypeTypeDef RxEventType; /*!< Type of Rx Event */
DMA_HandleTypeDef *hdmatx; /*!< UART Tx DMA Handle parameters */
DMA_HandleTypeDef *hdmarx; /*!< UART Rx DMA Handle parameters */
HAL_LockTypeDef Lock; /*!< Locking object */
__IO HAL_UART_StateTypeDef gState; /*!< UART state information related to global Handle management
and also related to Tx operations.
This parameter can be a value of @ref HAL_UART_StateTypeDef */
__IO HAL_UART_StateTypeDef RxState; /*!< UART state information related to Rx operations.
This parameter can be a value of @ref HAL_UART_StateTypeDef */
__IO uint32_t ErrorCode; /*!< UART Error code */
#if (USE_HAL_UART_REGISTER_CALLBACKS == 1)
void (* TxHalfCpltCallback)(struct __UART_HandleTypeDef *huart); /*!< UART Tx Half Complete Callback */
void (* TxCpltCallback)(struct __UART_HandleTypeDef *huart); /*!< UART Tx Complete Callback */
void (* RxHalfCpltCallback)(struct __UART_HandleTypeDef *huart); /*!< UART Rx Half Complete Callback */
void (* RxCpltCallback)(struct __UART_HandleTypeDef *huart); /*!< UART Rx Complete Callback */
void (* ErrorCallback)(struct __UART_HandleTypeDef *huart); /*!< UART Error Callback */
void (* AbortCpltCallback)(struct __UART_HandleTypeDef *huart); /*!< UART Abort Complete Callback */
void (* AbortTransmitCpltCallback)(struct __UART_HandleTypeDef *huart); /*!< UART Abort Transmit Complete Callback */
void (* AbortReceiveCpltCallback)(struct __UART_HandleTypeDef *huart); /*!< UART Abort Receive Complete Callback */
void (* WakeupCallback)(struct __UART_HandleTypeDef *huart); /*!< UART Wakeup Callback */
void (* RxEventCallback)(struct __UART_HandleTypeDef *huart, uint16_t Pos); /*!< UART Reception Event Callback */
void (* MspInitCallback)(struct __UART_HandleTypeDef *huart); /*!< UART Msp Init callback */
void (* MspDeInitCallback)(struct __UART_HandleTypeDef *huart); /*!< UART Msp DeInit callback */
#endif /* USE_HAL_UART_REGISTER_CALLBACKS */
} UART_HandleTypeDef;
USART_TypeDef是串口结构体,按顺序排列里面的寄存器
cs
typedef struct
{
__IO uint32_t SR; /*!< USART Status register, Address offset: 0x00 */
__IO uint32_t DR; /*!< USART Data register, Address offset: 0x04 */
__IO uint32_t BRR; /*!< USART Baud rate register, Address offset: 0x08 */
__IO uint32_t CR1; /*!< USART Control register 1, Address offset: 0x0C */
__IO uint32_t CR2; /*!< USART Control register 2, Address offset: 0x10 */
__IO uint32_t CR3; /*!< USART Control register 3, Address offset: 0x14 */
__IO uint32_t GTPR; /*!< USART Guard time and prescaler register, Address offset: 0x18 */
} USART_TypeDef;
UART_InitTypeDef就工程配置时的参数
cs
typedef struct
{
uint32_t BaudRate; /*!< This member configures the UART communication baud rate.
The baud rate is computed using the following formula:
- IntegerDivider = ((PCLKx) / (16 * (huart->Init.BaudRate)))
- FractionalDivider = ((IntegerDivider - ((uint32_t) IntegerDivider)) * 16) + 0.5 */
uint32_t WordLength; /*!< Specifies the number of data bits transmitted or received in a frame.
This parameter can be a value of @ref UART_Word_Length */
uint32_t StopBits; /*!< Specifies the number of stop bits transmitted.
This parameter can be a value of @ref UART_Stop_Bits */
uint32_t Parity; /*!< Specifies the parity mode.
This parameter can be a value of @ref UART_Parity
@note When parity is enabled, the computed parity is inserted
at the MSB position of the transmitted data (9th bit when
the word length is set to 9 data bits; 8th bit when the
word length is set to 8 data bits). */
uint32_t Mode; /*!< Specifies whether the Receive or Transmit mode is enabled or disabled.
This parameter can be a value of @ref UART_Mode */
uint32_t HwFlowCtl; /*!< Specifies whether the hardware flow control mode is enabled or disabled.
This parameter can be a value of @ref UART_Hardware_Flow_Control */
uint32_t OverSampling; /*!< Specifies whether the Over sampling 8 is enabled or disabled, to achieve higher speed (up to fPCLK/8).
This parameter can be a value of @ref UART_Over_Sampling. This feature is only available
on STM32F100xx family, so OverSampling parameter should always be set to 16. */
} UART_InitTypeDef;
然后通过 HAL_UART_Init 把 Init 配置到 *Instance 里面
cs
HAL_StatusTypeDef HAL_UART_Init(UART_HandleTypeDef *huart)
{
/* Check the UART handle allocation */
if (huart == NULL)
{
return HAL_ERROR;
}
/* Check the parameters */
if (huart->Init.HwFlowCtl != UART_HWCONTROL_NONE)
{
/* The hardware flow control is available only for USART1, USART2 and USART3 */
assert_param(IS_UART_HWFLOW_INSTANCE(huart->Instance));
assert_param(IS_UART_HARDWARE_FLOW_CONTROL(huart->Init.HwFlowCtl));
}
else
{
assert_param(IS_UART_INSTANCE(huart->Instance));
}
assert_param(IS_UART_WORD_LENGTH(huart->Init.WordLength));
#if defined(USART_CR1_OVER8)
assert_param(IS_UART_OVERSAMPLING(huart->Init.OverSampling));
#endif /* USART_CR1_OVER8 */
if (huart->gState == HAL_UART_STATE_RESET)
{
/* Allocate lock resource and initialize it */
huart->Lock = HAL_UNLOCKED;
#if (USE_HAL_UART_REGISTER_CALLBACKS == 1)
UART_InitCallbacksToDefault(huart);
if (huart->MspInitCallback == NULL)
{
huart->MspInitCallback = HAL_UART_MspInit;
}
/* Init the low level hardware */
huart->MspInitCallback(huart);
#else
/* Init the low level hardware : GPIO, CLOCK */
HAL_UART_MspInit(huart);
#endif /* (USE_HAL_UART_REGISTER_CALLBACKS) */
}
huart->gState = HAL_UART_STATE_BUSY;
/* Disable the peripheral */
__HAL_UART_DISABLE(huart);
/* Set the UART Communication parameters */
UART_SetConfig(huart);
/* In asynchronous mode, the following bits must be kept cleared:
- LINEN and CLKEN bits in the USART_CR2 register,
- SCEN, HDSEL and IREN bits in the USART_CR3 register.*/
CLEAR_BIT(huart->Instance->CR2, (USART_CR2_LINEN | USART_CR2_CLKEN));
CLEAR_BIT(huart->Instance->CR3, (USART_CR3_SCEN | USART_CR3_HDSEL | USART_CR3_IREN));
/* Enable the peripheral */
__HAL_UART_ENABLE(huart);
/* Initialize the UART state */
huart->ErrorCode = HAL_UART_ERROR_NONE;
huart->gState = HAL_UART_STATE_READY;
huart->RxState = HAL_UART_STATE_READY;
huart->RxEventType = HAL_UART_RXEVENT_TC;
return HAL_OK;
}