STM32 USB工程的文件分析
先介紹下我參考其他工程而建立的STM32 USB工程:
簡單介紹下:Startup當(dāng)然放置STM32的啟動(dòng)文件,CMSIS放置著STM32內(nèi)核ARMCortex的內(nèi)核文件,StdPeripheral_Driver目錄里放置著STM32外設(shè)的庫函數(shù),這幾個(gè)都是STM32工程必須的,這里不仔細(xì)講訴,User Source里放著自己的應(yīng)用代碼,如main.c,stm32f10x_it.c等文件都放這里。USB-FS-Driver_Driver下放著USB的庫,這里暫時(shí)不講述,我重點(diǎn)想分析的文件在USB-User里,這個(gè)目錄主要放著一些與USB庫和用戶相關(guān)的文件,起著USB庫與用戶之間的橋梁作用,文件如下圖所示,該目錄包含如下文件:
接下去要分別分析下這幾個(gè)文件:
hw_config.c:
這個(gè)文件主要是配置一些跟板載及系統(tǒng)相關(guān)的代碼,比如說USB系統(tǒng)時(shí)鐘配置,上拉電阻引腳及LED燈配置,還有USB的中斷燈。主要的函數(shù)如下:
void Set_System(void); /*設(shè)置系統(tǒng)時(shí)鐘,USB 及LED引腳配置*/
void Set_USBClock(void); /*設(shè)置USB的時(shí)鐘頻率*/
void GPIO_AINConfig(void); /*設(shè)置GPIO模擬輸入(這里是空函數(shù))*/
void Enter_LowPowerMode(void); /*進(jìn)入低功耗模式(這里是空函數(shù))*/
void Leave_LowPowerMode(void); /*離開低功耗模式(這里是空函數(shù))*/
void USB_Interrupts_Config(void); /*設(shè)置USB中斷配置*/
void USB_Cable_Config (FunctionalState NewState);/*USB連接斷開選擇,其實(shí)是控制上拉電阻引腳*/
/*void Joystick_Send(uint8_t Keys);*/ /*操作桿發(fā)送(沒有用)*/
/*uint8_t JoyState(void); */ /*操作桿狀態(tài)(沒有用到)*/
void Get_SerialNum(void); /*創(chuàng)建字符串描述符的序列號*/
usb_des.c:
這個(gè)文件主要是定義了USB的一些描述符:分別是:設(shè)備描述符、配置描述符集合(包括接口描述符,HID描述符,端點(diǎn)描述符)、HID報(bào)告描述符、語言ID描述符、廠家的字符串描述符、產(chǎn)品的字符串描述符、產(chǎn)品序列號的字符串描述符。
CustomHID_DeviceDescriptor[CUSTOMHID_SIZ_DEVICE_DESC];
CustomHID_ConfigDescriptor[CUSTOMHID_SIZ_CONFIG_DESC];
CustomHID_ReportDescriptor[CUSTOMHID_SIZ_REPORT_DESC];
CustomHID_StringLangID[CUSTOMHID_SIZ_STRING_LANGID];
CustomHID_StringVendor[CUSTOMHID_SIZ_STRING_VENDOR];
CustomHID_StringProduct[CUSTOMHID_SIZ_STRING_PRODUCT];
CustomHID_StringSerial[CUSTOMHID_SIZ_STRING_SERIAL];
usb_endp.c:
這個(gè)文件主要是定義了幾個(gè)端點(diǎn)輸入輸出的回調(diào)函數(shù),這里指定以了端點(diǎn)1輸入輸出回調(diào)及端點(diǎn)2輸入回調(diào)函數(shù),如下:
void EP1_IN_Callback(void); /*端點(diǎn)1輸入回調(diào)函數(shù)*/
void EP1_OUT_Callback(void); /*端點(diǎn)1輸出回調(diào)函數(shù)*/
void EP2_IN_Callback(void); /*端點(diǎn)2輸入回調(diào)函數(shù)*/
usb_Istr.c:
這個(gè)文件主要是每個(gè)端點(diǎn)對應(yīng)的回調(diào)函數(shù)的注冊;USB中斷服務(wù)程序的處理,通過讀取STM32 ISTR中斷狀態(tài)寄存器來判斷是什么中斷,并做相應(yīng)的專斷處理。
void (*pEpInt_IN[7])(void) = /*端點(diǎn)輸入回調(diào)函數(shù)注冊*/
{
EP1_IN_Callback,
EP2_IN_Callback,
EP3_IN_Callback,
EP4_IN_Callback,
EP5_IN_Callback,
EP6_IN_Callback,
EP7_IN_Callback,
};
void (*pEpInt_OUT[7])(void) = /*端點(diǎn)輸出回調(diào)函數(shù)的注冊*/
{
EP1_OUT_Callback,
EP2_OUT_Callback,
EP3_OUT_Callback,
EP4_OUT_Callback,
EP5_OUT_Callback,
EP6_OUT_Callback,
EP7_OUT_Callback,
};
void USB_Istr(void);/*ISTR事件中斷服務(wù)程序*/
usb_propc:
這個(gè)文件主要是把之前定義的一些列描述符注冊到USB庫中,并且注冊一些USB常用的處理函數(shù)如獲取設(shè)備描述符等和一些標(biāo)準(zhǔn)請求函數(shù),具體如下:
DEVICE_PROP Device_Property =/*注冊一些CustomHID函數(shù)*/
{
CustomHID_init, /*CustomHID的初始化函數(shù)*/
CustomHID_Reset, /*CustomHID的復(fù)位函數(shù)*/
CustomHID_Status_In, /*CustomHID狀態(tài)輸入函數(shù)*/
CustomHID_Status_Out, /*CustomHID狀態(tài)輸出函數(shù)*/
CustomHID_Data_Setup,/*CustomHID的處理帶數(shù)據(jù)的特殊類請求函數(shù)*/
CustomHID_NoData_Setup, /*CustomHID的處理不帶數(shù)據(jù)特殊類請求函數(shù)*/
CustomHID_Get_Interface_Setting,/*CustomHID獲取接口及備用接口設(shè)置是否可用 */
CustomHID_GetDeviceDescriptor,/*CustomHID獲取設(shè)備描述符*/
CustomHID_GetConfigDescriptor,/*CustomHID獲取配置描述符*/
CustomHID_GetStringDescriptor,/*CustomHID獲取字符串描述符*/
0,/*當(dāng)前庫未使用*/
0x40 /*MAX PACKET SIZE*/ /*最大的包長度為64字節(jié)*/
};
/*注冊USB標(biāo)準(zhǔn)請求的實(shí)現(xiàn)函數(shù)*/
USER_STANDARD_REQUESTS User_Standard_Requests =
{
CustomHID_GetConfiguration,/*獲取配置請求*/
CustomHID_SetConfiguration,/*設(shè)置配置請求*/
CustomHID_GetInterface,/*獲取接口請求*/
CustomHID_SetInterface,/*設(shè)置接口請求*/
CustomHID_GetStatus,/*獲取狀態(tài)請求*/
CustomHID_ClearFeature,/*清除特性請求*/
CustomHID_SetEndPointFeature,/*設(shè)置端點(diǎn)特性請求*/
CustomHID_SetDeviceFeature,/*設(shè)置設(shè)備特性請求*/
CustomHID_SetDeviceAddress/*設(shè)置設(shè)備地址請求*/
};
/*注冊設(shè)備描述符信息*/
ONE_DESCRIPTOR Device_Descriptor;
/*注冊報(bào)告描述符信息*/
ONE_DESCRIPTOR CustomHID_Report_Descriptor;
/*注冊HID描述符信息*/
ONE_DESCRIPTOR CustomHID_Descriptor;
/*注冊字符串描述符,包括語言ID、廠商、產(chǎn)品、序列號描述符*/
ONE_DESCRIPTOR String_Descriptor[4];
usb_pwr.c:
這個(gè)文件主要一些USB與功耗方面的函數(shù),如上電、掉電、掛起等。
void Suspend(void); /*掛起*/
void Resume_Init(void); /*恢復(fù)初始化*/
void Resume(RESUME_STATE eResumeSetVal);/*恢復(fù)到某個(gè)狀態(tài)狀態(tài)*/
RESULT PowerOn(void); /*上電*/
RESULT PowerOff(void); /*掉電*/
usbio.c
這個(gè)文件只有兩個(gè)文件,一個(gè)是USB發(fā)送函數(shù),另一個(gè)當(dāng)然是USB接收函數(shù)。
uint32_t USB_SendData(uint8_t *data,uint32_t dataNum);
uint32_t USB_GetData(uint8_t *data,uint32_t dataNum);
頂