引言
今天被一个坑给坑了，难以平静，记录下。
ST的HAL库串口结构体 UART_InitTypeDef 的 WordLength 不单单是指数据位！ ST的HAL库串口结构体 UART_InitTypeDef 的 WordLength 不单单是指数据位！ ST的HAL库串口结构体 UART_InitTypeDef 的 WordLength 不单单是指数据位！
气人的话说三遍！
如果你有用到了奇偶校验的话，一定要在数据位数再加1。血淋淋的教训，浪费了本尊半天的生命，分分钟几百万上下的宝贵时间，居然被这细节给绊倒了！
原因分析
- ST的注释有误导嫌疑 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 */
- Semtech的串口驱动 uart-board 有不足
是的，作为一个官方库，还没考虑足够多的细节。在这里头就得把WordLength给准备好，一旦有奇偶校验，得给WordLength 1处理。
翻看串口例程
代码语言：javascript复制/*##-1- Configure the UART peripheral ######################################*/
/* Put the USART peripheral in the Asynchronous mode (UART Mode) */
/* UART configured as follows:
- Word Length = 8 Bits (7 data bit 1 parity bit)
- Stop Bit = One Stop bit
- Parity = ODD parity
- BaudRate = 9600 baud
- Hardware flow control disabled (RTS and CTS signals) */
UartHandle.Instance = USARTx;
UartHandle.Init.BaudRate = 9600;
UartHandle.Init.WordLength = UART_WORDLENGTH_8B;
UartHandle.Init.StopBits = UART_STOPBITS_1;
UartHandle.Init.Parity = UART_PARITY_ODD;
UartHandle.Init.HwFlowCtl = UART_HWCONTROL_NONE;
UartHandle.Init.Mode = UART_MODE_TX_RX;从这个例程注释才发现了端倪！
总结
在STM32中WordLength需要包含数据位数和奇偶校验的位数
如果需要8位数据，无奇偶校验，则WordLength=8 如果需要8位数据，有奇偶校验，则WordLength=9
