stm32f4xx_ll_usb.c 56 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360136113621363136413651366136713681369137013711372137313741375137613771378137913801381138213831384138513861387138813891390139113921393139413951396139713981399140014011402140314041405140614071408140914101411141214131414141514161417141814191420142114221423142414251426142714281429143014311432143314341435143614371438143914401441144214431444144514461447144814491450145114521453145414551456145714581459146014611462146314641465146614671468146914701471147214731474147514761477147814791480148114821483148414851486148714881489149014911492149314941495149614971498149915001501150215031504150515061507150815091510151115121513151415151516151715181519152015211522152315241525152615271528152915301531153215331534153515361537153815391540154115421543154415451546154715481549155015511552155315541555155615571558155915601561156215631564156515661567156815691570157115721573157415751576157715781579158015811582158315841585158615871588158915901591159215931594159515961597159815991600160116021603160416051606160716081609161016111612161316141615161616171618161916201621162216231624162516261627162816291630163116321633163416351636163716381639164016411642164316441645164616471648164916501651165216531654165516561657165816591660166116621663166416651666166716681669167016711672167316741675167616771678167916801681168216831684168516861687168816891690169116921693169416951696169716981699170017011702170317041705170617071708170917101711171217131714171517161717171817191720172117221723172417251726172717281729173017311732173317341735173617371738173917401741174217431744174517461747174817491750175117521753175417551756175717581759176017611762176317641765176617671768176917701771177217731774177517761777177817791780178117821783178417851786178717881789179017911792179317941795179617971798179918001801180218031804180518061807180818091810181118121813181418151816181718181819182018211822182318241825182618271828182918301831183218331834183518361837183818391840184118421843184418451846184718481849185018511852185318541855185618571858185918601861186218631864186518661867186818691870187118721873187418751876187718781879188018811882188318841885188618871888188918901891189218931894189518961897189818991900190119021903190419051906190719081909191019111912191319141915191619171918191919201921192219231924192519261927192819291930193119321933193419351936193719381939194019411942194319441945194619471948194919501951195219531954195519561957195819591960196119621963196419651966196719681969197019711972197319741975197619771978197919801981198219831984198519861987198819891990199119921993199419951996199719981999200020012002200320042005200620072008200920102011201220132014201520162017201820192020202120222023202420252026202720282029203020312032
  1. /**
  2. ******************************************************************************
  3. * @file stm32f4xx_ll_usb.c
  4. * @author MCD Application Team
  5. * @brief USB Low Layer HAL module driver.
  6. *
  7. * This file provides firmware functions to manage the following
  8. * functionalities of the USB Peripheral Controller:
  9. * + Initialization/de-initialization functions
  10. * + I/O operation functions
  11. * + Peripheral Control functions
  12. * + Peripheral State functions
  13. *
  14. @verbatim
  15. ==============================================================================
  16. ##### How to use this driver #####
  17. ==============================================================================
  18. [..]
  19. (#) Fill parameters of Init structure in USB_OTG_CfgTypeDef structure.
  20. (#) Call USB_CoreInit() API to initialize the USB Core peripheral.
  21. (#) The upper HAL HCD/PCD driver will call the right routines for its internal processes.
  22. @endverbatim
  23. ******************************************************************************
  24. * @attention
  25. *
  26. * <h2><center>&copy; Copyright (c) 2016 STMicroelectronics.
  27. * All rights reserved.</center></h2>
  28. *
  29. * This software component is licensed by ST under BSD 3-Clause license,
  30. * the "License"; You may not use this file except in compliance with the
  31. * License. You may obtain a copy of the License at:
  32. * opensource.org/licenses/BSD-3-Clause
  33. *
  34. ******************************************************************************
  35. */
  36. /* Includes ------------------------------------------------------------------*/
  37. #include "stm32f4xx_hal.h"
  38. /** @addtogroup STM32F4xx_LL_USB_DRIVER
  39. * @{
  40. */
  41. #if defined (HAL_PCD_MODULE_ENABLED) || defined (HAL_HCD_MODULE_ENABLED)
  42. #if defined (USB_OTG_FS) || defined (USB_OTG_HS)
  43. /* Private typedef -----------------------------------------------------------*/
  44. /* Private define ------------------------------------------------------------*/
  45. /* Private macro -------------------------------------------------------------*/
  46. /* Private variables ---------------------------------------------------------*/
  47. /* Private function prototypes -----------------------------------------------*/
  48. /* Private functions ---------------------------------------------------------*/
  49. #if defined (USB_OTG_FS) || defined (USB_OTG_HS)
  50. static HAL_StatusTypeDef USB_CoreReset(USB_OTG_GlobalTypeDef *USBx);
  51. /* Exported functions --------------------------------------------------------*/
  52. /** @defgroup USB_LL_Exported_Functions USB Low Layer Exported Functions
  53. * @{
  54. */
  55. /** @defgroup USB_LL_Exported_Functions_Group1 Initialization/de-initialization functions
  56. * @brief Initialization and Configuration functions
  57. *
  58. @verbatim
  59. ===============================================================================
  60. ##### Initialization/de-initialization functions #####
  61. ===============================================================================
  62. @endverbatim
  63. * @{
  64. */
  65. /**
  66. * @brief Initializes the USB Core
  67. * @param USBx USB Instance
  68. * @param cfg pointer to a USB_OTG_CfgTypeDef structure that contains
  69. * the configuration information for the specified USBx peripheral.
  70. * @retval HAL status
  71. */
  72. HAL_StatusTypeDef USB_CoreInit(USB_OTG_GlobalTypeDef *USBx, USB_OTG_CfgTypeDef cfg)
  73. {
  74. HAL_StatusTypeDef ret;
  75. if (cfg.phy_itface == USB_OTG_ULPI_PHY)
  76. {
  77. USBx->GCCFG &= ~(USB_OTG_GCCFG_PWRDWN);
  78. /* Init The ULPI Interface */
  79. USBx->GUSBCFG &= ~(USB_OTG_GUSBCFG_TSDPS | USB_OTG_GUSBCFG_ULPIFSLS | USB_OTG_GUSBCFG_PHYSEL);
  80. /* Select vbus source */
  81. USBx->GUSBCFG &= ~(USB_OTG_GUSBCFG_ULPIEVBUSD | USB_OTG_GUSBCFG_ULPIEVBUSI);
  82. if (cfg.use_external_vbus == 1U)
  83. {
  84. USBx->GUSBCFG |= USB_OTG_GUSBCFG_ULPIEVBUSD;
  85. }
  86. /* Reset after a PHY select */
  87. ret = USB_CoreReset(USBx);
  88. }
  89. else /* FS interface (embedded Phy) */
  90. {
  91. /* Select FS Embedded PHY */
  92. USBx->GUSBCFG |= USB_OTG_GUSBCFG_PHYSEL;
  93. /* Reset after a PHY select and set Host mode */
  94. ret = USB_CoreReset(USBx);
  95. if (cfg.battery_charging_enable == 0U)
  96. {
  97. /* Activate the USB Transceiver */
  98. USBx->GCCFG |= USB_OTG_GCCFG_PWRDWN;
  99. }
  100. else
  101. {
  102. /* Deactivate the USB Transceiver */
  103. USBx->GCCFG &= ~(USB_OTG_GCCFG_PWRDWN);
  104. }
  105. }
  106. if (cfg.dma_enable == 1U)
  107. {
  108. USBx->GAHBCFG |= USB_OTG_GAHBCFG_HBSTLEN_2;
  109. USBx->GAHBCFG |= USB_OTG_GAHBCFG_DMAEN;
  110. }
  111. return ret;
  112. }
  113. /**
  114. * @brief Set the USB turnaround time
  115. * @param USBx USB Instance
  116. * @param hclk: AHB clock frequency
  117. * @retval USB turnaround time In PHY Clocks number
  118. */
  119. HAL_StatusTypeDef USB_SetTurnaroundTime(USB_OTG_GlobalTypeDef *USBx,
  120. uint32_t hclk, uint8_t speed)
  121. {
  122. uint32_t UsbTrd;
  123. /* The USBTRD is configured according to the tables below, depending on AHB frequency
  124. used by application. In the low AHB frequency range it is used to stretch enough the USB response
  125. time to IN tokens, the USB turnaround time, so to compensate for the longer AHB read access
  126. latency to the Data FIFO */
  127. if (speed == USBD_FS_SPEED)
  128. {
  129. if ((hclk >= 14200000U) && (hclk < 15000000U))
  130. {
  131. /* hclk Clock Range between 14.2-15 MHz */
  132. UsbTrd = 0xFU;
  133. }
  134. else if ((hclk >= 15000000U) && (hclk < 16000000U))
  135. {
  136. /* hclk Clock Range between 15-16 MHz */
  137. UsbTrd = 0xEU;
  138. }
  139. else if ((hclk >= 16000000U) && (hclk < 17200000U))
  140. {
  141. /* hclk Clock Range between 16-17.2 MHz */
  142. UsbTrd = 0xDU;
  143. }
  144. else if ((hclk >= 17200000U) && (hclk < 18500000U))
  145. {
  146. /* hclk Clock Range between 17.2-18.5 MHz */
  147. UsbTrd = 0xCU;
  148. }
  149. else if ((hclk >= 18500000U) && (hclk < 20000000U))
  150. {
  151. /* hclk Clock Range between 18.5-20 MHz */
  152. UsbTrd = 0xBU;
  153. }
  154. else if ((hclk >= 20000000U) && (hclk < 21800000U))
  155. {
  156. /* hclk Clock Range between 20-21.8 MHz */
  157. UsbTrd = 0xAU;
  158. }
  159. else if ((hclk >= 21800000U) && (hclk < 24000000U))
  160. {
  161. /* hclk Clock Range between 21.8-24 MHz */
  162. UsbTrd = 0x9U;
  163. }
  164. else if ((hclk >= 24000000U) && (hclk < 27700000U))
  165. {
  166. /* hclk Clock Range between 24-27.7 MHz */
  167. UsbTrd = 0x8U;
  168. }
  169. else if ((hclk >= 27700000U) && (hclk < 32000000U))
  170. {
  171. /* hclk Clock Range between 27.7-32 MHz */
  172. UsbTrd = 0x7U;
  173. }
  174. else /* if(hclk >= 32000000) */
  175. {
  176. /* hclk Clock Range between 32-200 MHz */
  177. UsbTrd = 0x6U;
  178. }
  179. }
  180. else if (speed == USBD_HS_SPEED)
  181. {
  182. UsbTrd = USBD_HS_TRDT_VALUE;
  183. }
  184. else
  185. {
  186. UsbTrd = USBD_DEFAULT_TRDT_VALUE;
  187. }
  188. USBx->GUSBCFG &= ~USB_OTG_GUSBCFG_TRDT;
  189. USBx->GUSBCFG |= (uint32_t)((UsbTrd << 10) & USB_OTG_GUSBCFG_TRDT);
  190. return HAL_OK;
  191. }
  192. /**
  193. * @brief USB_EnableGlobalInt
  194. * Enables the controller's Global Int in the AHB Config reg
  195. * @param USBx Selected device
  196. * @retval HAL status
  197. */
  198. HAL_StatusTypeDef USB_EnableGlobalInt(USB_OTG_GlobalTypeDef *USBx)
  199. {
  200. USBx->GAHBCFG |= USB_OTG_GAHBCFG_GINT;
  201. return HAL_OK;
  202. }
  203. /**
  204. * @brief USB_DisableGlobalInt
  205. * Disable the controller's Global Int in the AHB Config reg
  206. * @param USBx Selected device
  207. * @retval HAL status
  208. */
  209. HAL_StatusTypeDef USB_DisableGlobalInt(USB_OTG_GlobalTypeDef *USBx)
  210. {
  211. USBx->GAHBCFG &= ~USB_OTG_GAHBCFG_GINT;
  212. return HAL_OK;
  213. }
  214. /**
  215. * @brief USB_SetCurrentMode : Set functional mode
  216. * @param USBx Selected device
  217. * @param mode current core mode
  218. * This parameter can be one of these values:
  219. * @arg USB_DEVICE_MODE: Peripheral mode
  220. * @arg USB_HOST_MODE: Host mode
  221. * @arg USB_DRD_MODE: Dual Role Device mode
  222. * @retval HAL status
  223. */
  224. HAL_StatusTypeDef USB_SetCurrentMode(USB_OTG_GlobalTypeDef *USBx, USB_OTG_ModeTypeDef mode)
  225. {
  226. USBx->GUSBCFG &= ~(USB_OTG_GUSBCFG_FHMOD | USB_OTG_GUSBCFG_FDMOD);
  227. if (mode == USB_HOST_MODE)
  228. {
  229. USBx->GUSBCFG |= USB_OTG_GUSBCFG_FHMOD;
  230. }
  231. else if (mode == USB_DEVICE_MODE)
  232. {
  233. USBx->GUSBCFG |= USB_OTG_GUSBCFG_FDMOD;
  234. }
  235. else
  236. {
  237. return HAL_ERROR;
  238. }
  239. HAL_Delay(50U);
  240. return HAL_OK;
  241. }
  242. /**
  243. * @brief USB_DevInit : Initializes the USB_OTG controller registers
  244. * for device mode
  245. * @param USBx Selected device
  246. * @param cfg pointer to a USB_OTG_CfgTypeDef structure that contains
  247. * the configuration information for the specified USBx peripheral.
  248. * @retval HAL status
  249. */
  250. HAL_StatusTypeDef USB_DevInit(USB_OTG_GlobalTypeDef *USBx, USB_OTG_CfgTypeDef cfg)
  251. {
  252. HAL_StatusTypeDef ret = HAL_OK;
  253. uint32_t USBx_BASE = (uint32_t)USBx;
  254. uint32_t i;
  255. for (i = 0U; i < 15U; i++)
  256. {
  257. USBx->DIEPTXF[i] = 0U;
  258. }
  259. #if defined(STM32F446xx) || defined(STM32F469xx) || defined(STM32F479xx) || defined(STM32F412Zx) || defined(STM32F412Vx) || defined(STM32F412Rx) || defined(STM32F412Cx) || defined(STM32F413xx) || defined(STM32F423xx)
  260. /* VBUS Sensing setup */
  261. if (cfg.vbus_sensing_enable == 0U)
  262. {
  263. /* Deactivate VBUS Sensing B */
  264. USBx->GCCFG &= ~USB_OTG_GCCFG_VBDEN;
  265. /* B-peripheral session valid override enable */
  266. USBx->GOTGCTL |= USB_OTG_GOTGCTL_BVALOEN;
  267. USBx->GOTGCTL |= USB_OTG_GOTGCTL_BVALOVAL;
  268. }
  269. else
  270. {
  271. /* Enable HW VBUS sensing */
  272. USBx->GCCFG |= USB_OTG_GCCFG_VBDEN;
  273. }
  274. #else
  275. /* VBUS Sensing setup */
  276. if (cfg.vbus_sensing_enable == 0U)
  277. {
  278. /*
  279. * Disable HW VBUS sensing. VBUS is internally considered to be always
  280. * at VBUS-Valid level (5V).
  281. */
  282. USBx->GCCFG |= USB_OTG_GCCFG_NOVBUSSENS;
  283. USBx->GCCFG &= ~USB_OTG_GCCFG_VBUSBSEN;
  284. USBx->GCCFG &= ~USB_OTG_GCCFG_VBUSASEN;
  285. }
  286. else
  287. {
  288. /* Enable HW VBUS sensing */
  289. USBx->GOTGCTL &= ~USB_OTG_GCCFG_NOVBUSSENS;
  290. USBx->GCCFG |= USB_OTG_GCCFG_VBUSBSEN;
  291. }
  292. #endif /* defined(STM32F446xx) || defined(STM32F469xx) || defined(STM32F479xx) || defined(STM32F412Zx) || defined(STM32F412Vx) || defined(STM32F412Rx) || defined(STM32F412Cx) || defined(STM32F413xx) || defined(STM32F423xx) */
  293. /* Restart the Phy Clock */
  294. USBx_PCGCCTL = 0U;
  295. /* Device mode configuration */
  296. USBx_DEVICE->DCFG |= DCFG_FRAME_INTERVAL_80;
  297. if (cfg.phy_itface == USB_OTG_ULPI_PHY)
  298. {
  299. if (cfg.speed == USBD_HS_SPEED)
  300. {
  301. /* Set Core speed to High speed mode */
  302. (void)USB_SetDevSpeed(USBx, USB_OTG_SPEED_HIGH);
  303. }
  304. else
  305. {
  306. /* Set Core speed to Full speed mode */
  307. (void)USB_SetDevSpeed(USBx, USB_OTG_SPEED_HIGH_IN_FULL);
  308. }
  309. }
  310. else
  311. {
  312. /* Set Core speed to Full speed mode */
  313. (void)USB_SetDevSpeed(USBx, USB_OTG_SPEED_FULL);
  314. }
  315. /* Flush the FIFOs */
  316. if (USB_FlushTxFifo(USBx, 0x10U) != HAL_OK) /* all Tx FIFOs */
  317. {
  318. ret = HAL_ERROR;
  319. }
  320. if (USB_FlushRxFifo(USBx) != HAL_OK)
  321. {
  322. ret = HAL_ERROR;
  323. }
  324. /* Clear all pending Device Interrupts */
  325. USBx_DEVICE->DIEPMSK = 0U;
  326. USBx_DEVICE->DOEPMSK = 0U;
  327. USBx_DEVICE->DAINTMSK = 0U;
  328. for (i = 0U; i < cfg.dev_endpoints; i++)
  329. {
  330. if ((USBx_INEP(i)->DIEPCTL & USB_OTG_DIEPCTL_EPENA) == USB_OTG_DIEPCTL_EPENA)
  331. {
  332. if (i == 0U)
  333. {
  334. USBx_INEP(i)->DIEPCTL = USB_OTG_DIEPCTL_SNAK;
  335. }
  336. else
  337. {
  338. USBx_INEP(i)->DIEPCTL = USB_OTG_DIEPCTL_EPDIS | USB_OTG_DIEPCTL_SNAK;
  339. }
  340. }
  341. else
  342. {
  343. USBx_INEP(i)->DIEPCTL = 0U;
  344. }
  345. USBx_INEP(i)->DIEPTSIZ = 0U;
  346. USBx_INEP(i)->DIEPINT = 0xFB7FU;
  347. }
  348. for (i = 0U; i < cfg.dev_endpoints; i++)
  349. {
  350. if ((USBx_OUTEP(i)->DOEPCTL & USB_OTG_DOEPCTL_EPENA) == USB_OTG_DOEPCTL_EPENA)
  351. {
  352. if (i == 0U)
  353. {
  354. USBx_OUTEP(i)->DOEPCTL = USB_OTG_DOEPCTL_SNAK;
  355. }
  356. else
  357. {
  358. USBx_OUTEP(i)->DOEPCTL = USB_OTG_DOEPCTL_EPDIS | USB_OTG_DOEPCTL_SNAK;
  359. }
  360. }
  361. else
  362. {
  363. USBx_OUTEP(i)->DOEPCTL = 0U;
  364. }
  365. USBx_OUTEP(i)->DOEPTSIZ = 0U;
  366. USBx_OUTEP(i)->DOEPINT = 0xFB7FU;
  367. }
  368. USBx_DEVICE->DIEPMSK &= ~(USB_OTG_DIEPMSK_TXFURM);
  369. if (cfg.dma_enable == 1U)
  370. {
  371. /*Set threshold parameters */
  372. USBx_DEVICE->DTHRCTL = USB_OTG_DTHRCTL_TXTHRLEN_6 |
  373. USB_OTG_DTHRCTL_RXTHRLEN_6;
  374. USBx_DEVICE->DTHRCTL |= USB_OTG_DTHRCTL_RXTHREN |
  375. USB_OTG_DTHRCTL_ISOTHREN |
  376. USB_OTG_DTHRCTL_NONISOTHREN;
  377. }
  378. /* Disable all interrupts. */
  379. USBx->GINTMSK = 0U;
  380. /* Clear any pending interrupts */
  381. USBx->GINTSTS = 0xBFFFFFFFU;
  382. /* Enable the common interrupts */
  383. if (cfg.dma_enable == 0U)
  384. {
  385. USBx->GINTMSK |= USB_OTG_GINTMSK_RXFLVLM;
  386. }
  387. /* Enable interrupts matching to the Device mode ONLY */
  388. USBx->GINTMSK |= USB_OTG_GINTMSK_USBSUSPM | USB_OTG_GINTMSK_USBRST |
  389. USB_OTG_GINTMSK_ENUMDNEM | USB_OTG_GINTMSK_IEPINT |
  390. USB_OTG_GINTMSK_OEPINT | USB_OTG_GINTMSK_IISOIXFRM |
  391. USB_OTG_GINTMSK_PXFRM_IISOOXFRM | USB_OTG_GINTMSK_WUIM;
  392. if (cfg.Sof_enable != 0U)
  393. {
  394. USBx->GINTMSK |= USB_OTG_GINTMSK_SOFM;
  395. }
  396. if (cfg.vbus_sensing_enable == 1U)
  397. {
  398. USBx->GINTMSK |= (USB_OTG_GINTMSK_SRQIM | USB_OTG_GINTMSK_OTGINT);
  399. }
  400. return ret;
  401. }
  402. /**
  403. * @brief USB_OTG_FlushTxFifo : Flush a Tx FIFO
  404. * @param USBx Selected device
  405. * @param num FIFO number
  406. * This parameter can be a value from 1 to 15
  407. 15 means Flush all Tx FIFOs
  408. * @retval HAL status
  409. */
  410. HAL_StatusTypeDef USB_FlushTxFifo(USB_OTG_GlobalTypeDef *USBx, uint32_t num)
  411. {
  412. uint32_t count = 0U;
  413. USBx->GRSTCTL = (USB_OTG_GRSTCTL_TXFFLSH | (num << 6));
  414. do
  415. {
  416. if (++count > 200000U)
  417. {
  418. return HAL_TIMEOUT;
  419. }
  420. }
  421. while ((USBx->GRSTCTL & USB_OTG_GRSTCTL_TXFFLSH) == USB_OTG_GRSTCTL_TXFFLSH);
  422. return HAL_OK;
  423. }
  424. /**
  425. * @brief USB_FlushRxFifo : Flush Rx FIFO
  426. * @param USBx Selected device
  427. * @retval HAL status
  428. */
  429. HAL_StatusTypeDef USB_FlushRxFifo(USB_OTG_GlobalTypeDef *USBx)
  430. {
  431. uint32_t count = 0;
  432. USBx->GRSTCTL = USB_OTG_GRSTCTL_RXFFLSH;
  433. do
  434. {
  435. if (++count > 200000U)
  436. {
  437. return HAL_TIMEOUT;
  438. }
  439. }
  440. while ((USBx->GRSTCTL & USB_OTG_GRSTCTL_RXFFLSH) == USB_OTG_GRSTCTL_RXFFLSH);
  441. return HAL_OK;
  442. }
  443. /**
  444. * @brief USB_SetDevSpeed Initializes the DevSpd field of DCFG register
  445. * depending the PHY type and the enumeration speed of the device.
  446. * @param USBx Selected device
  447. * @param speed device speed
  448. * This parameter can be one of these values:
  449. * @arg USB_OTG_SPEED_HIGH: High speed mode
  450. * @arg USB_OTG_SPEED_HIGH_IN_FULL: High speed core in Full Speed mode
  451. * @arg USB_OTG_SPEED_FULL: Full speed mode
  452. * @retval Hal status
  453. */
  454. HAL_StatusTypeDef USB_SetDevSpeed(USB_OTG_GlobalTypeDef *USBx, uint8_t speed)
  455. {
  456. uint32_t USBx_BASE = (uint32_t)USBx;
  457. USBx_DEVICE->DCFG |= speed;
  458. return HAL_OK;
  459. }
  460. /**
  461. * @brief USB_GetDevSpeed Return the Dev Speed
  462. * @param USBx Selected device
  463. * @retval speed device speed
  464. * This parameter can be one of these values:
  465. * @arg PCD_SPEED_HIGH: High speed mode
  466. * @arg PCD_SPEED_FULL: Full speed mode
  467. */
  468. uint8_t USB_GetDevSpeed(USB_OTG_GlobalTypeDef *USBx)
  469. {
  470. uint32_t USBx_BASE = (uint32_t)USBx;
  471. uint8_t speed;
  472. uint32_t DevEnumSpeed = USBx_DEVICE->DSTS & USB_OTG_DSTS_ENUMSPD;
  473. if (DevEnumSpeed == DSTS_ENUMSPD_HS_PHY_30MHZ_OR_60MHZ)
  474. {
  475. speed = USBD_HS_SPEED;
  476. }
  477. else if ((DevEnumSpeed == DSTS_ENUMSPD_FS_PHY_30MHZ_OR_60MHZ) ||
  478. (DevEnumSpeed == DSTS_ENUMSPD_FS_PHY_48MHZ))
  479. {
  480. speed = USBD_FS_SPEED;
  481. }
  482. else
  483. {
  484. speed = 0xFU;
  485. }
  486. return speed;
  487. }
  488. /**
  489. * @brief Activate and configure an endpoint
  490. * @param USBx Selected device
  491. * @param ep pointer to endpoint structure
  492. * @retval HAL status
  493. */
  494. HAL_StatusTypeDef USB_ActivateEndpoint(USB_OTG_GlobalTypeDef *USBx, USB_OTG_EPTypeDef *ep)
  495. {
  496. uint32_t USBx_BASE = (uint32_t)USBx;
  497. uint32_t epnum = (uint32_t)ep->num;
  498. if (ep->is_in == 1U)
  499. {
  500. USBx_DEVICE->DAINTMSK |= USB_OTG_DAINTMSK_IEPM & (uint32_t)(1UL << (ep->num & EP_ADDR_MSK));
  501. if ((USBx_INEP(epnum)->DIEPCTL & USB_OTG_DIEPCTL_USBAEP) == 0U)
  502. {
  503. USBx_INEP(epnum)->DIEPCTL |= (ep->maxpacket & USB_OTG_DIEPCTL_MPSIZ) |
  504. ((uint32_t)ep->type << 18) | (epnum << 22) |
  505. USB_OTG_DIEPCTL_SD0PID_SEVNFRM |
  506. USB_OTG_DIEPCTL_USBAEP;
  507. }
  508. }
  509. else
  510. {
  511. USBx_DEVICE->DAINTMSK |= USB_OTG_DAINTMSK_OEPM & ((uint32_t)(1UL << (ep->num & EP_ADDR_MSK)) << 16);
  512. if (((USBx_OUTEP(epnum)->DOEPCTL) & USB_OTG_DOEPCTL_USBAEP) == 0U)
  513. {
  514. USBx_OUTEP(epnum)->DOEPCTL |= (ep->maxpacket & USB_OTG_DOEPCTL_MPSIZ) |
  515. ((uint32_t)ep->type << 18) |
  516. USB_OTG_DIEPCTL_SD0PID_SEVNFRM |
  517. USB_OTG_DOEPCTL_USBAEP;
  518. }
  519. }
  520. return HAL_OK;
  521. }
  522. /**
  523. * @brief Activate and configure a dedicated endpoint
  524. * @param USBx Selected device
  525. * @param ep pointer to endpoint structure
  526. * @retval HAL status
  527. */
  528. HAL_StatusTypeDef USB_ActivateDedicatedEndpoint(USB_OTG_GlobalTypeDef *USBx, USB_OTG_EPTypeDef *ep)
  529. {
  530. uint32_t USBx_BASE = (uint32_t)USBx;
  531. uint32_t epnum = (uint32_t)ep->num;
  532. /* Read DEPCTLn register */
  533. if (ep->is_in == 1U)
  534. {
  535. if (((USBx_INEP(epnum)->DIEPCTL) & USB_OTG_DIEPCTL_USBAEP) == 0U)
  536. {
  537. USBx_INEP(epnum)->DIEPCTL |= (ep->maxpacket & USB_OTG_DIEPCTL_MPSIZ) |
  538. ((uint32_t)ep->type << 18) | (epnum << 22) |
  539. USB_OTG_DIEPCTL_SD0PID_SEVNFRM |
  540. USB_OTG_DIEPCTL_USBAEP;
  541. }
  542. USBx_DEVICE->DEACHMSK |= USB_OTG_DAINTMSK_IEPM & (uint32_t)(1UL << (ep->num & EP_ADDR_MSK));
  543. }
  544. else
  545. {
  546. if (((USBx_OUTEP(epnum)->DOEPCTL) & USB_OTG_DOEPCTL_USBAEP) == 0U)
  547. {
  548. USBx_OUTEP(epnum)->DOEPCTL |= (ep->maxpacket & USB_OTG_DOEPCTL_MPSIZ) |
  549. ((uint32_t)ep->type << 18) | (epnum << 22) |
  550. USB_OTG_DOEPCTL_USBAEP;
  551. }
  552. USBx_DEVICE->DEACHMSK |= USB_OTG_DAINTMSK_OEPM & ((uint32_t)(1UL << (ep->num & EP_ADDR_MSK)) << 16);
  553. }
  554. return HAL_OK;
  555. }
  556. /**
  557. * @brief De-activate and de-initialize an endpoint
  558. * @param USBx Selected device
  559. * @param ep pointer to endpoint structure
  560. * @retval HAL status
  561. */
  562. HAL_StatusTypeDef USB_DeactivateEndpoint(USB_OTG_GlobalTypeDef *USBx, USB_OTG_EPTypeDef *ep)
  563. {
  564. uint32_t USBx_BASE = (uint32_t)USBx;
  565. uint32_t epnum = (uint32_t)ep->num;
  566. /* Read DEPCTLn register */
  567. if (ep->is_in == 1U)
  568. {
  569. USBx_DEVICE->DEACHMSK &= ~(USB_OTG_DAINTMSK_IEPM & (uint32_t)(1UL << (ep->num & EP_ADDR_MSK)));
  570. USBx_DEVICE->DAINTMSK &= ~(USB_OTG_DAINTMSK_IEPM & (uint32_t)(1UL << (ep->num & EP_ADDR_MSK)));
  571. USBx_INEP(epnum)->DIEPCTL &= ~(USB_OTG_DIEPCTL_USBAEP |
  572. USB_OTG_DIEPCTL_MPSIZ |
  573. USB_OTG_DIEPCTL_TXFNUM |
  574. USB_OTG_DIEPCTL_SD0PID_SEVNFRM |
  575. USB_OTG_DIEPCTL_EPTYP);
  576. }
  577. else
  578. {
  579. USBx_DEVICE->DEACHMSK &= ~(USB_OTG_DAINTMSK_OEPM & ((uint32_t)(1UL << (ep->num & EP_ADDR_MSK)) << 16));
  580. USBx_DEVICE->DAINTMSK &= ~(USB_OTG_DAINTMSK_OEPM & ((uint32_t)(1UL << (ep->num & EP_ADDR_MSK)) << 16));
  581. USBx_OUTEP(epnum)->DOEPCTL &= ~(USB_OTG_DOEPCTL_USBAEP |
  582. USB_OTG_DOEPCTL_MPSIZ |
  583. USB_OTG_DOEPCTL_SD0PID_SEVNFRM |
  584. USB_OTG_DOEPCTL_EPTYP);
  585. }
  586. return HAL_OK;
  587. }
  588. /**
  589. * @brief De-activate and de-initialize a dedicated endpoint
  590. * @param USBx Selected device
  591. * @param ep pointer to endpoint structure
  592. * @retval HAL status
  593. */
  594. HAL_StatusTypeDef USB_DeactivateDedicatedEndpoint(USB_OTG_GlobalTypeDef *USBx, USB_OTG_EPTypeDef *ep)
  595. {
  596. uint32_t USBx_BASE = (uint32_t)USBx;
  597. uint32_t epnum = (uint32_t)ep->num;
  598. /* Read DEPCTLn register */
  599. if (ep->is_in == 1U)
  600. {
  601. USBx_INEP(epnum)->DIEPCTL &= ~ USB_OTG_DIEPCTL_USBAEP;
  602. USBx_DEVICE->DAINTMSK &= ~(USB_OTG_DAINTMSK_IEPM & (uint32_t)(1UL << (ep->num & EP_ADDR_MSK)));
  603. }
  604. else
  605. {
  606. USBx_OUTEP(epnum)->DOEPCTL &= ~USB_OTG_DOEPCTL_USBAEP;
  607. USBx_DEVICE->DAINTMSK &= ~(USB_OTG_DAINTMSK_OEPM & ((uint32_t)(1UL << (ep->num & EP_ADDR_MSK)) << 16));
  608. }
  609. return HAL_OK;
  610. }
  611. /**
  612. * @brief USB_EPStartXfer : setup and starts a transfer over an EP
  613. * @param USBx Selected device
  614. * @param ep pointer to endpoint structure
  615. * @param dma USB dma enabled or disabled
  616. * This parameter can be one of these values:
  617. * 0 : DMA feature not used
  618. * 1 : DMA feature used
  619. * @retval HAL status
  620. */
  621. HAL_StatusTypeDef USB_EPStartXfer(USB_OTG_GlobalTypeDef *USBx, USB_OTG_EPTypeDef *ep, uint8_t dma)
  622. {
  623. uint32_t USBx_BASE = (uint32_t)USBx;
  624. uint32_t epnum = (uint32_t)ep->num;
  625. uint16_t pktcnt;
  626. /* IN endpoint */
  627. if (ep->is_in == 1U)
  628. {
  629. /* Zero Length Packet? */
  630. if (ep->xfer_len == 0U)
  631. {
  632. USBx_INEP(epnum)->DIEPTSIZ &= ~(USB_OTG_DIEPTSIZ_PKTCNT);
  633. USBx_INEP(epnum)->DIEPTSIZ |= (USB_OTG_DIEPTSIZ_PKTCNT & (1U << 19));
  634. USBx_INEP(epnum)->DIEPTSIZ &= ~(USB_OTG_DIEPTSIZ_XFRSIZ);
  635. }
  636. else
  637. {
  638. /* Program the transfer size and packet count
  639. * as follows: xfersize = N * maxpacket +
  640. * short_packet pktcnt = N + (short_packet
  641. * exist ? 1 : 0)
  642. */
  643. USBx_INEP(epnum)->DIEPTSIZ &= ~(USB_OTG_DIEPTSIZ_XFRSIZ);
  644. USBx_INEP(epnum)->DIEPTSIZ &= ~(USB_OTG_DIEPTSIZ_PKTCNT);
  645. USBx_INEP(epnum)->DIEPTSIZ |= (USB_OTG_DIEPTSIZ_PKTCNT & (((ep->xfer_len + ep->maxpacket - 1U) / ep->maxpacket) << 19));
  646. USBx_INEP(epnum)->DIEPTSIZ |= (USB_OTG_DIEPTSIZ_XFRSIZ & ep->xfer_len);
  647. if (ep->type == EP_TYPE_ISOC)
  648. {
  649. USBx_INEP(epnum)->DIEPTSIZ &= ~(USB_OTG_DIEPTSIZ_MULCNT);
  650. USBx_INEP(epnum)->DIEPTSIZ |= (USB_OTG_DIEPTSIZ_MULCNT & (1U << 29));
  651. }
  652. }
  653. if (dma == 1U)
  654. {
  655. if ((uint32_t)ep->dma_addr != 0U)
  656. {
  657. USBx_INEP(epnum)->DIEPDMA = (uint32_t)(ep->dma_addr);
  658. }
  659. if (ep->type == EP_TYPE_ISOC)
  660. {
  661. if ((USBx_DEVICE->DSTS & (1U << 8)) == 0U)
  662. {
  663. USBx_INEP(epnum)->DIEPCTL |= USB_OTG_DIEPCTL_SODDFRM;
  664. }
  665. else
  666. {
  667. USBx_INEP(epnum)->DIEPCTL |= USB_OTG_DIEPCTL_SD0PID_SEVNFRM;
  668. }
  669. }
  670. /* EP enable, IN data in FIFO */
  671. USBx_INEP(epnum)->DIEPCTL |= (USB_OTG_DIEPCTL_CNAK | USB_OTG_DIEPCTL_EPENA);
  672. }
  673. else
  674. {
  675. /* EP enable, IN data in FIFO */
  676. USBx_INEP(epnum)->DIEPCTL |= (USB_OTG_DIEPCTL_CNAK | USB_OTG_DIEPCTL_EPENA);
  677. if (ep->type != EP_TYPE_ISOC)
  678. {
  679. /* Enable the Tx FIFO Empty Interrupt for this EP */
  680. if (ep->xfer_len > 0U)
  681. {
  682. USBx_DEVICE->DIEPEMPMSK |= 1UL << (ep->num & EP_ADDR_MSK);
  683. }
  684. }
  685. else
  686. {
  687. if ((USBx_DEVICE->DSTS & (1U << 8)) == 0U)
  688. {
  689. USBx_INEP(epnum)->DIEPCTL |= USB_OTG_DIEPCTL_SODDFRM;
  690. }
  691. else
  692. {
  693. USBx_INEP(epnum)->DIEPCTL |= USB_OTG_DIEPCTL_SD0PID_SEVNFRM;
  694. }
  695. (void)USB_WritePacket(USBx, ep->xfer_buff, ep->num, (uint16_t)ep->xfer_len, dma);
  696. }
  697. }
  698. }
  699. else /* OUT endpoint */
  700. {
  701. /* Program the transfer size and packet count as follows:
  702. * pktcnt = N
  703. * xfersize = N * maxpacket
  704. */
  705. USBx_OUTEP(epnum)->DOEPTSIZ &= ~(USB_OTG_DOEPTSIZ_XFRSIZ);
  706. USBx_OUTEP(epnum)->DOEPTSIZ &= ~(USB_OTG_DOEPTSIZ_PKTCNT);
  707. if (ep->xfer_len == 0U)
  708. {
  709. USBx_OUTEP(epnum)->DOEPTSIZ |= (USB_OTG_DOEPTSIZ_XFRSIZ & ep->maxpacket);
  710. USBx_OUTEP(epnum)->DOEPTSIZ |= (USB_OTG_DOEPTSIZ_PKTCNT & (1U << 19));
  711. }
  712. else
  713. {
  714. pktcnt = (uint16_t)((ep->xfer_len + ep->maxpacket - 1U) / ep->maxpacket);
  715. USBx_OUTEP(epnum)->DOEPTSIZ |= USB_OTG_DOEPTSIZ_PKTCNT & ((uint32_t)pktcnt << 19);
  716. USBx_OUTEP(epnum)->DOEPTSIZ |= USB_OTG_DOEPTSIZ_XFRSIZ & (ep->maxpacket * pktcnt);
  717. }
  718. if (dma == 1U)
  719. {
  720. if ((uint32_t)ep->xfer_buff != 0U)
  721. {
  722. USBx_OUTEP(epnum)->DOEPDMA = (uint32_t)(ep->xfer_buff);
  723. }
  724. }
  725. if (ep->type == EP_TYPE_ISOC)
  726. {
  727. if ((USBx_DEVICE->DSTS & (1U << 8)) == 0U)
  728. {
  729. USBx_OUTEP(epnum)->DOEPCTL |= USB_OTG_DOEPCTL_SODDFRM;
  730. }
  731. else
  732. {
  733. USBx_OUTEP(epnum)->DOEPCTL |= USB_OTG_DOEPCTL_SD0PID_SEVNFRM;
  734. }
  735. }
  736. /* EP enable */
  737. USBx_OUTEP(epnum)->DOEPCTL |= (USB_OTG_DOEPCTL_CNAK | USB_OTG_DOEPCTL_EPENA);
  738. }
  739. return HAL_OK;
  740. }
  741. /**
  742. * @brief USB_EP0StartXfer : setup and starts a transfer over the EP 0
  743. * @param USBx Selected device
  744. * @param ep pointer to endpoint structure
  745. * @param dma USB dma enabled or disabled
  746. * This parameter can be one of these values:
  747. * 0 : DMA feature not used
  748. * 1 : DMA feature used
  749. * @retval HAL status
  750. */
  751. HAL_StatusTypeDef USB_EP0StartXfer(USB_OTG_GlobalTypeDef *USBx, USB_OTG_EPTypeDef *ep, uint8_t dma)
  752. {
  753. uint32_t USBx_BASE = (uint32_t)USBx;
  754. uint32_t epnum = (uint32_t)ep->num;
  755. /* IN endpoint */
  756. if (ep->is_in == 1U)
  757. {
  758. /* Zero Length Packet? */
  759. if (ep->xfer_len == 0U)
  760. {
  761. USBx_INEP(epnum)->DIEPTSIZ &= ~(USB_OTG_DIEPTSIZ_PKTCNT);
  762. USBx_INEP(epnum)->DIEPTSIZ |= (USB_OTG_DIEPTSIZ_PKTCNT & (1U << 19));
  763. USBx_INEP(epnum)->DIEPTSIZ &= ~(USB_OTG_DIEPTSIZ_XFRSIZ);
  764. }
  765. else
  766. {
  767. /* Program the transfer size and packet count
  768. * as follows: xfersize = N * maxpacket +
  769. * short_packet pktcnt = N + (short_packet
  770. * exist ? 1 : 0)
  771. */
  772. USBx_INEP(epnum)->DIEPTSIZ &= ~(USB_OTG_DIEPTSIZ_XFRSIZ);
  773. USBx_INEP(epnum)->DIEPTSIZ &= ~(USB_OTG_DIEPTSIZ_PKTCNT);
  774. if (ep->xfer_len > ep->maxpacket)
  775. {
  776. ep->xfer_len = ep->maxpacket;
  777. }
  778. USBx_INEP(epnum)->DIEPTSIZ |= (USB_OTG_DIEPTSIZ_PKTCNT & (1U << 19));
  779. USBx_INEP(epnum)->DIEPTSIZ |= (USB_OTG_DIEPTSIZ_XFRSIZ & ep->xfer_len);
  780. }
  781. if (dma == 1U)
  782. {
  783. if ((uint32_t)ep->dma_addr != 0U)
  784. {
  785. USBx_INEP(epnum)->DIEPDMA = (uint32_t)(ep->dma_addr);
  786. }
  787. /* EP enable, IN data in FIFO */
  788. USBx_INEP(epnum)->DIEPCTL |= (USB_OTG_DIEPCTL_CNAK | USB_OTG_DIEPCTL_EPENA);
  789. }
  790. else
  791. {
  792. /* EP enable, IN data in FIFO */
  793. USBx_INEP(epnum)->DIEPCTL |= (USB_OTG_DIEPCTL_CNAK | USB_OTG_DIEPCTL_EPENA);
  794. /* Enable the Tx FIFO Empty Interrupt for this EP */
  795. if (ep->xfer_len > 0U)
  796. {
  797. USBx_DEVICE->DIEPEMPMSK |= 1UL << (ep->num & EP_ADDR_MSK);
  798. }
  799. }
  800. }
  801. else /* OUT endpoint */
  802. {
  803. /* Program the transfer size and packet count as follows:
  804. * pktcnt = N
  805. * xfersize = N * maxpacket
  806. */
  807. USBx_OUTEP(epnum)->DOEPTSIZ &= ~(USB_OTG_DOEPTSIZ_XFRSIZ);
  808. USBx_OUTEP(epnum)->DOEPTSIZ &= ~(USB_OTG_DOEPTSIZ_PKTCNT);
  809. if (ep->xfer_len > 0U)
  810. {
  811. ep->xfer_len = ep->maxpacket;
  812. }
  813. USBx_OUTEP(epnum)->DOEPTSIZ |= (USB_OTG_DOEPTSIZ_PKTCNT & (1U << 19));
  814. USBx_OUTEP(epnum)->DOEPTSIZ |= (USB_OTG_DOEPTSIZ_XFRSIZ & (ep->maxpacket));
  815. if (dma == 1U)
  816. {
  817. if ((uint32_t)ep->xfer_buff != 0U)
  818. {
  819. USBx_OUTEP(epnum)->DOEPDMA = (uint32_t)(ep->xfer_buff);
  820. }
  821. }
  822. /* EP enable */
  823. USBx_OUTEP(epnum)->DOEPCTL |= (USB_OTG_DOEPCTL_CNAK | USB_OTG_DOEPCTL_EPENA);
  824. }
  825. return HAL_OK;
  826. }
  827. /**
  828. * @brief USB_WritePacket : Writes a packet into the Tx FIFO associated
  829. * with the EP/channel
  830. * @param USBx Selected device
  831. * @param src pointer to source buffer
  832. * @param ch_ep_num endpoint or host channel number
  833. * @param len Number of bytes to write
  834. * @param dma USB dma enabled or disabled
  835. * This parameter can be one of these values:
  836. * 0 : DMA feature not used
  837. * 1 : DMA feature used
  838. * @retval HAL status
  839. */
  840. HAL_StatusTypeDef USB_WritePacket(USB_OTG_GlobalTypeDef *USBx, uint8_t *src, uint8_t ch_ep_num, uint16_t len, uint8_t dma)
  841. {
  842. uint32_t USBx_BASE = (uint32_t)USBx;
  843. uint32_t *pSrc = (uint32_t *)src;
  844. uint32_t count32b, i;
  845. if (dma == 0U)
  846. {
  847. count32b = ((uint32_t)len + 3U) / 4U;
  848. for (i = 0U; i < count32b; i++)
  849. {
  850. USBx_DFIFO((uint32_t)ch_ep_num) = __UNALIGNED_UINT32_READ(pSrc);
  851. pSrc++;
  852. }
  853. }
  854. return HAL_OK;
  855. }
  856. /**
  857. * @brief USB_ReadPacket : read a packet from the RX FIFO
  858. * @param USBx Selected device
  859. * @param dest source pointer
  860. * @param len Number of bytes to read
  861. * @retval pointer to destination buffer
  862. */
  863. void *USB_ReadPacket(USB_OTG_GlobalTypeDef *USBx, uint8_t *dest, uint16_t len)
  864. {
  865. uint32_t USBx_BASE = (uint32_t)USBx;
  866. uint32_t *pDest = (uint32_t *)dest;
  867. uint32_t i;
  868. uint32_t count32b = ((uint32_t)len + 3U) / 4U;
  869. for (i = 0U; i < count32b; i++)
  870. {
  871. __UNALIGNED_UINT32_WRITE(pDest, USBx_DFIFO(0U));
  872. pDest++;
  873. }
  874. return ((void *)pDest);
  875. }
  876. /**
  877. * @brief USB_EPSetStall : set a stall condition over an EP
  878. * @param USBx Selected device
  879. * @param ep pointer to endpoint structure
  880. * @retval HAL status
  881. */
  882. HAL_StatusTypeDef USB_EPSetStall(USB_OTG_GlobalTypeDef *USBx, USB_OTG_EPTypeDef *ep)
  883. {
  884. uint32_t USBx_BASE = (uint32_t)USBx;
  885. uint32_t epnum = (uint32_t)ep->num;
  886. if (ep->is_in == 1U)
  887. {
  888. if (((USBx_INEP(epnum)->DIEPCTL & USB_OTG_DIEPCTL_EPENA) == 0U) && (epnum != 0U))
  889. {
  890. USBx_INEP(epnum)->DIEPCTL &= ~(USB_OTG_DIEPCTL_EPDIS);
  891. }
  892. USBx_INEP(epnum)->DIEPCTL |= USB_OTG_DIEPCTL_STALL;
  893. }
  894. else
  895. {
  896. if (((USBx_OUTEP(epnum)->DOEPCTL & USB_OTG_DOEPCTL_EPENA) == 0U) && (epnum != 0U))
  897. {
  898. USBx_OUTEP(epnum)->DOEPCTL &= ~(USB_OTG_DOEPCTL_EPDIS);
  899. }
  900. USBx_OUTEP(epnum)->DOEPCTL |= USB_OTG_DOEPCTL_STALL;
  901. }
  902. return HAL_OK;
  903. }
  904. /**
  905. * @brief USB_EPClearStall : Clear a stall condition over an EP
  906. * @param USBx Selected device
  907. * @param ep pointer to endpoint structure
  908. * @retval HAL status
  909. */
  910. HAL_StatusTypeDef USB_EPClearStall(USB_OTG_GlobalTypeDef *USBx, USB_OTG_EPTypeDef *ep)
  911. {
  912. uint32_t USBx_BASE = (uint32_t)USBx;
  913. uint32_t epnum = (uint32_t)ep->num;
  914. if (ep->is_in == 1U)
  915. {
  916. USBx_INEP(epnum)->DIEPCTL &= ~USB_OTG_DIEPCTL_STALL;
  917. if ((ep->type == EP_TYPE_INTR) || (ep->type == EP_TYPE_BULK))
  918. {
  919. USBx_INEP(epnum)->DIEPCTL |= USB_OTG_DIEPCTL_SD0PID_SEVNFRM; /* DATA0 */
  920. }
  921. }
  922. else
  923. {
  924. USBx_OUTEP(epnum)->DOEPCTL &= ~USB_OTG_DOEPCTL_STALL;
  925. if ((ep->type == EP_TYPE_INTR) || (ep->type == EP_TYPE_BULK))
  926. {
  927. USBx_OUTEP(epnum)->DOEPCTL |= USB_OTG_DOEPCTL_SD0PID_SEVNFRM; /* DATA0 */
  928. }
  929. }
  930. return HAL_OK;
  931. }
  932. /**
  933. * @brief USB_StopDevice : Stop the usb device mode
  934. * @param USBx Selected device
  935. * @retval HAL status
  936. */
  937. HAL_StatusTypeDef USB_StopDevice(USB_OTG_GlobalTypeDef *USBx)
  938. {
  939. HAL_StatusTypeDef ret;
  940. uint32_t USBx_BASE = (uint32_t)USBx;
  941. uint32_t i;
  942. /* Clear Pending interrupt */
  943. for (i = 0U; i < 15U; i++)
  944. {
  945. USBx_INEP(i)->DIEPINT = 0xFB7FU;
  946. USBx_OUTEP(i)->DOEPINT = 0xFB7FU;
  947. }
  948. /* Clear interrupt masks */
  949. USBx_DEVICE->DIEPMSK = 0U;
  950. USBx_DEVICE->DOEPMSK = 0U;
  951. USBx_DEVICE->DAINTMSK = 0U;
  952. /* Flush the FIFO */
  953. ret = USB_FlushRxFifo(USBx);
  954. if (ret != HAL_OK)
  955. {
  956. return ret;
  957. }
  958. ret = USB_FlushTxFifo(USBx, 0x10U);
  959. if (ret != HAL_OK)
  960. {
  961. return ret;
  962. }
  963. return ret;
  964. }
  965. /**
  966. * @brief USB_SetDevAddress : Stop the usb device mode
  967. * @param USBx Selected device
  968. * @param address new device address to be assigned
  969. * This parameter can be a value from 0 to 255
  970. * @retval HAL status
  971. */
  972. HAL_StatusTypeDef USB_SetDevAddress(USB_OTG_GlobalTypeDef *USBx, uint8_t address)
  973. {
  974. uint32_t USBx_BASE = (uint32_t)USBx;
  975. USBx_DEVICE->DCFG &= ~(USB_OTG_DCFG_DAD);
  976. USBx_DEVICE->DCFG |= ((uint32_t)address << 4) & USB_OTG_DCFG_DAD;
  977. return HAL_OK;
  978. }
  979. /**
  980. * @brief USB_DevConnect : Connect the USB device by enabling the pull-up/pull-down
  981. * @param USBx Selected device
  982. * @retval HAL status
  983. */
  984. HAL_StatusTypeDef USB_DevConnect(USB_OTG_GlobalTypeDef *USBx)
  985. {
  986. uint32_t USBx_BASE = (uint32_t)USBx;
  987. USBx_DEVICE->DCTL &= ~USB_OTG_DCTL_SDIS;
  988. HAL_Delay(3U);
  989. return HAL_OK;
  990. }
  991. /**
  992. * @brief USB_DevDisconnect : Disconnect the USB device by disabling the pull-up/pull-down
  993. * @param USBx Selected device
  994. * @retval HAL status
  995. */
  996. HAL_StatusTypeDef USB_DevDisconnect(USB_OTG_GlobalTypeDef *USBx)
  997. {
  998. uint32_t USBx_BASE = (uint32_t)USBx;
  999. USBx_DEVICE->DCTL |= USB_OTG_DCTL_SDIS;
  1000. HAL_Delay(3U);
  1001. return HAL_OK;
  1002. }
  1003. /**
  1004. * @brief USB_ReadInterrupts: return the global USB interrupt status
  1005. * @param USBx Selected device
  1006. * @retval HAL status
  1007. */
  1008. uint32_t USB_ReadInterrupts(USB_OTG_GlobalTypeDef *USBx)
  1009. {
  1010. uint32_t tmpreg;
  1011. tmpreg = USBx->GINTSTS;
  1012. tmpreg &= USBx->GINTMSK;
  1013. return tmpreg;
  1014. }
  1015. /**
  1016. * @brief USB_ReadDevAllOutEpInterrupt: return the USB device OUT endpoints interrupt status
  1017. * @param USBx Selected device
  1018. * @retval HAL status
  1019. */
  1020. uint32_t USB_ReadDevAllOutEpInterrupt(USB_OTG_GlobalTypeDef *USBx)
  1021. {
  1022. uint32_t USBx_BASE = (uint32_t)USBx;
  1023. uint32_t tmpreg;
  1024. tmpreg = USBx_DEVICE->DAINT;
  1025. tmpreg &= USBx_DEVICE->DAINTMSK;
  1026. return ((tmpreg & 0xffff0000U) >> 16);
  1027. }
  1028. /**
  1029. * @brief USB_ReadDevAllInEpInterrupt: return the USB device IN endpoints interrupt status
  1030. * @param USBx Selected device
  1031. * @retval HAL status
  1032. */
  1033. uint32_t USB_ReadDevAllInEpInterrupt(USB_OTG_GlobalTypeDef *USBx)
  1034. {
  1035. uint32_t USBx_BASE = (uint32_t)USBx;
  1036. uint32_t tmpreg;
  1037. tmpreg = USBx_DEVICE->DAINT;
  1038. tmpreg &= USBx_DEVICE->DAINTMSK;
  1039. return ((tmpreg & 0xFFFFU));
  1040. }
  1041. /**
  1042. * @brief Returns Device OUT EP Interrupt register
  1043. * @param USBx Selected device
  1044. * @param epnum endpoint number
  1045. * This parameter can be a value from 0 to 15
  1046. * @retval Device OUT EP Interrupt register
  1047. */
  1048. uint32_t USB_ReadDevOutEPInterrupt(USB_OTG_GlobalTypeDef *USBx, uint8_t epnum)
  1049. {
  1050. uint32_t USBx_BASE = (uint32_t)USBx;
  1051. uint32_t tmpreg;
  1052. tmpreg = USBx_OUTEP((uint32_t)epnum)->DOEPINT;
  1053. tmpreg &= USBx_DEVICE->DOEPMSK;
  1054. return tmpreg;
  1055. }
  1056. /**
  1057. * @brief Returns Device IN EP Interrupt register
  1058. * @param USBx Selected device
  1059. * @param epnum endpoint number
  1060. * This parameter can be a value from 0 to 15
  1061. * @retval Device IN EP Interrupt register
  1062. */
  1063. uint32_t USB_ReadDevInEPInterrupt(USB_OTG_GlobalTypeDef *USBx, uint8_t epnum)
  1064. {
  1065. uint32_t USBx_BASE = (uint32_t)USBx;
  1066. uint32_t tmpreg, msk, emp;
  1067. msk = USBx_DEVICE->DIEPMSK;
  1068. emp = USBx_DEVICE->DIEPEMPMSK;
  1069. msk |= ((emp >> (epnum & EP_ADDR_MSK)) & 0x1U) << 7;
  1070. tmpreg = USBx_INEP((uint32_t)epnum)->DIEPINT & msk;
  1071. return tmpreg;
  1072. }
  1073. /**
  1074. * @brief USB_ClearInterrupts: clear a USB interrupt
  1075. * @param USBx Selected device
  1076. * @param interrupt interrupt flag
  1077. * @retval None
  1078. */
  1079. void USB_ClearInterrupts(USB_OTG_GlobalTypeDef *USBx, uint32_t interrupt)
  1080. {
  1081. USBx->GINTSTS |= interrupt;
  1082. }
  1083. /**
  1084. * @brief Returns USB core mode
  1085. * @param USBx Selected device
  1086. * @retval return core mode : Host or Device
  1087. * This parameter can be one of these values:
  1088. * 0 : Host
  1089. * 1 : Device
  1090. */
  1091. uint32_t USB_GetMode(USB_OTG_GlobalTypeDef *USBx)
  1092. {
  1093. return ((USBx->GINTSTS) & 0x1U);
  1094. }
  1095. /**
  1096. * @brief Activate EP0 for Setup transactions
  1097. * @param USBx Selected device
  1098. * @retval HAL status
  1099. */
  1100. HAL_StatusTypeDef USB_ActivateSetup(USB_OTG_GlobalTypeDef *USBx)
  1101. {
  1102. uint32_t USBx_BASE = (uint32_t)USBx;
  1103. /* Set the MPS of the IN EP based on the enumeration speed */
  1104. USBx_INEP(0U)->DIEPCTL &= ~USB_OTG_DIEPCTL_MPSIZ;
  1105. if ((USBx_DEVICE->DSTS & USB_OTG_DSTS_ENUMSPD) == DSTS_ENUMSPD_LS_PHY_6MHZ)
  1106. {
  1107. USBx_INEP(0U)->DIEPCTL |= 3U;
  1108. }
  1109. USBx_DEVICE->DCTL |= USB_OTG_DCTL_CGINAK;
  1110. return HAL_OK;
  1111. }
  1112. /**
  1113. * @brief Prepare the EP0 to start the first control setup
  1114. * @param USBx Selected device
  1115. * @param dma USB dma enabled or disabled
  1116. * This parameter can be one of these values:
  1117. * 0 : DMA feature not used
  1118. * 1 : DMA feature used
  1119. * @param psetup pointer to setup packet
  1120. * @retval HAL status
  1121. */
  1122. HAL_StatusTypeDef USB_EP0_OutStart(USB_OTG_GlobalTypeDef *USBx, uint8_t dma, uint8_t *psetup)
  1123. {
  1124. uint32_t USBx_BASE = (uint32_t)USBx;
  1125. uint32_t gSNPSiD = *(__IO uint32_t *)(&USBx->CID + 0x1U);
  1126. if (gSNPSiD > USB_OTG_CORE_ID_300A)
  1127. {
  1128. if ((USBx_OUTEP(0U)->DOEPCTL & USB_OTG_DOEPCTL_EPENA) == USB_OTG_DOEPCTL_EPENA)
  1129. {
  1130. return HAL_OK;
  1131. }
  1132. }
  1133. USBx_OUTEP(0U)->DOEPTSIZ = 0U;
  1134. USBx_OUTEP(0U)->DOEPTSIZ |= (USB_OTG_DOEPTSIZ_PKTCNT & (1U << 19));
  1135. USBx_OUTEP(0U)->DOEPTSIZ |= (3U * 8U);
  1136. USBx_OUTEP(0U)->DOEPTSIZ |= USB_OTG_DOEPTSIZ_STUPCNT;
  1137. if (dma == 1U)
  1138. {
  1139. USBx_OUTEP(0U)->DOEPDMA = (uint32_t)psetup;
  1140. /* EP enable */
  1141. USBx_OUTEP(0U)->DOEPCTL |= USB_OTG_DOEPCTL_EPENA | USB_OTG_DOEPCTL_USBAEP;
  1142. }
  1143. return HAL_OK;
  1144. }
  1145. /**
  1146. * @brief Reset the USB Core (needed after USB clock settings change)
  1147. * @param USBx Selected device
  1148. * @retval HAL status
  1149. */
  1150. static HAL_StatusTypeDef USB_CoreReset(USB_OTG_GlobalTypeDef *USBx)
  1151. {
  1152. uint32_t count = 0U;
  1153. /* Wait for AHB master IDLE state. */
  1154. do
  1155. {
  1156. if (++count > 200000U)
  1157. {
  1158. return HAL_TIMEOUT;
  1159. }
  1160. }
  1161. while ((USBx->GRSTCTL & USB_OTG_GRSTCTL_AHBIDL) == 0U);
  1162. /* Core Soft Reset */
  1163. count = 0U;
  1164. USBx->GRSTCTL |= USB_OTG_GRSTCTL_CSRST;
  1165. do
  1166. {
  1167. if (++count > 200000U)
  1168. {
  1169. return HAL_TIMEOUT;
  1170. }
  1171. }
  1172. while ((USBx->GRSTCTL & USB_OTG_GRSTCTL_CSRST) == USB_OTG_GRSTCTL_CSRST);
  1173. return HAL_OK;
  1174. }
  1175. /**
  1176. * @brief USB_HostInit : Initializes the USB OTG controller registers
  1177. * for Host mode
  1178. * @param USBx Selected device
  1179. * @param cfg pointer to a USB_OTG_CfgTypeDef structure that contains
  1180. * the configuration information for the specified USBx peripheral.
  1181. * @retval HAL status
  1182. */
  1183. HAL_StatusTypeDef USB_HostInit(USB_OTG_GlobalTypeDef *USBx, USB_OTG_CfgTypeDef cfg)
  1184. {
  1185. uint32_t USBx_BASE = (uint32_t)USBx;
  1186. uint32_t i;
  1187. /* Restart the Phy Clock */
  1188. USBx_PCGCCTL = 0U;
  1189. #if defined(STM32F446xx) || defined(STM32F469xx) || defined(STM32F479xx) || defined(STM32F412Zx) || defined(STM32F412Vx) || defined(STM32F412Rx) || defined(STM32F412Cx) || defined(STM32F413xx) || defined(STM32F423xx)
  1190. /* Disable HW VBUS sensing */
  1191. USBx->GCCFG &= ~(USB_OTG_GCCFG_VBDEN);
  1192. #else
  1193. /*
  1194. * Disable HW VBUS sensing. VBUS is internally considered to be always
  1195. * at VBUS-Valid level (5V).
  1196. */
  1197. USBx->GCCFG |= USB_OTG_GCCFG_NOVBUSSENS;
  1198. USBx->GCCFG &= ~USB_OTG_GCCFG_VBUSBSEN;
  1199. USBx->GCCFG &= ~USB_OTG_GCCFG_VBUSASEN;
  1200. #endif /* defined(STM32F446xx) || defined(STM32F469xx) || defined(STM32F479xx) || defined(STM32F412Zx) || defined(STM32F412Vx) || defined(STM32F412Rx) || defined(STM32F412Cx) || defined(STM32F413xx) || defined(STM32F423xx) */
  1201. #if defined(STM32F412Zx) || defined(STM32F412Vx) || defined(STM32F412Rx) || defined(STM32F412Cx) || defined(STM32F413xx) || defined(STM32F423xx)
  1202. /* Disable Battery chargin detector */
  1203. USBx->GCCFG &= ~(USB_OTG_GCCFG_BCDEN);
  1204. #endif /* defined(STM32F412Zx) || defined(STM32F412Vx) || defined(STM32F412Rx) || defined(STM32F412Cx) || defined(STM32F413xx) || defined(STM32F423xx) */
  1205. if ((USBx->CID & (0x1U << 8)) != 0U)
  1206. {
  1207. if (cfg.speed == USB_OTG_SPEED_FULL)
  1208. {
  1209. /* Force Device Enumeration to FS/LS mode only */
  1210. USBx_HOST->HCFG |= USB_OTG_HCFG_FSLSS;
  1211. }
  1212. else
  1213. {
  1214. /* Set default Max speed support */
  1215. USBx_HOST->HCFG &= ~(USB_OTG_HCFG_FSLSS);
  1216. }
  1217. }
  1218. else
  1219. {
  1220. /* Set default Max speed support */
  1221. USBx_HOST->HCFG &= ~(USB_OTG_HCFG_FSLSS);
  1222. }
  1223. /* Make sure the FIFOs are flushed. */
  1224. (void)USB_FlushTxFifo(USBx, 0x10U); /* all Tx FIFOs */
  1225. (void)USB_FlushRxFifo(USBx);
  1226. /* Clear all pending HC Interrupts */
  1227. for (i = 0U; i < cfg.Host_channels; i++)
  1228. {
  1229. USBx_HC(i)->HCINT = 0xFFFFFFFFU;
  1230. USBx_HC(i)->HCINTMSK = 0U;
  1231. }
  1232. /* Enable VBUS driving */
  1233. (void)USB_DriveVbus(USBx, 1U);
  1234. HAL_Delay(200U);
  1235. /* Disable all interrupts. */
  1236. USBx->GINTMSK = 0U;
  1237. /* Clear any pending interrupts */
  1238. USBx->GINTSTS = 0xFFFFFFFFU;
  1239. if ((USBx->CID & (0x1U << 8)) != 0U)
  1240. {
  1241. /* set Rx FIFO size */
  1242. USBx->GRXFSIZ = 0x200U;
  1243. USBx->DIEPTXF0_HNPTXFSIZ = (uint32_t)(((0x100U << 16) & USB_OTG_NPTXFD) | 0x200U);
  1244. USBx->HPTXFSIZ = (uint32_t)(((0xE0U << 16) & USB_OTG_HPTXFSIZ_PTXFD) | 0x300U);
  1245. }
  1246. else
  1247. {
  1248. /* set Rx FIFO size */
  1249. USBx->GRXFSIZ = 0x80U;
  1250. USBx->DIEPTXF0_HNPTXFSIZ = (uint32_t)(((0x60U << 16) & USB_OTG_NPTXFD) | 0x80U);
  1251. USBx->HPTXFSIZ = (uint32_t)(((0x40U << 16)& USB_OTG_HPTXFSIZ_PTXFD) | 0xE0U);
  1252. }
  1253. /* Enable the common interrupts */
  1254. if (cfg.dma_enable == 0U)
  1255. {
  1256. USBx->GINTMSK |= USB_OTG_GINTMSK_RXFLVLM;
  1257. }
  1258. /* Enable interrupts matching to the Host mode ONLY */
  1259. USBx->GINTMSK |= (USB_OTG_GINTMSK_PRTIM | USB_OTG_GINTMSK_HCIM | \
  1260. USB_OTG_GINTMSK_SOFM | USB_OTG_GINTSTS_DISCINT | \
  1261. USB_OTG_GINTMSK_PXFRM_IISOOXFRM | USB_OTG_GINTMSK_WUIM);
  1262. return HAL_OK;
  1263. }
  1264. /**
  1265. * @brief USB_InitFSLSPClkSel : Initializes the FSLSPClkSel field of the
  1266. * HCFG register on the PHY type and set the right frame interval
  1267. * @param USBx Selected device
  1268. * @param freq clock frequency
  1269. * This parameter can be one of these values:
  1270. * HCFG_48_MHZ : Full Speed 48 MHz Clock
  1271. * HCFG_6_MHZ : Low Speed 6 MHz Clock
  1272. * @retval HAL status
  1273. */
  1274. HAL_StatusTypeDef USB_InitFSLSPClkSel(USB_OTG_GlobalTypeDef *USBx, uint8_t freq)
  1275. {
  1276. uint32_t USBx_BASE = (uint32_t)USBx;
  1277. USBx_HOST->HCFG &= ~(USB_OTG_HCFG_FSLSPCS);
  1278. USBx_HOST->HCFG |= (uint32_t)freq & USB_OTG_HCFG_FSLSPCS;
  1279. if (freq == HCFG_48_MHZ)
  1280. {
  1281. USBx_HOST->HFIR = 48000U;
  1282. }
  1283. else if (freq == HCFG_6_MHZ)
  1284. {
  1285. USBx_HOST->HFIR = 6000U;
  1286. }
  1287. else
  1288. {
  1289. /* ... */
  1290. }
  1291. return HAL_OK;
  1292. }
  1293. /**
  1294. * @brief USB_OTG_ResetPort : Reset Host Port
  1295. * @param USBx Selected device
  1296. * @retval HAL status
  1297. * @note (1)The application must wait at least 10 ms
  1298. * before clearing the reset bit.
  1299. */
  1300. HAL_StatusTypeDef USB_ResetPort(USB_OTG_GlobalTypeDef *USBx)
  1301. {
  1302. uint32_t USBx_BASE = (uint32_t)USBx;
  1303. __IO uint32_t hprt0 = 0U;
  1304. hprt0 = USBx_HPRT0;
  1305. hprt0 &= ~(USB_OTG_HPRT_PENA | USB_OTG_HPRT_PCDET |
  1306. USB_OTG_HPRT_PENCHNG | USB_OTG_HPRT_POCCHNG);
  1307. USBx_HPRT0 = (USB_OTG_HPRT_PRST | hprt0);
  1308. HAL_Delay(100U); /* See Note #1 */
  1309. USBx_HPRT0 = ((~USB_OTG_HPRT_PRST) & hprt0);
  1310. HAL_Delay(10U);
  1311. return HAL_OK;
  1312. }
  1313. /**
  1314. * @brief USB_DriveVbus : activate or de-activate vbus
  1315. * @param state VBUS state
  1316. * This parameter can be one of these values:
  1317. * 0 : VBUS Active
  1318. * 1 : VBUS Inactive
  1319. * @retval HAL status
  1320. */
  1321. HAL_StatusTypeDef USB_DriveVbus(USB_OTG_GlobalTypeDef *USBx, uint8_t state)
  1322. {
  1323. uint32_t USBx_BASE = (uint32_t)USBx;
  1324. __IO uint32_t hprt0 = 0U;
  1325. hprt0 = USBx_HPRT0;
  1326. hprt0 &= ~(USB_OTG_HPRT_PENA | USB_OTG_HPRT_PCDET |
  1327. USB_OTG_HPRT_PENCHNG | USB_OTG_HPRT_POCCHNG);
  1328. if (((hprt0 & USB_OTG_HPRT_PPWR) == 0U) && (state == 1U))
  1329. {
  1330. USBx_HPRT0 = (USB_OTG_HPRT_PPWR | hprt0);
  1331. }
  1332. if (((hprt0 & USB_OTG_HPRT_PPWR) == USB_OTG_HPRT_PPWR) && (state == 0U))
  1333. {
  1334. USBx_HPRT0 = ((~USB_OTG_HPRT_PPWR) & hprt0);
  1335. }
  1336. return HAL_OK;
  1337. }
  1338. /**
  1339. * @brief Return Host Core speed
  1340. * @param USBx Selected device
  1341. * @retval speed : Host speed
  1342. * This parameter can be one of these values:
  1343. * @arg HCD_SPEED_HIGH: High speed mode
  1344. * @arg HCD_SPEED_FULL: Full speed mode
  1345. * @arg HCD_SPEED_LOW: Low speed mode
  1346. */
  1347. uint32_t USB_GetHostSpeed(USB_OTG_GlobalTypeDef *USBx)
  1348. {
  1349. uint32_t USBx_BASE = (uint32_t)USBx;
  1350. __IO uint32_t hprt0 = 0U;
  1351. hprt0 = USBx_HPRT0;
  1352. return ((hprt0 & USB_OTG_HPRT_PSPD) >> 17);
  1353. }
  1354. /**
  1355. * @brief Return Host Current Frame number
  1356. * @param USBx Selected device
  1357. * @retval current frame number
  1358. */
  1359. uint32_t USB_GetCurrentFrame(USB_OTG_GlobalTypeDef *USBx)
  1360. {
  1361. uint32_t USBx_BASE = (uint32_t)USBx;
  1362. return (USBx_HOST->HFNUM & USB_OTG_HFNUM_FRNUM);
  1363. }
  1364. /**
  1365. * @brief Initialize a host channel
  1366. * @param USBx Selected device
  1367. * @param ch_num Channel number
  1368. * This parameter can be a value from 1 to 15
  1369. * @param epnum Endpoint number
  1370. * This parameter can be a value from 1 to 15
  1371. * @param dev_address Current device address
  1372. * This parameter can be a value from 0 to 255
  1373. * @param speed Current device speed
  1374. * This parameter can be one of these values:
  1375. * @arg USB_OTG_SPEED_HIGH: High speed mode
  1376. * @arg USB_OTG_SPEED_FULL: Full speed mode
  1377. * @arg USB_OTG_SPEED_LOW: Low speed mode
  1378. * @param ep_type Endpoint Type
  1379. * This parameter can be one of these values:
  1380. * @arg EP_TYPE_CTRL: Control type
  1381. * @arg EP_TYPE_ISOC: Isochronous type
  1382. * @arg EP_TYPE_BULK: Bulk type
  1383. * @arg EP_TYPE_INTR: Interrupt type
  1384. * @param mps Max Packet Size
  1385. * This parameter can be a value from 0 to32K
  1386. * @retval HAL state
  1387. */
  1388. HAL_StatusTypeDef USB_HC_Init(USB_OTG_GlobalTypeDef *USBx,
  1389. uint8_t ch_num,
  1390. uint8_t epnum,
  1391. uint8_t dev_address,
  1392. uint8_t speed,
  1393. uint8_t ep_type,
  1394. uint16_t mps)
  1395. {
  1396. HAL_StatusTypeDef ret = HAL_OK;
  1397. uint32_t USBx_BASE = (uint32_t)USBx;
  1398. uint32_t HCcharEpDir, HCcharLowSpeed;
  1399. /* Clear old interrupt conditions for this host channel. */
  1400. USBx_HC((uint32_t)ch_num)->HCINT = 0xFFFFFFFFU;
  1401. /* Enable channel interrupts required for this transfer. */
  1402. switch (ep_type)
  1403. {
  1404. case EP_TYPE_CTRL:
  1405. case EP_TYPE_BULK:
  1406. USBx_HC((uint32_t)ch_num)->HCINTMSK = USB_OTG_HCINTMSK_XFRCM |
  1407. USB_OTG_HCINTMSK_STALLM |
  1408. USB_OTG_HCINTMSK_TXERRM |
  1409. USB_OTG_HCINTMSK_DTERRM |
  1410. USB_OTG_HCINTMSK_AHBERR |
  1411. USB_OTG_HCINTMSK_NAKM;
  1412. if ((epnum & 0x80U) == 0x80U)
  1413. {
  1414. USBx_HC((uint32_t)ch_num)->HCINTMSK |= USB_OTG_HCINTMSK_BBERRM;
  1415. }
  1416. else
  1417. {
  1418. if ((USBx->CID & (0x1U << 8)) != 0U)
  1419. {
  1420. USBx_HC((uint32_t)ch_num)->HCINTMSK |= (USB_OTG_HCINTMSK_NYET | USB_OTG_HCINTMSK_ACKM);
  1421. }
  1422. }
  1423. break;
  1424. case EP_TYPE_INTR:
  1425. USBx_HC((uint32_t)ch_num)->HCINTMSK = USB_OTG_HCINTMSK_XFRCM |
  1426. USB_OTG_HCINTMSK_STALLM |
  1427. USB_OTG_HCINTMSK_TXERRM |
  1428. USB_OTG_HCINTMSK_DTERRM |
  1429. USB_OTG_HCINTMSK_NAKM |
  1430. USB_OTG_HCINTMSK_AHBERR |
  1431. USB_OTG_HCINTMSK_FRMORM;
  1432. if ((epnum & 0x80U) == 0x80U)
  1433. {
  1434. USBx_HC((uint32_t)ch_num)->HCINTMSK |= USB_OTG_HCINTMSK_BBERRM;
  1435. }
  1436. break;
  1437. case EP_TYPE_ISOC:
  1438. USBx_HC((uint32_t)ch_num)->HCINTMSK = USB_OTG_HCINTMSK_XFRCM |
  1439. USB_OTG_HCINTMSK_ACKM |
  1440. USB_OTG_HCINTMSK_AHBERR |
  1441. USB_OTG_HCINTMSK_FRMORM;
  1442. if ((epnum & 0x80U) == 0x80U)
  1443. {
  1444. USBx_HC((uint32_t)ch_num)->HCINTMSK |= (USB_OTG_HCINTMSK_TXERRM | USB_OTG_HCINTMSK_BBERRM);
  1445. }
  1446. break;
  1447. default:
  1448. ret = HAL_ERROR;
  1449. break;
  1450. }
  1451. /* Enable the top level host channel interrupt. */
  1452. USBx_HOST->HAINTMSK |= 1UL << (ch_num & 0xFU);
  1453. /* Make sure host channel interrupts are enabled. */
  1454. USBx->GINTMSK |= USB_OTG_GINTMSK_HCIM;
  1455. /* Program the HCCHAR register */
  1456. if ((epnum & 0x80U) == 0x80U)
  1457. {
  1458. HCcharEpDir = (0x1U << 15) & USB_OTG_HCCHAR_EPDIR;
  1459. }
  1460. else
  1461. {
  1462. HCcharEpDir = 0U;
  1463. }
  1464. if (speed == HPRT0_PRTSPD_LOW_SPEED)
  1465. {
  1466. HCcharLowSpeed = (0x1U << 17) & USB_OTG_HCCHAR_LSDEV;
  1467. }
  1468. else
  1469. {
  1470. HCcharLowSpeed = 0U;
  1471. }
  1472. USBx_HC((uint32_t)ch_num)->HCCHAR = (((uint32_t)dev_address << 22) & USB_OTG_HCCHAR_DAD) |
  1473. ((((uint32_t)epnum & 0x7FU) << 11) & USB_OTG_HCCHAR_EPNUM) |
  1474. (((uint32_t)ep_type << 18) & USB_OTG_HCCHAR_EPTYP) |
  1475. ((uint32_t)mps & USB_OTG_HCCHAR_MPSIZ) | HCcharEpDir | HCcharLowSpeed;
  1476. if (ep_type == EP_TYPE_INTR)
  1477. {
  1478. USBx_HC((uint32_t)ch_num)->HCCHAR |= USB_OTG_HCCHAR_ODDFRM ;
  1479. }
  1480. return ret;
  1481. }
  1482. /**
  1483. * @brief Start a transfer over a host channel
  1484. * @param USBx Selected device
  1485. * @param hc pointer to host channel structure
  1486. * @param dma USB dma enabled or disabled
  1487. * This parameter can be one of these values:
  1488. * 0 : DMA feature not used
  1489. * 1 : DMA feature used
  1490. * @retval HAL state
  1491. */
  1492. HAL_StatusTypeDef USB_HC_StartXfer(USB_OTG_GlobalTypeDef *USBx, USB_OTG_HCTypeDef *hc, uint8_t dma)
  1493. {
  1494. uint32_t USBx_BASE = (uint32_t)USBx;
  1495. uint32_t ch_num = (uint32_t)hc->ch_num;
  1496. static __IO uint32_t tmpreg = 0U;
  1497. uint8_t is_oddframe;
  1498. uint16_t len_words;
  1499. uint16_t num_packets;
  1500. uint16_t max_hc_pkt_count = 256U;
  1501. if (((USBx->CID & (0x1U << 8)) != 0U) && (hc->speed == USBH_HS_SPEED))
  1502. {
  1503. if ((dma == 0U) && (hc->do_ping == 1U))
  1504. {
  1505. (void)USB_DoPing(USBx, hc->ch_num);
  1506. return HAL_OK;
  1507. }
  1508. else if (dma == 1U)
  1509. {
  1510. USBx_HC(ch_num)->HCINTMSK &= ~(USB_OTG_HCINTMSK_NYET | USB_OTG_HCINTMSK_ACKM);
  1511. hc->do_ping = 0U;
  1512. }
  1513. else
  1514. {
  1515. /* ... */
  1516. }
  1517. }
  1518. /* Compute the expected number of packets associated to the transfer */
  1519. if (hc->xfer_len > 0U)
  1520. {
  1521. num_packets = (uint16_t)((hc->xfer_len + hc->max_packet - 1U) / hc->max_packet);
  1522. if (num_packets > max_hc_pkt_count)
  1523. {
  1524. num_packets = max_hc_pkt_count;
  1525. hc->xfer_len = (uint32_t)num_packets * hc->max_packet;
  1526. }
  1527. }
  1528. else
  1529. {
  1530. num_packets = 1U;
  1531. }
  1532. if (hc->ep_is_in != 0U)
  1533. {
  1534. hc->xfer_len = (uint32_t)num_packets * hc->max_packet;
  1535. }
  1536. /* Initialize the HCTSIZn register */
  1537. USBx_HC(ch_num)->HCTSIZ = (hc->xfer_len & USB_OTG_HCTSIZ_XFRSIZ) |
  1538. (((uint32_t)num_packets << 19) & USB_OTG_HCTSIZ_PKTCNT) |
  1539. (((uint32_t)hc->data_pid << 29) & USB_OTG_HCTSIZ_DPID);
  1540. if (dma != 0U)
  1541. {
  1542. /* xfer_buff MUST be 32-bits aligned */
  1543. USBx_HC(ch_num)->HCDMA = (uint32_t)hc->xfer_buff;
  1544. }
  1545. is_oddframe = (((uint32_t)USBx_HOST->HFNUM & 0x01U) != 0U) ? 0U : 1U;
  1546. USBx_HC(ch_num)->HCCHAR &= ~USB_OTG_HCCHAR_ODDFRM;
  1547. USBx_HC(ch_num)->HCCHAR |= (uint32_t)is_oddframe << 29;
  1548. /* Set host channel enable */
  1549. tmpreg = USBx_HC(ch_num)->HCCHAR;
  1550. tmpreg &= ~USB_OTG_HCCHAR_CHDIS;
  1551. /* make sure to set the correct ep direction */
  1552. if (hc->ep_is_in != 0U)
  1553. {
  1554. tmpreg |= USB_OTG_HCCHAR_EPDIR;
  1555. }
  1556. else
  1557. {
  1558. tmpreg &= ~USB_OTG_HCCHAR_EPDIR;
  1559. }
  1560. tmpreg |= USB_OTG_HCCHAR_CHENA;
  1561. USBx_HC(ch_num)->HCCHAR = tmpreg;
  1562. if (dma == 0U) /* Slave mode */
  1563. {
  1564. if ((hc->ep_is_in == 0U) && (hc->xfer_len > 0U))
  1565. {
  1566. switch (hc->ep_type)
  1567. {
  1568. /* Non periodic transfer */
  1569. case EP_TYPE_CTRL:
  1570. case EP_TYPE_BULK:
  1571. len_words = (uint16_t)((hc->xfer_len + 3U) / 4U);
  1572. /* check if there is enough space in FIFO space */
  1573. if (len_words > (USBx->HNPTXSTS & 0xFFFFU))
  1574. {
  1575. /* need to process data in nptxfempty interrupt */
  1576. USBx->GINTMSK |= USB_OTG_GINTMSK_NPTXFEM;
  1577. }
  1578. break;
  1579. /* Periodic transfer */
  1580. case EP_TYPE_INTR:
  1581. case EP_TYPE_ISOC:
  1582. len_words = (uint16_t)((hc->xfer_len + 3U) / 4U);
  1583. /* check if there is enough space in FIFO space */
  1584. if (len_words > (USBx_HOST->HPTXSTS & 0xFFFFU)) /* split the transfer */
  1585. {
  1586. /* need to process data in ptxfempty interrupt */
  1587. USBx->GINTMSK |= USB_OTG_GINTMSK_PTXFEM;
  1588. }
  1589. break;
  1590. default:
  1591. break;
  1592. }
  1593. /* Write packet into the Tx FIFO. */
  1594. (void)USB_WritePacket(USBx, hc->xfer_buff, hc->ch_num, (uint16_t)hc->xfer_len, 0);
  1595. }
  1596. }
  1597. return HAL_OK;
  1598. }
  1599. /**
  1600. * @brief Read all host channel interrupts status
  1601. * @param USBx Selected device
  1602. * @retval HAL state
  1603. */
  1604. uint32_t USB_HC_ReadInterrupt(USB_OTG_GlobalTypeDef *USBx)
  1605. {
  1606. uint32_t USBx_BASE = (uint32_t)USBx;
  1607. return ((USBx_HOST->HAINT) & 0xFFFFU);
  1608. }
  1609. /**
  1610. * @brief Halt a host channel
  1611. * @param USBx Selected device
  1612. * @param hc_num Host Channel number
  1613. * This parameter can be a value from 1 to 15
  1614. * @retval HAL state
  1615. */
  1616. HAL_StatusTypeDef USB_HC_Halt(USB_OTG_GlobalTypeDef *USBx, uint8_t hc_num)
  1617. {
  1618. uint32_t USBx_BASE = (uint32_t)USBx;
  1619. uint32_t hcnum = (uint32_t)hc_num;
  1620. uint32_t count = 0U;
  1621. uint32_t HcEpType = (USBx_HC(hcnum)->HCCHAR & USB_OTG_HCCHAR_EPTYP) >> 18;
  1622. /* Check for space in the request queue to issue the halt. */
  1623. if ((HcEpType == HCCHAR_CTRL) || (HcEpType == HCCHAR_BULK))
  1624. {
  1625. USBx_HC(hcnum)->HCCHAR |= USB_OTG_HCCHAR_CHDIS;
  1626. if ((USBx->HNPTXSTS & (0xFFU << 16)) == 0U)
  1627. {
  1628. USBx_HC(hcnum)->HCCHAR &= ~USB_OTG_HCCHAR_CHENA;
  1629. USBx_HC(hcnum)->HCCHAR |= USB_OTG_HCCHAR_CHENA;
  1630. USBx_HC(hcnum)->HCCHAR &= ~USB_OTG_HCCHAR_EPDIR;
  1631. do
  1632. {
  1633. if (++count > 1000U)
  1634. {
  1635. break;
  1636. }
  1637. }
  1638. while ((USBx_HC(hcnum)->HCCHAR & USB_OTG_HCCHAR_CHENA) == USB_OTG_HCCHAR_CHENA);
  1639. }
  1640. else
  1641. {
  1642. USBx_HC(hcnum)->HCCHAR |= USB_OTG_HCCHAR_CHENA;
  1643. }
  1644. }
  1645. else
  1646. {
  1647. USBx_HC(hcnum)->HCCHAR |= USB_OTG_HCCHAR_CHDIS;
  1648. if ((USBx_HOST->HPTXSTS & (0xFFU << 16)) == 0U)
  1649. {
  1650. USBx_HC(hcnum)->HCCHAR &= ~USB_OTG_HCCHAR_CHENA;
  1651. USBx_HC(hcnum)->HCCHAR |= USB_OTG_HCCHAR_CHENA;
  1652. USBx_HC(hcnum)->HCCHAR &= ~USB_OTG_HCCHAR_EPDIR;
  1653. do
  1654. {
  1655. if (++count > 1000U)
  1656. {
  1657. break;
  1658. }
  1659. }
  1660. while ((USBx_HC(hcnum)->HCCHAR & USB_OTG_HCCHAR_CHENA) == USB_OTG_HCCHAR_CHENA);
  1661. }
  1662. else
  1663. {
  1664. USBx_HC(hcnum)->HCCHAR |= USB_OTG_HCCHAR_CHENA;
  1665. }
  1666. }
  1667. return HAL_OK;
  1668. }
  1669. /**
  1670. * @brief Initiate Do Ping protocol
  1671. * @param USBx Selected device
  1672. * @param hc_num Host Channel number
  1673. * This parameter can be a value from 1 to 15
  1674. * @retval HAL state
  1675. */
  1676. HAL_StatusTypeDef USB_DoPing(USB_OTG_GlobalTypeDef *USBx, uint8_t ch_num)
  1677. {
  1678. uint32_t USBx_BASE = (uint32_t)USBx;
  1679. uint32_t chnum = (uint32_t)ch_num;
  1680. uint32_t num_packets = 1U;
  1681. uint32_t tmpreg;
  1682. USBx_HC(chnum)->HCTSIZ = ((num_packets << 19) & USB_OTG_HCTSIZ_PKTCNT) |
  1683. USB_OTG_HCTSIZ_DOPING;
  1684. /* Set host channel enable */
  1685. tmpreg = USBx_HC(chnum)->HCCHAR;
  1686. tmpreg &= ~USB_OTG_HCCHAR_CHDIS;
  1687. tmpreg |= USB_OTG_HCCHAR_CHENA;
  1688. USBx_HC(chnum)->HCCHAR = tmpreg;
  1689. return HAL_OK;
  1690. }
  1691. /**
  1692. * @brief Stop Host Core
  1693. * @param USBx Selected device
  1694. * @retval HAL state
  1695. */
  1696. HAL_StatusTypeDef USB_StopHost(USB_OTG_GlobalTypeDef *USBx)
  1697. {
  1698. uint32_t USBx_BASE = (uint32_t)USBx;
  1699. uint32_t count = 0U;
  1700. uint32_t value;
  1701. uint32_t i;
  1702. (void)USB_DisableGlobalInt(USBx);
  1703. /* Flush FIFO */
  1704. (void)USB_FlushTxFifo(USBx, 0x10U);
  1705. (void)USB_FlushRxFifo(USBx);
  1706. /* Flush out any leftover queued requests. */
  1707. for (i = 0U; i <= 15U; i++)
  1708. {
  1709. value = USBx_HC(i)->HCCHAR;
  1710. value |= USB_OTG_HCCHAR_CHDIS;
  1711. value &= ~USB_OTG_HCCHAR_CHENA;
  1712. value &= ~USB_OTG_HCCHAR_EPDIR;
  1713. USBx_HC(i)->HCCHAR = value;
  1714. }
  1715. /* Halt all channels to put them into a known state. */
  1716. for (i = 0U; i <= 15U; i++)
  1717. {
  1718. value = USBx_HC(i)->HCCHAR;
  1719. value |= USB_OTG_HCCHAR_CHDIS;
  1720. value |= USB_OTG_HCCHAR_CHENA;
  1721. value &= ~USB_OTG_HCCHAR_EPDIR;
  1722. USBx_HC(i)->HCCHAR = value;
  1723. do
  1724. {
  1725. if (++count > 1000U)
  1726. {
  1727. break;
  1728. }
  1729. }
  1730. while ((USBx_HC(i)->HCCHAR & USB_OTG_HCCHAR_CHENA) == USB_OTG_HCCHAR_CHENA);
  1731. }
  1732. /* Clear any pending Host interrupts */
  1733. USBx_HOST->HAINT = 0xFFFFFFFFU;
  1734. USBx->GINTSTS = 0xFFFFFFFFU;
  1735. (void)USB_EnableGlobalInt(USBx);
  1736. return HAL_OK;
  1737. }
  1738. /**
  1739. * @brief USB_ActivateRemoteWakeup active remote wakeup signalling
  1740. * @param USBx Selected device
  1741. * @retval HAL status
  1742. */
  1743. HAL_StatusTypeDef USB_ActivateRemoteWakeup(USB_OTG_GlobalTypeDef *USBx)
  1744. {
  1745. uint32_t USBx_BASE = (uint32_t)USBx;
  1746. if ((USBx_DEVICE->DSTS & USB_OTG_DSTS_SUSPSTS) == USB_OTG_DSTS_SUSPSTS)
  1747. {
  1748. /* active Remote wakeup signalling */
  1749. USBx_DEVICE->DCTL |= USB_OTG_DCTL_RWUSIG;
  1750. }
  1751. return HAL_OK;
  1752. }
  1753. /**
  1754. * @brief USB_DeActivateRemoteWakeup de-active remote wakeup signalling
  1755. * @param USBx Selected device
  1756. * @retval HAL status
  1757. */
  1758. HAL_StatusTypeDef USB_DeActivateRemoteWakeup(USB_OTG_GlobalTypeDef *USBx)
  1759. {
  1760. uint32_t USBx_BASE = (uint32_t)USBx;
  1761. /* active Remote wakeup signalling */
  1762. USBx_DEVICE->DCTL &= ~(USB_OTG_DCTL_RWUSIG);
  1763. return HAL_OK;
  1764. }
  1765. #endif /* defined (USB_OTG_FS) || defined (USB_OTG_HS) */
  1766. /**
  1767. * @}
  1768. */
  1769. /**
  1770. * @}
  1771. */
  1772. #endif /* defined (USB_OTG_FS) || defined (USB_OTG_HS) */
  1773. #endif /* defined (HAL_PCD_MODULE_ENABLED) || defined (HAL_HCD_MODULE_ENABLED) */
  1774. /**
  1775. * @}
  1776. */
  1777. /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/