USB協議棧開發手冊 (20210518 V0.1)

USB Interrupt Service Routine(USB_IRQHandler)：
    基本的USB中斷處理程序，開發者可經由Callback程序擴充中斷處理程序
操作模式配置(usb_core_mode_set)：
    配置USB控制器的操作模式，目前版本僅提供ForceDeviceMode，ForceHostMode
Soft Connect(usb_core_dev_connect)：
    在裝置模式下使用Soft Connect連接USB
Soft Disconnect(usb_core_dev_disconnect)：
    在裝置模式下使用Soft Disconnect斷接USB

USB標準請求處理程序(pUSBDStandardRequest[])：
    所有USB標準請求基本處理流程處理，其中GET_DESCRIPTOR，SET_ADDRESS，SET_COFIGURATION，SET_INTERFACE可經由Callback程序擴充處理流程
裝置枚舉狀態(usbd_dev_enum)：
    經由相關的USB中斷處理紀錄目前的裝置枚舉狀態，提供給應用層開發相對應的應用流程，枚舉狀態定義於eUSBDState(usb_dev_enum.h)類型

HID裝置類(Class)請求處理程序(pHIDClassRequest[])：
    相關HID裝置類(Class)請求基本處理流程，其中SET_REPORT，SET_IDLE，SET_PROTOCOL可經由Callback程序擴充請求處理流程

應用裝置初始化(xxxx_dev_init)：
    端點0初始化(以最大64Bytes初始化端點0Tx/Rx，開發者無須修改此函數)，Enable端點0中斷
    開發者將自訂的標準及裝置類(Class)請求的Callback函數位址以_CB_DEV_REQUEST_USER(usb_dev_enum.h)型態賦予以_USB_FS_DEVICE(usb_core.h)型態定義的USB裝置的cb_dev_req_user欄位，如無自訂Callback請求程序，則賦予NULL
    開發者將自訂的USB中斷Callback函數位址賦予cb_app_usb_handler變數，如無自訂Callback中斷程序，則賦予NULL
應用裝置使用的端點配置(xxxx_dev_ep_config)：
    配置使用端點的類型，最大封包，記憶體位置，端點中斷
應用裝置枚舉狀態(xxxx_dev_enum)：
    經由裝置枚舉層的usbd_dev_enum紀錄目前的裝置枚舉狀態
應用裝置應用程序(xxxx_dev_transaction)：
    經由特定的端點狀態開發相對應的應用處理程序，這個程序為開發者最必須專注開發的程序，在USB應用過程中，開發者需針對對應的端點狀態及相關的應用處理流程開發相對應的程序

Callback程序，由於中斷，標準請求及裝置類(Class)請求的處理程序僅提供最基本的處理流程，在實際應用中可能需根據系統應用擴充額外的處理流程，這些流程依據應用的不同並無法提供一致性的流程，因此定義了Callback程序以提供開發者更彈性化的開發，Callback程序本身根據應用分成幾大項
USB中斷處理(cb_app_usb_handler)：
    額外的中斷處理流程，基本的USB中斷流程僅將中斷旗標記錄下來，清除中斷旗標，再回到主程序由usbd_dev_enum(usb_dev_enum.h)決定枚舉狀態，如果開發者希望增加額外的中斷處理流程，可自行開發處理程序，並將cb_app_usb_handler(usb_core.h)指向自行開發的中斷處理程序
標準請求流程(cb_dev_enum_user)：
    額外的標準請求處理流程，基本的標準請求處理流程僅依據USB規範的標準流程處理，在目前的協議棧中，提供GET_DESCRIPTOR、SET_ADDRESS、SET_CONFIGURATION、SET_INTERFACE可由開發者自行開發額外的處理流程，如果開發者希望增加額外的請求處理流程，可自行開發處理程序，並將_USB_FS_DEVICE(usb_dev_enum.h)中以_CB_DEV_REQUEST_USER(usb_dev_enum.h)型態定義的cb_dev_enum_user函數指標指向自行開發的請求處理程序，
    GET_DESCRIPTOR：在額外的請求處理程序中，GET_DESCRIPTOR是目前開發者必需提供的請求處理程序，由於Descriptor Data是USB裝置與主機溝通的基本資訊，而且每一個應用裝置的Descriptor Data都不會相同，為保留最大的彈性，所有GET_DESCRIPTOR請求所需要的資訊將留給開發者提供，開發者須將_USB_FS_DEVICE(usb_dev_enum.h)中定義的pCtrlBurstData指標指向要回傳的Descriptor Data的位址，將_USB_FS_DEVICEㄒ中定義的CtrlBurstRemain變數填入要回傳的Descriptor Data的長度
類(Class)請求流程(cb_dev_class_user)：
    額外的類(Class)請求處理流程，基本的類(Class)請求處理流程僅依據USB類(Class)規範的標準流程處理，在目前的協議棧中，依據不同的類(Class)請求提供開發者開發額外的處理流程，如果開發者希望增加額外的類(Class)請求處理流程，可自行開發處理程序，並將_USB_FS_DEVICE(usb_dev_enum.h)中以_CB_DEV_REQUEST_USER(usb_dev_enum.h)型態定義的cb_dev_class_user函數指標指向自行開發的類(Class)請求處理程序，額外的類(Class)請求處理程序將於個別的應用開發例程中說明

DevAddr：主機賦予的USB裝置地址，預設為0，主機會透過SET_ADDRESS配置一個唯一的地址給USB裝置，當收到SET_ADDRESS的請求時，會將主機賦予的USB裝置地址存放在這裡，一個USB裝置只會有一個地址，在SET_ADDRESS的請求程序中已完成此配置
ConfigValue：主機配置的配置值，預設為0，主機會依據應用的不同透過SET_CONFIGURATION賦予不同的配置值，當收到SET_CONFIGURATION的請求時，會將主機配置的配置值存放在這裡，這個數值是由裝置定義的COnfiguration Descriptor中的bConfigurationValue決定，在一般應用下，一個裝置只會定義一個配置值，但在多重配置的應用下，一個裝置可以有好幾個不同的Configuration Descriptor，每一個Configuration Descriptor有各自的配置值，在SET_CONFIGURATION的請求程序中已完成此配置
pCtrlBurstData：用於指定Control In/Out的數據緩衝區指標，在處理Control In/Out時會直接從這裡所指向的數據緩衝區存取數據
CtrlBurstRemain：存放Control In/Out的數據剩餘長度，在處理Control In/Out時會從這裡所存放的數值決定還有多少數據
cb_dev_req_user：一個以_CB_DEV_REQUEST_USER(usb_dev_enum.h)的類型定義的Callback函數指標，指向處理額外的標準及裝置類(Class)請求的處理程序的Callback函數
在整個枚舉或請求的過程中，這個裝置都會以指標的形式作為函數呼叫的參數之一
另外一個以指標的形式作為函數呼叫的參數為以_USB_SETUP_REQUEST(usb_core.h)的型態定義的SetupReq指標參數，SetupReq包含USB標準請求所定義的8個字節的數據