stm32l4xx_ll_gpio.h 39 KB

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