You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
551 lines
19 KiB
C
551 lines
19 KiB
C
/**
|
|
******************************************************************************
|
|
* @file stm32g0xx_hal_gpio.c
|
|
* @author MCD Application Team
|
|
* @brief GPIO HAL module driver.
|
|
* This file provides firmware functions to manage the following
|
|
* functionalities of the General Purpose Input/Output (GPIO) peripheral:
|
|
* + Initialization and de-initialization functions
|
|
* + IO operation functions
|
|
*
|
|
******************************************************************************
|
|
* @attention
|
|
*
|
|
* Copyright (c) 2018 STMicroelectronics.
|
|
* All rights reserved.
|
|
*
|
|
* This software is licensed under terms that can be found in the LICENSE file
|
|
* in the root directory of this software component.
|
|
* If no LICENSE file comes with this software, it is provided AS-IS.
|
|
*
|
|
******************************************************************************
|
|
@verbatim
|
|
==============================================================================
|
|
##### GPIO Peripheral features #####
|
|
==============================================================================
|
|
[..]
|
|
(+) Each port bit of the general-purpose I/O (GPIO) ports can be individually
|
|
configured by software in several modes:
|
|
(++) Input mode
|
|
(++) Analog mode
|
|
(++) Output mode
|
|
(++) Alternate function mode
|
|
(++) External interrupt/event lines
|
|
|
|
(+) During and just after reset, the alternate functions and external interrupt
|
|
lines are not active and the I/O ports are configured in input floating mode.
|
|
|
|
(+) All GPIO pins have weak internal pull-up and pull-down resistors, which can be
|
|
activated or not.
|
|
|
|
(+) In Output or Alternate mode, each IO can be configured on open-drain or push-pull
|
|
type and the IO speed can be selected depending on the VDD value.
|
|
|
|
(+) The microcontroller IO pins are connected to onboard peripherals/modules through a
|
|
multiplexer that allows only one peripheral alternate function (AF) connected
|
|
to an IO pin at a time. In this way, there can be no conflict between peripherals
|
|
sharing the same IO pin.
|
|
|
|
(+) All ports have external interrupt/event capability. To use external interrupt
|
|
lines, the port must be configured in input mode. All available GPIO pins are
|
|
connected to the 16 external interrupt/event lines from EXTI0 to EXTI15.
|
|
|
|
(+) The external interrupt/event controller consists of up to 28 edge detectors
|
|
(16 lines are connected to GPIO) for generating event/interrupt requests (each
|
|
input line can be independently configured to select the type (interrupt or event)
|
|
and the corresponding trigger event (rising or falling or both). Each line can
|
|
also be masked independently.
|
|
|
|
##### How to use this driver #####
|
|
==============================================================================
|
|
[..]
|
|
(#) Enable the GPIO AHB clock using the following function: __HAL_RCC_GPIOx_CLK_ENABLE().
|
|
|
|
(#) Configure the GPIO pin(s) using HAL_GPIO_Init().
|
|
(++) Configure the IO mode using "Mode" member from GPIO_InitTypeDef structure
|
|
(++) Activate Pull-up, Pull-down resistor using "Pull" member from GPIO_InitTypeDef
|
|
structure.
|
|
(++) In case of Output or alternate function mode selection: the speed is
|
|
configured through "Speed" member from GPIO_InitTypeDef structure.
|
|
(++) In alternate mode is selection, the alternate function connected to the IO
|
|
is configured through "Alternate" member from GPIO_InitTypeDef structure.
|
|
(++) Analog mode is required when a pin is to be used as ADC channel
|
|
or DAC output.
|
|
(++) In case of external interrupt/event selection the "Mode" member from
|
|
GPIO_InitTypeDef structure select the type (interrupt or event) and
|
|
the corresponding trigger event (rising or falling or both).
|
|
|
|
(#) In case of external interrupt/event mode selection, configure NVIC IRQ priority
|
|
mapped to the EXTI line using HAL_NVIC_SetPriority() and enable it using
|
|
HAL_NVIC_EnableIRQ().
|
|
|
|
(#) To get the level of a pin configured in input mode use HAL_GPIO_ReadPin().
|
|
|
|
(#) To set/reset the level of a pin configured in output mode use
|
|
HAL_GPIO_WritePin()/HAL_GPIO_TogglePin().
|
|
|
|
(#) To lock pin configuration until next reset use HAL_GPIO_LockPin().
|
|
|
|
(#) During and just after reset, the alternate functions are not
|
|
active and the GPIO pins are configured in input floating mode (except JTAG
|
|
pins).
|
|
|
|
(#) The LSE oscillator pins OSC32_IN and OSC32_OUT can be used as general purpose
|
|
(PC14 and PC15, respectively) when the LSE oscillator is off. The LSE has
|
|
priority over the GPIO function.
|
|
|
|
(#) The HSE oscillator pins OSC_IN/OSC_OUT can be used as
|
|
general purpose PF0 and PF1, respectively, when the HSE oscillator is off.
|
|
The HSE has priority over the GPIO function.
|
|
|
|
@endverbatim
|
|
******************************************************************************
|
|
*/
|
|
|
|
/* Includes ------------------------------------------------------------------*/
|
|
#include "stm32g0xx_hal.h"
|
|
|
|
/** @addtogroup STM32G0xx_HAL_Driver
|
|
* @{
|
|
*/
|
|
|
|
/** @addtogroup GPIO
|
|
* @{
|
|
*/
|
|
/** MISRA C:2012 deviation rule has been granted for following rules:
|
|
* Rule-12.2 - Medium: RHS argument is in interval [0,INF] which is out of
|
|
* range of the shift operator in following API :
|
|
* HAL_GPIO_Init
|
|
* HAL_GPIO_DeInit
|
|
*/
|
|
|
|
#ifdef HAL_GPIO_MODULE_ENABLED
|
|
|
|
/* Private typedef -----------------------------------------------------------*/
|
|
/* Private defines ------------------------------------------------------------*/
|
|
/** @addtogroup GPIO_Private_Constants
|
|
* @{
|
|
*/
|
|
#define GPIO_NUMBER (16u)
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
/* Private macros ------------------------------------------------------------*/
|
|
/* Private variables ---------------------------------------------------------*/
|
|
/* Private function prototypes -----------------------------------------------*/
|
|
/* Exported functions --------------------------------------------------------*/
|
|
|
|
/** @addtogroup GPIO_Exported_Functions
|
|
* @{
|
|
*/
|
|
|
|
/** @addtogroup GPIO_Exported_Functions_Group1
|
|
* @brief Initialization and Configuration functions
|
|
*
|
|
@verbatim
|
|
===============================================================================
|
|
##### Initialization and de-initialization functions #####
|
|
===============================================================================
|
|
|
|
@endverbatim
|
|
* @{
|
|
*/
|
|
|
|
/**
|
|
* @brief Initialize the GPIOx peripheral according to the specified parameters in the GPIO_Init.
|
|
* @param GPIOx where x can be (A..F) to select the GPIO peripheral for STM32G0xx family
|
|
* @param GPIO_Init pointer to a GPIO_InitTypeDef structure that contains
|
|
* the configuration information for the specified GPIO peripheral.
|
|
* @retval None
|
|
*/
|
|
void HAL_GPIO_Init(GPIO_TypeDef *GPIOx, GPIO_InitTypeDef *GPIO_Init)
|
|
{
|
|
uint32_t position = 0x00u;
|
|
uint32_t iocurrent;
|
|
uint32_t temp;
|
|
|
|
/* Check the parameters */
|
|
assert_param(IS_GPIO_ALL_INSTANCE(GPIOx));
|
|
assert_param(IS_GPIO_PIN(GPIO_Init->Pin));
|
|
assert_param(IS_GPIO_MODE(GPIO_Init->Mode));
|
|
|
|
/* Configure the port pins */
|
|
while (((GPIO_Init->Pin) >> position) != 0x00u)
|
|
{
|
|
/* Get current io position */
|
|
iocurrent = (GPIO_Init->Pin) & (1uL << position);
|
|
|
|
if (iocurrent != 0x00u)
|
|
{
|
|
/*--------------------- GPIO Mode Configuration ------------------------*/
|
|
/* In case of Output or Alternate function mode selection */
|
|
if (((GPIO_Init->Mode & GPIO_MODE) == MODE_OUTPUT) || ((GPIO_Init->Mode & GPIO_MODE) == MODE_AF))
|
|
{
|
|
/* Check the Speed parameter */
|
|
assert_param(IS_GPIO_SPEED(GPIO_Init->Speed));
|
|
|
|
/* Configure the IO Speed */
|
|
temp = GPIOx->OSPEEDR;
|
|
temp &= ~(GPIO_OSPEEDR_OSPEED0 << (position * 2u));
|
|
temp |= (GPIO_Init->Speed << (position * 2u));
|
|
GPIOx->OSPEEDR = temp;
|
|
|
|
/* Configure the IO Output Type */
|
|
temp = GPIOx->OTYPER;
|
|
temp &= ~(GPIO_OTYPER_OT0 << position) ;
|
|
temp |= (((GPIO_Init->Mode & OUTPUT_TYPE) >> OUTPUT_TYPE_Pos) << position);
|
|
GPIOx->OTYPER = temp;
|
|
}
|
|
|
|
if ((GPIO_Init->Mode & GPIO_MODE) != MODE_ANALOG)
|
|
{
|
|
/* Check the Pull parameter */
|
|
assert_param(IS_GPIO_PULL(GPIO_Init->Pull));
|
|
|
|
/* Activate the Pull-up or Pull down resistor for the current IO */
|
|
temp = GPIOx->PUPDR;
|
|
temp &= ~(GPIO_PUPDR_PUPD0 << (position * 2u));
|
|
temp |= ((GPIO_Init->Pull) << (position * 2u));
|
|
GPIOx->PUPDR = temp;
|
|
}
|
|
|
|
/* In case of Alternate function mode selection */
|
|
if ((GPIO_Init->Mode & GPIO_MODE) == MODE_AF)
|
|
{
|
|
/* Check the Alternate function parameters */
|
|
assert_param(IS_GPIO_AF_INSTANCE(GPIOx));
|
|
assert_param(IS_GPIO_AF(GPIO_Init->Alternate));
|
|
|
|
/* Configure Alternate function mapped with the current IO */
|
|
temp = GPIOx->AFR[position >> 3u];
|
|
temp &= ~(0xFu << ((position & 0x07u) * 4u));
|
|
temp |= ((GPIO_Init->Alternate) << ((position & 0x07u) * 4u));
|
|
GPIOx->AFR[position >> 3u] = temp;
|
|
}
|
|
|
|
/* Configure IO Direction mode (Input, Output, Alternate or Analog) */
|
|
temp = GPIOx->MODER;
|
|
temp &= ~(GPIO_MODER_MODE0 << (position * 2u));
|
|
temp |= ((GPIO_Init->Mode & GPIO_MODE) << (position * 2u));
|
|
GPIOx->MODER = temp;
|
|
|
|
/*--------------------- EXTI Mode Configuration ------------------------*/
|
|
/* Configure the External Interrupt or event for the current IO */
|
|
if ((GPIO_Init->Mode & EXTI_MODE) != 0x00u)
|
|
{
|
|
temp = EXTI->EXTICR[position >> 2u];
|
|
temp &= ~(0x0FuL << (8u * (position & 0x03u)));
|
|
temp |= (GPIO_GET_INDEX(GPIOx) << (8u * (position & 0x03u)));
|
|
EXTI->EXTICR[position >> 2u] = temp;
|
|
|
|
/* Clear Rising Falling edge configuration */
|
|
temp = EXTI->RTSR1;
|
|
temp &= ~(iocurrent);
|
|
if ((GPIO_Init->Mode & TRIGGER_RISING) != 0x00u)
|
|
{
|
|
temp |= iocurrent;
|
|
}
|
|
EXTI->RTSR1 = temp;
|
|
|
|
temp = EXTI->FTSR1;
|
|
temp &= ~(iocurrent);
|
|
if ((GPIO_Init->Mode & TRIGGER_FALLING) != 0x00u)
|
|
{
|
|
temp |= iocurrent;
|
|
}
|
|
EXTI->FTSR1 = temp;
|
|
|
|
/* Clear EXTI line configuration */
|
|
temp = EXTI->EMR1;
|
|
temp &= ~(iocurrent);
|
|
if ((GPIO_Init->Mode & EXTI_EVT) != 0x00u)
|
|
{
|
|
temp |= iocurrent;
|
|
}
|
|
EXTI->EMR1 = temp;
|
|
|
|
temp = EXTI->IMR1;
|
|
temp &= ~(iocurrent);
|
|
if ((GPIO_Init->Mode & EXTI_IT) != 0x00u)
|
|
{
|
|
temp |= iocurrent;
|
|
}
|
|
EXTI->IMR1 = temp;
|
|
}
|
|
}
|
|
|
|
position++;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* @brief De-initialize the GPIOx peripheral registers to their default reset values.
|
|
* @param GPIOx where x can be (A..F) to select the GPIO peripheral for STM32G0xx family
|
|
* @param GPIO_Pin specifies the port bit to be written.
|
|
* This parameter can be any combination of GPIO_Pin_x where x can be (0..15).
|
|
* @retval None
|
|
*/
|
|
void HAL_GPIO_DeInit(GPIO_TypeDef *GPIOx, uint32_t GPIO_Pin)
|
|
{
|
|
uint32_t position = 0x00u;
|
|
uint32_t iocurrent;
|
|
uint32_t tmp;
|
|
|
|
/* Check the parameters */
|
|
assert_param(IS_GPIO_ALL_INSTANCE(GPIOx));
|
|
assert_param(IS_GPIO_PIN(GPIO_Pin));
|
|
|
|
/* Configure the port pins */
|
|
while ((GPIO_Pin >> position) != 0x00u)
|
|
{
|
|
/* Get current io position */
|
|
iocurrent = (GPIO_Pin) & (1uL << position);
|
|
|
|
if (iocurrent != 0x00u)
|
|
{
|
|
/*------------------------- EXTI Mode Configuration --------------------*/
|
|
/* Clear the External Interrupt or Event for the current IO */
|
|
|
|
tmp = EXTI->EXTICR[position >> 2u];
|
|
tmp &= (0x0FuL << (8u * (position & 0x03u)));
|
|
if (tmp == (GPIO_GET_INDEX(GPIOx) << (8u * (position & 0x03u))))
|
|
{
|
|
/* Clear EXTI line configuration */
|
|
EXTI->IMR1 &= ~(iocurrent);
|
|
EXTI->EMR1 &= ~(iocurrent);
|
|
|
|
/* Clear Rising Falling edge configuration */
|
|
EXTI->FTSR1 &= ~(iocurrent);
|
|
EXTI->RTSR1 &= ~(iocurrent);
|
|
|
|
tmp = 0x0FuL << (8u * (position & 0x03u));
|
|
EXTI->EXTICR[position >> 2u] &= ~tmp;
|
|
}
|
|
|
|
/*------------------------- GPIO Mode Configuration --------------------*/
|
|
/* Configure IO in Analog Mode */
|
|
GPIOx->MODER |= (GPIO_MODER_MODE0 << (position * 2u));
|
|
|
|
/* Configure the default Alternate Function in current IO */
|
|
GPIOx->AFR[position >> 3u] &= ~(0xFu << ((position & 0x07u) * 4u)) ;
|
|
|
|
/* Configure the default value for IO Speed */
|
|
GPIOx->OSPEEDR &= ~(GPIO_OSPEEDR_OSPEED0 << (position * 2u));
|
|
|
|
/* Configure the default value IO Output Type */
|
|
GPIOx->OTYPER &= ~(GPIO_OTYPER_OT0 << position) ;
|
|
|
|
/* Deactivate the Pull-up and Pull-down resistor for the current IO */
|
|
GPIOx->PUPDR &= ~(GPIO_PUPDR_PUPD0 << (position * 2u));
|
|
}
|
|
|
|
position++;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
/** @addtogroup GPIO_Exported_Functions_Group2
|
|
* @brief GPIO Read, Write, Toggle, Lock and EXTI management functions.
|
|
*
|
|
@verbatim
|
|
===============================================================================
|
|
##### IO operation functions #####
|
|
===============================================================================
|
|
|
|
@endverbatim
|
|
* @{
|
|
*/
|
|
|
|
/**
|
|
* @brief Read the specified input port pin.
|
|
* @param GPIOx where x can be (A..F) to select the GPIO peripheral for STM32G0xx family
|
|
* @param GPIO_Pin specifies the port bit to read.
|
|
* This parameter can be any combination of GPIO_Pin_x where x can be (0..15).
|
|
* @retval The input port pin value.
|
|
*/
|
|
GPIO_PinState HAL_GPIO_ReadPin(GPIO_TypeDef *GPIOx, uint16_t GPIO_Pin)
|
|
{
|
|
GPIO_PinState bitstatus;
|
|
|
|
/* Check the parameters */
|
|
assert_param(IS_GPIO_PIN(GPIO_Pin));
|
|
|
|
if ((GPIOx->IDR & GPIO_Pin) != 0x00u)
|
|
{
|
|
bitstatus = GPIO_PIN_SET;
|
|
}
|
|
else
|
|
{
|
|
bitstatus = GPIO_PIN_RESET;
|
|
}
|
|
return bitstatus;
|
|
}
|
|
|
|
/**
|
|
* @brief Set or clear the selected data port bit.
|
|
*
|
|
* @note This function uses GPIOx_BSRR and GPIOx_BRR registers to allow atomic read/modify
|
|
* accesses. In this way, there is no risk of an IRQ occurring between
|
|
* the read and the modify access.
|
|
*
|
|
* @param GPIOx where x can be (A..F) to select the GPIO peripheral for STM32G0xx family
|
|
* @param GPIO_Pin specifies the port bit to be written.
|
|
* This parameter can be any combination of GPIO_Pin_x where x can be (0..15).
|
|
* @param PinState specifies the value to be written to the selected bit.
|
|
* This parameter can be one of the GPIO_PinState enum values:
|
|
* @arg GPIO_PIN_RESET: to clear the port pin
|
|
* @arg GPIO_PIN_SET: to set the port pin
|
|
* @retval None
|
|
*/
|
|
void HAL_GPIO_WritePin(GPIO_TypeDef *GPIOx, uint16_t GPIO_Pin, GPIO_PinState PinState)
|
|
{
|
|
/* Check the parameters */
|
|
assert_param(IS_GPIO_PIN(GPIO_Pin));
|
|
assert_param(IS_GPIO_PIN_ACTION(PinState));
|
|
|
|
if (PinState != GPIO_PIN_RESET)
|
|
{
|
|
GPIOx->BSRR = (uint32_t)GPIO_Pin;
|
|
}
|
|
else
|
|
{
|
|
GPIOx->BRR = (uint32_t)GPIO_Pin;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* @brief Toggle the specified GPIO pin.
|
|
* @param GPIOx where x can be (A..F) to select the GPIO peripheral for STM32G0xx family
|
|
* @param GPIO_Pin specifies the pin to be toggled.
|
|
* This parameter can be any combination of GPIO_Pin_x where x can be (0..15).
|
|
* @retval None
|
|
*/
|
|
void HAL_GPIO_TogglePin(GPIO_TypeDef *GPIOx, uint16_t GPIO_Pin)
|
|
{
|
|
uint32_t odr;
|
|
|
|
/* Check the parameters */
|
|
assert_param(IS_GPIO_PIN(GPIO_Pin));
|
|
|
|
/* get current Output Data Register value */
|
|
odr = GPIOx->ODR;
|
|
|
|
/* Set selected pins that were at low level, and reset ones that were high */
|
|
GPIOx->BSRR = ((odr & GPIO_Pin) << GPIO_NUMBER) | (~odr & GPIO_Pin);
|
|
}
|
|
|
|
/**
|
|
* @brief Lock GPIO Pins configuration registers.
|
|
* @note The locked registers are GPIOx_MODER, GPIOx_OTYPER, GPIOx_OSPEEDR,
|
|
* GPIOx_PUPDR, GPIOx_AFRL and GPIOx_AFRH.
|
|
* @note The configuration of the locked GPIO pins can no longer be modified
|
|
* until the next reset.
|
|
* @param GPIOx where x can be (A..F) to select the GPIO peripheral for STM32G0xx family
|
|
* @param GPIO_Pin specifies the port bits to be locked.
|
|
* This parameter can be any combination of GPIO_Pin_x where x can be (0..15).
|
|
* @retval None
|
|
*/
|
|
HAL_StatusTypeDef HAL_GPIO_LockPin(GPIO_TypeDef *GPIOx, uint16_t GPIO_Pin)
|
|
{
|
|
__IO uint32_t tmp = GPIO_LCKR_LCKK;
|
|
|
|
/* Check the parameters */
|
|
assert_param(IS_GPIO_LOCK_INSTANCE(GPIOx));
|
|
assert_param(IS_GPIO_PIN(GPIO_Pin));
|
|
|
|
/* Apply lock key write sequence */
|
|
tmp |= GPIO_Pin;
|
|
/* Set LCKx bit(s): LCKK='1' + LCK[15-0] */
|
|
GPIOx->LCKR = tmp;
|
|
/* Reset LCKx bit(s): LCKK='0' + LCK[15-0] */
|
|
GPIOx->LCKR = GPIO_Pin;
|
|
/* Set LCKx bit(s): LCKK='1' + LCK[15-0] */
|
|
GPIOx->LCKR = tmp;
|
|
/* Read LCKK register. This read is mandatory to complete key lock sequence */
|
|
tmp = GPIOx->LCKR;
|
|
|
|
/* read again in order to confirm lock is active */
|
|
if ((GPIOx->LCKR & GPIO_LCKR_LCKK) != 0x00u)
|
|
{
|
|
return HAL_OK;
|
|
}
|
|
else
|
|
{
|
|
return HAL_ERROR;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* @brief Handle EXTI interrupt request.
|
|
* @param GPIO_Pin Specifies the port pin connected to corresponding EXTI line.
|
|
* @retval None
|
|
*/
|
|
void HAL_GPIO_EXTI_IRQHandler(uint16_t GPIO_Pin)
|
|
{
|
|
/* EXTI line interrupt detected */
|
|
if (__HAL_GPIO_EXTI_GET_RISING_IT(GPIO_Pin) != 0x00u)
|
|
{
|
|
__HAL_GPIO_EXTI_CLEAR_RISING_IT(GPIO_Pin);
|
|
HAL_GPIO_EXTI_Rising_Callback(GPIO_Pin);
|
|
}
|
|
|
|
if (__HAL_GPIO_EXTI_GET_FALLING_IT(GPIO_Pin) != 0x00u)
|
|
{
|
|
__HAL_GPIO_EXTI_CLEAR_FALLING_IT(GPIO_Pin);
|
|
HAL_GPIO_EXTI_Falling_Callback(GPIO_Pin);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* @brief EXTI line detection callback.
|
|
* @param GPIO_Pin Specifies the port pin connected to corresponding EXTI line.
|
|
* @retval None
|
|
*/
|
|
__weak void HAL_GPIO_EXTI_Rising_Callback(uint16_t GPIO_Pin)
|
|
{
|
|
/* Prevent unused argument(s) compilation warning */
|
|
UNUSED(GPIO_Pin);
|
|
|
|
/* NOTE: This function should not be modified, when the callback is needed,
|
|
the HAL_GPIO_EXTI_Rising_Callback could be implemented in the user file
|
|
*/
|
|
}
|
|
|
|
/**
|
|
* @brief EXTI line detection callback.
|
|
* @param GPIO_Pin Specifies the port pin connected to corresponding EXTI line.
|
|
* @retval None
|
|
*/
|
|
__weak void HAL_GPIO_EXTI_Falling_Callback(uint16_t GPIO_Pin)
|
|
{
|
|
/* Prevent unused argument(s) compilation warning */
|
|
UNUSED(GPIO_Pin);
|
|
|
|
/* NOTE: This function should not be modified, when the callback is needed,
|
|
the HAL_GPIO_EXTI_Falling_Callback could be implemented in the user file
|
|
*/
|
|
}
|
|
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
#endif /* HAL_GPIO_MODULE_ENABLED */
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
/**
|
|
* @}
|
|
*/
|
|
|