Subversion Repositories DashDisplay

Rev

Rev 56 | Blame | Compare with Previous | Last modification | View Log | Download | RSS feed

  1. /**
  2.   ******************************************************************************
  3.   * @file    stm32l1xx_ll_gpio.c
  4.   * @author  MCD Application Team
  5.   * @brief   GPIO LL module driver.
  6.   ******************************************************************************
  7.   * @attention
  8.   *
  9.   * <h2><center>&copy; Copyright (c) 2017 STMicroelectronics.
  10.   * All rights reserved.</center></h2>
  11.   *
  12.   * This software component is licensed by ST under BSD 3-Clause license,
  13.   * the "License"; You may not use this file except in compliance with the
  14.   * License. You may obtain a copy of the License at:
  15.   *                        opensource.org/licenses/BSD-3-Clause
  16.   *
  17.   ******************************************************************************
  18.   */
  19. #if defined(USE_FULL_LL_DRIVER)
  20.  
  21. /* Includes ------------------------------------------------------------------*/
  22. #include "stm32l1xx_ll_gpio.h"
  23. #include "stm32l1xx_ll_bus.h"
  24. #ifdef  USE_FULL_ASSERT
  25. #include "stm32_assert.h"
  26. #else
  27. #define assert_param(expr) ((void)0U)
  28. #endif
  29.  
  30. /** @addtogroup STM32L1xx_LL_Driver
  31.   * @{
  32.   */
  33.  
  34. #if defined (GPIOA) || defined (GPIOB) || defined (GPIOC) || defined (GPIOD) || defined (GPIOE) || defined (GPIOF) || defined (GPIOG) || defined (GPIOH)
  35.  
  36. /** @addtogroup GPIO_LL
  37.   * @{
  38.   */
  39.  
  40. /* Private types -------------------------------------------------------------*/
  41. /* Private variables ---------------------------------------------------------*/
  42. /* Private constants ---------------------------------------------------------*/
  43. /* Private macros ------------------------------------------------------------*/
  44. /** @addtogroup GPIO_LL_Private_Macros
  45.   * @{
  46.   */
  47. #define IS_LL_GPIO_PIN(__VALUE__)          (((0x00000000U) < (__VALUE__)) && ((__VALUE__) <= (LL_GPIO_PIN_ALL)))
  48.  
  49. #define IS_LL_GPIO_MODE(__VALUE__)         (((__VALUE__) == LL_GPIO_MODE_INPUT)     ||\
  50.                                             ((__VALUE__) == LL_GPIO_MODE_OUTPUT)    ||\
  51.                                             ((__VALUE__) == LL_GPIO_MODE_ALTERNATE) ||\
  52.                                             ((__VALUE__) == LL_GPIO_MODE_ANALOG))
  53.  
  54. #define IS_LL_GPIO_OUTPUT_TYPE(__VALUE__)  (((__VALUE__) == LL_GPIO_OUTPUT_PUSHPULL)  ||\
  55.                                             ((__VALUE__) == LL_GPIO_OUTPUT_OPENDRAIN))
  56.  
  57. #define IS_LL_GPIO_SPEED(__VALUE__)        (((__VALUE__) == LL_GPIO_SPEED_FREQ_LOW)       ||\
  58.                                             ((__VALUE__) == LL_GPIO_SPEED_FREQ_MEDIUM)    ||\
  59.                                             ((__VALUE__) == LL_GPIO_SPEED_FREQ_HIGH)      ||\
  60.                                             ((__VALUE__) == LL_GPIO_SPEED_FREQ_VERY_HIGH))
  61.  
  62. #define IS_LL_GPIO_PULL(__VALUE__)         (((__VALUE__) == LL_GPIO_PULL_NO)   ||\
  63.                                             ((__VALUE__) == LL_GPIO_PULL_UP)   ||\
  64.                                             ((__VALUE__) == LL_GPIO_PULL_DOWN))
  65.  
  66. #define IS_LL_GPIO_ALTERNATE(__VALUE__)    (((__VALUE__) == LL_GPIO_AF_0  )   ||\
  67.                                             ((__VALUE__) == LL_GPIO_AF_1  )   ||\
  68.                                             ((__VALUE__) == LL_GPIO_AF_2  )   ||\
  69.                                             ((__VALUE__) == LL_GPIO_AF_3  )   ||\
  70.                                             ((__VALUE__) == LL_GPIO_AF_4  )   ||\
  71.                                             ((__VALUE__) == LL_GPIO_AF_5  )   ||\
  72.                                             ((__VALUE__) == LL_GPIO_AF_6  )   ||\
  73.                                             ((__VALUE__) == LL_GPIO_AF_7  )   ||\
  74.                                             ((__VALUE__) == LL_GPIO_AF_8  )   ||\
  75.                                             ((__VALUE__) == LL_GPIO_AF_9  )   ||\
  76.                                             ((__VALUE__) == LL_GPIO_AF_10 )   ||\
  77.                                             ((__VALUE__) == LL_GPIO_AF_11 )   ||\
  78.                                             ((__VALUE__) == LL_GPIO_AF_12 )   ||\
  79.                                             ((__VALUE__) == LL_GPIO_AF_13 )   ||\
  80.                                             ((__VALUE__) == LL_GPIO_AF_14 )   ||\
  81.                                             ((__VALUE__) == LL_GPIO_AF_15 ))
  82. /**
  83.   * @}
  84.   */
  85.  
  86. /* Private function prototypes -----------------------------------------------*/
  87.  
  88. /* Exported functions --------------------------------------------------------*/
  89. /** @addtogroup GPIO_LL_Exported_Functions
  90.   * @{
  91.   */
  92.  
  93. /** @addtogroup GPIO_LL_EF_Init
  94.   * @{
  95.   */
  96.  
  97. /**
  98.   * @brief  De-initialize GPIO registers (Registers restored to their default values).
  99.   * @param  GPIOx GPIO Port
  100.   * @retval An ErrorStatus enumeration value:
  101.   *          - SUCCESS: GPIO registers are de-initialized
  102.   *          - ERROR:   Wrong GPIO Port
  103.   */
  104. ErrorStatus LL_GPIO_DeInit(GPIO_TypeDef *GPIOx)
  105. {
  106.   ErrorStatus status = SUCCESS;
  107.  
  108.   /* Check the parameters */
  109.   assert_param(IS_GPIO_ALL_INSTANCE(GPIOx));
  110.  
  111.   /* Force and Release reset on clock of GPIOx Port */
  112.   if (GPIOx == GPIOA)
  113.   {
  114.     LL_AHB1_GRP1_ForceReset(LL_AHB1_GRP1_PERIPH_GPIOA);
  115.     LL_AHB1_GRP1_ReleaseReset(LL_AHB1_GRP1_PERIPH_GPIOA);
  116.   }
  117.   else if (GPIOx == GPIOB)
  118.   {
  119.     LL_AHB1_GRP1_ForceReset(LL_AHB1_GRP1_PERIPH_GPIOB);
  120.     LL_AHB1_GRP1_ReleaseReset(LL_AHB1_GRP1_PERIPH_GPIOB);
  121.   }
  122.   else if (GPIOx == GPIOC)
  123.   {
  124.     LL_AHB1_GRP1_ForceReset(LL_AHB1_GRP1_PERIPH_GPIOC);
  125.     LL_AHB1_GRP1_ReleaseReset(LL_AHB1_GRP1_PERIPH_GPIOC);
  126.   }
  127. #if defined(GPIOD)
  128.   else if (GPIOx == GPIOD)
  129.   {
  130.     LL_AHB1_GRP1_ForceReset(LL_AHB1_GRP1_PERIPH_GPIOD);
  131.     LL_AHB1_GRP1_ReleaseReset(LL_AHB1_GRP1_PERIPH_GPIOD);
  132.   }
  133. #endif /* GPIOD */
  134. #if defined(GPIOE)
  135.   else if (GPIOx == GPIOE)
  136.   {
  137.     LL_AHB1_GRP1_ForceReset(LL_AHB1_GRP1_PERIPH_GPIOE);
  138.     LL_AHB1_GRP1_ReleaseReset(LL_AHB1_GRP1_PERIPH_GPIOE);
  139.   }
  140. #endif /* GPIOE */
  141. #if defined(GPIOF)
  142.   else if (GPIOx == GPIOF)
  143.   {
  144.     LL_AHB1_GRP1_ForceReset(LL_AHB1_GRP1_PERIPH_GPIOF);
  145.     LL_AHB1_GRP1_ReleaseReset(LL_AHB1_GRP1_PERIPH_GPIOF);
  146.   }
  147. #endif /* GPIOF */
  148. #if defined(GPIOG)
  149.   else if (GPIOx == GPIOG)
  150.   {
  151.     LL_AHB1_GRP1_ForceReset(LL_AHB1_GRP1_PERIPH_GPIOG);
  152.     LL_AHB1_GRP1_ReleaseReset(LL_AHB1_GRP1_PERIPH_GPIOG);
  153.   }
  154. #endif /* GPIOG */
  155. #if defined(GPIOH)
  156.   else if (GPIOx == GPIOH)
  157.   {
  158.     LL_AHB1_GRP1_ForceReset(LL_AHB1_GRP1_PERIPH_GPIOH);
  159.     LL_AHB1_GRP1_ReleaseReset(LL_AHB1_GRP1_PERIPH_GPIOH);
  160.   }
  161. #endif /* GPIOH */
  162.   else
  163.   {
  164.     status = ERROR;
  165.   }
  166.  
  167.   return (status);
  168. }
  169.  
  170. /**
  171.   * @brief  Initialize GPIO registers according to the specified parameters in GPIO_InitStruct.
  172.   * @param  GPIOx GPIO Port
  173.   * @param  GPIO_InitStruct pointer to a @ref LL_GPIO_InitTypeDef structure
  174.   *         that contains the configuration information for the specified GPIO peripheral.
  175.   * @retval An ErrorStatus enumeration value:
  176.   *          - SUCCESS: GPIO registers are initialized according to GPIO_InitStruct content
  177.   *          - ERROR:   Not applicable
  178.   */
  179. ErrorStatus LL_GPIO_Init(GPIO_TypeDef *GPIOx, LL_GPIO_InitTypeDef *GPIO_InitStruct)
  180. {
  181.   uint32_t pinpos     = 0x00000000U;
  182.   uint32_t currentpin = 0x00000000U;
  183.  
  184.   /* Check the parameters */
  185.   assert_param(IS_GPIO_ALL_INSTANCE(GPIOx));
  186.   assert_param(IS_LL_GPIO_PIN(GPIO_InitStruct->Pin));
  187.   assert_param(IS_LL_GPIO_MODE(GPIO_InitStruct->Mode));
  188.   assert_param(IS_LL_GPIO_PULL(GPIO_InitStruct->Pull));
  189.  
  190.   /* ------------------------- Configure the port pins ---------------- */
  191.   /* Initialize  pinpos on first pin set */
  192.   pinpos = POSITION_VAL(GPIO_InitStruct->Pin);
  193.  
  194.   /* Configure the port pins */
  195.   while (((GPIO_InitStruct->Pin) >> pinpos) != 0x00000000U)
  196.   {
  197.     /* Get current io position */
  198.     currentpin = (GPIO_InitStruct->Pin) & (0x00000001U << pinpos);
  199.  
  200.     if (currentpin)
  201.     {
  202.  
  203.       if ((GPIO_InitStruct->Mode == LL_GPIO_MODE_OUTPUT) || (GPIO_InitStruct->Mode == LL_GPIO_MODE_ALTERNATE))
  204.       {
  205.         /* Check Speed mode parameters */
  206.         assert_param(IS_LL_GPIO_SPEED(GPIO_InitStruct->Speed));
  207.  
  208.         /* Speed mode configuration */
  209.         LL_GPIO_SetPinSpeed(GPIOx, currentpin, GPIO_InitStruct->Speed);
  210.  
  211.         /* Check Output mode parameters */
  212.         assert_param(IS_LL_GPIO_OUTPUT_TYPE(GPIO_InitStruct->OutputType));
  213.  
  214.         /* Output mode configuration*/
  215.         LL_GPIO_SetPinOutputType(GPIOx, currentpin, GPIO_InitStruct->OutputType);
  216.       }
  217.  
  218.       /* Pull-up Pull down resistor configuration*/
  219.       LL_GPIO_SetPinPull(GPIOx, currentpin, GPIO_InitStruct->Pull);
  220.  
  221.       if (GPIO_InitStruct->Mode == LL_GPIO_MODE_ALTERNATE)
  222.       {
  223.         /* Check Alternate parameter */
  224.         assert_param(IS_LL_GPIO_ALTERNATE(GPIO_InitStruct->Alternate));
  225.  
  226.         /* Speed mode configuration */
  227.         if (POSITION_VAL(currentpin) < 0x00000008U)
  228.         {
  229.           LL_GPIO_SetAFPin_0_7(GPIOx, currentpin, GPIO_InitStruct->Alternate);
  230.         }
  231.         else
  232.         {
  233.           LL_GPIO_SetAFPin_8_15(GPIOx, currentpin, GPIO_InitStruct->Alternate);
  234.         }
  235.       }
  236.  
  237.       /* Pin Mode configuration */
  238.       LL_GPIO_SetPinMode(GPIOx, currentpin, GPIO_InitStruct->Mode);
  239.     }
  240.     pinpos++;
  241.   }
  242.  
  243.   return (SUCCESS);
  244. }
  245.  
  246. /**
  247.   * @brief Set each @ref LL_GPIO_InitTypeDef field to default value.
  248.   * @param GPIO_InitStruct: pointer to a @ref LL_GPIO_InitTypeDef structure
  249.   *                          whose fields will be set to default values.
  250.   * @retval None
  251.   */
  252.  
  253. void LL_GPIO_StructInit(LL_GPIO_InitTypeDef *GPIO_InitStruct)
  254. {
  255.   /* Reset GPIO init structure parameters values */
  256.   GPIO_InitStruct->Pin        = LL_GPIO_PIN_ALL;
  257.   GPIO_InitStruct->Mode       = LL_GPIO_MODE_ANALOG;
  258.   GPIO_InitStruct->Speed      = LL_GPIO_SPEED_FREQ_LOW;
  259.   GPIO_InitStruct->OutputType = LL_GPIO_OUTPUT_PUSHPULL;
  260.   GPIO_InitStruct->Pull       = LL_GPIO_PULL_NO;
  261.   GPIO_InitStruct->Alternate  = LL_GPIO_AF_0;
  262. }
  263.  
  264. /**
  265.   * @}
  266.   */
  267.  
  268. /**
  269.   * @}
  270.   */
  271.  
  272. /**
  273.   * @}
  274.   */
  275.  
  276. #endif /* defined (GPIOA) || defined (GPIOB) || defined (GPIOC) || defined (GPIOD) || defined (GPIOE) || defined (GPIOF) || defined (GPIOG) || defined (GPIOH) */
  277.  
  278. /**
  279.   * @}
  280.   */
  281.  
  282. #endif /* USE_FULL_LL_DRIVER */
  283.  
  284. /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/
  285.