mbed library sources. Supersedes mbed-src.
Dependents: Nucleo_Hello_Encoder BLE_iBeaconScan AM1805_DEMO DISCO-F429ZI_ExportTemplate1 ... more
targets/TARGET_NUVOTON/TARGET_M480/device/StdDriver/m480_usbd.h@173:e131a1973e81, 2017-09-15 (annotated)
- Committer:
- AnnaBridge
- Date:
- Fri Sep 15 14:59:18 2017 +0100
- Revision:
- 173:e131a1973e81
- Parent:
- 172:7d866c31b3c5
This updates the lib to the mbed lib v 151
Who changed what in which revision?
User | Revision | Line number | New contents of line |
---|---|---|---|
AnnaBridge | 172:7d866c31b3c5 | 1 | /**************************************************************************//** |
AnnaBridge | 172:7d866c31b3c5 | 2 | * @file usbd.h |
AnnaBridge | 172:7d866c31b3c5 | 3 | * @version V1.00 |
AnnaBridge | 172:7d866c31b3c5 | 4 | * @brief M480 series USB driver header file |
AnnaBridge | 172:7d866c31b3c5 | 5 | * |
AnnaBridge | 172:7d866c31b3c5 | 6 | * @copyright (C) 2016 Nuvoton Technology Corp. All rights reserved. |
AnnaBridge | 172:7d866c31b3c5 | 7 | ******************************************************************************/ |
AnnaBridge | 172:7d866c31b3c5 | 8 | #ifndef __USBD_H__ |
AnnaBridge | 172:7d866c31b3c5 | 9 | #define __USBD_H__ |
AnnaBridge | 172:7d866c31b3c5 | 10 | |
AnnaBridge | 172:7d866c31b3c5 | 11 | #ifdef __cplusplus |
AnnaBridge | 172:7d866c31b3c5 | 12 | extern "C" |
AnnaBridge | 172:7d866c31b3c5 | 13 | { |
AnnaBridge | 172:7d866c31b3c5 | 14 | #endif |
AnnaBridge | 172:7d866c31b3c5 | 15 | |
AnnaBridge | 172:7d866c31b3c5 | 16 | |
AnnaBridge | 172:7d866c31b3c5 | 17 | /** @addtogroup M480_Device_Driver M480 Device Driver |
AnnaBridge | 172:7d866c31b3c5 | 18 | @{ |
AnnaBridge | 172:7d866c31b3c5 | 19 | */ |
AnnaBridge | 172:7d866c31b3c5 | 20 | |
AnnaBridge | 172:7d866c31b3c5 | 21 | /** @addtogroup M480_USBD_Driver USBD Driver |
AnnaBridge | 172:7d866c31b3c5 | 22 | @{ |
AnnaBridge | 172:7d866c31b3c5 | 23 | */ |
AnnaBridge | 172:7d866c31b3c5 | 24 | |
AnnaBridge | 172:7d866c31b3c5 | 25 | /** @addtogroup M480_USBD_EXPORTED_STRUCT USBD Exported Struct |
AnnaBridge | 172:7d866c31b3c5 | 26 | @{ |
AnnaBridge | 172:7d866c31b3c5 | 27 | */ |
AnnaBridge | 172:7d866c31b3c5 | 28 | typedef struct s_usbd_info { |
AnnaBridge | 172:7d866c31b3c5 | 29 | uint8_t *gu8DevDesc; /*!< Pointer for USB Device Descriptor */ |
AnnaBridge | 172:7d866c31b3c5 | 30 | uint8_t *gu8ConfigDesc; /*!< Pointer for USB Configuration Descriptor */ |
AnnaBridge | 172:7d866c31b3c5 | 31 | uint8_t **gu8StringDesc; /*!< Pointer for USB String Descriptor pointers */ |
AnnaBridge | 172:7d866c31b3c5 | 32 | uint8_t **gu8HidReportDesc; /*!< Pointer for USB HID Report Descriptor */ |
AnnaBridge | 172:7d866c31b3c5 | 33 | uint8_t *gu8BosDesc; /*!< Pointer for USB BOS Descriptor */ |
AnnaBridge | 172:7d866c31b3c5 | 34 | uint32_t *gu32HidReportSize; /*!< Pointer for HID Report descriptor Size */ |
AnnaBridge | 172:7d866c31b3c5 | 35 | uint32_t *gu32ConfigHidDescIdx; /*!< Pointer for HID Descriptor start index */ |
AnnaBridge | 172:7d866c31b3c5 | 36 | |
AnnaBridge | 172:7d866c31b3c5 | 37 | } S_USBD_INFO_T; /*!< Device description structure */ |
AnnaBridge | 172:7d866c31b3c5 | 38 | |
AnnaBridge | 172:7d866c31b3c5 | 39 | extern const S_USBD_INFO_T gsInfo; |
AnnaBridge | 172:7d866c31b3c5 | 40 | |
AnnaBridge | 172:7d866c31b3c5 | 41 | /*@}*/ /* end of group M480_USBD_EXPORTED_STRUCT */ |
AnnaBridge | 172:7d866c31b3c5 | 42 | |
AnnaBridge | 172:7d866c31b3c5 | 43 | |
AnnaBridge | 172:7d866c31b3c5 | 44 | |
AnnaBridge | 172:7d866c31b3c5 | 45 | |
AnnaBridge | 172:7d866c31b3c5 | 46 | /** @addtogroup M480_USBD_EXPORTED_CONSTANTS USBD Exported Constants |
AnnaBridge | 172:7d866c31b3c5 | 47 | @{ |
AnnaBridge | 172:7d866c31b3c5 | 48 | */ |
AnnaBridge | 172:7d866c31b3c5 | 49 | #define USBD_BUF_BASE (USBD_BASE+0x100ul) /*!< USBD buffer base address \hideinitializer */ |
AnnaBridge | 172:7d866c31b3c5 | 50 | #define USBD_MAX_EP 12ul /*!< Total EP number \hideinitializer */ |
AnnaBridge | 172:7d866c31b3c5 | 51 | |
AnnaBridge | 172:7d866c31b3c5 | 52 | #define EP0 0ul /*!< Endpoint 0 \hideinitializer */ |
AnnaBridge | 172:7d866c31b3c5 | 53 | #define EP1 1ul /*!< Endpoint 1 \hideinitializer */ |
AnnaBridge | 172:7d866c31b3c5 | 54 | #define EP2 2ul /*!< Endpoint 2 \hideinitializer */ |
AnnaBridge | 172:7d866c31b3c5 | 55 | #define EP3 3ul /*!< Endpoint 3 \hideinitializer */ |
AnnaBridge | 172:7d866c31b3c5 | 56 | #define EP4 4ul /*!< Endpoint 4 \hideinitializer */ |
AnnaBridge | 172:7d866c31b3c5 | 57 | #define EP5 5ul /*!< Endpoint 5 \hideinitializer */ |
AnnaBridge | 172:7d866c31b3c5 | 58 | #define EP6 6ul /*!< Endpoint 6 \hideinitializer */ |
AnnaBridge | 172:7d866c31b3c5 | 59 | #define EP7 7ul /*!< Endpoint 7 \hideinitializer */ |
AnnaBridge | 172:7d866c31b3c5 | 60 | #define EP8 8ul /*!< Endpoint 8 \hideinitializer */ |
AnnaBridge | 172:7d866c31b3c5 | 61 | #define EP9 9ul /*!< Endpoint 9 \hideinitializer */ |
AnnaBridge | 172:7d866c31b3c5 | 62 | #define EP10 10ul /*!< Endpoint 10 \hideinitializer */ |
AnnaBridge | 172:7d866c31b3c5 | 63 | #define EP11 11ul /*!< Endpoint 11 \hideinitializer */ |
AnnaBridge | 172:7d866c31b3c5 | 64 | |
AnnaBridge | 172:7d866c31b3c5 | 65 | /** @cond HIDDEN_SYMBOLS */ |
AnnaBridge | 172:7d866c31b3c5 | 66 | /* USB Request Type */ |
AnnaBridge | 172:7d866c31b3c5 | 67 | #define REQ_STANDARD 0x00ul |
AnnaBridge | 172:7d866c31b3c5 | 68 | #define REQ_CLASS 0x20ul |
AnnaBridge | 172:7d866c31b3c5 | 69 | #define REQ_VENDOR 0x40ul |
AnnaBridge | 172:7d866c31b3c5 | 70 | |
AnnaBridge | 172:7d866c31b3c5 | 71 | /* USB Standard Request */ |
AnnaBridge | 173:e131a1973e81 | 72 | #define USBD_GET_STATUS 0x00ul |
AnnaBridge | 173:e131a1973e81 | 73 | #define USBD_CLEAR_FEATURE 0x01ul |
AnnaBridge | 173:e131a1973e81 | 74 | #define USBD_SET_FEATURE 0x03ul |
AnnaBridge | 173:e131a1973e81 | 75 | #define USBD_SET_ADDRESS 0x05ul |
AnnaBridge | 173:e131a1973e81 | 76 | #define USBD_GET_DESCRIPTOR 0x06ul |
AnnaBridge | 173:e131a1973e81 | 77 | #define USBD_SET_DESCRIPTOR 0x07ul |
AnnaBridge | 173:e131a1973e81 | 78 | #define USBD_GET_CONFIGURATION 0x08ul |
AnnaBridge | 173:e131a1973e81 | 79 | #define USBD_SET_CONFIGURATION 0x09ul |
AnnaBridge | 173:e131a1973e81 | 80 | #define USBD_GET_INTERFACE 0x0Aul |
AnnaBridge | 173:e131a1973e81 | 81 | #define USBD_SET_INTERFACE 0x0Bul |
AnnaBridge | 173:e131a1973e81 | 82 | #define USBD_SYNC_FRAME 0x0Cul |
AnnaBridge | 172:7d866c31b3c5 | 83 | |
AnnaBridge | 172:7d866c31b3c5 | 84 | /* USB Descriptor Type */ |
AnnaBridge | 172:7d866c31b3c5 | 85 | #define DESC_DEVICE 0x01ul |
AnnaBridge | 172:7d866c31b3c5 | 86 | #define DESC_CONFIG 0x02ul |
AnnaBridge | 172:7d866c31b3c5 | 87 | #define DESC_STRING 0x03ul |
AnnaBridge | 172:7d866c31b3c5 | 88 | #define DESC_INTERFACE 0x04ul |
AnnaBridge | 172:7d866c31b3c5 | 89 | #define DESC_ENDPOINT 0x05ul |
AnnaBridge | 172:7d866c31b3c5 | 90 | #define DESC_QUALIFIER 0x06ul |
AnnaBridge | 172:7d866c31b3c5 | 91 | #define DESC_OTHERSPEED 0x07ul |
AnnaBridge | 172:7d866c31b3c5 | 92 | #define DESC_IFPOWER 0x08ul |
AnnaBridge | 172:7d866c31b3c5 | 93 | #define DESC_OTG 0x09ul |
AnnaBridge | 172:7d866c31b3c5 | 94 | #define DESC_BOS 0x0Ful |
AnnaBridge | 172:7d866c31b3c5 | 95 | #define DESC_CAPABILITY 0x10ul |
AnnaBridge | 172:7d866c31b3c5 | 96 | |
AnnaBridge | 172:7d866c31b3c5 | 97 | /* USB Device Capability Type */ |
AnnaBridge | 172:7d866c31b3c5 | 98 | #define CAP_WIRELESS 0x01ul |
AnnaBridge | 172:7d866c31b3c5 | 99 | #define CAP_USB20_EXT 0x02ul |
AnnaBridge | 172:7d866c31b3c5 | 100 | |
AnnaBridge | 172:7d866c31b3c5 | 101 | /* USB HID Descriptor Type */ |
AnnaBridge | 172:7d866c31b3c5 | 102 | #define DESC_HID 0x21ul |
AnnaBridge | 172:7d866c31b3c5 | 103 | #define DESC_HID_RPT 0x22ul |
AnnaBridge | 172:7d866c31b3c5 | 104 | |
AnnaBridge | 172:7d866c31b3c5 | 105 | /* USB Descriptor Length */ |
AnnaBridge | 172:7d866c31b3c5 | 106 | #define LEN_DEVICE 18ul |
AnnaBridge | 172:7d866c31b3c5 | 107 | #define LEN_QUALIFIER 10ul |
AnnaBridge | 172:7d866c31b3c5 | 108 | #define LEN_CONFIG 9ul |
AnnaBridge | 172:7d866c31b3c5 | 109 | #define LEN_INTERFACE 9ul |
AnnaBridge | 172:7d866c31b3c5 | 110 | #define LEN_ENDPOINT 7ul |
AnnaBridge | 172:7d866c31b3c5 | 111 | #define LEN_OTG 5ul |
AnnaBridge | 172:7d866c31b3c5 | 112 | #define LEN_BOS 5ul |
AnnaBridge | 172:7d866c31b3c5 | 113 | #define LEN_HID 9ul |
AnnaBridge | 172:7d866c31b3c5 | 114 | #define LEN_CCID 0x36ul |
AnnaBridge | 172:7d866c31b3c5 | 115 | #define LEN_BOSCAP 7ul |
AnnaBridge | 172:7d866c31b3c5 | 116 | |
AnnaBridge | 172:7d866c31b3c5 | 117 | /* USB Endpoint Type */ |
AnnaBridge | 172:7d866c31b3c5 | 118 | #define EP_ISO 0x01 |
AnnaBridge | 172:7d866c31b3c5 | 119 | #define EP_BULK 0x02 |
AnnaBridge | 172:7d866c31b3c5 | 120 | #define EP_INT 0x03 |
AnnaBridge | 172:7d866c31b3c5 | 121 | |
AnnaBridge | 172:7d866c31b3c5 | 122 | #define EP_INPUT 0x80 |
AnnaBridge | 172:7d866c31b3c5 | 123 | #define EP_OUTPUT 0x00 |
AnnaBridge | 172:7d866c31b3c5 | 124 | |
AnnaBridge | 172:7d866c31b3c5 | 125 | /* USB Feature Selector */ |
AnnaBridge | 172:7d866c31b3c5 | 126 | #define FEATURE_DEVICE_REMOTE_WAKEUP 0x01ul |
AnnaBridge | 172:7d866c31b3c5 | 127 | #define FEATURE_ENDPOINT_HALT 0x00ul |
AnnaBridge | 172:7d866c31b3c5 | 128 | /** @endcond HIDDEN_SYMBOLS */ |
AnnaBridge | 172:7d866c31b3c5 | 129 | |
AnnaBridge | 172:7d866c31b3c5 | 130 | /******************************************************************************/ |
AnnaBridge | 172:7d866c31b3c5 | 131 | /* USB Specific Macros */ |
AnnaBridge | 172:7d866c31b3c5 | 132 | /******************************************************************************/ |
AnnaBridge | 172:7d866c31b3c5 | 133 | |
AnnaBridge | 172:7d866c31b3c5 | 134 | #define USBD_WAKEUP_EN USBD_INTEN_WKEN_Msk /*!< USB Wake-up Enable \hideinitializer */ |
AnnaBridge | 172:7d866c31b3c5 | 135 | #define USBD_DRVSE0 USBD_SE0_SE0_Msk /*!< Drive SE0 \hideinitializer */ |
AnnaBridge | 172:7d866c31b3c5 | 136 | |
AnnaBridge | 172:7d866c31b3c5 | 137 | #define USBD_DPPU_EN USBD_ATTR_DPPUEN_Msk /*!< USB D+ Pull-up Enable \hideinitializer */ |
AnnaBridge | 172:7d866c31b3c5 | 138 | #define USBD_PWRDN USBD_ATTR_PWRDN_Msk /*!< PHY Turn-On \hideinitializer */ |
AnnaBridge | 172:7d866c31b3c5 | 139 | #define USBD_PHY_EN USBD_ATTR_PHYEN_Msk /*!< PHY Enable \hideinitializer */ |
AnnaBridge | 172:7d866c31b3c5 | 140 | #define USBD_USB_EN USBD_ATTR_USBEN_Msk /*!< USB Enable \hideinitializer */ |
AnnaBridge | 172:7d866c31b3c5 | 141 | |
AnnaBridge | 172:7d866c31b3c5 | 142 | #define USBD_INT_BUS USBD_INTEN_BUSIEN_Msk /*!< USB Bus Event Interrupt \hideinitializer */ |
AnnaBridge | 172:7d866c31b3c5 | 143 | #define USBD_INT_USB USBD_INTEN_USBIEN_Msk /*!< USB Event Interrupt \hideinitializer */ |
AnnaBridge | 172:7d866c31b3c5 | 144 | #define USBD_INT_FLDET USBD_INTEN_VBDETIEN_Msk /*!< USB VBUS Detection Interrupt \hideinitializer */ |
AnnaBridge | 172:7d866c31b3c5 | 145 | #define USBD_INT_WAKEUP (USBD_INTEN_NEVWKIEN_Msk | USBD_INTEN_WKEN_Msk) /*!< USB No-Event-Wake-Up Interrupt \hideinitializer */ |
AnnaBridge | 172:7d866c31b3c5 | 146 | |
AnnaBridge | 172:7d866c31b3c5 | 147 | #define USBD_INTSTS_WAKEUP USBD_INTSTS_NEVWKIF_Msk /*!< USB No-Event-Wake-Up Interrupt Status \hideinitializer */ |
AnnaBridge | 172:7d866c31b3c5 | 148 | #define USBD_INTSTS_FLDET USBD_INTSTS_VBDETIF_Msk /*!< USB Float Detect Interrupt Status \hideinitializer */ |
AnnaBridge | 172:7d866c31b3c5 | 149 | #define USBD_INTSTS_BUS USBD_INTSTS_BUSIF_Msk /*!< USB Bus Event Interrupt Status \hideinitializer */ |
AnnaBridge | 172:7d866c31b3c5 | 150 | #define USBD_INTSTS_USB USBD_INTSTS_USBIF_Msk /*!< USB Event Interrupt Status \hideinitializer */ |
AnnaBridge | 172:7d866c31b3c5 | 151 | #define USBD_INTSTS_SETUP USBD_INTSTS_SETUP_Msk /*!< USB Setup Event \hideinitializer */ |
AnnaBridge | 172:7d866c31b3c5 | 152 | #define USBD_INTSTS_EP0 USBD_INTSTS_EPEVT0_Msk /*!< USB Endpoint 0 Event \hideinitializer */ |
AnnaBridge | 172:7d866c31b3c5 | 153 | #define USBD_INTSTS_EP1 USBD_INTSTS_EPEVT1_Msk /*!< USB Endpoint 1 Event \hideinitializer */ |
AnnaBridge | 172:7d866c31b3c5 | 154 | #define USBD_INTSTS_EP2 USBD_INTSTS_EPEVT2_Msk /*!< USB Endpoint 2 Event \hideinitializer */ |
AnnaBridge | 172:7d866c31b3c5 | 155 | #define USBD_INTSTS_EP3 USBD_INTSTS_EPEVT3_Msk /*!< USB Endpoint 3 Event \hideinitializer */ |
AnnaBridge | 172:7d866c31b3c5 | 156 | #define USBD_INTSTS_EP4 USBD_INTSTS_EPEVT4_Msk /*!< USB Endpoint 4 Event \hideinitializer */ |
AnnaBridge | 172:7d866c31b3c5 | 157 | #define USBD_INTSTS_EP5 USBD_INTSTS_EPEVT5_Msk /*!< USB Endpoint 5 Event \hideinitializer */ |
AnnaBridge | 172:7d866c31b3c5 | 158 | #define USBD_INTSTS_EP6 USBD_INTSTS_EPEVT6_Msk /*!< USB Endpoint 6 Event \hideinitializer */ |
AnnaBridge | 172:7d866c31b3c5 | 159 | #define USBD_INTSTS_EP7 USBD_INTSTS_EPEVT7_Msk /*!< USB Endpoint 7 Event \hideinitializer */ |
AnnaBridge | 172:7d866c31b3c5 | 160 | #define USBD_INTSTS_EP8 USBD_INTSTS_EPEVT8_Msk /*!< USB Endpoint 8 Event \hideinitializer */ |
AnnaBridge | 172:7d866c31b3c5 | 161 | #define USBD_INTSTS_EP9 USBD_INTSTS_EPEVT9_Msk /*!< USB Endpoint 9 Event \hideinitializer */ |
AnnaBridge | 172:7d866c31b3c5 | 162 | #define USBD_INTSTS_EP10 USBD_INTSTS_EPEVT10_Msk /*!< USB Endpoint 10 Event \hideinitializer */ |
AnnaBridge | 172:7d866c31b3c5 | 163 | #define USBD_INTSTS_EP11 USBD_INTSTS_EPEVT11_Msk /*!< USB Endpoint 11 Event \hideinitializer */ |
AnnaBridge | 172:7d866c31b3c5 | 164 | |
AnnaBridge | 172:7d866c31b3c5 | 165 | #define USBD_STATE_USBRST USBD_ATTR_USBRST_Msk /*!< USB Bus Reset \hideinitializer */ |
AnnaBridge | 172:7d866c31b3c5 | 166 | #define USBD_STATE_SUSPEND USBD_ATTR_SUSPEND_Msk /*!< USB Bus Suspend \hideinitializer */ |
AnnaBridge | 172:7d866c31b3c5 | 167 | #define USBD_STATE_RESUME USBD_ATTR_RESUME_Msk /*!< USB Bus Resume \hideinitializer */ |
AnnaBridge | 172:7d866c31b3c5 | 168 | #define USBD_STATE_TIMEOUT USBD_ATTR_TOUT_Msk /*!< USB Bus Timeout \hideinitializer */ |
AnnaBridge | 172:7d866c31b3c5 | 169 | |
AnnaBridge | 172:7d866c31b3c5 | 170 | #define USBD_CFGP_SSTALL USBD_CFGP_SSTALL_Msk /*!< Set Stall \hideinitializer */ |
AnnaBridge | 172:7d866c31b3c5 | 171 | #define USBD_CFG_CSTALL USBD_CFG_CSTALL_Msk /*!< Clear Stall \hideinitializer */ |
AnnaBridge | 172:7d866c31b3c5 | 172 | |
AnnaBridge | 172:7d866c31b3c5 | 173 | #define USBD_CFG_EPMODE_DISABLE (0ul << USBD_CFG_STATE_Pos)/*!< Endpoint Disable \hideinitializer */ |
AnnaBridge | 172:7d866c31b3c5 | 174 | #define USBD_CFG_EPMODE_OUT (1ul << USBD_CFG_STATE_Pos)/*!< Out Endpoint \hideinitializer */ |
AnnaBridge | 172:7d866c31b3c5 | 175 | #define USBD_CFG_EPMODE_IN (2ul << USBD_CFG_STATE_Pos)/*!< In Endpoint \hideinitializer */ |
AnnaBridge | 172:7d866c31b3c5 | 176 | #define USBD_CFG_TYPE_ISO (1ul << USBD_CFG_ISOCH_Pos) /*!< Isochronous \hideinitializer */ |
AnnaBridge | 172:7d866c31b3c5 | 177 | |
AnnaBridge | 172:7d866c31b3c5 | 178 | |
AnnaBridge | 172:7d866c31b3c5 | 179 | |
AnnaBridge | 172:7d866c31b3c5 | 180 | /*@}*/ /* end of group M480_USBD_EXPORTED_CONSTANTS */ |
AnnaBridge | 172:7d866c31b3c5 | 181 | |
AnnaBridge | 172:7d866c31b3c5 | 182 | |
AnnaBridge | 172:7d866c31b3c5 | 183 | /** @addtogroup M480_USBD_EXPORTED_FUNCTIONS USBD Exported Functions |
AnnaBridge | 172:7d866c31b3c5 | 184 | @{ |
AnnaBridge | 172:7d866c31b3c5 | 185 | */ |
AnnaBridge | 172:7d866c31b3c5 | 186 | /** |
AnnaBridge | 172:7d866c31b3c5 | 187 | * @brief Compare two input numbers and return maximum one. |
AnnaBridge | 172:7d866c31b3c5 | 188 | * |
AnnaBridge | 172:7d866c31b3c5 | 189 | * @param[in] a First number to be compared. |
AnnaBridge | 172:7d866c31b3c5 | 190 | * @param[in] b Second number to be compared. |
AnnaBridge | 172:7d866c31b3c5 | 191 | * |
AnnaBridge | 172:7d866c31b3c5 | 192 | * @return Maximum value between a and b. |
AnnaBridge | 172:7d866c31b3c5 | 193 | * |
AnnaBridge | 172:7d866c31b3c5 | 194 | * @details If a > b, then return a. Otherwise, return b. |
AnnaBridge | 172:7d866c31b3c5 | 195 | * \hideinitializer |
AnnaBridge | 172:7d866c31b3c5 | 196 | */ |
AnnaBridge | 172:7d866c31b3c5 | 197 | #define USBD_Maximum(a,b) ((a)>(b) ? (a) : (b)) |
AnnaBridge | 172:7d866c31b3c5 | 198 | |
AnnaBridge | 172:7d866c31b3c5 | 199 | |
AnnaBridge | 172:7d866c31b3c5 | 200 | /** |
AnnaBridge | 172:7d866c31b3c5 | 201 | * @brief Compare two input numbers and return minimum one |
AnnaBridge | 172:7d866c31b3c5 | 202 | * |
AnnaBridge | 172:7d866c31b3c5 | 203 | * @param[in] a First number to be compared |
AnnaBridge | 172:7d866c31b3c5 | 204 | * @param[in] b Second number to be compared |
AnnaBridge | 172:7d866c31b3c5 | 205 | * |
AnnaBridge | 172:7d866c31b3c5 | 206 | * @return Minimum value between a and b |
AnnaBridge | 172:7d866c31b3c5 | 207 | * |
AnnaBridge | 172:7d866c31b3c5 | 208 | * @details If a < b, then return a. Otherwise, return b. |
AnnaBridge | 172:7d866c31b3c5 | 209 | * \hideinitializer |
AnnaBridge | 172:7d866c31b3c5 | 210 | */ |
AnnaBridge | 172:7d866c31b3c5 | 211 | #define USBD_Minimum(a,b) ((a)<(b) ? (a) : (b)) |
AnnaBridge | 172:7d866c31b3c5 | 212 | |
AnnaBridge | 172:7d866c31b3c5 | 213 | |
AnnaBridge | 172:7d866c31b3c5 | 214 | /** |
AnnaBridge | 172:7d866c31b3c5 | 215 | * @brief Enable USB |
AnnaBridge | 172:7d866c31b3c5 | 216 | * |
AnnaBridge | 172:7d866c31b3c5 | 217 | * @param None |
AnnaBridge | 172:7d866c31b3c5 | 218 | * |
AnnaBridge | 172:7d866c31b3c5 | 219 | * @return None |
AnnaBridge | 172:7d866c31b3c5 | 220 | * |
AnnaBridge | 172:7d866c31b3c5 | 221 | * @details To set USB ATTR control register to enable USB and PHY. |
AnnaBridge | 172:7d866c31b3c5 | 222 | * \hideinitializer |
AnnaBridge | 172:7d866c31b3c5 | 223 | */ |
AnnaBridge | 172:7d866c31b3c5 | 224 | #define USBD_ENABLE_USB() ((uint32_t)(USBD->ATTR |= 0x7D0)) |
AnnaBridge | 172:7d866c31b3c5 | 225 | |
AnnaBridge | 172:7d866c31b3c5 | 226 | /** |
AnnaBridge | 172:7d866c31b3c5 | 227 | * @brief Disable USB |
AnnaBridge | 172:7d866c31b3c5 | 228 | * |
AnnaBridge | 172:7d866c31b3c5 | 229 | * @param None |
AnnaBridge | 172:7d866c31b3c5 | 230 | * |
AnnaBridge | 172:7d866c31b3c5 | 231 | * @return None |
AnnaBridge | 172:7d866c31b3c5 | 232 | * |
AnnaBridge | 172:7d866c31b3c5 | 233 | * @details To set USB ATTR control register to disable USB. |
AnnaBridge | 172:7d866c31b3c5 | 234 | * \hideinitializer |
AnnaBridge | 172:7d866c31b3c5 | 235 | */ |
AnnaBridge | 172:7d866c31b3c5 | 236 | #define USBD_DISABLE_USB() ((uint32_t)(USBD->ATTR &= ~USBD_USB_EN)) |
AnnaBridge | 172:7d866c31b3c5 | 237 | |
AnnaBridge | 172:7d866c31b3c5 | 238 | /** |
AnnaBridge | 172:7d866c31b3c5 | 239 | * @brief Enable USB PHY |
AnnaBridge | 172:7d866c31b3c5 | 240 | * |
AnnaBridge | 172:7d866c31b3c5 | 241 | * @param None |
AnnaBridge | 172:7d866c31b3c5 | 242 | * |
AnnaBridge | 172:7d866c31b3c5 | 243 | * @return None |
AnnaBridge | 172:7d866c31b3c5 | 244 | * |
AnnaBridge | 172:7d866c31b3c5 | 245 | * @details To set USB ATTR control register to enable USB PHY. |
AnnaBridge | 172:7d866c31b3c5 | 246 | * \hideinitializer |
AnnaBridge | 172:7d866c31b3c5 | 247 | */ |
AnnaBridge | 172:7d866c31b3c5 | 248 | #define USBD_ENABLE_PHY() ((uint32_t)(USBD->ATTR |= USBD_PHY_EN)) |
AnnaBridge | 172:7d866c31b3c5 | 249 | |
AnnaBridge | 172:7d866c31b3c5 | 250 | /** |
AnnaBridge | 172:7d866c31b3c5 | 251 | * @brief Disable USB PHY |
AnnaBridge | 172:7d866c31b3c5 | 252 | * |
AnnaBridge | 172:7d866c31b3c5 | 253 | * @param None |
AnnaBridge | 172:7d866c31b3c5 | 254 | * |
AnnaBridge | 172:7d866c31b3c5 | 255 | * @return None |
AnnaBridge | 172:7d866c31b3c5 | 256 | * |
AnnaBridge | 172:7d866c31b3c5 | 257 | * @details To set USB ATTR control register to disable USB PHY. |
AnnaBridge | 172:7d866c31b3c5 | 258 | * \hideinitializer |
AnnaBridge | 172:7d866c31b3c5 | 259 | */ |
AnnaBridge | 172:7d866c31b3c5 | 260 | #define USBD_DISABLE_PHY() ((uint32_t)(USBD->ATTR &= ~USBD_PHY_EN)) |
AnnaBridge | 172:7d866c31b3c5 | 261 | |
AnnaBridge | 172:7d866c31b3c5 | 262 | /** |
AnnaBridge | 172:7d866c31b3c5 | 263 | * @brief Enable SE0. Force USB PHY transceiver to drive SE0. |
AnnaBridge | 172:7d866c31b3c5 | 264 | * |
AnnaBridge | 172:7d866c31b3c5 | 265 | * @param None |
AnnaBridge | 172:7d866c31b3c5 | 266 | * |
AnnaBridge | 172:7d866c31b3c5 | 267 | * @return None |
AnnaBridge | 172:7d866c31b3c5 | 268 | * |
AnnaBridge | 172:7d866c31b3c5 | 269 | * @details Set DRVSE0 bit of USB_DRVSE0 register to enable software-disconnect function. Force USB PHY transceiver to drive SE0 to bus. |
AnnaBridge | 172:7d866c31b3c5 | 270 | * \hideinitializer |
AnnaBridge | 172:7d866c31b3c5 | 271 | */ |
AnnaBridge | 172:7d866c31b3c5 | 272 | #define USBD_SET_SE0() ((uint32_t)(USBD->SE0 |= USBD_DRVSE0)) |
AnnaBridge | 172:7d866c31b3c5 | 273 | |
AnnaBridge | 172:7d866c31b3c5 | 274 | /** |
AnnaBridge | 172:7d866c31b3c5 | 275 | * @brief Disable SE0 |
AnnaBridge | 172:7d866c31b3c5 | 276 | * |
AnnaBridge | 172:7d866c31b3c5 | 277 | * @param None |
AnnaBridge | 172:7d866c31b3c5 | 278 | * |
AnnaBridge | 172:7d866c31b3c5 | 279 | * @return None |
AnnaBridge | 172:7d866c31b3c5 | 280 | * |
AnnaBridge | 172:7d866c31b3c5 | 281 | * @details Clear DRVSE0 bit of USB_DRVSE0 register to disable software-disconnect function. |
AnnaBridge | 172:7d866c31b3c5 | 282 | * \hideinitializer |
AnnaBridge | 172:7d866c31b3c5 | 283 | */ |
AnnaBridge | 172:7d866c31b3c5 | 284 | #define USBD_CLR_SE0() ((uint32_t)(USBD->SE0 &= ~USBD_DRVSE0)) |
AnnaBridge | 172:7d866c31b3c5 | 285 | |
AnnaBridge | 172:7d866c31b3c5 | 286 | /** |
AnnaBridge | 172:7d866c31b3c5 | 287 | * @brief Set USB device address |
AnnaBridge | 172:7d866c31b3c5 | 288 | * |
AnnaBridge | 172:7d866c31b3c5 | 289 | * @param[in] addr The USB device address. |
AnnaBridge | 172:7d866c31b3c5 | 290 | * |
AnnaBridge | 172:7d866c31b3c5 | 291 | * @return None |
AnnaBridge | 172:7d866c31b3c5 | 292 | * |
AnnaBridge | 172:7d866c31b3c5 | 293 | * @details Write USB device address to USB_FADDR register. |
AnnaBridge | 172:7d866c31b3c5 | 294 | * \hideinitializer |
AnnaBridge | 172:7d866c31b3c5 | 295 | */ |
AnnaBridge | 172:7d866c31b3c5 | 296 | #define USBD_SET_ADDR(addr) (USBD->FADDR = (addr)) |
AnnaBridge | 172:7d866c31b3c5 | 297 | |
AnnaBridge | 172:7d866c31b3c5 | 298 | /** |
AnnaBridge | 172:7d866c31b3c5 | 299 | * @brief Get USB device address |
AnnaBridge | 172:7d866c31b3c5 | 300 | * |
AnnaBridge | 172:7d866c31b3c5 | 301 | * @param None |
AnnaBridge | 172:7d866c31b3c5 | 302 | * |
AnnaBridge | 172:7d866c31b3c5 | 303 | * @return USB device address |
AnnaBridge | 172:7d866c31b3c5 | 304 | * |
AnnaBridge | 172:7d866c31b3c5 | 305 | * @details Read USB_FADDR register to get USB device address. |
AnnaBridge | 172:7d866c31b3c5 | 306 | * \hideinitializer |
AnnaBridge | 172:7d866c31b3c5 | 307 | */ |
AnnaBridge | 172:7d866c31b3c5 | 308 | #define USBD_GET_ADDR() ((uint32_t)(USBD->FADDR)) |
AnnaBridge | 172:7d866c31b3c5 | 309 | |
AnnaBridge | 172:7d866c31b3c5 | 310 | /** |
AnnaBridge | 172:7d866c31b3c5 | 311 | * @brief Enable USB interrupt function |
AnnaBridge | 172:7d866c31b3c5 | 312 | * |
AnnaBridge | 172:7d866c31b3c5 | 313 | * @param[in] intr The combination of the specified interrupt enable bits. |
AnnaBridge | 172:7d866c31b3c5 | 314 | * Each bit corresponds to a interrupt enable bit. |
AnnaBridge | 172:7d866c31b3c5 | 315 | * This parameter decides which interrupts will be enabled. |
AnnaBridge | 172:7d866c31b3c5 | 316 | * (USBD_INT_WAKEUP, USBD_INT_FLDET, USBD_INT_USB, USBD_INT_BUS) |
AnnaBridge | 172:7d866c31b3c5 | 317 | * |
AnnaBridge | 172:7d866c31b3c5 | 318 | * @return None |
AnnaBridge | 172:7d866c31b3c5 | 319 | * |
AnnaBridge | 172:7d866c31b3c5 | 320 | * @details Enable USB related interrupt functions specified by intr parameter. |
AnnaBridge | 172:7d866c31b3c5 | 321 | * \hideinitializer |
AnnaBridge | 172:7d866c31b3c5 | 322 | */ |
AnnaBridge | 172:7d866c31b3c5 | 323 | #define USBD_ENABLE_INT(intr) (USBD->INTEN |= (intr)) |
AnnaBridge | 172:7d866c31b3c5 | 324 | |
AnnaBridge | 172:7d866c31b3c5 | 325 | /** |
AnnaBridge | 172:7d866c31b3c5 | 326 | * @brief Get interrupt status |
AnnaBridge | 172:7d866c31b3c5 | 327 | * |
AnnaBridge | 172:7d866c31b3c5 | 328 | * @param None |
AnnaBridge | 172:7d866c31b3c5 | 329 | * |
AnnaBridge | 172:7d866c31b3c5 | 330 | * @return The value of USB_INTSTS register |
AnnaBridge | 172:7d866c31b3c5 | 331 | * |
AnnaBridge | 172:7d866c31b3c5 | 332 | * @details Return all interrupt flags of USB_INTSTS register. |
AnnaBridge | 172:7d866c31b3c5 | 333 | * \hideinitializer |
AnnaBridge | 172:7d866c31b3c5 | 334 | */ |
AnnaBridge | 172:7d866c31b3c5 | 335 | #define USBD_GET_INT_FLAG() ((uint32_t)(USBD->INTSTS)) |
AnnaBridge | 172:7d866c31b3c5 | 336 | |
AnnaBridge | 172:7d866c31b3c5 | 337 | /** |
AnnaBridge | 172:7d866c31b3c5 | 338 | * @brief Clear USB interrupt flag |
AnnaBridge | 172:7d866c31b3c5 | 339 | * |
AnnaBridge | 172:7d866c31b3c5 | 340 | * @param[in] flag The combination of the specified interrupt flags. |
AnnaBridge | 172:7d866c31b3c5 | 341 | * Each bit corresponds to a interrupt source. |
AnnaBridge | 172:7d866c31b3c5 | 342 | * This parameter decides which interrupt flags will be cleared. |
AnnaBridge | 172:7d866c31b3c5 | 343 | * (USBD_INTSTS_WAKEUP, USBD_INTSTS_FLDET, USBD_INTSTS_BUS, USBD_INTSTS_USB) |
AnnaBridge | 172:7d866c31b3c5 | 344 | * |
AnnaBridge | 172:7d866c31b3c5 | 345 | * @return None |
AnnaBridge | 172:7d866c31b3c5 | 346 | * |
AnnaBridge | 172:7d866c31b3c5 | 347 | * @details Clear USB related interrupt flags specified by flag parameter. |
AnnaBridge | 172:7d866c31b3c5 | 348 | * \hideinitializer |
AnnaBridge | 172:7d866c31b3c5 | 349 | */ |
AnnaBridge | 172:7d866c31b3c5 | 350 | #define USBD_CLR_INT_FLAG(flag) (USBD->INTSTS = (flag)) |
AnnaBridge | 172:7d866c31b3c5 | 351 | |
AnnaBridge | 172:7d866c31b3c5 | 352 | /** |
AnnaBridge | 172:7d866c31b3c5 | 353 | * @brief Get endpoint status |
AnnaBridge | 172:7d866c31b3c5 | 354 | * |
AnnaBridge | 172:7d866c31b3c5 | 355 | * @param None |
AnnaBridge | 172:7d866c31b3c5 | 356 | * |
AnnaBridge | 172:7d866c31b3c5 | 357 | * @return The value of USB_EPSTS register. |
AnnaBridge | 172:7d866c31b3c5 | 358 | * |
AnnaBridge | 172:7d866c31b3c5 | 359 | * @details Return all endpoint status. |
AnnaBridge | 172:7d866c31b3c5 | 360 | * \hideinitializer |
AnnaBridge | 172:7d866c31b3c5 | 361 | */ |
AnnaBridge | 172:7d866c31b3c5 | 362 | #define USBD_GET_EP_FLAG() ((uint32_t)(USBD->EPSTS)) |
AnnaBridge | 172:7d866c31b3c5 | 363 | |
AnnaBridge | 172:7d866c31b3c5 | 364 | /** |
AnnaBridge | 172:7d866c31b3c5 | 365 | * @brief Get USB bus state |
AnnaBridge | 172:7d866c31b3c5 | 366 | * |
AnnaBridge | 172:7d866c31b3c5 | 367 | * @param None |
AnnaBridge | 172:7d866c31b3c5 | 368 | * |
AnnaBridge | 172:7d866c31b3c5 | 369 | * @return The value of USB_ATTR[3:0]. |
AnnaBridge | 172:7d866c31b3c5 | 370 | * Bit 0 indicates USB bus reset status. |
AnnaBridge | 172:7d866c31b3c5 | 371 | * Bit 1 indicates USB bus suspend status. |
AnnaBridge | 172:7d866c31b3c5 | 372 | * Bit 2 indicates USB bus resume status. |
AnnaBridge | 172:7d866c31b3c5 | 373 | * Bit 3 indicates USB bus time-out status. |
AnnaBridge | 172:7d866c31b3c5 | 374 | * |
AnnaBridge | 172:7d866c31b3c5 | 375 | * @details Return USB_ATTR[3:0] for USB bus events. |
AnnaBridge | 172:7d866c31b3c5 | 376 | * \hideinitializer |
AnnaBridge | 172:7d866c31b3c5 | 377 | */ |
AnnaBridge | 172:7d866c31b3c5 | 378 | #define USBD_GET_BUS_STATE() ((uint32_t)(USBD->ATTR & 0xf)) |
AnnaBridge | 172:7d866c31b3c5 | 379 | |
AnnaBridge | 172:7d866c31b3c5 | 380 | /** |
AnnaBridge | 172:7d866c31b3c5 | 381 | * @brief Check cable connection state |
AnnaBridge | 172:7d866c31b3c5 | 382 | * |
AnnaBridge | 172:7d866c31b3c5 | 383 | * @param None |
AnnaBridge | 172:7d866c31b3c5 | 384 | * |
AnnaBridge | 172:7d866c31b3c5 | 385 | * @retval 0 USB cable is not attached. |
AnnaBridge | 172:7d866c31b3c5 | 386 | * @retval 1 USB cable is attached. |
AnnaBridge | 172:7d866c31b3c5 | 387 | * |
AnnaBridge | 172:7d866c31b3c5 | 388 | * @details Check the connection state by FLDET bit of USB_FLDET register. |
AnnaBridge | 172:7d866c31b3c5 | 389 | * \hideinitializer |
AnnaBridge | 172:7d866c31b3c5 | 390 | */ |
AnnaBridge | 172:7d866c31b3c5 | 391 | #define USBD_IS_ATTACHED() ((uint32_t)(USBD->VBUSDET & USBD_VBUSDET_VBUSDET_Msk)) |
AnnaBridge | 172:7d866c31b3c5 | 392 | |
AnnaBridge | 172:7d866c31b3c5 | 393 | /** |
AnnaBridge | 172:7d866c31b3c5 | 394 | * @brief Stop USB transaction of the specified endpoint ID |
AnnaBridge | 172:7d866c31b3c5 | 395 | * |
AnnaBridge | 172:7d866c31b3c5 | 396 | * @param[in] ep The USB endpoint ID. M480 Series supports 8 hardware endpoint ID. This parameter could be 0 ~ 11. |
AnnaBridge | 172:7d866c31b3c5 | 397 | * |
AnnaBridge | 172:7d866c31b3c5 | 398 | * @return None |
AnnaBridge | 172:7d866c31b3c5 | 399 | * |
AnnaBridge | 172:7d866c31b3c5 | 400 | * @details Write 1 to CLRRDY bit of USB_CFGPx register to stop USB transaction of the specified endpoint ID. |
AnnaBridge | 172:7d866c31b3c5 | 401 | * \hideinitializer |
AnnaBridge | 172:7d866c31b3c5 | 402 | */ |
AnnaBridge | 172:7d866c31b3c5 | 403 | #define USBD_STOP_TRANSACTION(ep) (*((__IO uint32_t *) ((uint32_t)&USBD->EP[0].CFGP + (uint32_t)((ep) << 4))) |= USBD_CFGP_CLRRDY_Msk) |
AnnaBridge | 172:7d866c31b3c5 | 404 | |
AnnaBridge | 172:7d866c31b3c5 | 405 | /** |
AnnaBridge | 172:7d866c31b3c5 | 406 | * @brief Set USB DATA1 PID for the specified endpoint ID |
AnnaBridge | 172:7d866c31b3c5 | 407 | * |
AnnaBridge | 172:7d866c31b3c5 | 408 | * @param[in] ep The USB endpoint ID. M480 Series supports 8 hardware endpoint ID. This parameter could be 0 ~ 11. |
AnnaBridge | 172:7d866c31b3c5 | 409 | * |
AnnaBridge | 172:7d866c31b3c5 | 410 | * @return None |
AnnaBridge | 172:7d866c31b3c5 | 411 | * |
AnnaBridge | 172:7d866c31b3c5 | 412 | * @details Set DSQ_SYNC bit of USB_CFGx register to specify the DATA1 PID for the following IN token transaction. |
AnnaBridge | 172:7d866c31b3c5 | 413 | * Base on this setting, hardware will toggle PID between DATA0 and DATA1 automatically for IN token transactions. |
AnnaBridge | 172:7d866c31b3c5 | 414 | * \hideinitializer |
AnnaBridge | 172:7d866c31b3c5 | 415 | */ |
AnnaBridge | 172:7d866c31b3c5 | 416 | #define USBD_SET_DATA1(ep) (*((__IO uint32_t *) ((uint32_t)&USBD->EP[0].CFG + (uint32_t)((ep) << 4))) |= USBD_CFG_DSQSYNC_Msk) |
AnnaBridge | 172:7d866c31b3c5 | 417 | |
AnnaBridge | 172:7d866c31b3c5 | 418 | /** |
AnnaBridge | 172:7d866c31b3c5 | 419 | * @brief Set USB DATA0 PID for the specified endpoint ID |
AnnaBridge | 172:7d866c31b3c5 | 420 | * |
AnnaBridge | 172:7d866c31b3c5 | 421 | * @param[in] ep The USB endpoint ID. M480 Series supports 8 hardware endpoint ID. This parameter could be 0 ~ 11. |
AnnaBridge | 172:7d866c31b3c5 | 422 | * |
AnnaBridge | 172:7d866c31b3c5 | 423 | * @return None |
AnnaBridge | 172:7d866c31b3c5 | 424 | * |
AnnaBridge | 172:7d866c31b3c5 | 425 | * @details Clear DSQ_SYNC bit of USB_CFGx register to specify the DATA0 PID for the following IN token transaction. |
AnnaBridge | 172:7d866c31b3c5 | 426 | * Base on this setting, hardware will toggle PID between DATA0 and DATA1 automatically for IN token transactions. |
AnnaBridge | 172:7d866c31b3c5 | 427 | * \hideinitializer |
AnnaBridge | 172:7d866c31b3c5 | 428 | */ |
AnnaBridge | 172:7d866c31b3c5 | 429 | #define USBD_SET_DATA0(ep) (*((__IO uint32_t *) ((uint32_t)&USBD->EP[0].CFG + (uint32_t)((ep) << 4))) &= (~USBD_CFG_DSQSYNC_Msk)) |
AnnaBridge | 172:7d866c31b3c5 | 430 | |
AnnaBridge | 172:7d866c31b3c5 | 431 | /** |
AnnaBridge | 172:7d866c31b3c5 | 432 | * @brief Set USB payload size (IN data) |
AnnaBridge | 172:7d866c31b3c5 | 433 | * |
AnnaBridge | 172:7d866c31b3c5 | 434 | * @param[in] ep The USB endpoint ID. M480 Series supports 8 hardware endpoint ID. This parameter could be 0 ~ 11. |
AnnaBridge | 172:7d866c31b3c5 | 435 | * |
AnnaBridge | 172:7d866c31b3c5 | 436 | * @param[in] size The transfer length. |
AnnaBridge | 172:7d866c31b3c5 | 437 | * |
AnnaBridge | 172:7d866c31b3c5 | 438 | * @return None |
AnnaBridge | 172:7d866c31b3c5 | 439 | * |
AnnaBridge | 172:7d866c31b3c5 | 440 | * @details This macro will write the transfer length to USB_MXPLDx register for IN data transaction. |
AnnaBridge | 172:7d866c31b3c5 | 441 | * \hideinitializer |
AnnaBridge | 172:7d866c31b3c5 | 442 | */ |
AnnaBridge | 172:7d866c31b3c5 | 443 | #define USBD_SET_PAYLOAD_LEN(ep, size) (*((__IO uint32_t *) ((uint32_t)&USBD->EP[0].MXPLD + (uint32_t)((ep) << 4))) = (size)) |
AnnaBridge | 172:7d866c31b3c5 | 444 | |
AnnaBridge | 172:7d866c31b3c5 | 445 | /** |
AnnaBridge | 172:7d866c31b3c5 | 446 | * @brief Get USB payload size (OUT data) |
AnnaBridge | 172:7d866c31b3c5 | 447 | * |
AnnaBridge | 172:7d866c31b3c5 | 448 | * @param[in] ep The USB endpoint ID. M480 Series supports 8 endpoint ID. This parameter could be 0 ~ 11. |
AnnaBridge | 172:7d866c31b3c5 | 449 | * |
AnnaBridge | 172:7d866c31b3c5 | 450 | * @return The value of USB_MXPLDx register. |
AnnaBridge | 172:7d866c31b3c5 | 451 | * |
AnnaBridge | 172:7d866c31b3c5 | 452 | * @details Get the data length of OUT data transaction by reading USB_MXPLDx register. |
AnnaBridge | 172:7d866c31b3c5 | 453 | * \hideinitializer |
AnnaBridge | 172:7d866c31b3c5 | 454 | */ |
AnnaBridge | 172:7d866c31b3c5 | 455 | #define USBD_GET_PAYLOAD_LEN(ep) ((uint32_t)*((__IO uint32_t *) ((uint32_t)&USBD->EP[0].MXPLD + (uint32_t)((ep) << 4)))) |
AnnaBridge | 172:7d866c31b3c5 | 456 | |
AnnaBridge | 172:7d866c31b3c5 | 457 | /** |
AnnaBridge | 172:7d866c31b3c5 | 458 | * @brief Configure endpoint |
AnnaBridge | 172:7d866c31b3c5 | 459 | * |
AnnaBridge | 172:7d866c31b3c5 | 460 | * @param[in] ep The USB endpoint ID. M480 Series supports 8 hardware endpoint ID. This parameter could be 0 ~ 11. |
AnnaBridge | 172:7d866c31b3c5 | 461 | * |
AnnaBridge | 172:7d866c31b3c5 | 462 | * @param[in] config The USB configuration. |
AnnaBridge | 172:7d866c31b3c5 | 463 | * |
AnnaBridge | 172:7d866c31b3c5 | 464 | * @return None |
AnnaBridge | 172:7d866c31b3c5 | 465 | * |
AnnaBridge | 172:7d866c31b3c5 | 466 | * @details This macro will write config parameter to USB_CFGx register of specified endpoint ID. |
AnnaBridge | 172:7d866c31b3c5 | 467 | * \hideinitializer |
AnnaBridge | 172:7d866c31b3c5 | 468 | */ |
AnnaBridge | 172:7d866c31b3c5 | 469 | #define USBD_CONFIG_EP(ep, config) (*((__IO uint32_t *) ((uint32_t)&USBD->EP[0].CFG + (uint32_t)((ep) << 4))) = (config)) |
AnnaBridge | 172:7d866c31b3c5 | 470 | |
AnnaBridge | 172:7d866c31b3c5 | 471 | /** |
AnnaBridge | 172:7d866c31b3c5 | 472 | * @brief Set USB endpoint buffer |
AnnaBridge | 172:7d866c31b3c5 | 473 | * |
AnnaBridge | 172:7d866c31b3c5 | 474 | * @param[in] ep The USB endpoint ID. M480 Series supports 8 hardware endpoint ID. This parameter could be 0 ~ 11. |
AnnaBridge | 172:7d866c31b3c5 | 475 | * |
AnnaBridge | 172:7d866c31b3c5 | 476 | * @param[in] offset The SRAM offset. |
AnnaBridge | 172:7d866c31b3c5 | 477 | * |
AnnaBridge | 172:7d866c31b3c5 | 478 | * @return None |
AnnaBridge | 172:7d866c31b3c5 | 479 | * |
AnnaBridge | 172:7d866c31b3c5 | 480 | * @details This macro will set the SRAM offset for the specified endpoint ID. |
AnnaBridge | 172:7d866c31b3c5 | 481 | * \hideinitializer |
AnnaBridge | 172:7d866c31b3c5 | 482 | */ |
AnnaBridge | 172:7d866c31b3c5 | 483 | #define USBD_SET_EP_BUF_ADDR(ep, offset) (*((__IO uint32_t *) ((uint32_t)&USBD->EP[0].BUFSEG + (uint32_t)((ep) << 4))) = (offset)) |
AnnaBridge | 172:7d866c31b3c5 | 484 | |
AnnaBridge | 172:7d866c31b3c5 | 485 | /** |
AnnaBridge | 172:7d866c31b3c5 | 486 | * @brief Get the offset of the specified USB endpoint buffer |
AnnaBridge | 172:7d866c31b3c5 | 487 | * |
AnnaBridge | 172:7d866c31b3c5 | 488 | * @param[in] ep The USB endpoint ID. M480 Series supports 8 hardware endpoint ID. This parameter could be 0 ~ 11. |
AnnaBridge | 172:7d866c31b3c5 | 489 | * |
AnnaBridge | 172:7d866c31b3c5 | 490 | * @return The offset of the specified endpoint buffer. |
AnnaBridge | 172:7d866c31b3c5 | 491 | * |
AnnaBridge | 172:7d866c31b3c5 | 492 | * @details This macro will return the SRAM offset of the specified endpoint ID. |
AnnaBridge | 172:7d866c31b3c5 | 493 | * \hideinitializer |
AnnaBridge | 172:7d866c31b3c5 | 494 | */ |
AnnaBridge | 172:7d866c31b3c5 | 495 | #define USBD_GET_EP_BUF_ADDR(ep) ((uint32_t)*((__IO uint32_t *) ((uint32_t)&USBD->EP[0].BUFSEG + (uint32_t)((ep) << 4)))) |
AnnaBridge | 172:7d866c31b3c5 | 496 | |
AnnaBridge | 172:7d866c31b3c5 | 497 | /** |
AnnaBridge | 172:7d866c31b3c5 | 498 | * @brief Set USB endpoint stall state |
AnnaBridge | 172:7d866c31b3c5 | 499 | * |
AnnaBridge | 172:7d866c31b3c5 | 500 | * @param[in] ep The USB endpoint ID. M480 Series supports 8 hardware endpoint ID. This parameter could be 0 ~ 11. |
AnnaBridge | 172:7d866c31b3c5 | 501 | * |
AnnaBridge | 172:7d866c31b3c5 | 502 | * @return None |
AnnaBridge | 172:7d866c31b3c5 | 503 | * |
AnnaBridge | 172:7d866c31b3c5 | 504 | * @details Set USB endpoint stall state for the specified endpoint ID. Endpoint will respond STALL token automatically. |
AnnaBridge | 172:7d866c31b3c5 | 505 | * \hideinitializer |
AnnaBridge | 172:7d866c31b3c5 | 506 | */ |
AnnaBridge | 172:7d866c31b3c5 | 507 | #define USBD_SET_EP_STALL(ep) (*((__IO uint32_t *) ((uint32_t)&USBD->EP[0ul].CFGP + (uint32_t)((ep) << 4))) |= USBD_CFGP_SSTALL_Msk) |
AnnaBridge | 172:7d866c31b3c5 | 508 | |
AnnaBridge | 172:7d866c31b3c5 | 509 | /** |
AnnaBridge | 172:7d866c31b3c5 | 510 | * @brief Clear USB endpoint stall state |
AnnaBridge | 172:7d866c31b3c5 | 511 | * |
AnnaBridge | 172:7d866c31b3c5 | 512 | * @param[in] ep The USB endpoint ID. M480 Series supports 8 hardware endpoint ID. This parameter could be 0 ~ 11. |
AnnaBridge | 172:7d866c31b3c5 | 513 | * |
AnnaBridge | 172:7d866c31b3c5 | 514 | * @return None |
AnnaBridge | 172:7d866c31b3c5 | 515 | * |
AnnaBridge | 172:7d866c31b3c5 | 516 | * @details Clear USB endpoint stall state for the specified endpoint ID. Endpoint will respond ACK/NAK token. |
AnnaBridge | 172:7d866c31b3c5 | 517 | * \hideinitializer |
AnnaBridge | 172:7d866c31b3c5 | 518 | */ |
AnnaBridge | 172:7d866c31b3c5 | 519 | #define USBD_CLR_EP_STALL(ep) (*((__IO uint32_t *) ((uint32_t)&USBD->EP[0].CFGP + (uint32_t)((ep) << 4))) &= ~USBD_CFGP_SSTALL_Msk) |
AnnaBridge | 172:7d866c31b3c5 | 520 | |
AnnaBridge | 172:7d866c31b3c5 | 521 | /** |
AnnaBridge | 172:7d866c31b3c5 | 522 | * @brief Get USB endpoint stall state |
AnnaBridge | 172:7d866c31b3c5 | 523 | * |
AnnaBridge | 172:7d866c31b3c5 | 524 | * @param[in] ep The USB endpoint ID. M480 Series supports 8 hardware endpoint ID. This parameter could be 0 ~ 11. |
AnnaBridge | 172:7d866c31b3c5 | 525 | * |
AnnaBridge | 172:7d866c31b3c5 | 526 | * @retval 0 USB endpoint is not stalled. |
AnnaBridge | 172:7d866c31b3c5 | 527 | * @retval Others USB endpoint is stalled. |
AnnaBridge | 172:7d866c31b3c5 | 528 | * |
AnnaBridge | 172:7d866c31b3c5 | 529 | * @details Get USB endpoint stall state of the specified endpoint ID. |
AnnaBridge | 172:7d866c31b3c5 | 530 | * \hideinitializer |
AnnaBridge | 172:7d866c31b3c5 | 531 | */ |
AnnaBridge | 172:7d866c31b3c5 | 532 | #define USBD_GET_EP_STALL(ep) (*((__IO uint32_t *) ((uint32_t)&USBD->EP[0].CFGP + (uint32_t)((ep) << 4))) & USBD_CFGP_SSTALL_Msk) |
AnnaBridge | 172:7d866c31b3c5 | 533 | |
AnnaBridge | 172:7d866c31b3c5 | 534 | /** |
AnnaBridge | 172:7d866c31b3c5 | 535 | * @brief To support byte access between USB SRAM and system SRAM |
AnnaBridge | 172:7d866c31b3c5 | 536 | * |
AnnaBridge | 172:7d866c31b3c5 | 537 | * @param[in] dest Destination pointer. |
AnnaBridge | 172:7d866c31b3c5 | 538 | * |
AnnaBridge | 172:7d866c31b3c5 | 539 | * @param[in] src Source pointer. |
AnnaBridge | 172:7d866c31b3c5 | 540 | * |
AnnaBridge | 172:7d866c31b3c5 | 541 | * @param[in] size Byte count. |
AnnaBridge | 172:7d866c31b3c5 | 542 | * |
AnnaBridge | 172:7d866c31b3c5 | 543 | * @return None |
AnnaBridge | 172:7d866c31b3c5 | 544 | * |
AnnaBridge | 172:7d866c31b3c5 | 545 | * @details This function will copy the number of data specified by size and src parameters to the address specified by dest parameter. |
AnnaBridge | 172:7d866c31b3c5 | 546 | * |
AnnaBridge | 172:7d866c31b3c5 | 547 | */ |
AnnaBridge | 172:7d866c31b3c5 | 548 | static __INLINE void USBD_MemCopy(uint8_t dest[], uint8_t src[], uint32_t size) |
AnnaBridge | 172:7d866c31b3c5 | 549 | { |
AnnaBridge | 172:7d866c31b3c5 | 550 | uint32_t volatile i=0ul; |
AnnaBridge | 172:7d866c31b3c5 | 551 | |
AnnaBridge | 172:7d866c31b3c5 | 552 | while(size--) |
AnnaBridge | 172:7d866c31b3c5 | 553 | { |
AnnaBridge | 172:7d866c31b3c5 | 554 | dest[i] = src[i]; |
AnnaBridge | 172:7d866c31b3c5 | 555 | i++; |
AnnaBridge | 172:7d866c31b3c5 | 556 | } |
AnnaBridge | 172:7d866c31b3c5 | 557 | } |
AnnaBridge | 172:7d866c31b3c5 | 558 | |
AnnaBridge | 172:7d866c31b3c5 | 559 | /** |
AnnaBridge | 172:7d866c31b3c5 | 560 | * @brief Set USB endpoint stall state |
AnnaBridge | 172:7d866c31b3c5 | 561 | * |
AnnaBridge | 172:7d866c31b3c5 | 562 | * @param[in] epnum USB endpoint number |
AnnaBridge | 172:7d866c31b3c5 | 563 | * |
AnnaBridge | 172:7d866c31b3c5 | 564 | * @return None |
AnnaBridge | 172:7d866c31b3c5 | 565 | * |
AnnaBridge | 172:7d866c31b3c5 | 566 | * @details Set USB endpoint stall state. Endpoint will respond STALL token automatically. |
AnnaBridge | 172:7d866c31b3c5 | 567 | * |
AnnaBridge | 172:7d866c31b3c5 | 568 | */ |
AnnaBridge | 172:7d866c31b3c5 | 569 | static __INLINE void USBD_SetStall(uint8_t epnum) |
AnnaBridge | 172:7d866c31b3c5 | 570 | { |
AnnaBridge | 172:7d866c31b3c5 | 571 | uint32_t u32CfgAddr; |
AnnaBridge | 172:7d866c31b3c5 | 572 | uint32_t u32Cfg; |
AnnaBridge | 172:7d866c31b3c5 | 573 | uint32_t i; |
AnnaBridge | 172:7d866c31b3c5 | 574 | |
AnnaBridge | 172:7d866c31b3c5 | 575 | for(i = 0ul; i < USBD_MAX_EP; i++) { |
AnnaBridge | 172:7d866c31b3c5 | 576 | u32CfgAddr = (uint32_t)(i << 4) + (uint32_t)&USBD->EP[0].CFG; /* USBD_CFG0 */ |
AnnaBridge | 172:7d866c31b3c5 | 577 | u32Cfg = *((__IO uint32_t *)(u32CfgAddr)); |
AnnaBridge | 172:7d866c31b3c5 | 578 | |
AnnaBridge | 172:7d866c31b3c5 | 579 | if((u32Cfg & 0xful) == epnum) { |
AnnaBridge | 172:7d866c31b3c5 | 580 | u32CfgAddr = (uint32_t)(i << 4) + (uint32_t)&USBD->EP[0].CFGP; /* USBD_CFGP0 */ |
AnnaBridge | 172:7d866c31b3c5 | 581 | u32Cfg = *((__IO uint32_t *)(u32CfgAddr)); |
AnnaBridge | 172:7d866c31b3c5 | 582 | |
AnnaBridge | 172:7d866c31b3c5 | 583 | *((__IO uint32_t *)(u32CfgAddr)) = (u32Cfg | USBD_CFGP_SSTALL); |
AnnaBridge | 172:7d866c31b3c5 | 584 | break; |
AnnaBridge | 172:7d866c31b3c5 | 585 | } |
AnnaBridge | 172:7d866c31b3c5 | 586 | } |
AnnaBridge | 172:7d866c31b3c5 | 587 | } |
AnnaBridge | 172:7d866c31b3c5 | 588 | |
AnnaBridge | 172:7d866c31b3c5 | 589 | /** |
AnnaBridge | 172:7d866c31b3c5 | 590 | * @brief Clear USB endpoint stall state |
AnnaBridge | 172:7d866c31b3c5 | 591 | * |
AnnaBridge | 172:7d866c31b3c5 | 592 | * @param[in] epnum USB endpoint number |
AnnaBridge | 172:7d866c31b3c5 | 593 | * |
AnnaBridge | 172:7d866c31b3c5 | 594 | * @return None |
AnnaBridge | 172:7d866c31b3c5 | 595 | * |
AnnaBridge | 172:7d866c31b3c5 | 596 | * @details Clear USB endpoint stall state. Endpoint will respond ACK/NAK token. |
AnnaBridge | 172:7d866c31b3c5 | 597 | */ |
AnnaBridge | 172:7d866c31b3c5 | 598 | static __INLINE void USBD_ClearStall(uint8_t epnum) |
AnnaBridge | 172:7d866c31b3c5 | 599 | { |
AnnaBridge | 172:7d866c31b3c5 | 600 | uint32_t u32CfgAddr; |
AnnaBridge | 172:7d866c31b3c5 | 601 | uint32_t u32Cfg; |
AnnaBridge | 172:7d866c31b3c5 | 602 | uint32_t i; |
AnnaBridge | 172:7d866c31b3c5 | 603 | |
AnnaBridge | 172:7d866c31b3c5 | 604 | for(i = 0ul; i < USBD_MAX_EP; i++) { |
AnnaBridge | 172:7d866c31b3c5 | 605 | u32CfgAddr = (uint32_t)(i << 4) + (uint32_t)&USBD->EP[0].CFG; /* USBD_CFG0 */ |
AnnaBridge | 172:7d866c31b3c5 | 606 | u32Cfg = *((__IO uint32_t *)(u32CfgAddr)); |
AnnaBridge | 172:7d866c31b3c5 | 607 | |
AnnaBridge | 172:7d866c31b3c5 | 608 | if((u32Cfg & 0xful) == epnum) { |
AnnaBridge | 172:7d866c31b3c5 | 609 | u32CfgAddr = (uint32_t)(i << 4) + (uint32_t)&USBD->EP[0].CFGP; /* USBD_CFGP0 */ |
AnnaBridge | 172:7d866c31b3c5 | 610 | u32Cfg = *((__IO uint32_t *)(u32CfgAddr)); |
AnnaBridge | 172:7d866c31b3c5 | 611 | |
AnnaBridge | 172:7d866c31b3c5 | 612 | *((__IO uint32_t *)(u32CfgAddr)) = (u32Cfg & ~USBD_CFGP_SSTALL); |
AnnaBridge | 172:7d866c31b3c5 | 613 | break; |
AnnaBridge | 172:7d866c31b3c5 | 614 | } |
AnnaBridge | 172:7d866c31b3c5 | 615 | } |
AnnaBridge | 172:7d866c31b3c5 | 616 | } |
AnnaBridge | 172:7d866c31b3c5 | 617 | |
AnnaBridge | 172:7d866c31b3c5 | 618 | /** |
AnnaBridge | 172:7d866c31b3c5 | 619 | * @brief Get USB endpoint stall state |
AnnaBridge | 172:7d866c31b3c5 | 620 | * |
AnnaBridge | 172:7d866c31b3c5 | 621 | * @param[in] epnum USB endpoint number |
AnnaBridge | 172:7d866c31b3c5 | 622 | * |
AnnaBridge | 172:7d866c31b3c5 | 623 | * @retval 0 USB endpoint is not stalled. |
AnnaBridge | 172:7d866c31b3c5 | 624 | * @retval Others USB endpoint is stalled. |
AnnaBridge | 172:7d866c31b3c5 | 625 | * |
AnnaBridge | 172:7d866c31b3c5 | 626 | * @details Get USB endpoint stall state. |
AnnaBridge | 172:7d866c31b3c5 | 627 | * |
AnnaBridge | 172:7d866c31b3c5 | 628 | */ |
AnnaBridge | 172:7d866c31b3c5 | 629 | static __INLINE uint32_t USBD_GetStall(uint8_t epnum) |
AnnaBridge | 172:7d866c31b3c5 | 630 | { |
AnnaBridge | 172:7d866c31b3c5 | 631 | uint32_t u32CfgAddr; |
AnnaBridge | 172:7d866c31b3c5 | 632 | uint32_t u32Cfg; |
AnnaBridge | 172:7d866c31b3c5 | 633 | uint32_t i; |
AnnaBridge | 172:7d866c31b3c5 | 634 | |
AnnaBridge | 172:7d866c31b3c5 | 635 | for(i = 0ul; i < USBD_MAX_EP; i++) { |
AnnaBridge | 172:7d866c31b3c5 | 636 | u32CfgAddr = (uint32_t)(i << 4) + (uint32_t)&USBD->EP[0].CFG; /* USBD_CFG0 */ |
AnnaBridge | 172:7d866c31b3c5 | 637 | u32Cfg = *((__IO uint32_t *)(u32CfgAddr)); |
AnnaBridge | 172:7d866c31b3c5 | 638 | |
AnnaBridge | 172:7d866c31b3c5 | 639 | if((u32Cfg & 0xful) == epnum) { |
AnnaBridge | 172:7d866c31b3c5 | 640 | u32CfgAddr = (uint32_t)(i << 4) + (uint32_t)&USBD->EP[0].CFGP; /* USBD_CFGP0 */ |
AnnaBridge | 172:7d866c31b3c5 | 641 | break; |
AnnaBridge | 172:7d866c31b3c5 | 642 | } |
AnnaBridge | 172:7d866c31b3c5 | 643 | } |
AnnaBridge | 172:7d866c31b3c5 | 644 | |
AnnaBridge | 172:7d866c31b3c5 | 645 | return ((*((__IO uint32_t *)(u32CfgAddr))) & USBD_CFGP_SSTALL); |
AnnaBridge | 172:7d866c31b3c5 | 646 | } |
AnnaBridge | 172:7d866c31b3c5 | 647 | |
AnnaBridge | 172:7d866c31b3c5 | 648 | |
AnnaBridge | 172:7d866c31b3c5 | 649 | extern volatile uint8_t g_usbd_RemoteWakeupEn; |
AnnaBridge | 172:7d866c31b3c5 | 650 | |
AnnaBridge | 172:7d866c31b3c5 | 651 | |
AnnaBridge | 172:7d866c31b3c5 | 652 | typedef void (*VENDOR_REQ)(void); /*!< Functional pointer type definition for Vendor class */ |
AnnaBridge | 172:7d866c31b3c5 | 653 | typedef void (*CLASS_REQ)(void); /*!< Functional pointer type declaration for USB class request callback handler */ |
AnnaBridge | 172:7d866c31b3c5 | 654 | typedef void (*SET_INTERFACE_REQ)(uint32_t u32AltInterface); /*!< Functional pointer type declaration for USB set interface request callback handler */ |
AnnaBridge | 172:7d866c31b3c5 | 655 | typedef void (*SET_CONFIG_CB)(void); /*!< Functional pointer type declaration for USB set configuration request callback handler */ |
AnnaBridge | 172:7d866c31b3c5 | 656 | |
AnnaBridge | 172:7d866c31b3c5 | 657 | |
AnnaBridge | 172:7d866c31b3c5 | 658 | /*--------------------------------------------------------------------*/ |
AnnaBridge | 172:7d866c31b3c5 | 659 | void USBD_Open(const S_USBD_INFO_T *param, CLASS_REQ pfnClassReq, SET_INTERFACE_REQ pfnSetInterface); |
AnnaBridge | 172:7d866c31b3c5 | 660 | void USBD_Start(void); |
AnnaBridge | 172:7d866c31b3c5 | 661 | void USBD_GetSetupPacket(uint8_t *buf); |
AnnaBridge | 172:7d866c31b3c5 | 662 | void USBD_ProcessSetupPacket(void); |
AnnaBridge | 172:7d866c31b3c5 | 663 | void USBD_StandardRequest(void); |
AnnaBridge | 172:7d866c31b3c5 | 664 | void USBD_PrepareCtrlIn(uint8_t pu8Buf[], uint32_t u32Size); |
AnnaBridge | 172:7d866c31b3c5 | 665 | void USBD_CtrlIn(void); |
AnnaBridge | 172:7d866c31b3c5 | 666 | void USBD_PrepareCtrlOut(uint8_t *pu8Buf, uint32_t u32Size); |
AnnaBridge | 172:7d866c31b3c5 | 667 | void USBD_CtrlOut(void); |
AnnaBridge | 172:7d866c31b3c5 | 668 | void USBD_SwReset(void); |
AnnaBridge | 172:7d866c31b3c5 | 669 | void USBD_SetVendorRequest(VENDOR_REQ pfnVendorReq); |
AnnaBridge | 172:7d866c31b3c5 | 670 | void USBD_SetConfigCallback(SET_CONFIG_CB pfnSetConfigCallback); |
AnnaBridge | 172:7d866c31b3c5 | 671 | void USBD_LockEpStall(uint32_t u32EpBitmap); |
AnnaBridge | 172:7d866c31b3c5 | 672 | |
AnnaBridge | 172:7d866c31b3c5 | 673 | /*@}*/ /* end of group M480_USBD_EXPORTED_FUNCTIONS */ |
AnnaBridge | 172:7d866c31b3c5 | 674 | |
AnnaBridge | 172:7d866c31b3c5 | 675 | /*@}*/ /* end of group M480_USBD_Driver */ |
AnnaBridge | 172:7d866c31b3c5 | 676 | |
AnnaBridge | 172:7d866c31b3c5 | 677 | /*@}*/ /* end of group M480_Device_Driver */ |
AnnaBridge | 172:7d866c31b3c5 | 678 | |
AnnaBridge | 172:7d866c31b3c5 | 679 | #ifdef __cplusplus |
AnnaBridge | 172:7d866c31b3c5 | 680 | } |
AnnaBridge | 172:7d866c31b3c5 | 681 | #endif |
AnnaBridge | 172:7d866c31b3c5 | 682 | |
AnnaBridge | 172:7d866c31b3c5 | 683 | #endif /*__USBD_H__*/ |
AnnaBridge | 172:7d866c31b3c5 | 684 | |
AnnaBridge | 172:7d866c31b3c5 | 685 | /*** (C) COPYRIGHT 2016 Nuvoton Technology Corp. ***/ |