STM32 usb_prop.c文件分析与usb_core.h一些数据定义分析

2024-06-04 18:38

本文主要是介绍STM32 usb_prop.c文件分析与usb_core.h一些数据定义分析,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

usb_prop.c文件可以说是一个蛮重要的文件,因为USB的许多处理函数都在这里定义。在无论是在USB的建立阶段、数据阶段还是状态阶段的一些处理都在这个文件,USB标准函数请求的函数也在这个文件里。
usb_prop.c一开始就是一连串的结构体,如下:

DEVICE Device_Table = { EP_NUM, //被使用的端点数 1 //可以使用的端点数 };DEVICE_PROP Device_Property = //注册一些CustomHID函数 { CustomHID_init, //CustomHID的初始化函数 CustomHID_Reset, //CustomHID的复位函数 CustomHID_Status_In, //CustomHID状态输入函数 CustomHID_Status_Out, //CustomHID状态输出函数 CustomHID_Data_Setup, //CustomHID的处理有数据阶段的特殊类请求函数 CustomHID_NoData_Setup, //CustomHID的处理没有数据阶段特殊类请求函数 CustomHID_Get_Interface_Setting, //CustomHID获取接口及备用接口设置(是否可用) CustomHID_GetDeviceDescriptor, //CustomHID获取设备描述符 CustomHID_GetConfigDescriptor, //CustomHID获取配置描述符 CustomHID_GetStringDescriptor, //CustomHID获取字符串描述符 0, //当前库未使用 0x40 /*MAX PACKET SIZE*/ //最大的包长度为64字节 };/*注册USB标准请求的实现函数*/ USER_STANDARD_REQUESTS User_Standard_Requests = { CustomHID_GetConfiguration, //获取配置请求 CustomHID_SetConfiguration, //设置配置请求 CustomHID_GetInterface, //获取接口请求 CustomHID_SetInterface, //设置接口请求 CustomHID_GetStatus, //获取状态请求 CustomHID_ClearFeature, //清除属性请求 CustomHID_SetEndPointFeature, //设置端点属性请求 CustomHID_SetDeviceFeature, //设置设备属性请求 CustomHID_SetDeviceAddress //设置设备地址请求 };/*注册设备描述符信息*/ ONE_DESCRIPTOR Device_Descriptor = { (uint8_t*)CustomHID_DeviceDescriptor, //注册设备描述符数组 CUSTOMHID_SIZ_DEVICE_DESC //设备描述符的长度 };/*注册设备描述符信息*/ ONE_DESCRIPTOR Config_Descriptor = { (uint8_t*)CustomHID_ConfigDescriptor, //注册配置描述符数组 CUSTOMHID_SIZ_CONFIG_DESC //配置描述符的长度 };/*注册报告描述符信息*/ ONE_DESCRIPTOR CustomHID_Report_Descriptor = { (uint8_t *)CustomHID_ReportDescriptor, //注册报告描述符数组 CUSTOMHID_SIZ_REPORT_DESC //报告描述符的长度 };/*注册HID描述符信息*/ ONE_DESCRIPTOR CustomHID_Descriptor = { (uint8_t*)CustomHID_ConfigDescriptor + CUSTOMHID_OFF_HID_DESC, //注册HID描述符数组 CUSTOMHID_SIZ_HID_DESC //HID数组的长度 };/*注册字符串描述符,包括语言ID、厂商、产品、序列号描述符*/ ONE_DESCRIPTOR String_Descriptor[4] = { {(uint8_t*)CustomHID_StringLangID, CUSTOMHID_SIZ_STRING_LANGID},//注册语言字符串描述符数组 {(uint8_t*)CustomHID_StringVendor, CUSTOMHID_SIZ_STRING_VENDOR},//注册厂商字符串描述符数组 {(uint8_t*)CustomHID_StringProduct, CUSTOMHID_SIZ_STRING_PRODUCT},//注册产品字符串描述符数组 {(uint8_t*)CustomHID_StringSerial, CUSTOMHID_SIZ_STRING_SERIAL} //注册序列号字符串描述符数组 };

应该看了很明白,这一系列的结构体就是注册一些处理函数。我们一个个分析。
先来说下 DEVICE Device_Table这个结构体,DEVICE这个结构体类型在usb_core.h中定义:

typedef struct _DEVICE { uint8_t Total_Endpoint; /*被使用的端点数*/ uint8_t Total_Configuration;/*还可以用的端点数*/ } DEVICE;

这个结构体类型很简单,在结构体中定义了已经被使用的端点和没有被使用的端点,把他们两个放在一起方便查询和管理。



接下去的说说 D EVICE_PROP Device_Property 这个类型的结构体。这个结构体的前10个元素都是函数指针类型的,把一些常用的函数放在这里,而函数定义都在该结构体之后定义,有没有觉得像是语文中的关键句,把整个文件的概要全部浓缩在这个结构体中了,只要看这个结构体就可以把整个文件做什么了解个七七八八了。这样的结构使用起来也非常方便,比如说我想要使用 CustomHID_init函数,只要写Device_Property.CustomHID_init不就可以了。我们必须学会这种方法。
D EVICE_PROP这个结构体类型还是在usb_core.h中定义:

typedef struct _DEVICE_PROP { void (*Init)(void); /*初始化设备*/ void (*Reset)(void); /*复位该设备*/ /*在控制传输中分三个过程:1.建立过程,2、可选的数据过程,3、状态过程*/ /* Device dependent process after the status stage */ void (*Process_Status_IN)(void);/*状态过程中,处理IN令牌包*/ void (*Process_Status_OUT)(void);/*状态过程中,处理OUT令牌包*/ /*在建立阶段的过程中,会有很多特殊类请求的数据阶段stage */ /*所有在数据阶段的特殊类请求都在Class_Data_Setup()函数中处理 Class_Data_Setup() 会响应去检查所有的特殊类请求,同时根据请求填充ENDPOINT_INFO结构信息 如果IN令牌包是期望的令牌包,则wLength和wOffset两个域会分别被填充成要发送的总字节数和要开始传输的位置 如果OUT令牌包是期盼的令牌包,则rLength和rOffser将会分别被填充成要接收的总字节数和要接收数据的缓冲区起始地址 如果请求有效,Class_Data_Setup返回SUCCESS,否则返回UNSUPPORT 注意: 因为GET_CONFIGURATION和GET_INTERFACE两个请求跟个别的类联系密切,所以他们会在该函数中检查和处理*/ RESULT (*Class_Data_Setup)(uint8_t RequestNo); /*在建立过程中,会有很多特殊类请求的无数据阶段*/ /*所有的没有数据阶段的特殊请求都在Class_NoData_Setup这个函数中处理 Class_NoData_Setup() 会响应去检查所有特殊类请求,并且执行请求 注意: 因为SET_CONFIGURATION和SET_INTERFACE这两个请求跟个别的类联系密切,他们都会在该函数中被检查和处理*/ RESULT (*Class_NoData_Setup)(uint8_t RequestNo); /*Class_Get_Interface_Setting() 这个函数时在usb_core.c文件中被调用来测试应用程序是否支持被选中的接口和备用接口 这个函数时由用户写的。如果应用程序支持接口和备用接口,则必须返回"SUCCESS",否则,返回"UNSUPPORT"*/ RESULT (*Class_Get_Interface_Setting)(uint8_t Interface, uint8_t AlternateSetting); uint8_t* (*GetDeviceDescriptor)(uint16_t Length); uint8_t* (*GetConfigDescriptor)(uint16_t Length); uint8_t* (*GetStringDescriptor)(uint16_t Length); /* 这个字段不是用于当前库版本。它是只保持兼容以前的版本*/ void* RxEP_buffer; uint8_t MaxPacketSize;}DEVICE_PROP;




接下去是USER_STANDARD_REQUESTS User_Standard_Requests这个结构体,在这个结构体中主要注册了USB标准请求的实现函数,当然这些函数也实在该结构体后面定义的。跟上面的 D EVICE_PROP Device_Property结构体类似,就不多讲了。
USER_STANDARD_REQUESTS  结构体也是在usb_core.h中定义:

typedef struct _USER_STANDARD_REQUESTS { void (*User_GetConfiguration)(void); /*获取配置*/ void (*User_SetConfiguration)(void); /*设置配置*/ void (*User_GetInterface)(void); /*获取接口*/ void (*User_SetInterface)(void); /*设置接口*/ void (*User_GetStatus)(void); /*获取状态*/ void (*User_ClearFeature)(void); /*清除特性*/ void (*User_SetEndPointFeature)(void); /*设置端点特性*/ void (*User_SetDeviceFeature)(void); /*设置设备特性*/ void (*User_SetDeviceAddress)(void); /*设置设备地址*/ } USER_STANDARD_REQUESTS;


像ONE_DESCRIPTOR Device_Descriptor、ONE_DESCRIPTOR Config_Descriptor、ONE_DESCRIPTOR CustomHID_Report_Descriptor、ONE_DESCRIPTOR CustomHID_Descriptor、ONE_DESCRIPTOR String_Descriptor[4]这些结构体都不仔细讲了。贴出各个结构体的定义,依旧在usb_core.h中:

typedef struct OneDescriptor { uint8_t *Descriptor; uint16_t Descriptor_Size; } ONE_DESCRIPTOR, *PONE_DESCRIPTOR;


接下去上面各个结构体注册的函数贴出来:

/******************************************************************************* * Function Name : CustomHID_init. * Description : CustomHID Mouse init routine.初始化 * Input : None. * Output : None. * Return : None. *******************************************************************************/ void CustomHID_init(void) { /* Update the serial number string descriptor with the data from the unique ID*/ Get_SerialNum(); //获取序列号 pInformation->Current_Configuration = 0; /* Connect the device */ PowerOn(); //上电 /* Perform basic device initialization operations */ USB_SIL_Init(); //执行基本的初始化操作,比如说设备IP和端点0的初始化 bDeviceState = UNCONNECTED; //设置状态为未连接 }/******************************************************************************* * Function Name : CustomHID_Reset. * Description : CustomHID Mouse reset routine.复位 * Input : None. * Output : None. * Return : None. *******************************************************************************/ void CustomHID_Reset(void) { /* Set CustomHID_DEVICE as not configured */ pInformation->Current_Configuration = 0; //设置当前的配置为0,表示没有配置过 pInformation->Current_Interface = 0;//默认的接口 /* Current Feature initialization */ pInformation->Current_Feature = CustomHID_ConfigDescriptor[7];//当前的属性,bmAttributes:设备的一些特性,0xc0表示自供电,不支持远程唤醒#ifdef STM32F10X_CL /* EP0 is already configured in DFU_Init() by USB_SIL_Init() function */ /* Init EP1 IN snd EP1 OUT as Interrupt endpoint */ OTG_DEV_EP_Init(EP1_IN, OTG_DEV_EP_TYPE_INT, EP1_SIZE); OTG_DEV_EP_Init(EP1_OUT, OTG_DEV_EP_TYPE_INT, EP1_SIZE); #else SetBTABLE(BTABLE_ADDRESS); /* Initialize Endpoint 0 */ SetEPType(ENDP0, EP_CONTROL); //设置端点1为控制端点 SetEPTxStatus(ENDP0, EP_TX_STALL); //设置端点0发送延时 SetEPRxAddr(ENDP0, ENDP0_RXADDR); //设置端点0的接收缓冲区地址 SetEPTxAddr(ENDP0, ENDP0_TXADDR); //设置端点0的发送缓冲区地址 Clear_Status_Out(ENDP0); //清除端点0的状态 SetEPRxCount(ENDP0, Device_Property.MaxPacketSize);//设置端点0的接收的计数 SetEPRxValid(ENDP0); //使能接收状态 /* Initialize Endpoint 1 */ SetEPType(ENDP1, EP_INTERRUPT); //设置端点1为中断控制端点 SetEPRxAddr(ENDP1, ENDP1_RXADDR); //设置端点1的接收缓冲地址 SetEPRxCount(ENDP1, REPORT_COUNT); //设置端点1的接收计数 SetEPRxStatus(ENDP1, EP_RX_VALID); //设置端点1接收有效 //SetEPTxStatus(ENDP1, EP_TX_DIS); /* Initialize Endpoint 2 */ SetEPType(ENDP2, EP_INTERRUPT); //设置端点2为中断控制端点 SetEPTxAddr(ENDP2, ENDP2_TXADDR); //设置端点2的接收缓冲地址 SetEPTxCount(ENDP2, REPORT_COUNT); //设置端点2的接收计数 // SetEPTxStatus(ENDP2, EP_TX_DIS); SetEPTxStatus(ENDP2, EP_TX_NAK); //设置端点2为接收不响应 bDeviceState = ATTACHED; //设置设备状态为 ATTACHED状态 /* Set this device to response on default address */ SetDeviceAddress(0); //设置设备为默认地址 #endif /* STM32F10X_CL */ bDeviceState = ATTACHED; } /******************************************************************************* * Function Name : CustomHID_SetConfiguration. * Description : 更新设备配置状态 * Input : None. * Output : None. * Return : None. *******************************************************************************/ void CustomHID_SetConfiguration(void) { DEVICE_INFO *pInfo = &Device_Info; if (pInfo->Current_Configuration != 0) { /* Device configured */ bDeviceState = CONFIGURED; } } /******************************************************************************* * Function Name : CustomHID_SetConfiguration. * Description : 更新设备的编址状态 * Input : None. * Output : None. * Return : None. *******************************************************************************/ void CustomHID_SetDeviceAddress (void) { bDeviceState = ADDRESSED; } /******************************************************************************* * Function Name : CustomHID_Status_In. * Description : 状态输入函数 * Input : None. * Output : None. * Return : None. *******************************************************************************/ void CustomHID_Status_In(void) {}/******************************************************************************* * Function Name : CustomHID_Status_Out * Description : 状态输出函数 * Input : None. * Output : None. * Return : None. *******************************************************************************/ void CustomHID_Status_Out(void) {}/******************************************************************************* * Function Name : CustomHID_Data_Setup * Description : 处理有数据阶段的特殊类请求 * Input : Request Nb. * Output : None. * Return : USB_UNSUPPORT or USB_SUCCESS. *******************************************************************************/ RESULT CustomHID_Data_Setup(uint8_t RequestNo) { uint8_t *(*CopyRoutine)(uint16_t); //定义一个指向函数指针的指针 CopyRoutine = NULL; if ((RequestNo == GET_DESCRIPTOR) //是GET_DESCRIPTOR请求,见圈圈P75 && (Type_Recipient == (STANDARD_REQUEST | INTERFACE_RECIPIENT))//请求的类型为标准请求,请求的接收者为接口 && (pInformation->USBwIndex0 == 0)) //是非语言ID字符串描述符的其他描述符 { if (pInformation->USBwValue1 == REPORT_DESCRIPTOR) //是报告描述符 { CopyRoutine = CustomHID_GetReportDescriptor; //CopyRoutine指向获取报告描述符的函数指针 } else if (pInformation->USBwValue1 == HID_DESCRIPTOR_TYPE)//是HID描述符 { CopyRoutine = CustomHID_GetHIDDescriptor; //CopyRoutine指向获取HID描述符的函数指针 } } /* End of GET_DESCRIPTOR */ /*** GET_PROTOCOL ***/ else if ((Type_Recipient == (CLASS_REQUEST | INTERFACE_RECIPIENT)) //请求的类型是类请求,请求的接收者为接口请求 && RequestNo == GET_PROTOCOL) //获取协议 { CopyRoutine = CustomHID_GetProtocolValue; //获取协议的值 } if (CopyRoutine == NULL) //如果长度为0,CopyRoutine=NULL { return USB_UNSUPPORT; //USB没有接上 } pInformation->Ctrl_Info.CopyData = CopyRoutine; //注册CopyData函数 pInformation->Ctrl_Info.Usb_wOffset = 0; //数据的偏移 (*CopyRoutine)(0); //调用CopyData()函数 return USB_SUCCESS; //返回 USB_SUCCESS }/******************************************************************************* * Function Name : CustomHID_NoData_Setup * Description : 处理没有数据阶段的特殊类请求 * Input : Request Nb. * Output : None. * Return : USB_UNSUPPORT or USB_SUCCESS. *******************************************************************************/ RESULT CustomHID_NoData_Setup(uint8_t RequestNo) { if ((Type_Recipient == (CLASS_REQUEST | INTERFACE_RECIPIENT)) //类请求、接口接收 && (RequestNo == SET_PROTOCOL)) //设置协议 { return CustomHID_SetProtocol(); } else { return USB_UNSUPPORT; } }/******************************************************************************* * Function Name : CustomHID_GetDeviceDescriptor. * Description : 获取设备描述符 * Input : Length * Output : None. * Return : The address of the device descriptor. *******************************************************************************/ uint8_t *CustomHID_GetDeviceDescriptor(uint16_t Length) { return Standard_GetDescriptorData(Length, &Device_Descriptor); }/******************************************************************************* * Function Name : CustomHID_GetConfigDescriptor. * Description : 获取配置描述符 * Input : Length * Output : None. * Return : The address of the configuration descriptor. *******************************************************************************/ uint8_t *CustomHID_GetConfigDescriptor(uint16_t Length) { return Standard_GetDescriptorData(Length, &Config_Descriptor); }/******************************************************************************* * Function Name : CustomHID_GetStringDescriptor * Description : 根据索引获取字符描述符 * Input : Length * Output : None. * Return : The address of the string descriptors. *******************************************************************************/ uint8_t *CustomHID_GetStringDescriptor(uint16_t Length) { uint8_t wValue0 = pInformation->USBwValue0; if (wValue0 > 4) { return NULL; } else { return Standard_GetDescriptorData(Length, &String_Descriptor[wValue0]); } }/******************************************************************************* * Function Name : CustomHID_GetReportDescriptor. * Description : 获取报告描述符 * Input : Length * Output : None. * Return : The address of the configuration descriptor. *******************************************************************************/ uint8_t *CustomHID_GetReportDescriptor(uint16_t Length) { return Standard_GetDescriptorData(Length, &CustomHID_Report_Descriptor); }/******************************************************************************* * Function Name : CustomHID_GetHIDDescriptor. * Description : 获取HID描述符 * Input : Length * Output : None. * Return : The address of the configuration descriptor. *******************************************************************************/ uint8_t *CustomHID_GetHIDDescriptor(uint16_t Length) { return Standard_GetDescriptorData(Length, &CustomHID_Descriptor); }/******************************************************************************* * Function Name : CustomHID_Get_Interface_Setting. * Description : 测试接口及其备用接口是否可用 * Input : - Interface : interface number. * - AlternateSetting : Alternate Setting number. * Output : None. * Return : USB_SUCCESS or USB_UNSUPPORT. *******************************************************************************/ RESULT CustomHID_Get_Interface_Setting(uint8_t Interface, uint8_t AlternateSetting) { if (AlternateSetting > 0) //备用的编号大于0 { return USB_UNSUPPORT; } else if (Interface > 0) //接口的编号大于0 { return USB_UNSUPPORT; } return USB_SUCCESS; }/******************************************************************************* * Function Name : CustomHID_SetProtocol * Description : 设置接口所使用协议请求函数 * Input : None. * Output : None. * Return : USB SUCCESS. *******************************************************************************/ RESULT CustomHID_SetProtocol(void) { uint8_t wValue0 = pInformation->USBwValue0; //获取设备信息中的USBwValue值 ProtocolValue = wValue0; return USB_SUCCESS; }/******************************************************************************* * Function Name : CustomHID_GetProtocolValue * Description : 获取协议的值 * Input : Length. * Output : None. * Return : address of the protcol value. *******************************************************************************/ uint8_t *CustomHID_GetProtocolValue(uint16_t Length) { if (Length == 0) //Length为0时 { pInformation->Ctrl_Info.Usb_wLength = 1;//要发送的长度为1 return NULL; } else { return (uint8_t *)(&ProtocolValue); //返回协议的值 } }

这篇关于STM32 usb_prop.c文件分析与usb_core.h一些数据定义分析的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/1030800

相关文章

Python使用vllm处理多模态数据的预处理技巧

《Python使用vllm处理多模态数据的预处理技巧》本文深入探讨了在Python环境下使用vLLM处理多模态数据的预处理技巧,我们将从基础概念出发,详细讲解文本、图像、音频等多模态数据的预处理方法,... 目录1. 背景介绍1.1 目的和范围1.2 预期读者1.3 文档结构概述1.4 术语表1.4.1 核

MySQL 删除数据详解(最新整理)

《MySQL删除数据详解(最新整理)》:本文主要介绍MySQL删除数据的相关知识,本文通过实例代码给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友参考下吧... 目录一、前言二、mysql 中的三种删除方式1.DELETE语句✅ 基本语法: 示例:2.TRUNCATE语句✅ 基本语

怎样通过分析GC日志来定位Java进程的内存问题

《怎样通过分析GC日志来定位Java进程的内存问题》:本文主要介绍怎样通过分析GC日志来定位Java进程的内存问题,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教... 目录一、GC 日志基础配置1. 启用详细 GC 日志2. 不同收集器的日志格式二、关键指标与分析维度1.

MyBatisPlus如何优化千万级数据的CRUD

《MyBatisPlus如何优化千万级数据的CRUD》最近负责的一个项目,数据库表量级破千万,每次执行CRUD都像走钢丝,稍有不慎就引起数据库报警,本文就结合这个项目的实战经验,聊聊MyBatisPl... 目录背景一、MyBATis Plus 简介二、千万级数据的挑战三、优化 CRUD 的关键策略1. 查

python实现对数据公钥加密与私钥解密

《python实现对数据公钥加密与私钥解密》这篇文章主要为大家详细介绍了如何使用python实现对数据公钥加密与私钥解密,文中的示例代码讲解详细,感兴趣的小伙伴可以跟随小编一起学习一下... 目录公钥私钥的生成使用公钥加密使用私钥解密公钥私钥的生成这一部分,使用python生成公钥与私钥,然后保存在两个文

mysql中的数据目录用法及说明

《mysql中的数据目录用法及说明》:本文主要介绍mysql中的数据目录用法及说明,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教... 目录1、背景2、版本3、数据目录4、总结1、背景安装mysql之后,在安装目录下会有一个data目录,我们创建的数据库、创建的表、插入的

MySQL中的表连接原理分析

《MySQL中的表连接原理分析》:本文主要介绍MySQL中的表连接原理分析,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教... 目录1、背景2、环境3、表连接原理【1】驱动表和被驱动表【2】内连接【3】外连接【4编程】嵌套循环连接【5】join buffer4、总结1、背景

Navicat数据表的数据添加,删除及使用sql完成数据的添加过程

《Navicat数据表的数据添加,删除及使用sql完成数据的添加过程》:本文主要介绍Navicat数据表的数据添加,删除及使用sql完成数据的添加过程,具有很好的参考价值,希望对大家有所帮助,如有... 目录Navicat数据表数据添加,删除及使用sql完成数据添加选中操作的表则出现如下界面,查看左下角从左

python中Hash使用场景分析

《python中Hash使用场景分析》Python的hash()函数用于获取对象哈希值,常用于字典和集合,不可变类型可哈希,可变类型不可,常见算法包括除法、乘法、平方取中和随机数哈希,各有优缺点,需根... 目录python中的 Hash除法哈希算法乘法哈希算法平方取中法随机数哈希算法小结在Python中,

SpringBoot中4种数据水平分片策略

《SpringBoot中4种数据水平分片策略》数据水平分片作为一种水平扩展策略,通过将数据分散到多个物理节点上,有效解决了存储容量和性能瓶颈问题,下面小编就来和大家分享4种数据分片策略吧... 目录一、前言二、哈希分片2.1 原理2.2 SpringBoot实现2.3 优缺点分析2.4 适用场景三、范围分片