引言

今天被一个坑给坑了，难以平静，记录下。

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处理。

翻看串口例程

/*##-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