stm32l4xx_ll_gpio.h 40 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066
  1. /**
  2. ******************************************************************************
  3. * @file stm32l4xx_ll_gpio.h
  4. * @author MCD Application Team
  5. * @version V1.7.2
  6. * @date 16-June-2017
  7. * @brief Header file of GPIO LL module.
  8. ******************************************************************************
  9. * @attention
  10. *
  11. * <h2><center>&copy; COPYRIGHT(c) 2017 STMicroelectronics</center></h2>
  12. *
  13. * Redistribution and use in source and binary forms, with or without modification,
  14. * are permitted provided that the following conditions are met:
  15. * 1. Redistributions of source code must retain the above copyright notice,
  16. * this list of conditions and the following disclaimer.
  17. * 2. Redistributions in binary form must reproduce the above copyright notice,
  18. * this list of conditions and the following disclaimer in the documentation
  19. * and/or other materials provided with the distribution.
  20. * 3. Neither the name of STMicroelectronics nor the names of its contributors
  21. * may be used to endorse or promote products derived from this software
  22. * without specific prior written permission.
  23. *
  24. * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
  25. * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  26. * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
  27. * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
  28. * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  29. * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
  30. * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
  31. * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
  32. * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
  33. * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  34. *
  35. ******************************************************************************
  36. */
  37. /* Define to prevent recursive inclusion -------------------------------------*/
  38. #ifndef __STM32L4xx_LL_GPIO_H
  39. #define __STM32L4xx_LL_GPIO_H
  40. #ifdef __cplusplus
  41. extern "C" {
  42. #endif
  43. /* Includes ------------------------------------------------------------------*/
  44. #include "stm32l4xx.h"
  45. /** @addtogroup STM32L4xx_LL_Driver
  46. * @{
  47. */
  48. #if defined (GPIOA) || defined (GPIOB) || defined (GPIOC) || defined (GPIOD) || defined (GPIOE) || defined (GPIOF) || defined (GPIOG) || defined (GPIOH) || defined (GPIOI)
  49. /** @defgroup GPIO_LL GPIO
  50. * @{
  51. */
  52. /* Private types -------------------------------------------------------------*/
  53. /* Private variables ---------------------------------------------------------*/
  54. /* Private constants ---------------------------------------------------------*/
  55. /* Private macros ------------------------------------------------------------*/
  56. #if defined(USE_FULL_LL_DRIVER)
  57. /** @defgroup GPIO_LL_Private_Macros GPIO Private Macros
  58. * @{
  59. */
  60. /**
  61. * @}
  62. */
  63. #endif /*USE_FULL_LL_DRIVER*/
  64. /* Exported types ------------------------------------------------------------*/
  65. #if defined(USE_FULL_LL_DRIVER)
  66. /** @defgroup GPIO_LL_ES_INIT GPIO Exported Init structures
  67. * @{
  68. */
  69. /**
  70. * @brief LL GPIO Init Structure definition
  71. */
  72. typedef struct
  73. {
  74. uint32_t Pin; /*!< Specifies the GPIO pins to be configured.
  75. This parameter can be any value of @ref GPIO_LL_EC_PIN */
  76. uint32_t Mode; /*!< Specifies the operating mode for the selected pins.
  77. This parameter can be a value of @ref GPIO_LL_EC_MODE.
  78. GPIO HW configuration can be modified afterwards using unitary function @ref LL_GPIO_SetPinMode().*/
  79. uint32_t Speed; /*!< Specifies the speed for the selected pins.
  80. This parameter can be a value of @ref GPIO_LL_EC_SPEED.
  81. GPIO HW configuration can be modified afterwards using unitary function @ref LL_GPIO_SetPinSpeed().*/
  82. uint32_t OutputType; /*!< Specifies the operating output type for the selected pins.
  83. This parameter can be a value of @ref GPIO_LL_EC_OUTPUT.
  84. GPIO HW configuration can be modified afterwards using unitary function @ref LL_GPIO_SetPinOutputType().*/
  85. uint32_t Pull; /*!< Specifies the operating Pull-up/Pull down for the selected pins.
  86. This parameter can be a value of @ref GPIO_LL_EC_PULL.
  87. GPIO HW configuration can be modified afterwards using unitary function @ref LL_GPIO_SetPinPull().*/
  88. uint32_t Alternate; /*!< Specifies the Peripheral to be connected to the selected pins.
  89. This parameter can be a value of @ref GPIO_LL_EC_AF.
  90. GPIO HW configuration can be modified afterwards using unitary function @ref LL_GPIO_SetAFPin_0_7() and LL_GPIO_SetAFPin_8_15().*/
  91. } LL_GPIO_InitTypeDef;
  92. /**
  93. * @}
  94. */
  95. #endif /* USE_FULL_LL_DRIVER */
  96. /* Exported constants --------------------------------------------------------*/
  97. /** @defgroup GPIO_LL_Exported_Constants GPIO Exported Constants
  98. * @{
  99. */
  100. /** @defgroup GPIO_LL_EC_PIN PIN
  101. * @{
  102. */
  103. #define LL_GPIO_PIN_0 GPIO_BSRR_BS0 /*!< Select pin 0 */
  104. #define LL_GPIO_PIN_1 GPIO_BSRR_BS1 /*!< Select pin 1 */
  105. #define LL_GPIO_PIN_2 GPIO_BSRR_BS2 /*!< Select pin 2 */
  106. #define LL_GPIO_PIN_3 GPIO_BSRR_BS3 /*!< Select pin 3 */
  107. #define LL_GPIO_PIN_4 GPIO_BSRR_BS4 /*!< Select pin 4 */
  108. #define LL_GPIO_PIN_5 GPIO_BSRR_BS5 /*!< Select pin 5 */
  109. #define LL_GPIO_PIN_6 GPIO_BSRR_BS6 /*!< Select pin 6 */
  110. #define LL_GPIO_PIN_7 GPIO_BSRR_BS7 /*!< Select pin 7 */
  111. #define LL_GPIO_PIN_8 GPIO_BSRR_BS8 /*!< Select pin 8 */
  112. #define LL_GPIO_PIN_9 GPIO_BSRR_BS9 /*!< Select pin 9 */
  113. #define LL_GPIO_PIN_10 GPIO_BSRR_BS10 /*!< Select pin 10 */
  114. #define LL_GPIO_PIN_11 GPIO_BSRR_BS11 /*!< Select pin 11 */
  115. #define LL_GPIO_PIN_12 GPIO_BSRR_BS12 /*!< Select pin 12 */
  116. #define LL_GPIO_PIN_13 GPIO_BSRR_BS13 /*!< Select pin 13 */
  117. #define LL_GPIO_PIN_14 GPIO_BSRR_BS14 /*!< Select pin 14 */
  118. #define LL_GPIO_PIN_15 GPIO_BSRR_BS15 /*!< Select pin 15 */
  119. #define LL_GPIO_PIN_ALL (GPIO_BSRR_BS0 | GPIO_BSRR_BS1 | GPIO_BSRR_BS2 | \
  120. GPIO_BSRR_BS3 | GPIO_BSRR_BS4 | GPIO_BSRR_BS5 | \
  121. GPIO_BSRR_BS6 | GPIO_BSRR_BS7 | GPIO_BSRR_BS8 | \
  122. GPIO_BSRR_BS9 | GPIO_BSRR_BS10 | GPIO_BSRR_BS11 | \
  123. GPIO_BSRR_BS12 | GPIO_BSRR_BS13 | GPIO_BSRR_BS14 | \
  124. GPIO_BSRR_BS15) /*!< Select all pins */
  125. /**
  126. * @}
  127. */
  128. /** @defgroup GPIO_LL_EC_MODE Mode
  129. * @{
  130. */
  131. #define LL_GPIO_MODE_INPUT (0x00000000U) /*!< Select input mode */
  132. #define LL_GPIO_MODE_OUTPUT GPIO_MODER_MODE0_0 /*!< Select output mode */
  133. #define LL_GPIO_MODE_ALTERNATE GPIO_MODER_MODE0_1 /*!< Select alternate function mode */
  134. #define LL_GPIO_MODE_ANALOG GPIO_MODER_MODE0 /*!< Select analog mode */
  135. /**
  136. * @}
  137. */
  138. /** @defgroup GPIO_LL_EC_OUTPUT Output Type
  139. * @{
  140. */
  141. #define LL_GPIO_OUTPUT_PUSHPULL (0x00000000U) /*!< Select push-pull as output type */
  142. #define LL_GPIO_OUTPUT_OPENDRAIN GPIO_OTYPER_OT0 /*!< Select open-drain as output type */
  143. /**
  144. * @}
  145. */
  146. /** @defgroup GPIO_LL_EC_SPEED Output Speed
  147. * @{
  148. */
  149. #define LL_GPIO_SPEED_FREQ_LOW (0x00000000U) /*!< Select I/O low output speed */
  150. #define LL_GPIO_SPEED_FREQ_MEDIUM GPIO_OSPEEDR_OSPEED0_0 /*!< Select I/O medium output speed */
  151. #define LL_GPIO_SPEED_FREQ_HIGH GPIO_OSPEEDR_OSPEED0_1 /*!< Select I/O fast output speed */
  152. #define LL_GPIO_SPEED_FREQ_VERY_HIGH GPIO_OSPEEDR_OSPEED0 /*!< Select I/O high output speed */
  153. /**
  154. * @}
  155. */
  156. #define LL_GPIO_SPEED_LOW LL_GPIO_SPEED_FREQ_LOW
  157. #define LL_GPIO_SPEED_MEDIUM LL_GPIO_SPEED_FREQ_MEDIUM
  158. #define LL_GPIO_SPEED_FAST LL_GPIO_SPEED_FREQ_HIGH
  159. #define LL_GPIO_SPEED_HIGH LL_GPIO_SPEED_FREQ_VERY_HIGH
  160. /** @defgroup GPIO_LL_EC_PULL Pull Up Pull Down
  161. * @{
  162. */
  163. #define LL_GPIO_PULL_NO (0x00000000U) /*!< Select I/O no pull */
  164. #define LL_GPIO_PULL_UP GPIO_PUPDR_PUPD0_0 /*!< Select I/O pull up */
  165. #define LL_GPIO_PULL_DOWN GPIO_PUPDR_PUPD0_1 /*!< Select I/O pull down */
  166. /**
  167. * @}
  168. */
  169. /** @defgroup GPIO_LL_EC_AF Alternate Function
  170. * @{
  171. */
  172. #define LL_GPIO_AF_0 (0x0000000U) /*!< Select alternate function 0 */
  173. #define LL_GPIO_AF_1 (0x0000001U) /*!< Select alternate function 1 */
  174. #define LL_GPIO_AF_2 (0x0000002U) /*!< Select alternate function 2 */
  175. #define LL_GPIO_AF_3 (0x0000003U) /*!< Select alternate function 3 */
  176. #define LL_GPIO_AF_4 (0x0000004U) /*!< Select alternate function 4 */
  177. #define LL_GPIO_AF_5 (0x0000005U) /*!< Select alternate function 5 */
  178. #define LL_GPIO_AF_6 (0x0000006U) /*!< Select alternate function 6 */
  179. #define LL_GPIO_AF_7 (0x0000007U) /*!< Select alternate function 7 */
  180. #define LL_GPIO_AF_8 (0x0000008U) /*!< Select alternate function 8 */
  181. #define LL_GPIO_AF_9 (0x0000009U) /*!< Select alternate function 9 */
  182. #define LL_GPIO_AF_10 (0x000000AU) /*!< Select alternate function 10 */
  183. #define LL_GPIO_AF_11 (0x000000BU) /*!< Select alternate function 11 */
  184. #define LL_GPIO_AF_12 (0x000000CU) /*!< Select alternate function 12 */
  185. #define LL_GPIO_AF_13 (0x000000DU) /*!< Select alternate function 13 */
  186. #define LL_GPIO_AF_14 (0x000000EU) /*!< Select alternate function 14 */
  187. #define LL_GPIO_AF_15 (0x000000FU) /*!< Select alternate function 15 */
  188. /**
  189. * @}
  190. */
  191. /**
  192. * @}
  193. */
  194. /* Exported macro ------------------------------------------------------------*/
  195. /** @defgroup GPIO_LL_Exported_Macros GPIO Exported Macros
  196. * @{
  197. */
  198. /** @defgroup GPIO_LL_EM_WRITE_READ Common Write and read registers Macros
  199. * @{
  200. */
  201. /**
  202. * @brief Write a value in GPIO register
  203. * @param __INSTANCE__ GPIO Instance
  204. * @param __REG__ Register to be written
  205. * @param __VALUE__ Value to be written in the register
  206. * @retval None
  207. */
  208. #define LL_GPIO_WriteReg(__INSTANCE__, __REG__, __VALUE__) WRITE_REG(__INSTANCE__->__REG__, (__VALUE__))
  209. /**
  210. * @brief Read a value in GPIO register
  211. * @param __INSTANCE__ GPIO Instance
  212. * @param __REG__ Register to be read
  213. * @retval Register value
  214. */
  215. #define LL_GPIO_ReadReg(__INSTANCE__, __REG__) READ_REG(__INSTANCE__->__REG__)
  216. /**
  217. * @}
  218. */
  219. /**
  220. * @}
  221. */
  222. /* Exported functions --------------------------------------------------------*/
  223. /** @defgroup GPIO_LL_Exported_Functions GPIO Exported Functions
  224. * @{
  225. */
  226. /** @defgroup GPIO_LL_EF_Port_Configuration Port Configuration
  227. * @{
  228. */
  229. /**
  230. * @brief Configure gpio mode for a dedicated pin on dedicated port.
  231. * @note I/O mode can be Input mode, General purpose output, Alternate function mode or Analog.
  232. * @note Warning: only one pin can be passed as parameter.
  233. * @rmtoll MODER MODEy LL_GPIO_SetPinMode
  234. * @param GPIOx GPIO Port
  235. * @param Pin This parameter can be one of the following values:
  236. * @arg @ref LL_GPIO_PIN_0
  237. * @arg @ref LL_GPIO_PIN_1
  238. * @arg @ref LL_GPIO_PIN_2
  239. * @arg @ref LL_GPIO_PIN_3
  240. * @arg @ref LL_GPIO_PIN_4
  241. * @arg @ref LL_GPIO_PIN_5
  242. * @arg @ref LL_GPIO_PIN_6
  243. * @arg @ref LL_GPIO_PIN_7
  244. * @arg @ref LL_GPIO_PIN_8
  245. * @arg @ref LL_GPIO_PIN_9
  246. * @arg @ref LL_GPIO_PIN_10
  247. * @arg @ref LL_GPIO_PIN_11
  248. * @arg @ref LL_GPIO_PIN_12
  249. * @arg @ref LL_GPIO_PIN_13
  250. * @arg @ref LL_GPIO_PIN_14
  251. * @arg @ref LL_GPIO_PIN_15
  252. * @param Mode This parameter can be one of the following values:
  253. * @arg @ref LL_GPIO_MODE_INPUT
  254. * @arg @ref LL_GPIO_MODE_OUTPUT
  255. * @arg @ref LL_GPIO_MODE_ALTERNATE
  256. * @arg @ref LL_GPIO_MODE_ANALOG
  257. * @retval None
  258. */
  259. __STATIC_INLINE void LL_GPIO_SetPinMode(GPIO_TypeDef *GPIOx, uint32_t Pin, uint32_t Mode)
  260. {
  261. MODIFY_REG(GPIOx->MODER, (GPIO_MODER_MODE0 << (POSITION_VAL(Pin) * 2U)), (Mode << (POSITION_VAL(Pin) * 2U)));
  262. }
  263. /**
  264. * @brief Return gpio mode for a dedicated pin on dedicated port.
  265. * @note I/O mode can be Input mode, General purpose output, Alternate function mode or Analog.
  266. * @note Warning: only one pin can be passed as parameter.
  267. * @rmtoll MODER MODEy LL_GPIO_GetPinMode
  268. * @param GPIOx GPIO Port
  269. * @param Pin This parameter can be one of the following values:
  270. * @arg @ref LL_GPIO_PIN_0
  271. * @arg @ref LL_GPIO_PIN_1
  272. * @arg @ref LL_GPIO_PIN_2
  273. * @arg @ref LL_GPIO_PIN_3
  274. * @arg @ref LL_GPIO_PIN_4
  275. * @arg @ref LL_GPIO_PIN_5
  276. * @arg @ref LL_GPIO_PIN_6
  277. * @arg @ref LL_GPIO_PIN_7
  278. * @arg @ref LL_GPIO_PIN_8
  279. * @arg @ref LL_GPIO_PIN_9
  280. * @arg @ref LL_GPIO_PIN_10
  281. * @arg @ref LL_GPIO_PIN_11
  282. * @arg @ref LL_GPIO_PIN_12
  283. * @arg @ref LL_GPIO_PIN_13
  284. * @arg @ref LL_GPIO_PIN_14
  285. * @arg @ref LL_GPIO_PIN_15
  286. * @retval Returned value can be one of the following values:
  287. * @arg @ref LL_GPIO_MODE_INPUT
  288. * @arg @ref LL_GPIO_MODE_OUTPUT
  289. * @arg @ref LL_GPIO_MODE_ALTERNATE
  290. * @arg @ref LL_GPIO_MODE_ANALOG
  291. */
  292. __STATIC_INLINE uint32_t LL_GPIO_GetPinMode(GPIO_TypeDef *GPIOx, uint32_t Pin)
  293. {
  294. return (uint32_t)(READ_BIT(GPIOx->MODER,
  295. (GPIO_MODER_MODE0 << (POSITION_VAL(Pin) * 2U))) >> (POSITION_VAL(Pin) * 2U));
  296. }
  297. /**
  298. * @brief Configure gpio output type for several pins on dedicated port.
  299. * @note Output type as to be set when gpio pin is in output or
  300. * alternate modes. Possible type are Push-pull or Open-drain.
  301. * @rmtoll OTYPER OTy LL_GPIO_SetPinOutputType
  302. * @param GPIOx GPIO Port
  303. * @param PinMask This parameter can be a combination of the following values:
  304. * @arg @ref LL_GPIO_PIN_0
  305. * @arg @ref LL_GPIO_PIN_1
  306. * @arg @ref LL_GPIO_PIN_2
  307. * @arg @ref LL_GPIO_PIN_3
  308. * @arg @ref LL_GPIO_PIN_4
  309. * @arg @ref LL_GPIO_PIN_5
  310. * @arg @ref LL_GPIO_PIN_6
  311. * @arg @ref LL_GPIO_PIN_7
  312. * @arg @ref LL_GPIO_PIN_8
  313. * @arg @ref LL_GPIO_PIN_9
  314. * @arg @ref LL_GPIO_PIN_10
  315. * @arg @ref LL_GPIO_PIN_11
  316. * @arg @ref LL_GPIO_PIN_12
  317. * @arg @ref LL_GPIO_PIN_13
  318. * @arg @ref LL_GPIO_PIN_14
  319. * @arg @ref LL_GPIO_PIN_15
  320. * @arg @ref LL_GPIO_PIN_ALL
  321. * @param OutputType This parameter can be one of the following values:
  322. * @arg @ref LL_GPIO_OUTPUT_PUSHPULL
  323. * @arg @ref LL_GPIO_OUTPUT_OPENDRAIN
  324. * @retval None
  325. */
  326. __STATIC_INLINE void LL_GPIO_SetPinOutputType(GPIO_TypeDef *GPIOx, uint32_t PinMask, uint32_t OutputType)
  327. {
  328. MODIFY_REG(GPIOx->OTYPER, PinMask, (PinMask * OutputType));
  329. }
  330. /**
  331. * @brief Return gpio output type for several pins on dedicated port.
  332. * @note Output type as to be set when gpio pin is in output or
  333. * alternate modes. Possible type are Push-pull or Open-drain.
  334. * @note Warning: only one pin can be passed as parameter.
  335. * @rmtoll OTYPER OTy LL_GPIO_GetPinOutputType
  336. * @param GPIOx GPIO Port
  337. * @param Pin This parameter can be one of the following values:
  338. * @arg @ref LL_GPIO_PIN_0
  339. * @arg @ref LL_GPIO_PIN_1
  340. * @arg @ref LL_GPIO_PIN_2
  341. * @arg @ref LL_GPIO_PIN_3
  342. * @arg @ref LL_GPIO_PIN_4
  343. * @arg @ref LL_GPIO_PIN_5
  344. * @arg @ref LL_GPIO_PIN_6
  345. * @arg @ref LL_GPIO_PIN_7
  346. * @arg @ref LL_GPIO_PIN_8
  347. * @arg @ref LL_GPIO_PIN_9
  348. * @arg @ref LL_GPIO_PIN_10
  349. * @arg @ref LL_GPIO_PIN_11
  350. * @arg @ref LL_GPIO_PIN_12
  351. * @arg @ref LL_GPIO_PIN_13
  352. * @arg @ref LL_GPIO_PIN_14
  353. * @arg @ref LL_GPIO_PIN_15
  354. * @arg @ref LL_GPIO_PIN_ALL
  355. * @retval Returned value can be one of the following values:
  356. * @arg @ref LL_GPIO_OUTPUT_PUSHPULL
  357. * @arg @ref LL_GPIO_OUTPUT_OPENDRAIN
  358. */
  359. __STATIC_INLINE uint32_t LL_GPIO_GetPinOutputType(GPIO_TypeDef *GPIOx, uint32_t Pin)
  360. {
  361. return (uint32_t)(READ_BIT(GPIOx->OTYPER, Pin) >> POSITION_VAL(Pin));
  362. }
  363. /**
  364. * @brief Configure gpio speed for a dedicated pin on dedicated port.
  365. * @note I/O speed can be Low, Medium, Fast or High speed.
  366. * @note Warning: only one pin can be passed as parameter.
  367. * @note Refer to datasheet for frequency specifications and the power
  368. * supply and load conditions for each speed.
  369. * @rmtoll OSPEEDR OSPEEDy LL_GPIO_SetPinSpeed
  370. * @param GPIOx GPIO Port
  371. * @param Pin This parameter can be one of the following values:
  372. * @arg @ref LL_GPIO_PIN_0
  373. * @arg @ref LL_GPIO_PIN_1
  374. * @arg @ref LL_GPIO_PIN_2
  375. * @arg @ref LL_GPIO_PIN_3
  376. * @arg @ref LL_GPIO_PIN_4
  377. * @arg @ref LL_GPIO_PIN_5
  378. * @arg @ref LL_GPIO_PIN_6
  379. * @arg @ref LL_GPIO_PIN_7
  380. * @arg @ref LL_GPIO_PIN_8
  381. * @arg @ref LL_GPIO_PIN_9
  382. * @arg @ref LL_GPIO_PIN_10
  383. * @arg @ref LL_GPIO_PIN_11
  384. * @arg @ref LL_GPIO_PIN_12
  385. * @arg @ref LL_GPIO_PIN_13
  386. * @arg @ref LL_GPIO_PIN_14
  387. * @arg @ref LL_GPIO_PIN_15
  388. * @param Speed This parameter can be one of the following values:
  389. * @arg @ref LL_GPIO_SPEED_FREQ_LOW
  390. * @arg @ref LL_GPIO_SPEED_FREQ_MEDIUM
  391. * @arg @ref LL_GPIO_SPEED_FREQ_HIGH
  392. * @arg @ref LL_GPIO_SPEED_FREQ_VERY_HIGH
  393. * @retval None
  394. */
  395. __STATIC_INLINE void LL_GPIO_SetPinSpeed(GPIO_TypeDef *GPIOx, uint32_t Pin, uint32_t Speed)
  396. {
  397. MODIFY_REG(GPIOx->OSPEEDR, (GPIO_OSPEEDR_OSPEED0 << (POSITION_VAL(Pin) * 2U)),
  398. (Speed << (POSITION_VAL(Pin) * 2U)));
  399. }
  400. /**
  401. * @brief Return gpio speed for a dedicated pin on dedicated port.
  402. * @note I/O speed can be Low, Medium, Fast or High speed.
  403. * @note Warning: only one pin can be passed as parameter.
  404. * @note Refer to datasheet for frequency specifications and the power
  405. * supply and load conditions for each speed.
  406. * @rmtoll OSPEEDR OSPEEDy LL_GPIO_GetPinSpeed
  407. * @param GPIOx GPIO Port
  408. * @param Pin This parameter can be one of the following values:
  409. * @arg @ref LL_GPIO_PIN_0
  410. * @arg @ref LL_GPIO_PIN_1
  411. * @arg @ref LL_GPIO_PIN_2
  412. * @arg @ref LL_GPIO_PIN_3
  413. * @arg @ref LL_GPIO_PIN_4
  414. * @arg @ref LL_GPIO_PIN_5
  415. * @arg @ref LL_GPIO_PIN_6
  416. * @arg @ref LL_GPIO_PIN_7
  417. * @arg @ref LL_GPIO_PIN_8
  418. * @arg @ref LL_GPIO_PIN_9
  419. * @arg @ref LL_GPIO_PIN_10
  420. * @arg @ref LL_GPIO_PIN_11
  421. * @arg @ref LL_GPIO_PIN_12
  422. * @arg @ref LL_GPIO_PIN_13
  423. * @arg @ref LL_GPIO_PIN_14
  424. * @arg @ref LL_GPIO_PIN_15
  425. * @retval Returned value can be one of the following values:
  426. * @arg @ref LL_GPIO_SPEED_FREQ_LOW
  427. * @arg @ref LL_GPIO_SPEED_FREQ_MEDIUM
  428. * @arg @ref LL_GPIO_SPEED_FREQ_HIGH
  429. * @arg @ref LL_GPIO_SPEED_FREQ_VERY_HIGH
  430. */
  431. __STATIC_INLINE uint32_t LL_GPIO_GetPinSpeed(GPIO_TypeDef *GPIOx, uint32_t Pin)
  432. {
  433. return (uint32_t)(READ_BIT(GPIOx->OSPEEDR,
  434. (GPIO_OSPEEDR_OSPEED0 << (POSITION_VAL(Pin) * 2U))) >> (POSITION_VAL(Pin) * 2U));
  435. }
  436. /**
  437. * @brief Configure gpio pull-up or pull-down for a dedicated pin on a dedicated port.
  438. * @note Warning: only one pin can be passed as parameter.
  439. * @rmtoll PUPDR PUPDy LL_GPIO_SetPinPull
  440. * @param GPIOx GPIO Port
  441. * @param Pin This parameter can be one of the following values:
  442. * @arg @ref LL_GPIO_PIN_0
  443. * @arg @ref LL_GPIO_PIN_1
  444. * @arg @ref LL_GPIO_PIN_2
  445. * @arg @ref LL_GPIO_PIN_3
  446. * @arg @ref LL_GPIO_PIN_4
  447. * @arg @ref LL_GPIO_PIN_5
  448. * @arg @ref LL_GPIO_PIN_6
  449. * @arg @ref LL_GPIO_PIN_7
  450. * @arg @ref LL_GPIO_PIN_8
  451. * @arg @ref LL_GPIO_PIN_9
  452. * @arg @ref LL_GPIO_PIN_10
  453. * @arg @ref LL_GPIO_PIN_11
  454. * @arg @ref LL_GPIO_PIN_12
  455. * @arg @ref LL_GPIO_PIN_13
  456. * @arg @ref LL_GPIO_PIN_14
  457. * @arg @ref LL_GPIO_PIN_15
  458. * @param Pull This parameter can be one of the following values:
  459. * @arg @ref LL_GPIO_PULL_NO
  460. * @arg @ref LL_GPIO_PULL_UP
  461. * @arg @ref LL_GPIO_PULL_DOWN
  462. * @retval None
  463. */
  464. __STATIC_INLINE void LL_GPIO_SetPinPull(GPIO_TypeDef *GPIOx, uint32_t Pin, uint32_t Pull)
  465. {
  466. MODIFY_REG(GPIOx->PUPDR, (GPIO_PUPDR_PUPD0 << (POSITION_VAL(Pin) * 2U)), (Pull << (POSITION_VAL(Pin) * 2U)));
  467. }
  468. /**
  469. * @brief Return gpio pull-up or pull-down for a dedicated pin on a dedicated port
  470. * @note Warning: only one pin can be passed as parameter.
  471. * @rmtoll PUPDR PUPDy LL_GPIO_GetPinPull
  472. * @param GPIOx GPIO Port
  473. * @param Pin This parameter can be one of the following values:
  474. * @arg @ref LL_GPIO_PIN_0
  475. * @arg @ref LL_GPIO_PIN_1
  476. * @arg @ref LL_GPIO_PIN_2
  477. * @arg @ref LL_GPIO_PIN_3
  478. * @arg @ref LL_GPIO_PIN_4
  479. * @arg @ref LL_GPIO_PIN_5
  480. * @arg @ref LL_GPIO_PIN_6
  481. * @arg @ref LL_GPIO_PIN_7
  482. * @arg @ref LL_GPIO_PIN_8
  483. * @arg @ref LL_GPIO_PIN_9
  484. * @arg @ref LL_GPIO_PIN_10
  485. * @arg @ref LL_GPIO_PIN_11
  486. * @arg @ref LL_GPIO_PIN_12
  487. * @arg @ref LL_GPIO_PIN_13
  488. * @arg @ref LL_GPIO_PIN_14
  489. * @arg @ref LL_GPIO_PIN_15
  490. * @retval Returned value can be one of the following values:
  491. * @arg @ref LL_GPIO_PULL_NO
  492. * @arg @ref LL_GPIO_PULL_UP
  493. * @arg @ref LL_GPIO_PULL_DOWN
  494. */
  495. __STATIC_INLINE uint32_t LL_GPIO_GetPinPull(GPIO_TypeDef *GPIOx, uint32_t Pin)
  496. {
  497. return (uint32_t)(READ_BIT(GPIOx->PUPDR,
  498. (GPIO_PUPDR_PUPD0 << (POSITION_VAL(Pin) * 2U))) >> (POSITION_VAL(Pin) * 2U));
  499. }
  500. /**
  501. * @brief Configure gpio alternate function of a dedicated pin from 0 to 7 for a dedicated port.
  502. * @note Possible values are from AF0 to AF15 depending on target.
  503. * @note Warning: only one pin can be passed as parameter.
  504. * @rmtoll AFRL AFSELy LL_GPIO_SetAFPin_0_7
  505. * @param GPIOx GPIO Port
  506. * @param Pin This parameter can be one of the following values:
  507. * @arg @ref LL_GPIO_PIN_0
  508. * @arg @ref LL_GPIO_PIN_1
  509. * @arg @ref LL_GPIO_PIN_2
  510. * @arg @ref LL_GPIO_PIN_3
  511. * @arg @ref LL_GPIO_PIN_4
  512. * @arg @ref LL_GPIO_PIN_5
  513. * @arg @ref LL_GPIO_PIN_6
  514. * @arg @ref LL_GPIO_PIN_7
  515. * @param Alternate This parameter can be one of the following values:
  516. * @arg @ref LL_GPIO_AF_0
  517. * @arg @ref LL_GPIO_AF_1
  518. * @arg @ref LL_GPIO_AF_2
  519. * @arg @ref LL_GPIO_AF_3
  520. * @arg @ref LL_GPIO_AF_4
  521. * @arg @ref LL_GPIO_AF_5
  522. * @arg @ref LL_GPIO_AF_6
  523. * @arg @ref LL_GPIO_AF_7
  524. * @arg @ref LL_GPIO_AF_8
  525. * @arg @ref LL_GPIO_AF_9
  526. * @arg @ref LL_GPIO_AF_10
  527. * @arg @ref LL_GPIO_AF_11
  528. * @arg @ref LL_GPIO_AF_12
  529. * @arg @ref LL_GPIO_AF_13
  530. * @arg @ref LL_GPIO_AF_14
  531. * @arg @ref LL_GPIO_AF_15
  532. * @retval None
  533. */
  534. __STATIC_INLINE void LL_GPIO_SetAFPin_0_7(GPIO_TypeDef *GPIOx, uint32_t Pin, uint32_t Alternate)
  535. {
  536. MODIFY_REG(GPIOx->AFR[0], (GPIO_AFRL_AFSEL0 << (POSITION_VAL(Pin) * 4U)),
  537. (Alternate << (POSITION_VAL(Pin) * 4U)));
  538. }
  539. /**
  540. * @brief Return gpio alternate function of a dedicated pin from 0 to 7 for a dedicated port.
  541. * @rmtoll AFRL AFSELy LL_GPIO_GetAFPin_0_7
  542. * @param GPIOx GPIO Port
  543. * @param Pin This parameter can be one of the following values:
  544. * @arg @ref LL_GPIO_PIN_0
  545. * @arg @ref LL_GPIO_PIN_1
  546. * @arg @ref LL_GPIO_PIN_2
  547. * @arg @ref LL_GPIO_PIN_3
  548. * @arg @ref LL_GPIO_PIN_4
  549. * @arg @ref LL_GPIO_PIN_5
  550. * @arg @ref LL_GPIO_PIN_6
  551. * @arg @ref LL_GPIO_PIN_7
  552. * @retval Returned value can be one of the following values:
  553. * @arg @ref LL_GPIO_AF_0
  554. * @arg @ref LL_GPIO_AF_1
  555. * @arg @ref LL_GPIO_AF_2
  556. * @arg @ref LL_GPIO_AF_3
  557. * @arg @ref LL_GPIO_AF_4
  558. * @arg @ref LL_GPIO_AF_5
  559. * @arg @ref LL_GPIO_AF_6
  560. * @arg @ref LL_GPIO_AF_7
  561. * @arg @ref LL_GPIO_AF_8
  562. * @arg @ref LL_GPIO_AF_9
  563. * @arg @ref LL_GPIO_AF_10
  564. * @arg @ref LL_GPIO_AF_11
  565. * @arg @ref LL_GPIO_AF_12
  566. * @arg @ref LL_GPIO_AF_13
  567. * @arg @ref LL_GPIO_AF_14
  568. * @arg @ref LL_GPIO_AF_15
  569. */
  570. __STATIC_INLINE uint32_t LL_GPIO_GetAFPin_0_7(GPIO_TypeDef *GPIOx, uint32_t Pin)
  571. {
  572. return (uint32_t)(READ_BIT(GPIOx->AFR[0],
  573. (GPIO_AFRL_AFSEL0 << (POSITION_VAL(Pin) * 4U))) >> (POSITION_VAL(Pin) * 4U));
  574. }
  575. /**
  576. * @brief Configure gpio alternate function of a dedicated pin from 8 to 15 for a dedicated port.
  577. * @note Possible values are from AF0 to AF15 depending on target.
  578. * @note Warning: only one pin can be passed as parameter.
  579. * @rmtoll AFRH AFSELy LL_GPIO_SetAFPin_8_15
  580. * @param GPIOx GPIO Port
  581. * @param Pin This parameter can be one of the following values:
  582. * @arg @ref LL_GPIO_PIN_8
  583. * @arg @ref LL_GPIO_PIN_9
  584. * @arg @ref LL_GPIO_PIN_10
  585. * @arg @ref LL_GPIO_PIN_11
  586. * @arg @ref LL_GPIO_PIN_12
  587. * @arg @ref LL_GPIO_PIN_13
  588. * @arg @ref LL_GPIO_PIN_14
  589. * @arg @ref LL_GPIO_PIN_15
  590. * @param Alternate This parameter can be one of the following values:
  591. * @arg @ref LL_GPIO_AF_0
  592. * @arg @ref LL_GPIO_AF_1
  593. * @arg @ref LL_GPIO_AF_2
  594. * @arg @ref LL_GPIO_AF_3
  595. * @arg @ref LL_GPIO_AF_4
  596. * @arg @ref LL_GPIO_AF_5
  597. * @arg @ref LL_GPIO_AF_6
  598. * @arg @ref LL_GPIO_AF_7
  599. * @arg @ref LL_GPIO_AF_8
  600. * @arg @ref LL_GPIO_AF_9
  601. * @arg @ref LL_GPIO_AF_10
  602. * @arg @ref LL_GPIO_AF_11
  603. * @arg @ref LL_GPIO_AF_12
  604. * @arg @ref LL_GPIO_AF_13
  605. * @arg @ref LL_GPIO_AF_14
  606. * @arg @ref LL_GPIO_AF_15
  607. * @retval None
  608. */
  609. __STATIC_INLINE void LL_GPIO_SetAFPin_8_15(GPIO_TypeDef *GPIOx, uint32_t Pin, uint32_t Alternate)
  610. {
  611. MODIFY_REG(GPIOx->AFR[1], (GPIO_AFRH_AFSEL8 << (POSITION_VAL(Pin >> 8U) * 4U)),
  612. (Alternate << (POSITION_VAL(Pin >> 8U) * 4U)));
  613. }
  614. /**
  615. * @brief Return gpio alternate function of a dedicated pin from 8 to 15 for a dedicated port.
  616. * @note Possible values are from AF0 to AF15 depending on target.
  617. * @rmtoll AFRH AFSELy LL_GPIO_GetAFPin_8_15
  618. * @param GPIOx GPIO Port
  619. * @param Pin This parameter can be one of the following values:
  620. * @arg @ref LL_GPIO_PIN_8
  621. * @arg @ref LL_GPIO_PIN_9
  622. * @arg @ref LL_GPIO_PIN_10
  623. * @arg @ref LL_GPIO_PIN_11
  624. * @arg @ref LL_GPIO_PIN_12
  625. * @arg @ref LL_GPIO_PIN_13
  626. * @arg @ref LL_GPIO_PIN_14
  627. * @arg @ref LL_GPIO_PIN_15
  628. * @retval Returned value can be one of the following values:
  629. * @arg @ref LL_GPIO_AF_0
  630. * @arg @ref LL_GPIO_AF_1
  631. * @arg @ref LL_GPIO_AF_2
  632. * @arg @ref LL_GPIO_AF_3
  633. * @arg @ref LL_GPIO_AF_4
  634. * @arg @ref LL_GPIO_AF_5
  635. * @arg @ref LL_GPIO_AF_6
  636. * @arg @ref LL_GPIO_AF_7
  637. * @arg @ref LL_GPIO_AF_8
  638. * @arg @ref LL_GPIO_AF_9
  639. * @arg @ref LL_GPIO_AF_10
  640. * @arg @ref LL_GPIO_AF_11
  641. * @arg @ref LL_GPIO_AF_12
  642. * @arg @ref LL_GPIO_AF_13
  643. * @arg @ref LL_GPIO_AF_14
  644. * @arg @ref LL_GPIO_AF_15
  645. */
  646. __STATIC_INLINE uint32_t LL_GPIO_GetAFPin_8_15(GPIO_TypeDef *GPIOx, uint32_t Pin)
  647. {
  648. return (uint32_t)(READ_BIT(GPIOx->AFR[1],
  649. (GPIO_AFRH_AFSEL8 << (POSITION_VAL(Pin >> 8U) * 4U))) >> (POSITION_VAL(Pin >> 8U) * 4U));
  650. }
  651. #if defined(GPIO_ASCR_ASC0)
  652. /**
  653. * @brief Connect analog switch to ADC input of several pins for a dedicated port.
  654. * @note This bit must be set prior to the ADC conversion.
  655. * Only the IO which connected to the ADC input are effective.
  656. * Other IO must be kept reset value
  657. * @rmtoll ASCR ASCy LL_GPIO_EnablePinAnalogControl
  658. * @param GPIOx GPIO Port
  659. * @param PinMask This parameter can be a combination of the following values:
  660. * @arg @ref LL_GPIO_PIN_0
  661. * @arg @ref LL_GPIO_PIN_1
  662. * @arg @ref LL_GPIO_PIN_2
  663. * @arg @ref LL_GPIO_PIN_3
  664. * @arg @ref LL_GPIO_PIN_4
  665. * @arg @ref LL_GPIO_PIN_5
  666. * @arg @ref LL_GPIO_PIN_6
  667. * @arg @ref LL_GPIO_PIN_7
  668. * @arg @ref LL_GPIO_PIN_8
  669. * @arg @ref LL_GPIO_PIN_9
  670. * @arg @ref LL_GPIO_PIN_10
  671. * @arg @ref LL_GPIO_PIN_11
  672. * @arg @ref LL_GPIO_PIN_12
  673. * @arg @ref LL_GPIO_PIN_13
  674. * @arg @ref LL_GPIO_PIN_14
  675. * @arg @ref LL_GPIO_PIN_15
  676. * @arg @ref LL_GPIO_PIN_ALL
  677. * @retval None
  678. */
  679. __STATIC_INLINE void LL_GPIO_EnablePinAnalogControl(GPIO_TypeDef *GPIOx, uint32_t PinMask)
  680. {
  681. SET_BIT(GPIOx->ASCR, PinMask);
  682. }
  683. /**
  684. * @brief Disconnect analog switch to ADC input of several pins for a dedicated port.
  685. * @rmtoll ASCR ASCy LL_GPIO_DisablePinAnalogControl
  686. * @param GPIOx GPIO Port
  687. * @param PinMask This parameter can be a combination of the following values:
  688. * @arg @ref LL_GPIO_PIN_0
  689. * @arg @ref LL_GPIO_PIN_1
  690. * @arg @ref LL_GPIO_PIN_2
  691. * @arg @ref LL_GPIO_PIN_3
  692. * @arg @ref LL_GPIO_PIN_4
  693. * @arg @ref LL_GPIO_PIN_5
  694. * @arg @ref LL_GPIO_PIN_6
  695. * @arg @ref LL_GPIO_PIN_7
  696. * @arg @ref LL_GPIO_PIN_8
  697. * @arg @ref LL_GPIO_PIN_9
  698. * @arg @ref LL_GPIO_PIN_10
  699. * @arg @ref LL_GPIO_PIN_11
  700. * @arg @ref LL_GPIO_PIN_12
  701. * @arg @ref LL_GPIO_PIN_13
  702. * @arg @ref LL_GPIO_PIN_14
  703. * @arg @ref LL_GPIO_PIN_15
  704. * @arg @ref LL_GPIO_PIN_ALL
  705. * @retval None
  706. */
  707. __STATIC_INLINE void LL_GPIO_DisablePinAnalogControl(GPIO_TypeDef *GPIOx, uint32_t PinMask)
  708. {
  709. CLEAR_BIT(GPIOx->ASCR, PinMask);
  710. }
  711. #endif /* GPIO_ASCR_ASC0 */
  712. /**
  713. * @brief Lock configuration of several pins for a dedicated port.
  714. * @note When the lock sequence has been applied on a port bit, the
  715. * value of this port bit can no longer be modified until the
  716. * next reset.
  717. * @note Each lock bit freezes a specific configuration register
  718. * (control and alternate function registers).
  719. * @rmtoll LCKR LCKK LL_GPIO_LockPin
  720. * @param GPIOx GPIO Port
  721. * @param PinMask This parameter can be a combination of the following values:
  722. * @arg @ref LL_GPIO_PIN_0
  723. * @arg @ref LL_GPIO_PIN_1
  724. * @arg @ref LL_GPIO_PIN_2
  725. * @arg @ref LL_GPIO_PIN_3
  726. * @arg @ref LL_GPIO_PIN_4
  727. * @arg @ref LL_GPIO_PIN_5
  728. * @arg @ref LL_GPIO_PIN_6
  729. * @arg @ref LL_GPIO_PIN_7
  730. * @arg @ref LL_GPIO_PIN_8
  731. * @arg @ref LL_GPIO_PIN_9
  732. * @arg @ref LL_GPIO_PIN_10
  733. * @arg @ref LL_GPIO_PIN_11
  734. * @arg @ref LL_GPIO_PIN_12
  735. * @arg @ref LL_GPIO_PIN_13
  736. * @arg @ref LL_GPIO_PIN_14
  737. * @arg @ref LL_GPIO_PIN_15
  738. * @arg @ref LL_GPIO_PIN_ALL
  739. * @retval None
  740. */
  741. __STATIC_INLINE void LL_GPIO_LockPin(GPIO_TypeDef *GPIOx, uint32_t PinMask)
  742. {
  743. __IO uint32_t temp;
  744. WRITE_REG(GPIOx->LCKR, GPIO_LCKR_LCKK | PinMask);
  745. WRITE_REG(GPIOx->LCKR, PinMask);
  746. WRITE_REG(GPIOx->LCKR, GPIO_LCKR_LCKK | PinMask);
  747. temp = READ_REG(GPIOx->LCKR);
  748. (void) temp;
  749. }
  750. /**
  751. * @brief Return 1 if all pins passed as parameter, of a dedicated port, are locked. else Return 0.
  752. * @rmtoll LCKR LCKy LL_GPIO_IsPinLocked
  753. * @param GPIOx GPIO Port
  754. * @param PinMask This parameter can be a combination of the following values:
  755. * @arg @ref LL_GPIO_PIN_0
  756. * @arg @ref LL_GPIO_PIN_1
  757. * @arg @ref LL_GPIO_PIN_2
  758. * @arg @ref LL_GPIO_PIN_3
  759. * @arg @ref LL_GPIO_PIN_4
  760. * @arg @ref LL_GPIO_PIN_5
  761. * @arg @ref LL_GPIO_PIN_6
  762. * @arg @ref LL_GPIO_PIN_7
  763. * @arg @ref LL_GPIO_PIN_8
  764. * @arg @ref LL_GPIO_PIN_9
  765. * @arg @ref LL_GPIO_PIN_10
  766. * @arg @ref LL_GPIO_PIN_11
  767. * @arg @ref LL_GPIO_PIN_12
  768. * @arg @ref LL_GPIO_PIN_13
  769. * @arg @ref LL_GPIO_PIN_14
  770. * @arg @ref LL_GPIO_PIN_15
  771. * @arg @ref LL_GPIO_PIN_ALL
  772. * @retval State of bit (1 or 0).
  773. */
  774. __STATIC_INLINE uint32_t LL_GPIO_IsPinLocked(GPIO_TypeDef *GPIOx, uint32_t PinMask)
  775. {
  776. return (READ_BIT(GPIOx->LCKR, PinMask) == (PinMask));
  777. }
  778. /**
  779. * @brief Return 1 if one of the pin of a dedicated port is locked. else return 0.
  780. * @rmtoll LCKR LCKK LL_GPIO_IsAnyPinLocked
  781. * @param GPIOx GPIO Port
  782. * @retval State of bit (1 or 0).
  783. */
  784. __STATIC_INLINE uint32_t LL_GPIO_IsAnyPinLocked(GPIO_TypeDef *GPIOx)
  785. {
  786. return (READ_BIT(GPIOx->LCKR, GPIO_LCKR_LCKK) == (GPIO_LCKR_LCKK));
  787. }
  788. /**
  789. * @}
  790. */
  791. /** @defgroup GPIO_LL_EF_Data_Access Data Access
  792. * @{
  793. */
  794. /**
  795. * @brief Return full input data register value for a dedicated port.
  796. * @rmtoll IDR IDy LL_GPIO_ReadInputPort
  797. * @param GPIOx GPIO Port
  798. * @retval Input data register value of port
  799. */
  800. __STATIC_INLINE uint32_t LL_GPIO_ReadInputPort(GPIO_TypeDef *GPIOx)
  801. {
  802. return (uint32_t)(READ_REG(GPIOx->IDR));
  803. }
  804. /**
  805. * @brief Return if input data level for several pins of dedicated port is high or low.
  806. * @rmtoll IDR IDy LL_GPIO_IsInputPinSet
  807. * @param GPIOx GPIO Port
  808. * @param PinMask This parameter can be a combination of the following values:
  809. * @arg @ref LL_GPIO_PIN_0
  810. * @arg @ref LL_GPIO_PIN_1
  811. * @arg @ref LL_GPIO_PIN_2
  812. * @arg @ref LL_GPIO_PIN_3
  813. * @arg @ref LL_GPIO_PIN_4
  814. * @arg @ref LL_GPIO_PIN_5
  815. * @arg @ref LL_GPIO_PIN_6
  816. * @arg @ref LL_GPIO_PIN_7
  817. * @arg @ref LL_GPIO_PIN_8
  818. * @arg @ref LL_GPIO_PIN_9
  819. * @arg @ref LL_GPIO_PIN_10
  820. * @arg @ref LL_GPIO_PIN_11
  821. * @arg @ref LL_GPIO_PIN_12
  822. * @arg @ref LL_GPIO_PIN_13
  823. * @arg @ref LL_GPIO_PIN_14
  824. * @arg @ref LL_GPIO_PIN_15
  825. * @arg @ref LL_GPIO_PIN_ALL
  826. * @retval State of bit (1 or 0).
  827. */
  828. __STATIC_INLINE uint32_t LL_GPIO_IsInputPinSet(GPIO_TypeDef *GPIOx, uint32_t PinMask)
  829. {
  830. return (READ_BIT(GPIOx->IDR, PinMask) == (PinMask));
  831. }
  832. /**
  833. * @brief Write output data register for the port.
  834. * @rmtoll ODR ODy LL_GPIO_WriteOutputPort
  835. * @param GPIOx GPIO Port
  836. * @param PortValue Level value for each pin of the port
  837. * @retval None
  838. */
  839. __STATIC_INLINE void LL_GPIO_WriteOutputPort(GPIO_TypeDef *GPIOx, uint32_t PortValue)
  840. {
  841. WRITE_REG(GPIOx->ODR, PortValue);
  842. }
  843. /**
  844. * @brief Return full output data register value for a dedicated port.
  845. * @rmtoll ODR ODy LL_GPIO_ReadOutputPort
  846. * @param GPIOx GPIO Port
  847. * @retval Output data register value of port
  848. */
  849. __STATIC_INLINE uint32_t LL_GPIO_ReadOutputPort(GPIO_TypeDef *GPIOx)
  850. {
  851. return (uint32_t)(READ_REG(GPIOx->ODR));
  852. }
  853. /**
  854. * @brief Return if input data level for several pins of dedicated port is high or low.
  855. * @rmtoll ODR ODy LL_GPIO_IsOutputPinSet
  856. * @param GPIOx GPIO Port
  857. * @param PinMask This parameter can be a combination of the following values:
  858. * @arg @ref LL_GPIO_PIN_0
  859. * @arg @ref LL_GPIO_PIN_1
  860. * @arg @ref LL_GPIO_PIN_2
  861. * @arg @ref LL_GPIO_PIN_3
  862. * @arg @ref LL_GPIO_PIN_4
  863. * @arg @ref LL_GPIO_PIN_5
  864. * @arg @ref LL_GPIO_PIN_6
  865. * @arg @ref LL_GPIO_PIN_7
  866. * @arg @ref LL_GPIO_PIN_8
  867. * @arg @ref LL_GPIO_PIN_9
  868. * @arg @ref LL_GPIO_PIN_10
  869. * @arg @ref LL_GPIO_PIN_11
  870. * @arg @ref LL_GPIO_PIN_12
  871. * @arg @ref LL_GPIO_PIN_13
  872. * @arg @ref LL_GPIO_PIN_14
  873. * @arg @ref LL_GPIO_PIN_15
  874. * @arg @ref LL_GPIO_PIN_ALL
  875. * @retval State of bit (1 or 0).
  876. */
  877. __STATIC_INLINE uint32_t LL_GPIO_IsOutputPinSet(GPIO_TypeDef *GPIOx, uint32_t PinMask)
  878. {
  879. return (READ_BIT(GPIOx->ODR, PinMask) == (PinMask));
  880. }
  881. /**
  882. * @brief Set several pins to high level on dedicated gpio port.
  883. * @rmtoll BSRR BSy LL_GPIO_SetOutputPin
  884. * @param GPIOx GPIO Port
  885. * @param PinMask This parameter can be a combination of the following values:
  886. * @arg @ref LL_GPIO_PIN_0
  887. * @arg @ref LL_GPIO_PIN_1
  888. * @arg @ref LL_GPIO_PIN_2
  889. * @arg @ref LL_GPIO_PIN_3
  890. * @arg @ref LL_GPIO_PIN_4
  891. * @arg @ref LL_GPIO_PIN_5
  892. * @arg @ref LL_GPIO_PIN_6
  893. * @arg @ref LL_GPIO_PIN_7
  894. * @arg @ref LL_GPIO_PIN_8
  895. * @arg @ref LL_GPIO_PIN_9
  896. * @arg @ref LL_GPIO_PIN_10
  897. * @arg @ref LL_GPIO_PIN_11
  898. * @arg @ref LL_GPIO_PIN_12
  899. * @arg @ref LL_GPIO_PIN_13
  900. * @arg @ref LL_GPIO_PIN_14
  901. * @arg @ref LL_GPIO_PIN_15
  902. * @arg @ref LL_GPIO_PIN_ALL
  903. * @retval None
  904. */
  905. __STATIC_INLINE void LL_GPIO_SetOutputPin(GPIO_TypeDef *GPIOx, uint32_t PinMask)
  906. {
  907. WRITE_REG(GPIOx->BSRR, PinMask);
  908. }
  909. /**
  910. * @brief Set several pins to low level on dedicated gpio port.
  911. * @rmtoll BRR BRy LL_GPIO_ResetOutputPin
  912. * @param GPIOx GPIO Port
  913. * @param PinMask This parameter can be a combination of the following values:
  914. * @arg @ref LL_GPIO_PIN_0
  915. * @arg @ref LL_GPIO_PIN_1
  916. * @arg @ref LL_GPIO_PIN_2
  917. * @arg @ref LL_GPIO_PIN_3
  918. * @arg @ref LL_GPIO_PIN_4
  919. * @arg @ref LL_GPIO_PIN_5
  920. * @arg @ref LL_GPIO_PIN_6
  921. * @arg @ref LL_GPIO_PIN_7
  922. * @arg @ref LL_GPIO_PIN_8
  923. * @arg @ref LL_GPIO_PIN_9
  924. * @arg @ref LL_GPIO_PIN_10
  925. * @arg @ref LL_GPIO_PIN_11
  926. * @arg @ref LL_GPIO_PIN_12
  927. * @arg @ref LL_GPIO_PIN_13
  928. * @arg @ref LL_GPIO_PIN_14
  929. * @arg @ref LL_GPIO_PIN_15
  930. * @arg @ref LL_GPIO_PIN_ALL
  931. * @retval None
  932. */
  933. __STATIC_INLINE void LL_GPIO_ResetOutputPin(GPIO_TypeDef *GPIOx, uint32_t PinMask)
  934. {
  935. WRITE_REG(GPIOx->BRR, PinMask);
  936. }
  937. /**
  938. * @brief Toggle data value for several pin of dedicated port.
  939. * @rmtoll ODR ODy LL_GPIO_TogglePin
  940. * @param GPIOx GPIO Port
  941. * @param PinMask This parameter can be a combination of the following values:
  942. * @arg @ref LL_GPIO_PIN_0
  943. * @arg @ref LL_GPIO_PIN_1
  944. * @arg @ref LL_GPIO_PIN_2
  945. * @arg @ref LL_GPIO_PIN_3
  946. * @arg @ref LL_GPIO_PIN_4
  947. * @arg @ref LL_GPIO_PIN_5
  948. * @arg @ref LL_GPIO_PIN_6
  949. * @arg @ref LL_GPIO_PIN_7
  950. * @arg @ref LL_GPIO_PIN_8
  951. * @arg @ref LL_GPIO_PIN_9
  952. * @arg @ref LL_GPIO_PIN_10
  953. * @arg @ref LL_GPIO_PIN_11
  954. * @arg @ref LL_GPIO_PIN_12
  955. * @arg @ref LL_GPIO_PIN_13
  956. * @arg @ref LL_GPIO_PIN_14
  957. * @arg @ref LL_GPIO_PIN_15
  958. * @arg @ref LL_GPIO_PIN_ALL
  959. * @retval None
  960. */
  961. __STATIC_INLINE void LL_GPIO_TogglePin(GPIO_TypeDef *GPIOx, uint32_t PinMask)
  962. {
  963. WRITE_REG(GPIOx->ODR, READ_REG(GPIOx->ODR) ^ PinMask);
  964. }
  965. /**
  966. * @}
  967. */
  968. #if defined(USE_FULL_LL_DRIVER)
  969. /** @defgroup GPIO_LL_EF_Init Initialization and de-initialization functions
  970. * @{
  971. */
  972. ErrorStatus LL_GPIO_DeInit(GPIO_TypeDef *GPIOx);
  973. ErrorStatus LL_GPIO_Init(GPIO_TypeDef *GPIOx, LL_GPIO_InitTypeDef *GPIO_InitStruct);
  974. void LL_GPIO_StructInit(LL_GPIO_InitTypeDef *GPIO_InitStruct);
  975. /**
  976. * @}
  977. */
  978. #endif /* USE_FULL_LL_DRIVER */
  979. /**
  980. * @}
  981. */
  982. /**
  983. * @}
  984. */
  985. #endif /* defined (GPIOA) || defined (GPIOB) || defined (GPIOC) || defined (GPIOD) || defined (GPIOE) || defined (GPIOF) || defined (GPIOG) || defined (GPIOH) || defined (GPIOI) */
  986. /**
  987. * @}
  988. */
  989. #ifdef __cplusplus
  990. }
  991. #endif
  992. #endif /* __STM32L4xx_LL_GPIO_H */
  993. /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/