【GD32F303红枫派使用手册】第十五节 USART-printf打印实验

15.1 实验内容

通过本实验主要学习以下内容：

• 串口简介

• GD32F303串口工作原理

• 使用printf打印信息

15.2 实验原理

15.2.1 串口简介

串口，从广义上看，指所有串行通信接口，比如RS232、RS422、RS485、SPI、IIC等。串行通讯是指仅用一根接收线和一根发送线就能将数据以位进行传输的通讯方式。和串行通讯相对应的是并行通讯，并行通信指一个传输接口可以传输8个bit即一个byte（有时甚至更多），虽然串行通信比并行通信慢，但是串口可以在仅仅使用两根线的情况下就能实现数据的传输。

对于GD32F303来说，串口一般特指USART（通用同步异步收发器  ）和UART（通用异步收发器  ）。USART/UART提供了一个灵活方便的串行数据交换接口，数据帧可以通过全双工或半双工，同步或异步的方式进行传输。红枫派开发板搭载的GD32F303ZET6总共拥有5个串口，（USART+UART） 对于一般应用来说足够使用了。

15.2.2 串口通信帧介绍

GD32F303的串口通信只需要3条线组成，分别为TX（发送线）、RX（接收线）和GND，对于两个通信结点，TX和RX需要交叉连接，如下示例：、

下面来介绍下串口数据帧组成。

以下为一个标准的串口通信帧：

一个串口帧由空闲、起始位、数据位、校验位以及停止位组成，传输的数据地位在前，高位再后。

空闲：串口TX或RX数据线上没有传输任何数据时，则该线处于为空闲状态。空闲是TX和RX都是处于高电平。

 起始位：占一个bit时间，标志数据起始，由一个逻辑0（低电平）的数据位表示。当发送方开始发送一帧数据时，起始位会最先发送，而对于接收方来说，检测到起始位后，即使自己的接收时钟与发送方的数据同步。

数据位：数据位紧跟在起始位之后，是通信中的真正有效信息。数据位的位数可以由通信双方共同约定，对于GD32F303来说，数据位一般只有8位。

校验位：校验位占一bit时间，GD32F303可以设置校验位为：奇校验、偶校验或无校验。校验位是为了保证通信的可靠性，如果是奇校验，需要保证传输的数据总共有奇数个逻辑高位，如果是偶校验，需要保证传输的数据总共有偶数个逻辑高位。以传输传输数据A：0x01000001为例，如果设置了奇校验，则需要在校验位传输“1”，如果是偶检验，则传输“0”。奇偶校验是由硬件处理的，当设置好校验位后，硬件会自动根据需要传输的数据自动插入校验位。

停止位：它是一帧数据的结束标志，可以是1bit、1.5bit、2bit个逻辑“1”。

15.2.3 串口波特率

波特率是串口通信中一个非常重要的参数，串口通信传输双方必须要设置一样的串口波特率，否则通讯就会出错。波特率可以认为是比特率，即每秒传输的位数。一般波特率可以是9600、19200、115200等等，如果设置波特率为9600，设置通信帧为1bit起始位+8bit数据帧+无校验+1bit停止位，那么每秒钟最多可以传输9600bit/10bit = 960个字节。

现在重点介绍下GD32F303串口接收器的工作原理。GD32F303串口接收器采用的是16倍过采样，即发送方发送数据后，GD32F303串口接受器都会将每个bit采样16次：

在默认情况下，接收器通过获取三个采样点的值来估计该位的值。如果在3个采样点中有2个或3个为0，该数据位被视为0，否则为1。如果3个采样点中有一个采样点的值与其他两个不同，不管是起始位，数据位，奇偶校验位或者停止位，都将产生噪声错误（NERR）。

15.2.4 GD32F303串口设置步骤

串口设置的一般步骤为：

1. GPIO时钟开启、串口时钟开启

1. GPIO设置，一般发送IO需要设置为AF模式，接受IO设置为in-floating模式

1. 串口复位

1. 串口参数配置，主要为波特率、数据位长度、校验位设置、停止位长度

1. 依据是否需要使用中断或DMA进行中断配置或DMA配置

1. 使能串口

1. 编写中断处理函数

15.3 硬件设计

红枫派开发板设计了一个USB转UART功能，通过USB TypeC线将电脑和开发板连接起来，就可以进行电脑和开发板之间的串口通讯了。

15.4 代码解析

15.4.1 在driver_uart.c中定义了串口初始化函数driver_uart_init。

C
void driver_uart_init(typdef_uart_struct *uartx)
{
    rcu_periph_clock_enable(uartx->rcu_uart_x);
    usart_deinit(uartx->uart_x);
    driver_gpio_general_init(uartx->uart_rx_gpio);
    driver_gpio_general_init(uartx->uart_tx_gpio);        
    if(uartx->uart_mode_rx==MODE_DMA)
    {
        if(uartx->uart_rx_dma!=NULL)
        {
            driver_dma_com_init(uartx->uart_rx_dma,(uint32_t)&USART_DATA(uartx->uart_x),NULL,DMA_Width_8BIT,DMA_PERIPHERAL_TO_MEMORY);
            usart_interrupt_enable(uartx->uart_x,USART_INT_IDLE);
        }
    }

    if(uartx->uart_mode_tx==MODE_DMA)
    {    
        if(uartx->uart_tx_dma!=NULL)
        {
            driver_dma_com_init(uartx->uart_tx_dma,(uint32_t)&USART_DATA(uartx->uart_x),NULL,DMA_Width_8BIT,DMA_MEMORY_TO_PERIPHERAL);
        }
    }
    usart_baudrate_set(uartx->uart_x, uartx->baudrate);
    usart_receive_config(uartx->uart_x, USART_RECEIVE_ENABLE);
    usart_transmit_config(uartx->uart_x, USART_TRANSMIT_ENABLE);
    usart_word_length_set(uartx->uart_x, uartx->data_length);
    usart_parity_config(uartx->uart_x, uartx->parity);
    usart_enable(uartx->uart_x);        
}

15.4.2 重定向函数int fputc(int ch, FILE *f)

要使用Printf，重定向函数fputc 是必须的。在C 语言标准库中，fputc 函数是printf 函数内部的一个函数，功能是将字符ch 写入到文件指针file所指向文件的当前写指针位置，简单理解就是把字符写入到特定文件中。我们使用USART 函数重新修改fputc 函数内容，达到类似“写入”的功能。

fputc定义在bsp_uart.c中

C
int fputc(int ch, FILE *f)
{   
    driver_uart_transmit_byte(&BOARD_UART,(uint8_t)ch);    
    return ch;
}

 这个函数比较简单，就是调用了接口driver_uart_transmit_byte，该接口定义在driver_uart.c中：

C
Drv_Err driver_uart_transmit_byte(typdef_uart_struct *uartx,uint8_t data)
{
    uint32_t timeout = driver_tick;    
    while(uartx->uart_control.Com_Flag.Bits.SendState==1)
    {
        if((timeout+UART_TIMEOUT_MS) <= driver_tick) 
        {              
            uartx->uart_control.Com_Flag.Bits.SendState=0;
            return DRV_ERROR;        
        } 
    }
    
    Drv_Err uart_state=DRV_SUCCESS;    
    uartx->uart_control.Com_Flag.Bits.SendSucess=0;
    uartx->uart_control.Com_Flag.Bits.SendState=1;        
    uart_state=driver_uart_flag_wait_timeout(uartx,USART_FLAG_TBE,SET);
    usart_data_transmit(uartx->uart_x,data);    
    uartx->uart_control.Com_Flag.Bits.SendSucess=1;
    uartx->uart_control.Com_Flag.Bits.SendState=0;     
    return uart_state;          
}

 这段代码作用是，循环去读串口的TBE标志位，并且将待发送的数据写到串口寄存器中。

15.4.3 main函数实现

串口初始化完成并定义好fputc重定向函数后，就可以通过printf函数往电脑上打印数据了。以下main函数：

C
int main(void)
{
    delay_init();  
    bsp_uart_init(&BOARD_UART);
    bsp_led_init(&LED0);       
    while(1)
    {
        delay_ms(1000);
        bsp_led_toggle(&LED0);      
        printf("printf:system driver_tick is %lld \r\n",driver_tick);
    }
}

本例程main函数首先进行了延时函数初始化，再配置开发板上的USB串口，并设置了一个LED灯用来提示代码运行。while（1）循环中先延时1s，再翻转一次LED状态，接着使用printf函数打印系统运行tick时间。

15.5 实验结果

使用USB-TypeC线，连接电脑和板上USB to UART口后，配置好串口调试助手，即可看到每秒钟串口打印的数据了。

由聚沃科技原创，来源于【红枫派开发板】第十五讲 USART-printf打印实验 - 苏州聚沃电子科技有限公司 (gd32bbs.com)