RT-Thread: 基于STM32CubeMX配置驱STM32驱动的USB虚拟串口调试

关键词：USB 虚拟串口 USB虚拟串口，RT-Thread Studio，STM32

说明：

1：文档记录 STM32F103系列基于 RT-Thread 系统的 USB虚拟串口的开启及数据收发应用流程介绍。

2：本文以STM32F103C8T6型号做测试，STM32CubeMX生成USB驱动。

1：创建 RT-Thread STM32F103C8T6 的工程

1.1 RT-Thread Studio 中创建工程

由于 STM32F103C8T6 的资源有限，先按以下流程关闭一些系统的框架，以便节省 ROM ,其他 ROM大的 IC 可以不用考虑这一步操作。

关闭掉 finsh

去掉勾选【使能内核调试功能】，这样系统编译后能减少20K左右

2：开启USB相关的框架设置

2.1 开启系统USB驱动程序

设置完成后点保存按钮保存。

2.2 board.h 中搜索 USB 按使用流程开启相关的宏定义

注意：这里用的是 USB DEVICE CONFIG

2.3 开启 #define BSP_USING_USBDEVICE 宏

/*-------------------------- USB DEVICE CONFIG BEGIN --------------------------*//** if you want to use usb device you can use the following instructions.** STEP 1, open usb device driver framework support in the RT-Thread Settings file** STEP 2 define macro related to the usb device*                 such as    BSP_USING_USBDEVICE** STEP 3, copy your usb device init function from stm32xxxx_hal_msp.c generated by stm32cubemx to the end of board.c file*                 such as     void HAL_PCD_MspInit(PCD_HandleTypeDef* hpcd)** STEP 4, config your usb peripheral clock in SystemClock_Config() generated by STM32CubeMX and replace this function in board.c** STEP 5, modify your stm32xxxx_hal_config.h file to support usb device peripherals. define macro related to the peripherals*                 such as     #define HAL_PCD_MODULE_ENABLED**/#define BSP_USING_USBDEVICE

2.4 开启 #define HAL_PCD_MODULE_ENABLED 宏

2.5 用STM32CubeMX生成时钟配置代码和 USB初始化代码

创建 MCU 对应的 STM32CubeMX 工程

设置时钟源为外部晶振

设置调试模式为 Serial Wire 否则我用 ST-LINK 调试时会出现只能下载一次程序的情况。

配置时钟，没有标注箭头的其他选项根据实际需求配置

配置USB相关配置项，其他的选择了默认选项，

项目配置，配置输出工程文件时的设置

输出代码,按钮在软件窗口右上角位置

导出的工程文件

3：移植 STM32CubeMX 生成时钟配置和USB初始化代码到 RT-Thread 工程

需要用到的代码在 Core 文件夹中

3.1 时钟配置代码移植，时钟代码在 main.c 文件的 void SystemClock_Config(void) 函数中

把 void SystemClock_Config(void) 函数中的代码复制到 drv_ckl.c 文件中，替换掉 void system_clock_config(int target_freq_Mhz) 函数中的代码。

3.2 USB配置代码移植

usb.c 文件中包含了 USB 的配置和初始化代码，复制这些代码到 board.c 文件的末尾。

4：编译下载程序，并在电脑设备管理处查看 USB虚拟串口的识别情况

编译后大小约 54K ，编译没有报错后继续第 5 步。

编译并烧录程序，把MCU的USB接口连接电脑，系统会自动检测并添加驱动，这个过程大概需要10s左右，添加成功后设备管理里面可以看到新增的 COM 口。

5：添加 USB 的收发数据的应用代码

文末附带测试工程，usb_com_drv.c 包含USB的数据收发功能函数

/** Copyright (c) 2006-2020, RT-Thread Development Team** SPDX-License-Identifier: Apache-2.0** Change Logs:* Date           Author       Notes* 2020-05-26     yl       the first version*/
/*说明：本文档提供一个 基于 RT-Thread 的USB虚拟串口接收和数据解析功能函数，解析按制定的通信协议进行解析，解析收到的数据合法后再调用具体的功能解析函数去解析具体功能。*1.添加USB虚拟串口：board.h 中搜索 USB 关键词，查找到 #define BSP_USING_USBDEVICE 去除注释，开启流程按 USB DEVICE CONFIG BEGIN 介绍的流程操作。*2.添加功能解析函数：在宏定义添加功能解析函数  #define Uart_Function_Resolver      usb_data_sample();    这里填入需要调用的功能解析函数。*3.协议解析函数：这个函数按协议格式解析收到的数据是否符合协议规范 ，符合的再调用功能解析函数解析具体解析。* */#include "user_cfg.h"#define Sync                        0xAE                           /* 通讯协议头 */#define SAMPLE_USB_NAME             "vcom"                         /* 需要操作的USB虚拟串口设备 */
#define rx_sem_usb                  usb_rx_sem                     /* 定义USB虚拟串口专用的信号量*/
#define Uart_Function_Resolver      usb_data_printf();             /* 这里填入需要调用的功能解析函数*/#define UART_TIMEOUT                50                             /* USB虚拟串口接收数据的超时时间 */
#define ONE_DATA_MAXLEN_USB         255                            /* 不定长数据的最大长度 ,接收缓存大小*/
#define DATA_CMD_END                '\r'                           /* 结束位设置为 \r，即回车符 */rt_device_t serial_usb;                                            /* USB虚拟串口设备句柄 */
static struct rt_semaphore rx_sem_usb;                             /* 用于接收消息的信号量 */
static uint8_t usb_rx_buffer[ONE_DATA_MAXLEN_USB];                 /* 定义用于接收USB虚拟串口数据的缓存数组 *//*测试代码,打印USB虚拟串口收到的数据到 调试串口 和 USB虚拟串口*/
static void usb_data_printf(void)
{rt_device_write(serial_usb, 0, usb_rx_buffer, ONE_DATA_MAXLEN_USB);rt_kprintf("read_usb_data =  \r\n");for (uint8_t var = 0; var < ONE_DATA_MAXLEN_USB; ++var){rt_kprintf("%02x " ,usb_rx_buffer[var]);if (var%30 == 0){rt_kprintf("\r\n");}}
}/* USB接收数据回调函数，USB虚拟串口接收到数据后产生中断，调用此回调函数，然后发送接收信号量 */
static rt_err_t uart_rx_ind(rt_device_t dev, rt_size_t size)
{/* ：USB虚拟串口接收到数据后产生中断，调用此回调函数，然后发送接收信号量 */if (size > 0){rt_sem_release(&rx_sem_usb);/*释放信号量可以唤醒挂起在该信号量上的线程*/}return RT_EOK;
}/* USB虚拟串口接收数据函数 */
static uint16_t uart_sample_get_char(void)
{rt_err_t timeout;char ch;while (rt_device_read(serial_usb, 0, &ch, 1) == 0){rt_sem_control(&rx_sem_usb, RT_IPC_CMD_RESET, RT_NULL);timeout = rt_sem_take(&rx_sem_usb, UART_TIMEOUT);/* 获取信号量函数,阻塞等待接收信号量,等待时间，***个时钟节拍，1个节拍是1ms*/if (timeout == (-RT_ETIMEOUT)) /*判断是否是等待信号量超时退出*/{return 0xABCD;  /*超时退出返回一个16位数据，正常数据只会返回8位数据*/}}return ch;
}/**数据异常结果处理回复* @param data ;异常代码* @param* @return*/
void USB_Data_Error(uint8_t Cmd,uint8_t Param )
{uint8_t response[6];uint16_t crc16;response[0] = Sync;response[1] = Cmd;response[2] = Param;response[3] = 0;crc16 =  yl_crc16(response, 4);response[4] = crc16;response[5] = crc16>>8;rt_device_write(serial_usb, 0, response, 6);
}/**USB虚拟串口数据 按协议解析函数（按通信协议解析收到的USB虚拟串口数据） (YL已验证测试)* @param *read_data ;接收数据缓存指针* @param i 数据长度* @return*/
static uint8_t USB_Data_Resolver(char *read_data,uint32_t i)
{uint16_t len = 0;               /* 数据长度*/uint16_t start_adr = 0;         /* 同步头开始地址*/uint16_t CRC16 = 0;             /* 计算收到数据的CRC*/uint16_t CRC16_READ = 0;        /* 数据中的CRC*/len = i;while(1){/*查找同步头*/for (uint16_t var = 0; var < len; ++var){if (*(read_data+var) == Sync){start_adr = var;var = len +1;}if (var == (len-1) ){USB_Data_Error(7,0xFF);return 0;}}/*判断Data长度是否和Len相符*//*命令中 len 位置描述的数据长度  ,   实际数据长度*/if (*(read_data+start_adr+3)>(len-start_adr-5))  /*判断收到的数据总长度 len 减掉 命令格式中的 crc+命令部分，剩余的数据应该 大于等于 命令中包含的数据长度*/{USB_Data_Error(6,0xFF);return 0;}/*判断CRC是否有效*//*                            命令开始地址       ，命令中 len 里面描述的数据长度 + 命令格式字节*/CRC16 = yl_crc16((uint8_t *)(read_data+start_adr), *(read_data+start_adr+3)+4);CRC16_READ = *(read_data+start_adr+3+*(read_data+start_adr+3)+2);                   /*按格式取出命令数据中的CRC的高位*/CRC16_READ = (CRC16_READ<<8)|(*(read_data+start_adr+3+*(read_data+start_adr+3)+1)); /*按格式取出命令数据中的CRC的低位*/if (CRC16 != CRC16_READ){USB_Data_Error(4,0xFF);return 0;}Uart_Function_Resolver; /*在此调用功能解析函数*/return 1;}}/**USB虚拟串口数据接收并解析线程 (YL已验证测试)* @param *read_data ;接收数据缓存指针* @param* @return*/
static void usb_data_parsing(char *read_data)
{uint16_t ch;static rt_uint16_t i = 0;while (1){ch = uart_sample_get_char();/*调用 USB串口读取函数*/if(ch == 0xABCD)       /* 判断USB虚拟串口是否接收超时 */{if(i){/*此处添加需要调用的数据解析函数*/USB_Data_Resolver(read_data,i);}i = 0;continue;           /* 结束本次 while 循环*/}i = (i >= ONE_DATA_MAXLEN_USB-1) ? ONE_DATA_MAXLEN_USB-1 : i; /* 溢出保护，如果一次性收到的数据大于缓存容量，则丢弃溢出的数据，始终把新收到的数据存入缓存的最后一个位置*/i++;*(read_data+i) = (uint8_t)ch;}}/* step：USB虚拟串口初始化函数，创建USB虚拟串口线程并打开线程 */
int usb_data_sample(void)
{char str[] = "usb_test";/*step1：查找 usb 设备 */serial_usb = rt_device_find(SAMPLE_USB_NAME);serial_usb = serial_usb;if (!serial_usb){rt_kprintf("find %s failed!\n", SAMPLE_USB_NAME);//return RT_ERROR;}/*step4： 初始化信号量 */rt_sem_init(&rx_sem_usb, "rx_sem_usb", 0, RT_IPC_FLAG_FIFO);/*step5：以中断接收及轮询发送模式打开USB虚拟串口设备 */rt_device_open(serial_usb, RT_DEVICE_FLAG_INT_RX);//rt_device_open(serial_usb, RT_DEVICE_FLAG_RDWR);/*step6： 设置接收回调函数:可以通过如下函数来设置数据接收指示，当USB虚拟串口收到数据时，通知上层应用线程有数据到达  */rt_device_set_rx_indicate(serial_usb, uart_rx_ind);/*step7：发送字符串 */rt_device_write(serial_usb, 0, str, (sizeof(str)-1));/*step8 创建线程 ，名称是 serial_usb，入口是 usb_data_parsing*/rt_thread_t thread;     /* 创建线程控制块指针来接收线程创建函数的返回值，目的是通过返回值判断线程是否创建ok *//* 创建线程 */thread = rt_thread_create("usb_thread",                                   // 线程名称，系统打印线程时会显示这个线程的名字(void (*)(void *parameter))usb_data_parsing,      // 线程入口函数,入口函数函数名usb_rx_buffer,                                    // 入口参数1000,                                             // 设置内存堆栈大小8,                                                // 设置优先级200);                                             // 时间片参数，时间片是在有多个相同优先级线程时，这个线程每次被执行多少个时间片/*step9： 创建成功则启动线程 */if (thread != RT_NULL){rt_thread_startup(thread);}else{return RT_ERROR;}return RT_EOK;
}INIT_APP_EXPORT(usb_data_sample);/*  函数使用范例  */
// yl_rt_device_write(serial_usb, 0, &ch, 1); /* 发送收到的一字节数据到USB虚拟串口*/

CRC16 代码

/** Copyright (c) 2006-2020, RT-Thread Development Team** SPDX-License-Identifier: Apache-2.0** Change Logs:* Date           Author       Notes*/
#include "user_cfg.h"
//#define CRC16_XModem    /*定义使用哪一种CRC16算法*/
#define CRC16_Modbus  /*定义使用哪一种CRC16算法*/// Table of CRC constants - implements x^16+x^12+x^5+1
static const uint16_t crc16_tab[] = {0x0000, 0x1021, 0x2042, 0x3063, 0x4084, 0x50a5, 0x60c6, 0x70e7,0x8108, 0x9129, 0xa14a, 0xb16b, 0xc18c, 0xd1ad, 0xe1ce, 0xf1ef,0x1231, 0x0210, 0x3273, 0x2252, 0x52b5, 0x4294, 0x72f7, 0x62d6,0x9339, 0x8318, 0xb37b, 0xa35a, 0xd3bd, 0xc39c, 0xf3ff, 0xe3de,0x2462, 0x3443, 0x0420, 0x1401, 0x64e6, 0x74c7, 0x44a4, 0x5485,0xa56a, 0xb54b, 0x8528, 0x9509, 0xe5ee, 0xf5cf, 0xc5ac, 0xd58d,0x3653, 0x2672, 0x1611, 0x0630, 0x76d7, 0x66f6, 0x5695, 0x46b4,0xb75b, 0xa77a, 0x9719, 0x8738, 0xf7df, 0xe7fe, 0xd79d, 0xc7bc,0x48c4, 0x58e5, 0x6886, 0x78a7, 0x0840, 0x1861, 0x2802, 0x3823,0xc9cc, 0xd9ed, 0xe98e, 0xf9af, 0x8948, 0x9969, 0xa90a, 0xb92b,0x5af5, 0x4ad4, 0x7ab7, 0x6a96, 0x1a71, 0x0a50, 0x3a33, 0x2a12,0xdbfd, 0xcbdc, 0xfbbf, 0xeb9e, 0x9b79, 0x8b58, 0xbb3b, 0xab1a,0x6ca6, 0x7c87, 0x4ce4, 0x5cc5, 0x2c22, 0x3c03, 0x0c60, 0x1c41,0xedae, 0xfd8f, 0xcdec, 0xddcd, 0xad2a, 0xbd0b, 0x8d68, 0x9d49,0x7e97, 0x6eb6, 0x5ed5, 0x4ef4, 0x3e13, 0x2e32, 0x1e51, 0x0e70,0xff9f, 0xefbe, 0xdfdd, 0xcffc, 0xbf1b, 0xaf3a, 0x9f59, 0x8f78,0x9188, 0x81a9, 0xb1ca, 0xa1eb, 0xd10c, 0xc12d, 0xf14e, 0xe16f,0x1080, 0x00a1, 0x30c2, 0x20e3, 0x5004, 0x4025, 0x7046, 0x6067,0x83b9, 0x9398, 0xa3fb, 0xb3da, 0xc33d, 0xd31c, 0xe37f, 0xf35e,0x02b1, 0x1290, 0x22f3, 0x32d2, 0x4235, 0x5214, 0x6277, 0x7256,0xb5ea, 0xa5cb, 0x95a8, 0x8589, 0xf56e, 0xe54f, 0xd52c, 0xc50d,0x34e2, 0x24c3, 0x14a0, 0x0481, 0x7466, 0x6447, 0x5424, 0x4405,0xa7db, 0xb7fa, 0x8799, 0x97b8, 0xe75f, 0xf77e, 0xc71d, 0xd73c,0x26d3, 0x36f2, 0x0691, 0x16b0, 0x6657, 0x7676, 0x4615, 0x5634,0xd94c, 0xc96d, 0xf90e, 0xe92f, 0x99c8, 0x89e9, 0xb98a, 0xa9ab,0x5844, 0x4865, 0x7806, 0x6827, 0x18c0, 0x08e1, 0x3882, 0x28a3,0xcb7d, 0xdb5c, 0xeb3f, 0xfb1e, 0x8bf9, 0x9bd8, 0xabbb, 0xbb9a,0x4a75, 0x5a54, 0x6a37, 0x7a16, 0x0af1, 0x1ad0, 0x2ab3, 0x3a92,0xfd2e, 0xed0f, 0xdd6c, 0xcd4d, 0xbdaa, 0xad8b, 0x9de8, 0x8dc9,0x7c26, 0x6c07, 0x5c64, 0x4c45, 0x3ca2, 0x2c83, 0x1ce0, 0x0cc1,0xef1f, 0xff3e, 0xcf5d, 0xdf7c, 0xaf9b, 0xbfba, 0x8fd9, 0x9ff8,0x6e17, 0x7e36, 0x4e55, 0x5e74, 0x2e93, 0x3eb2, 0x0ed1, 0x1ef0,
};/* CRC16代码备份
uint16_t yl_crc16_XModem(unsigned char *buf, int len)
{int i;uint16_t cksum;cksum = 0;for (i = 0;  i < len;  i++) {cksum = crc16_tab[((cksum>>8) ^ *buf++) & 0xFF] ^ (cksum << 8);}return cksum;
}uint16_t yl_crc16_Modbus(uint8_t *buffer, uint16_t len)
{uint16_t wcrc = 0XFFFF;         //16位crc寄存器预置uint8_t temp;uint16_t i = 0, j = 0;          //计数for (i = 0; i < len; i++)       //循环计算每个数据{temp = *buffer & 0X00FF;    //将八位数据与crc寄存器亦或buffer++;                   //指针地址增加，指向下个数据wcrc ^= temp;               //将数据存入crc寄存器for (j = 0; j < 8; j++)     //循环计算数据的{if (wcrc & 0X0001)      //判断右移出的是不是1，如果是1则与多项式进行异或。{wcrc >>= 1;         //先将数据右移一位wcrc ^= 0XA001;     //与上面的多项式进行异或}else                    //如果不是1，则直接移出{wcrc >>= 1;         //直接移出}}}uint8_t CRC_L;                  //定义数组uint8_t CRC_H;CRC_L = wcrc&0xff;              //crc的低八位CRC_H = wcrc >> 8;              //crc的高八位
//    return ((CRC_L << 8) | CRC_H);return wcrc;
}*/uint16_t yl_crc16(unsigned char *buffer, uint16_t len)
{#if defined  CRC16_XModemint i;uint16_t cksum;cksum = 0;for (i = 0;  i < len;  i++) {cksum = crc16_tab[((cksum>>8) ^ *buffer++) & 0xFF] ^ (cksum << 8);}return cksum;
#endif#if defined  CRC16_Modbusuint16_t wcrc = 0XFFFF;         //16位crc寄存器预置uint8_t temp;uint16_t i = 0, j = 0;          //计数for (i = 0; i < len; i++)       //循环计算每个数据{temp = *buffer & 0X00FF;    //将八位数据与crc寄存器亦或buffer++;                   //指针地址增加，指向下个数据wcrc ^= temp;               //将数据存入crc寄存器for (j = 0; j < 8; j++)     //循环计算数据的{if (wcrc & 0X0001)      //判断右移出的是不是1，如果是1则与多项式进行异或。{wcrc >>= 1;         //先将数据右移一位wcrc ^= 0XA001;     //与上面的多项式进行异或}else                    //如果不是1，则直接移出{wcrc >>= 1;         //直接移出}}}return wcrc;#endif}/* 带初始值的CRC16函数  */
uint16_t yl_crc16_2(unsigned char *buffer, uint16_t len ,uint16_t wcrc)
{#if defined  CRC16_XModemint i;uint16_t cksum;cksum = 0;for (i = 0;  i < len;  i++) {cksum = crc16_tab[((cksum>>8) ^ *buffer++) & 0xFF] ^ (cksum << 8);}return cksum;
#endif#if defined  CRC16_Modbus
//    uint16_t wcrc = 0XFFFF;         //16位crc寄存器预置uint8_t temp;uint16_t i = 0, j = 0;          //计数for (i = 0; i < len; i++)       //循环计算每个数据{temp = *buffer & 0X00FF;    //将八位数据与crc寄存器亦或buffer++;                   //指针地址增加，指向下个数据wcrc ^= temp;               //将数据存入crc寄存器for (j = 0; j < 8; j++)     //循环计算数据的{if (wcrc & 0X0001)      //判断右移出的是不是1，如果是1则与多项式进行异或。{wcrc >>= 1;         //先将数据右移一位wcrc ^= 0XA001;     //与上面的多项式进行异或}else                    //如果不是1，则直接移出{wcrc >>= 1;         //直接移出}}}return wcrc;#endif}

6：测试工程下载链接

https://download.csdn.net/download/yutian0606/88717877