Driver_USBH.h 20 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406
  1. /* -----------------------------------------------------------------------------
  2. * Copyright (c) 2013-2014 ARM Ltd.
  3. *
  4. * This software is provided 'as-is', without any express or implied warranty.
  5. * In no event will the authors be held liable for any damages arising from
  6. * the use of this software. Permission is granted to anyone to use this
  7. * software for any purpose, including commercial applications, and to alter
  8. * it and redistribute it freely, subject to the following restrictions:
  9. *
  10. * 1. The origin of this software must not be misrepresented; you must not
  11. * claim that you wrote the original software. If you use this software in
  12. * a product, an acknowledgment in the product documentation would be
  13. * appreciated but is not required.
  14. *
  15. * 2. Altered source versions must be plainly marked as such, and must not be
  16. * misrepresented as being the original software.
  17. *
  18. * 3. This notice may not be removed or altered from any source distribution.
  19. *
  20. *
  21. * $Date: 3. September 2014
  22. * $Revision: V2.01
  23. *
  24. * Project: USB Host Driver definitions
  25. * -------------------------------------------------------------------------- */
  26. /* History:
  27. * Version 2.01
  28. * Renamed structure ARM_USBH_EP_HANDLE to ARM_USBH_PIPE_HANDLE
  29. * Renamed functions ARM_USBH_Endpoint... to ARM_USBH_Pipe...
  30. * Renamed function ARM_USBH_SignalEndpointEvent to ARM_USBH_SignalPipeEvent
  31. * Version 2.00
  32. * Replaced function ARM_USBH_PortPowerOnOff with ARM_USBH_PortVbusOnOff
  33. * Changed function ARM_USBH_EndpointCreate parameters
  34. * Replaced function ARM_USBH_EndpointConfigure with ARM_USBH_EndpointModify
  35. * Replaced function ARM_USBH_EndpointClearHalt with ARM_USBH_EndpointReset
  36. * Replaced function ARM_USBH_URB_Submit with ARM_USBH_EndpointTransfer
  37. * Replaced function ARM_USBH_URB_Abort with ARM_USBH_EndpointTransferAbort
  38. * Added function ARM_USBH_EndpointTransferGetResult
  39. * Added function ARM_USBH_GetFrameNumber
  40. * Changed prefix ARM_DRV -> ARM_DRIVER
  41. * Version 1.20
  42. * Added API for OHCI/EHCI Host Controller Interface (HCI)
  43. * Version 1.10
  44. * Namespace prefix ARM_ added
  45. * Version 1.00
  46. * Initial release
  47. */
  48. #ifndef __DRIVER_USBH_H
  49. #define __DRIVER_USBH_H
  50. #include "Driver_USB.h"
  51. #define ARM_USBH_API_VERSION ARM_DRIVER_VERSION_MAJOR_MINOR(2,01) /* API version */
  52. /**
  53. \brief USB Host Port State
  54. */
  55. typedef struct _ARM_USBH_PORT_STATE {
  56. uint32_t connected : 1; ///< USB Host Port connected flag
  57. uint32_t overcurrent : 1; ///< USB Host Port overcurrent flag
  58. uint32_t speed : 2; ///< USB Host Port speed setting (ARM_USB_SPEED_xxx)
  59. } ARM_USBH_PORT_STATE;
  60. /**
  61. \brief USB Host Pipe Handle
  62. */
  63. typedef uint32_t ARM_USBH_PIPE_HANDLE;
  64. #define ARM_USBH_EP_HANDLE ARM_USBH_PIPE_HANDLE /* Legacy name */
  65. /****** USB Host Packet Information *****/
  66. #define ARM_USBH_PACKET_TOKEN_Pos 0
  67. #define ARM_USBH_PACKET_TOKEN_Msk (0x0FUL << ARM_USBH_PACKET_TOKEN_Pos)
  68. #define ARM_USBH_PACKET_SETUP (0x01UL << ARM_USBH_PACKET_TOKEN_Pos) ///< SETUP Packet
  69. #define ARM_USBH_PACKET_OUT (0x02UL << ARM_USBH_PACKET_TOKEN_Pos) ///< OUT Packet
  70. #define ARM_USBH_PACKET_IN (0x03UL << ARM_USBH_PACKET_TOKEN_Pos) ///< IN Packet
  71. #define ARM_USBH_PACKET_PING (0x04UL << ARM_USBH_PACKET_TOKEN_Pos) ///< PING Packet
  72. #define ARM_USBH_PACKET_DATA_Pos 4
  73. #define ARM_USBH_PACKET_DATA_Msk (0x0FUL << ARM_USBH_PACKET_DATA_Pos)
  74. #define ARM_USBH_PACKET_DATA0 (0x01UL << ARM_USBH_PACKET_DATA_Pos) ///< DATA0 PID
  75. #define ARM_USBH_PACKET_DATA1 (0x02UL << ARM_USBH_PACKET_DATA_Pos) ///< DATA1 PID
  76. #define ARM_USBH_PACKET_SPLIT_Pos 8
  77. #define ARM_USBH_PACKET_SPLIT_Msk (0x0FUL << ARM_USBH_PACKET_SPLIT_Pos)
  78. #define ARM_USBH_PACKET_SSPLIT (0x08UL << ARM_USBH_PACKET_SPLIT_Pos) ///< SSPLIT Packet
  79. #define ARM_USBH_PACKET_SSPLIT_S (0x09UL << ARM_USBH_PACKET_SPLIT_Pos) ///< SSPLIT Packet: Data Start
  80. #define ARM_USBH_PACKET_SSPLIT_E (0x0AUL << ARM_USBH_PACKET_SPLIT_Pos) ///< SSPLIT Packet: Data End
  81. #define ARM_USBH_PACKET_SSPLIT_S_E (0x0BUL << ARM_USBH_PACKET_SPLIT_Pos) ///< SSPLIT Packet: Data All
  82. #define ARM_USBH_PACKET_CSPLIT (0x0CUL << ARM_USBH_PACKET_SPLIT_Pos) ///< CSPLIT Packet
  83. #define ARM_USBH_PACKET_PRE (1UL << 12) ///< PRE Token
  84. /****** USB Host Port Event *****/
  85. #define ARM_USBH_EVENT_CONNECT (1UL << 0) ///< USB Device Connected to Port
  86. #define ARM_USBH_EVENT_DISCONNECT (1UL << 1) ///< USB Device Disconnected from Port
  87. #define ARM_USBH_EVENT_OVERCURRENT (1UL << 2) ///< USB Device caused Overcurrent
  88. #define ARM_USBH_EVENT_RESET (1UL << 3) ///< USB Reset completed
  89. #define ARM_USBH_EVENT_SUSPEND (1UL << 4) ///< USB Suspend occurred
  90. #define ARM_USBH_EVENT_RESUME (1UL << 5) ///< USB Resume occurred
  91. #define ARM_USBH_EVENT_REMOTE_WAKEUP (1UL << 6) ///< USB Device activated Remote Wakeup
  92. /****** USB Host Pipe Event *****/
  93. #define ARM_USBH_EVENT_TRANSFER_COMPLETE (1UL << 0) ///< Transfer completed
  94. #define ARM_USBH_EVENT_HANDSHAKE_NAK (1UL << 1) ///< NAK Handshake received
  95. #define ARM_USBH_EVENT_HANDSHAKE_NYET (1UL << 2) ///< NYET Handshake received
  96. #define ARM_USBH_EVENT_HANDSHAKE_MDATA (1UL << 3) ///< MDATA Handshake received
  97. #define ARM_USBH_EVENT_HANDSHAKE_STALL (1UL << 4) ///< STALL Handshake received
  98. #define ARM_USBH_EVENT_HANDSHAKE_ERR (1UL << 5) ///< ERR Handshake received
  99. #define ARM_USBH_EVENT_BUS_ERROR (1UL << 6) ///< Bus Error detected
  100. #ifndef __DOXYGEN_MW__ // exclude from middleware documentation
  101. // Function documentation
  102. /**
  103. \fn ARM_DRIVER_VERSION ARM_USBH_GetVersion (void)
  104. \brief Get driver version.
  105. \return \ref ARM_DRIVER_VERSION
  106. */
  107. /**
  108. \fn ARM_USBH_CAPABILITIES ARM_USBH_GetCapabilities (void)
  109. \brief Get driver capabilities.
  110. \return \ref ARM_USBH_CAPABILITIES
  111. */
  112. /**
  113. \fn int32_t ARM_USBH_Initialize (ARM_USBH_SignalPortEvent_t cb_port_event,
  114. ARM_USBH_SignalPipeEvent_t cb_pipe_event)
  115. \brief Initialize USB Host Interface.
  116. \param[in] cb_port_event Pointer to \ref ARM_USBH_SignalPortEvent
  117. \param[in] cb_pipe_event Pointer to \ref ARM_USBH_SignalPipeEvent
  118. \return \ref execution_status
  119. */
  120. /**
  121. \fn int32_t ARM_USBH_Uninitialize (void)
  122. \brief De-initialize USB Host Interface.
  123. \return \ref execution_status
  124. */
  125. /**
  126. \fn int32_t ARM_USBH_PowerControl (ARM_POWER_STATE state)
  127. \brief Control USB Host Interface Power.
  128. \param[in] state Power state
  129. \return \ref execution_status
  130. */
  131. /**
  132. \fn int32_t ARM_USBH_PortVbusOnOff (uint8_t port, bool vbus)
  133. \brief Root HUB Port VBUS on/off.
  134. \param[in] port Root HUB Port Number
  135. \param[in] vbus
  136. - \b false VBUS off
  137. - \b true VBUS on
  138. \return \ref execution_status
  139. */
  140. /**
  141. \fn int32_t ARM_USBH_PortReset (uint8_t port)
  142. \brief Do Root HUB Port Reset.
  143. \param[in] port Root HUB Port Number
  144. \return \ref execution_status
  145. */
  146. /**
  147. \fn int32_t ARM_USBH_PortSuspend (uint8_t port)
  148. \brief Suspend Root HUB Port (stop generating SOFs).
  149. \param[in] port Root HUB Port Number
  150. \return \ref execution_status
  151. */
  152. /**
  153. \fn int32_t ARM_USBH_PortResume (uint8_t port)
  154. \brief Resume Root HUB Port (start generating SOFs).
  155. \param[in] port Root HUB Port Number
  156. \return \ref execution_status
  157. */
  158. /**
  159. \fn ARM_USBH_PORT_STATE ARM_USBH_PortGetState (uint8_t port)
  160. \brief Get current Root HUB Port State.
  161. \param[in] port Root HUB Port Number
  162. \return Port State \ref ARM_USBH_PORT_STATE
  163. */
  164. /**
  165. \fn ARM_USBH_PIPE_HANDLE ARM_USBH_PipeCreate (uint8_t dev_addr,
  166. uint8_t dev_speed,
  167. uint8_t hub_addr,
  168. uint8_t hub_port,
  169. uint8_t ep_addr,
  170. uint8_t ep_type,
  171. uint16_t ep_max_packet_size,
  172. uint8_t ep_interval)
  173. \brief Create Pipe in System.
  174. \param[in] dev_addr Device Address
  175. \param[in] dev_speed Device Speed
  176. \param[in] hub_addr Hub Address
  177. \param[in] hub_port Hub Port
  178. \param[in] ep_addr Endpoint Address
  179. - ep_addr.0..3: Address
  180. - ep_addr.7: Direction
  181. \param[in] ep_type Endpoint Type (ARM_USB_ENDPOINT_xxx)
  182. \param[in] ep_max_packet_size Endpoint Maximum Packet Size
  183. \param[in] ep_interval Endpoint Polling Interval
  184. \return Pipe Handle \ref ARM_USBH_PIPE_HANDLE
  185. */
  186. /**
  187. \fn int32_t ARM_USBH_PipeModify (ARM_USBH_PIPE_HANDLE pipe_hndl,
  188. uint8_t dev_addr,
  189. uint8_t dev_speed,
  190. uint8_t hub_addr,
  191. uint8_t hub_port,
  192. uint16_t ep_max_packet_size)
  193. \brief Modify Pipe in System.
  194. \param[in] pipe_hndl Pipe Handle
  195. \param[in] dev_addr Device Address
  196. \param[in] dev_speed Device Speed
  197. \param[in] hub_addr Hub Address
  198. \param[in] hub_port Hub Port
  199. \param[in] ep_max_packet_size Endpoint Maximum Packet Size
  200. \return \ref execution_status
  201. */
  202. /**
  203. \fn int32_t ARM_USBH_PipeDelete (ARM_USBH_PIPE_HANDLE pipe_hndl)
  204. \brief Delete Pipe from System.
  205. \param[in] pipe_hndl Pipe Handle
  206. \return \ref execution_status
  207. */
  208. /**
  209. \fn int32_t ARM_USBH_PipeReset (ARM_USBH_PIPE_HANDLE pipe_hndl)
  210. \brief Reset Pipe.
  211. \param[in] pipe_hndl Pipe Handle
  212. \return \ref execution_status
  213. */
  214. /**
  215. \fn int32_t ARM_USBH_PipeTransfer (ARM_USBH_PIPE_HANDLE pipe_hndl,
  216. uint32_t packet,
  217. uint8_t *data,
  218. uint32_t num)
  219. \brief Transfer packets through USB Pipe.
  220. \param[in] pipe_hndl Pipe Handle
  221. \param[in] packet Packet information
  222. \param[in] data Pointer to buffer with data to send or for data to receive
  223. \param[in] num Number of data bytes to transfer
  224. \return \ref execution_status
  225. */
  226. /**
  227. \fn uint32_t ARM_USBH_PipeTransferGetResult (ARM_USBH_PIPE_HANDLE pipe_hndl)
  228. \brief Get result of USB Pipe transfer.
  229. \param[in] pipe_hndl Pipe Handle
  230. \return number of successfully transferred data bytes
  231. */
  232. /**
  233. \fn int32_t ARM_USBH_PipeTransferAbort (ARM_USBH_PIPE_HANDLE pipe_hndl)
  234. \brief Abort current USB Pipe transfer.
  235. \param[in] pipe_hndl Pipe Handle
  236. \return \ref execution_status
  237. */
  238. /**
  239. \fn uint16_t ARM_USBH_GetFrameNumber (void)
  240. \brief Get current USB Frame Number.
  241. \return Frame Number
  242. */
  243. /**
  244. \fn void ARM_USBH_SignalPortEvent (uint8_t port, uint32_t event)
  245. \brief Signal Root HUB Port Event.
  246. \param[in] port Root HUB Port Number
  247. \param[in] event \ref USBH_port_events
  248. \return none
  249. */
  250. /**
  251. \fn void ARM_USBH_SignalPipeEvent (ARM_USBH_PIPE_HANDLE pipe_hndl, uint32_t event)
  252. \brief Signal Pipe Event.
  253. \param[in] pipe_hndl Pipe Handle
  254. \param[in] event \ref USBH_pipe_events
  255. \return none
  256. */
  257. typedef void (*ARM_USBH_SignalPortEvent_t) (uint8_t port, uint32_t event); ///< Pointer to \ref ARM_USBH_SignalPortEvent : Signal Root HUB Port Event.
  258. typedef void (*ARM_USBH_SignalPipeEvent_t) (ARM_USBH_PIPE_HANDLE pipe_hndl, uint32_t event); ///< Pointer to \ref ARM_USBH_SignalPipeEvent : Signal Pipe Event.
  259. #define ARM_USBH_SignalEndpointEvent_t ARM_USBH_SignalPipeEvent_t /* Legacy name */
  260. /**
  261. \brief USB Host Driver Capabilities.
  262. */
  263. typedef struct _ARM_USBH_CAPABILITIES {
  264. uint32_t port_mask : 15; ///< Root HUB available Ports Mask
  265. uint32_t auto_split : 1; ///< Automatic SPLIT packet handling
  266. uint32_t event_connect : 1; ///< Signal Connect event
  267. uint32_t event_disconnect : 1; ///< Signal Disconnect event
  268. uint32_t event_overcurrent : 1; ///< Signal Overcurrent event
  269. } ARM_USBH_CAPABILITIES;
  270. /**
  271. \brief Access structure of USB Host Driver.
  272. */
  273. typedef struct _ARM_DRIVER_USBH {
  274. ARM_DRIVER_VERSION (*GetVersion) (void); ///< Pointer to \ref ARM_USBH_GetVersion : Get driver version.
  275. ARM_USBH_CAPABILITIES (*GetCapabilities) (void); ///< Pointer to \ref ARM_USBH_GetCapabilities : Get driver capabilities.
  276. int32_t (*Initialize) (ARM_USBH_SignalPortEvent_t cb_port_event,
  277. ARM_USBH_SignalPipeEvent_t cb_pipe_event); ///< Pointer to \ref ARM_USBH_Initialize : Initialize USB Host Interface.
  278. int32_t (*Uninitialize) (void); ///< Pointer to \ref ARM_USBH_Uninitialize : De-initialize USB Host Interface.
  279. int32_t (*PowerControl) (ARM_POWER_STATE state); ///< Pointer to \ref ARM_USBH_PowerControl : Control USB Host Interface Power.
  280. int32_t (*PortVbusOnOff) (uint8_t port, bool vbus); ///< Pointer to \ref ARM_USBH_PortVbusOnOff : Root HUB Port VBUS on/off.
  281. int32_t (*PortReset) (uint8_t port); ///< Pointer to \ref ARM_USBH_PortReset : Do Root HUB Port Reset.
  282. int32_t (*PortSuspend) (uint8_t port); ///< Pointer to \ref ARM_USBH_PortSuspend : Suspend Root HUB Port (stop generating SOFs).
  283. int32_t (*PortResume) (uint8_t port); ///< Pointer to \ref ARM_USBH_PortResume : Resume Root HUB Port (start generating SOFs).
  284. ARM_USBH_PORT_STATE (*PortGetState) (uint8_t port); ///< Pointer to \ref ARM_USBH_PortGetState : Get current Root HUB Port State.
  285. ARM_USBH_PIPE_HANDLE (*PipeCreate) (uint8_t dev_addr,
  286. uint8_t dev_speed,
  287. uint8_t hub_addr,
  288. uint8_t hub_port,
  289. uint8_t ep_addr,
  290. uint8_t ep_type,
  291. uint16_t ep_max_packet_size,
  292. uint8_t ep_interval); ///< Pointer to \ref ARM_USBH_PipeCreate : Create Pipe in System.
  293. int32_t (*PipeModify) (ARM_USBH_PIPE_HANDLE pipe_hndl,
  294. uint8_t dev_addr,
  295. uint8_t dev_speed,
  296. uint8_t hub_addr,
  297. uint8_t hub_port,
  298. uint16_t ep_max_packet_size); ///< Pointer to \ref ARM_USBH_PipeModify : Modify Pipe in System.
  299. int32_t (*PipeDelete) (ARM_USBH_PIPE_HANDLE pipe_hndl); ///< Pointer to \ref ARM_USBH_PipeDelete : Delete Pipe from System.
  300. int32_t (*PipeReset) (ARM_USBH_PIPE_HANDLE pipe_hndl); ///< Pointer to \ref ARM_USBH_PipeReset : Reset Pipe.
  301. int32_t (*PipeTransfer) (ARM_USBH_PIPE_HANDLE pipe_hndl,
  302. uint32_t packet,
  303. uint8_t *data,
  304. uint32_t num); ///< Pointer to \ref ARM_USBH_PipeTransfer : Transfer packets through USB Pipe.
  305. uint32_t (*PipeTransferGetResult) (ARM_USBH_PIPE_HANDLE pipe_hndl); ///< Pointer to \ref ARM_USBH_PipeTransferGetResult : Get result of USB Pipe transfer.
  306. int32_t (*PipeTransferAbort) (ARM_USBH_PIPE_HANDLE pipe_hndl); ///< Pointer to \ref ARM_USBH_PipeTransferAbort : Abort current USB Pipe transfer.
  307. uint16_t (*GetFrameNumber) (void); ///< Pointer to \ref ARM_USBH_GetFrameNumber : Get current USB Frame Number.
  308. } const ARM_DRIVER_USBH;
  309. // HCI (OHCI/EHCI)
  310. // Function documentation
  311. /**
  312. \fn ARM_DRIVER_VERSION ARM_USBH_HCI_GetVersion (void)
  313. \brief Get USB Host HCI (OHCI/EHCI) driver version.
  314. \return \ref ARM_DRIVER_VERSION
  315. */
  316. /**
  317. \fn ARM_USBH_HCI_CAPABILITIES ARM_USBH_HCI_GetCapabilities (void)
  318. \brief Get driver capabilities.
  319. \return \ref ARM_USBH_HCI_CAPABILITIES
  320. */
  321. /**
  322. \fn int32_t ARM_USBH_HCI_Initialize (ARM_USBH_HCI_Interrupt_t *cb_interrupt)
  323. \brief Initialize USB Host HCI (OHCI/EHCI) Interface.
  324. \param[in] cb_interrupt Pointer to Interrupt Handler Routine
  325. \return \ref execution_status
  326. */
  327. /**
  328. \fn int32_t ARM_USBH_HCI_Uninitialize (void)
  329. \brief De-initialize USB Host HCI (OHCI/EHCI) Interface.
  330. \return \ref execution_status
  331. */
  332. /**
  333. \fn int32_t ARM_USBH_HCI_PowerControl (ARM_POWER_STATE state)
  334. \brief Control USB Host HCI (OHCI/EHCI) Interface Power.
  335. \param[in] state Power state
  336. \return \ref execution_status
  337. */
  338. /**
  339. \fn int32_t ARM_USBH_HCI_PortVbusOnOff (uint8_t port, bool vbus)
  340. \brief USB Host HCI (OHCI/EHCI) Root HUB Port VBUS on/off.
  341. \param[in] port Root HUB Port Number
  342. \param[in] vbus
  343. - \b false VBUS off
  344. - \b true VBUS on
  345. \return \ref execution_status
  346. */
  347. /**
  348. \fn void ARM_USBH_HCI_Interrupt (void)
  349. \brief USB Host HCI Interrupt Handler.
  350. \return none
  351. */
  352. typedef void (*ARM_USBH_HCI_Interrupt_t) (void); ///< Pointer to Interrupt Handler Routine.
  353. /**
  354. \brief USB Host HCI (OHCI/EHCI) Driver Capabilities.
  355. */
  356. typedef struct _ARM_USBH_HCI_CAPABILITIES {
  357. uint32_t port_mask : 15; ///< Root HUB available Ports Mask
  358. } ARM_USBH_HCI_CAPABILITIES;
  359. /**
  360. \brief Access structure of USB Host HCI (OHCI/EHCI) Driver.
  361. */
  362. typedef struct _ARM_DRIVER_USBH_HCI {
  363. ARM_DRIVER_VERSION (*GetVersion) (void); ///< Pointer to \ref ARM_USBH_HCI_GetVersion : Get USB Host HCI (OHCI/EHCI) driver version.
  364. ARM_USBH_HCI_CAPABILITIES (*GetCapabilities) (void); ///< Pointer to \ref ARM_USBH_HCI_GetCapabilities : Get driver capabilities.
  365. int32_t (*Initialize) (ARM_USBH_HCI_Interrupt_t cb_interrupt); ///< Pointer to \ref ARM_USBH_HCI_Initialize : Initialize USB Host HCI (OHCI/EHCI) Interface.
  366. int32_t (*Uninitialize) (void); ///< Pointer to \ref ARM_USBH_HCI_Uninitialize : De-initialize USB Host HCI (OHCI/EHCI) Interface.
  367. int32_t (*PowerControl) (ARM_POWER_STATE state); ///< Pointer to \ref ARM_USBH_HCI_PowerControl : Control USB Host HCI (OHCI/EHCI) Interface Power.
  368. int32_t (*PortVbusOnOff) (uint8_t port, bool vbus); ///< Pointer to \ref ARM_USBH_HCI_PortVbusOnOff : USB Host HCI (OHCI/EHCI) Root HUB Port VBUS on/off.
  369. } const ARM_DRIVER_USBH_HCI;
  370. #endif /* __DOXYGEN_MW__ */
  371. #endif /* __DRIVER_USBH_H */