一、USB_OTG简介
USB_OTG(OTG,ON THE GO)是一款双角色设备(DRD) 控制器,同时支持从机(USB DEVICE)功能和主机(USB HOST)功能。在主机模式下,OTG 支持全速(OTG_FS,12 Mb/s)和低速(OTG_LS,1.5 Mb/s)收发器,而从机模式下则仅支持全速(FS,12 Mb/s)收发器。主机模式下需要的唯一外部设备是提供VBUS的电荷泵。在驱动实现层面,USB OTG是USB Device和USB Host 的基础。在实际使用,USB OTG是USB Device和USB Host 的底层驱动。
stm32芯片的通常USB物理接口管理两个引脚:
DP/DM:内置上下拉,由控制器来设置不同类型的需求
OTG实现时,额外配置ID引脚:
ID:检测插入的线是B端还是A端,用于区分A类和B类设备,
USB Host 模式下,需加配置Vbus引脚:
Vbus:内置检测器,用于测试UBUS的有效性
额外地需要支持SOF和NOF时,需要加配置SOF和NOF引脚。
例如本文采用的STM32L496VGT3芯片,其配置支持到的引脚如下:
USB协议栈的层次划分
一个Host可能有一个或者多个Device
一个Device可能有一个或者多个Interface
一个Interface可能有一个或者多个Endpoint
Host(主机)连的是Device(设备),这一层是走物理连接的,也就是信号线实际连接两台设备。
Device(设备)下可能有多个Interfece(接口),从这开始是逻辑概念,一个Interface,就是一个独立的功能接口,每个Interface模拟一个设备功能,比如集成了键盘和鼠标的USB设备,里面就是两个interface,一个是键盘,另一个是鼠标。Interface之间通常是隔离的,互相不干扰。
每个Interface(接口)下面有一个或者多个Endpoint(端点),这也是逻辑概念,例如控制信号端口、数据信号端口等。端点是USB设备通信的基本单位,所有通信几乎都是从端点发起的。
二、创建工程及USB_Device配置
本博文基于STM32L496VGTX3芯片实现,参考本专栏的博文:
cubeIDE开发, stm32的OLED点亮及字符显示设计(基于SPI通信)_py_free的博客-CSDN博客_stm32 hal spi oled
基于该工程的(.ioc)文件创建了新工程stm32L496VGTx_USB,并移植了相关源码,实现了lpusart通信以及lcd显示字体。
现打开工程的(.ioc)配置文件,进入cubeMX配置界面,开启USB_OTG_FS的USB Device功能,参数保持默认配置。
确保USB_OTG_FS的中断功能已经开启。
开启USB_OTG_FS的USB Device选项后,Middleware栏目可以去配置USB_Device信息,本文MCU作为USB_Device与笔记本电脑USB_HOST相连接,实现串口通信收发数据,因此选择通信类型虚拟串口功能,如下图所示,参数保持默认。
设备描述符按默认设置:
由于USB驱动引入了中间件代码,并比较复杂,需要更多缓存支持,现进入工程配置页面,调整min heap size和min stack size为合适的值,防止因数值较少而出现无法编译、编译异常、运行错误等情况出现。
点击保存输出生成代码,关于USB_Device驱动相关代码如下,其中usb_cdc_if.h/c源码是用户可修改源文件:
三、USB_Device驱动实现设计
【1】在usb_cdc_if.h中,添加USB相关全局变量(接收缓存数组、最大长度、接收标记及长度)
/* USER CODE BEGIN INCLUDE */
#define USB_REC_LEN 256//定义USB串口最大接收字节数
extern uint8_t USB_RX_BUF[USB_REC_LEN];//接收缓冲,最大USB_REC_LEN个字节.末字节为换行符
extern uint16_t USB_RX_STA;//接收状态标记(接收到的有效字节数量)
/* USER CODE END INCLUDE */
【2】在usb_cdc_if.h中,添加USB打印输出函数USB_printf声明
/* USER CODE BEGIN EXPORTED_VARIABLES */
void USB_printf(const char *format, ...);//USB模拟串口的打印函数
/* USER CODE END EXPORTED_VARIABLES */
【3】在usb_cdc_if.c中,调整USB接收函数
static int8_t CDC_Receive_FS(uint8_t* Buf, uint32_t *Len)
{
/* USER CODE BEGIN 6 */
//新增代码开始处
if(*Len<USB_REC_LEN)//判断收到数据量是否小于寄存器上限
{
uint16_t i;
USB_RX_STA = *Len;//将数据量值放入标志位
for(i=0;i<*Len;i++)//循环(循环次数=数据数量)
USB_RX_BUF[i] = Buf[i];//将数据内容放入数据寄存器
}
//新增代码结束处
USBD_CDC_SetRxBuffer(&hUsbDeviceFS, &Buf[0]);
USBD_CDC_ReceivePacket(&hUsbDeviceFS);
return (USBD_OK);
/* USER CODE END 6 */
}
【4】在usb_cdc_if.c中,调整USB发送函数
uint8_t CDC_Transmit_FS(uint8_t* Buf, uint16_t Len)
{
uint8_t result = USBD_OK;
/* USER CODE BEGIN 7 */
//注释旧代码
// USBD_CDC_HandleTypeDef *hcdc = (USBD_CDC_HandleTypeDef*)hUsbDeviceFS.pClassData;
// if (hcdc->TxState != 0){
// return USBD_BUSY;
// }
// USBD_CDC_SetTxBuffer(&hUsbDeviceFS, Buf, Len);
// result = USBD_CDC_TransmitPacket(&hUsbDeviceFS);
//新增新代码
uint32_t TimeStart = HAL_GetTick();
USBD_CDC_HandleTypeDef *hcdc = (USBD_CDC_HandleTypeDef*)hUsbDeviceFS.pClassData;
while(hcdc->TxState)
{
if(HAL_GetTick()-TimeStart > 10)
return USBD_BUSY;
else
break;
}
USBD_CDC_SetTxBuffer(&hUsbDeviceFS, Buf, Len);
result = USBD_CDC_TransmitPacket(&hUsbDeviceFS);
TimeStart = HAL_GetTick();
while(hcdc->TxState)
{
if(HAL_GetTick()-TimeStart > 10)
return USBD_BUSY;
}
/* USER CODE END 7 */
return result;
}
【5】在usb_cdc_if.c中,实现USB打印输出函数USB_printf定义
/* USER CODE BEGIN PRIVATE_FUNCTIONS_IMPLEMENTATION */
#include <stdarg.h>
void USB_printf(const char *format, ...)//USB模拟串口的打印函数
{
va_list args;
uint32_t length;
va_start(args, format);
length = vsnprintf((char *)UserTxBufferFS, APP_TX_DATA_SIZE, (char *)format, args);
va_end(args);
CDC_Transmit_FS(UserTxBufferFS, length);
}
/* USER CODE END PRIVATE_FUNCTIONS_IMPLEMENTATION */
【6】在main.c文件中,添加USB驱动头文件支持
/* USER CODE BEGIN Includes */
#include "../../ICore/led/led.h"
#include "../../ICore/oled/oled.h"
#include "../../USB_DEVICE/App/usbd_cdc_if.h"
/* USER CODE END Includes */
【7】在main主函数初始化处
/* USER CODE BEGIN 2 */
OLED_init();
//设置OLED蓝色背景显示
BSP_LCD_Clear_DMA(LCD_DISP_BLUE);
printf("OLED_Clear_DMA\r\n");
/* USER CODE END 2 */
【8】在main主函数循环体内实现
/* USER CODE BEGIN WHILE */
while (1)
{
//USB模拟串口的查寻接收处理(其编程原理与USART1串口收发相同)
if(USB_RX_STA!=0)//判断是否有数据
{
OLED_printf(10,42,"%.*s",USB_RX_STA, USB_RX_BUF);
Toggle_led1();
USB_RX_STA=0;//数据标志位清0
memset(USB_RX_BUF,0,sizeof(USB_RX_BUF));//USB串口数据寄存器清0
HAL_Delay(10);//等待
}
/* USER CODE END WHILE */
四、编译及下载
编译下载,该开发板原理框图,需要将跳线帽重新插拔设置,相当于原理的USB-ST-LINK连接到USB_MCU上,即原理lpusart通信及ST-LINK下载的USB接口改为连接到USB_MCU的DM/DP引脚上实现通信。
更改调线帽后,打开串口工具,发送数据,顺利在点(10,42)位置绘制输入文字,LED1等会切换状态。