STM32F103RET6 學(xué)習(xí)筆記之USB工程目錄文件分析
發(fā)布時(shí)間：2018/11/6
接下去要分別分析下這幾個(gè)文件：
hw_config.c：
這個(gè)文件主要是配置一些跟板載及系統(tǒng)相關(guān)的代碼，比如說(shuō)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); /*離開(kāi)低功耗模式（這里是空函數(shù)）*/
void USB_Interrupts_Config(void); /*設(shè)置USB中斷配置*/
void USB_Cable_Config (FunctionalState NewState);/*USB連接斷開(kāi)選擇，其實(shí)是控制上拉電阻引腳*/
/*void Joystick_Send(uint8_t Keys);*/ /*操作桿發(fā)送（沒(méi)有用)*/
/*uint8_t JoyState(void); */ /*操作桿狀態(tài)（沒(méi)有用到）*/
void Get_SerialNum(void); /*創(chuàng)建字符串描述符的序列號(hào)*/
usb_des.c：
這個(gè)文件主要是定義了USB的一些描述符：分別是：設(shè)備描述符、配置描述符集合（包括接口描述符，HID描述符，端點(diǎn)描述符）、HID報(bào)告描述符、語(yǔ)言ID描述符、廠家的字符串描述符、產(chǎn)品的字符串描述符、產(chǎn)品序列號(hào)的字符串描述符。
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)對(duì)應(yīng)的回調(diào)函數(shù)的注冊(cè)；USB中斷服務(wù)程序的處理，通過(guò)讀取STM32 ISTR中斷狀態(tài)寄存器來(lái)判斷是什么中斷，并做相應(yīng)的專(zhuān)斷處理。
void (*pEpInt_IN[7])(void) = /*端點(diǎn)輸入回調(diào)函數(shù)注冊(cè)*/
{
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ù)的注冊(cè)*/
{
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è)文件主要是把之前定義的一些列描述符注冊(cè)到USB庫(kù)中，并且注冊(cè)一些USB常用的處理函數(shù)如獲取設(shè)備描述符等和一些標(biāo)準(zhǔn)請(qǐng)求函數(shù)，具體如下：
DEVICE_PROP Device_Property = /*注冊(cè)一些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ù)的特殊類(lèi)請(qǐng)求函數(shù)*/
CustomHID_NoData_Setup, /*CustomHID的處理不帶數(shù)據(jù)特殊類(lèi)請(qǐng)求函數(shù)*/
CustomHID_Get_Interface_Setting, /*CustomHID獲取接口及備用接口設(shè)置是否可用 */
CustomHID_GetDeviceDescriptor, /*CustomHID獲取設(shè)備描述符*/
CustomHID_GetConfigDescriptor, /*CustomHID獲取配置描述符*/
CustomHID_GetStringDescriptor, /*CustomHID獲取字符串描述符*/
0, /*當(dāng)前庫(kù)未使用*/
0x40 /*MAX PACKET SIZE*/ /*最大的包長(zhǎng)度為64字節(jié)*/
};
/*注冊(cè)USB標(biāo)準(zhǔn)請(qǐng)求的實(shí)現(xiàn)函數(shù)*/
USER_STANDARD_REQUESTS User_Standard_Requests =
{
CustomHID_GetConfiguration, /*獲取配置請(qǐng)求*/
CustomHID_SetConfiguration, /*設(shè)置配置請(qǐng)求*/
CustomHID_GetInterface, /*獲取接口請(qǐng)求*/
CustomHID_SetInterface, /*設(shè)置接口請(qǐng)求*/
CustomHID_GetStatus, /*獲取狀態(tài)請(qǐng)求*/
CustomHID_ClearFeature, /*清除特性請(qǐng)求*/
CustomHID_SetEndPointFeature, /*設(shè)置端點(diǎn)特性請(qǐng)求*/
CustomHID_SetDeviceFeature, /*設(shè)置設(shè)備特性請(qǐng)求*/
CustomHID_SetDeviceAddress /*設(shè)置設(shè)備地址請(qǐng)求*/
};
/*注冊(cè)設(shè)備描述符信息*/
ONE_DESCRIPTOR Device_Descriptor；
/*注冊(cè)報(bào)告描述符信息*/
ONE_DESCRIPTOR CustomHID_Report_Descriptor;
/*注冊(cè)HID描述符信息*/
ONE_DESCRIPTOR CustomHID_Descriptor;
/*注冊(cè)字符串描述符，包括語(yǔ)言ID、廠商、產(chǎn)品、序列號(hào)描述符*/
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); /*掉電*/
