213 lines
8.4 KiB
C
213 lines
8.4 KiB
C
/**************************************************************************//**
|
|
* @file gpio.c
|
|
* @version V3.00
|
|
* @brief M261 series General Purpose I/O (GPIO) driver source file
|
|
*
|
|
* @note
|
|
* @copyright (C) 2019 Nuvoton Technology Corp. All rights reserved.
|
|
*
|
|
* Redistribution and use in source and binary forms, with or without modification,
|
|
* are permitted provided that the following conditions are met:
|
|
* 1. Redistributions of source code must retain the above copyright notice,
|
|
* this list of conditions and the following disclaimer.
|
|
* 2. Redistributions in binary form must reproduce the above copyright notice,
|
|
* this list of conditions and the following disclaimer in the documentation
|
|
* and/or other materials provided with the distribution.
|
|
* 3. Neither the name of Nuvoton Technology Corp. nor the names of its contributors
|
|
* may be used to endorse or promote products derived from this software
|
|
* without specific prior written permission.
|
|
*
|
|
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
|
|
* AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
|
* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
|
|
* DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
|
|
* FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
|
|
* DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
|
|
* SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
|
|
* CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
|
|
* OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
|
|
* OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
|
*****************************************************************************/
|
|
#include "NuMicro.h"
|
|
|
|
|
|
/** @addtogroup Standard_Driver Standard Driver
|
|
@{
|
|
*/
|
|
|
|
/** @addtogroup GPIO_Driver GPIO Driver
|
|
@{
|
|
*/
|
|
|
|
/** @addtogroup GPIO_EXPORTED_FUNCTIONS GPIO Exported Functions
|
|
@{
|
|
*/
|
|
|
|
/**
|
|
* @brief Set GPIO operation mode
|
|
*
|
|
* @param[in] port GPIO port. It could be PA, PB, PC, PD, PE, PF, PG or PH.
|
|
* @param[in] u32PinMask The single or multiple pins of specified GPIO port. \n
|
|
* It could be BIT0 ~ BIT15 for PA, PB and PE. \n
|
|
* It could be BIT0 ~ BIT13 for PC. \n
|
|
* It could be BIT0 ~ BIT14 for PD. \n
|
|
* It could be BIT0 ~ BIT11 for PF. \n
|
|
* It could be BIT2 ~ BIT3, BIT9 ~ BIT15 for PG. \n
|
|
* It could be BIT4 ~ BIT11 for PH.
|
|
* @param[in] u32Mode Operation mode. It could be
|
|
* - \ref GPIO_MODE_INPUT
|
|
* - \ref GPIO_MODE_OUTPUT
|
|
* - \ref GPIO_MODE_OPEN_DRAIN
|
|
* - \ref GPIO_MODE_QUASI
|
|
*
|
|
* @return None
|
|
*
|
|
* @details This function is used to set specified GPIO operation mode.
|
|
*/
|
|
void GPIO_SetMode(GPIO_T *port, uint32_t u32PinMask, uint32_t u32Mode)
|
|
{
|
|
uint32_t u32Idx;
|
|
|
|
for(u32Idx = 0ul; u32Idx < GPIO_PIN_MAX; u32Idx++)
|
|
{
|
|
if((u32PinMask & (1ul << u32Idx)) == (1ul << u32Idx))
|
|
{
|
|
port->MODE = (port->MODE & ~(0x3ul << (u32Idx << 1))) | (u32Mode << (u32Idx << 1));
|
|
}
|
|
}
|
|
}
|
|
|
|
/**
|
|
* @brief Enable GPIO interrupt
|
|
*
|
|
* @param[in] port GPIO port. It could be PA, PB, PC, PD, PE, PF, PG or PH.
|
|
* @param[in] u32Pin The pin of specified GPIO port. \n
|
|
* It could be 0 ~ 15 for PA, PB and PE. \n
|
|
* It could be 0 ~ 13 for PC GPIO port. \n
|
|
* It could be 0 ~ 14 for PD GPIO port. \n
|
|
* It could be 0 ~ 11 for PF GPIO port. \n
|
|
* It could be 2 ~ 4, 9 ~ 15 for PG GPIO port. \n
|
|
* It could be 4 ~ 11 for PH GPIO port.
|
|
* @param[in] u32IntAttribs The interrupt attribute of specified GPIO pin. It could be
|
|
* - \ref GPIO_INT_RISING
|
|
* - \ref GPIO_INT_FALLING
|
|
* - \ref GPIO_INT_BOTH_EDGE
|
|
* - \ref GPIO_INT_HIGH
|
|
* - \ref GPIO_INT_LOW
|
|
*
|
|
* @return None
|
|
*
|
|
* @details This function is used to enable specified GPIO pin interrupt.
|
|
*/
|
|
void GPIO_EnableInt(GPIO_T *port, uint32_t u32Pin, uint32_t u32IntAttribs)
|
|
{
|
|
/* Configure interrupt mode of specified pin */
|
|
port->INTTYPE |= (((u32IntAttribs >> 24) & 0xFFUL) << u32Pin);
|
|
|
|
/* Enable interrupt function of specified pin */
|
|
port->INTEN |= ((u32IntAttribs & 0xFFFFFFUL) << u32Pin);
|
|
}
|
|
|
|
|
|
/**
|
|
* @brief Disable GPIO interrupt
|
|
*
|
|
|
|
* @param[in] port GPIO port. It could be PA, PB, PC, PD, PE, PF, PG or PH.
|
|
* @param[in] u32Pin The pin of specified GPIO port. \n
|
|
* It could be 0 ~ 15 for PA, PB and PE. \n
|
|
* It could be 0 ~ 13 for PC GPIO port. \n
|
|
* It could be 0 ~ 14 for PD GPIO port. \n
|
|
* It could be 0 ~ 11 for PF GPIO port. \n
|
|
* It could be 2 ~ 4, 9 ~ 15 for PG GPIO port. \n
|
|
* It could be 4 ~ 11 for PH GPIO port.
|
|
*
|
|
* @return None
|
|
*
|
|
* @details This function is used to enable specified GPIO pin interrupt.
|
|
*/
|
|
void GPIO_DisableInt(GPIO_T *port, uint32_t u32Pin)
|
|
{
|
|
/* Configure interrupt mode of specified pin */
|
|
port->INTTYPE &= ~(1UL << u32Pin);
|
|
|
|
/* Disable interrupt function of specified pin */
|
|
port->INTEN &= ~((0x00010001UL) << u32Pin);
|
|
}
|
|
|
|
/**
|
|
* @brief Set GPIO slew rate control
|
|
*
|
|
|
|
* @param[in] port GPIO port. It could be PA, PB, PC, PD, PE, PF, PG or PH.
|
|
* @param[in] u32PinMask The single or multiple pins of specified GPIO port. \n
|
|
* It could be BIT0 ~ BIT15 for PA, PB and PE. \n
|
|
* It could be BIT0 ~ BIT13 for PC. \n
|
|
* It could be BIT0 ~ BIT14 for PD. \n
|
|
* It could be BIT0 ~ BIT11 for PF. \n
|
|
* It could be BIT2 ~ BIT3, BIT9 ~ BIT15 for PG. \n
|
|
* It could be BIT4 ~ BIT11 for PH.
|
|
* @param[in] u32Mode Slew rate mode. It could be
|
|
* - \ref GPIO_SLEWCTL_NORMAL (maximum 40 MHz at 2.7V)
|
|
* - \ref GPIO_SLEWCTL_HIGH (maximum 80 MHz at 2.7V)
|
|
* - \ref GPIO_SLEWCTL_FAST (maximum 100 MHz at 2.7V)
|
|
*
|
|
* @return None
|
|
*
|
|
* @details This function is used to set specified GPIO operation mode.
|
|
*/
|
|
void GPIO_SetSlewCtl(GPIO_T *port, uint32_t u32PinMask, uint32_t u32Mode)
|
|
{
|
|
uint32_t u32Idx;
|
|
|
|
for(u32Idx = 0ul; u32Idx < GPIO_PIN_MAX; u32Idx++)
|
|
{
|
|
if(u32PinMask & (1ul << u32Idx))
|
|
{
|
|
port->SLEWCTL = (port->SLEWCTL & ~(0x3ul << (u32Idx << 1))) | (u32Mode << (u32Idx << 1));
|
|
}
|
|
}
|
|
}
|
|
|
|
/**
|
|
* @brief Set GPIO Pull-up and Pull-down control
|
|
*
|
|
|
|
* @param[in] port GPIO port. It could be PA, PB, PC, PD, PE, PF, PG or PH.
|
|
* @param[in] u32PinMask The single or multiple pins of specified GPIO port. \n
|
|
* It could be BIT0 ~ BIT15 for PA, PB and PE. \n
|
|
* It could be BIT0 ~ BIT13 for PC. \n
|
|
* It could be BIT0 ~ BIT14 for PD. \n
|
|
* It could be BIT0 ~ BIT11 for PF. \n
|
|
* It could be BIT2 ~ BIT3, BIT9 ~ BIT15 for PG. \n
|
|
* It could be BIT4 ~ BIT11 for PH.
|
|
* @param[in] u32Mode The pin mode of specified GPIO pin. It could be
|
|
* - \ref GPIO_PUSEL_DISABLE
|
|
* - \ref GPIO_PUSEL_PULL_UP
|
|
* - \ref GPIO_PUSEL_PULL_DOWN
|
|
*
|
|
* @return None
|
|
*
|
|
* @details Set the pin mode of specified GPIO pin.
|
|
*/
|
|
void GPIO_SetPullCtl(GPIO_T *port, uint32_t u32PinMask, uint32_t u32Mode)
|
|
{
|
|
uint32_t u32Idx;
|
|
|
|
for(u32Idx = 0ul; u32Idx < GPIO_PIN_MAX; u32Idx++)
|
|
{
|
|
if(u32PinMask & (1ul << u32Idx))
|
|
{
|
|
port->PUSEL = (port->PUSEL & ~(0x3ul << (u32Idx << 1))) | (u32Mode << (u32Idx << 1));
|
|
}
|
|
}
|
|
}
|
|
|
|
/*@}*/ /* end of group GPIO_EXPORTED_FUNCTIONS */
|
|
|
|
/*@}*/ /* end of group GPIO_Driver */
|
|
|
|
/*@}*/ /* end of group Standard_Driver */
|
|
|
|
/*** (C) COPYRIGHT 2019 Nuvoton Technology Corp. ***/
|