rt-thread-official/bsp/samd21/sam_d2x_asflib/sam0/drivers/gpio/gpio.c

589 lines
17 KiB
C

/**
* \file
*
* \brief SAM GPIO Driver for SAMB11
*
* Copyright (C) 2015-2016 Atmel Corporation. All rights reserved.
*
* \asf_license_start
*
* \page License
*
* 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. The name of Atmel may not be used to endorse or promote products derived
* from this software without specific prior written permission.
*
* 4. This software may only be redistributed and used in connection with an
* Atmel microcontroller product.
*
* THIS SOFTWARE IS PROVIDED BY ATMEL "AS IS" AND ANY EXPRESS OR IMPLIED
* WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
* MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT ARE
* EXPRESSLY AND SPECIFICALLY DISCLAIMED. IN NO EVENT SHALL ATMEL 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.
*
* \asf_license_stop
*
*/
/*
* Support and FAQ: visit <a href="http://www.atmel.com/design-support/">Atmel Support</a>
*/
#include <gpio.h>
/**
* \internal
* Internal driver device instance struct.
*/
struct gpio_module _gpio_instances[3];
static void (*aon_handle_ext_wakeup_isr)(void) = (void (*)(void))0x1bc51;
/**
* \brief Initializes a gpio pin/group configuration structure to defaults.
*
* Initializes a given gpio pin/group configuration structure to a set of
* known default values. This function should be called on all new
* instances of these configuration structures before being modified by the
* user application.
*
* The default configuration is as follows:
* \li Input mode with internal pullup enabled
*
* \param[out] config Configuration structure to initialize to default values.
*/
void gpio_get_config_defaults(struct gpio_config *const config)
{
/* Default configuration values */
config->direction = GPIO_PIN_DIR_INPUT;
config->input_pull = GPIO_PIN_PULL_UP;
config->powersave = false;
config->aon_wakeup = false;
}
/**
* \brief Writes a gpio pin configuration to the hardware module.
*
* Writes out a given configuration of a gpio pin configuration to the hardware
* module. If the configuration is NULL then it releases the gpio pin.
*
* \note If the pin direction is set as an output, the pull-up/pull-down input
* configuration setting is ignored. Also certain gpio pin is used by
* FW and not available for user application. Please \ref gpio_pin
* for list of gpio_pin available.
*
* \param[in] gpio_pin Index of the GPIO pin to configure.
* \param[in] config Configuration settings for the pin.
*
* \return Status of initialization.
* \retval STATUS_OK gpio configured correctly
* \retval STATUS_ERR_INVALID_ARG Invalid gpio number, Certain gpios
* are used by FW and not allowed to change.
* \retval STATUS_RESOURCE_NOT_AVAILABLE Requested gpio is already in use.
*
*/
enum status_code gpio_pin_set_config(const uint8_t gpio_pin,
const struct gpio_config *config)
{
enum status_code status = STATUS_OK;
/* Following GPIO's should never be modified by user.
* GPIO_0 & GPIO_1 are used for SWD.
*/
if ((gpio_pin == PIN_LP_GPIO_0) || \
(gpio_pin == PIN_LP_GPIO_1))
{
status = STATUS_ERR_INVALID_ARG;
} else {
if (gpio_pin <= 7) {
LPMCU_MISC_REGS0->PINMUX_SEL_0.reg &= ~(7 << ((gpio_pin % 8) * 4));
} else if (gpio_pin <= 15) {
LPMCU_MISC_REGS0->PINMUX_SEL_1.reg &= ~(7 << ((gpio_pin % 8) * 4));
} else if (gpio_pin <= 23) {
LPMCU_MISC_REGS0->PINMUX_SEL_2.reg &= ~(7 << ((gpio_pin % 8) * 4));
} else if (44 <= gpio_pin && gpio_pin < 48) {
/* Set GPIO_MSx as digital mode */
AON_GP_REGS0->MS_GPIO_MODE.vec.ANALOG_ENABLE_ &= ~(1 << (gpio_pin - PIN_GPIO_MS4));
}
if ((gpio_pin == PIN_AO_GPIO_0) || (gpio_pin == PIN_AO_GPIO_1) ||
(gpio_pin == PIN_AO_GPIO_2)) {
/* Active Low, Always On Pull Enable Control */
if (config->input_pull == GPIO_PIN_PULL_UP) {
AON_GP_REGS0->AON_PULL_ENABLE.reg &= ~(1 << (31 - gpio_pin));
} else {
AON_GP_REGS0->AON_PULL_ENABLE.reg |= 1 << (31 - gpio_pin);
}
if (config->aon_wakeup) {
/* Enable AON_GPIO_x to be a wakeup MCU from sleep mode */
AON_GP_REGS0->AON_PINMUX_SEL.reg |= 1 << (4 * (31 - gpio_pin));
/* Enable AON_GPIO_x to wake up the BLE domain from sleep mode */
AON_PWR_SEQ0->GPIO_WAKEUP_CTRL.bit.BLE_ENABLE = 1;
}
} else {
if(config->direction == GPIO_PIN_DIR_INPUT) {
if(gpio_pin < 16) {
GPIO0->OUTENCLR.reg = (1 << gpio_pin);
} else if (gpio_pin < 32){
GPIO1->OUTENCLR.reg = (1 << (gpio_pin % 16));
} else {
GPIO2->OUTENCLR.reg = (1 << (gpio_pin % 16));
}
/* pull_enable. */
if (gpio_pin < 32) {
switch(config->input_pull) {
case GPIO_PIN_PULL_NONE:
LPMCU_MISC_REGS0->PULL_ENABLE.reg |= (1 << gpio_pin);
break;
case GPIO_PIN_PULL_UP:
LPMCU_MISC_REGS0->PULL_ENABLE.reg &= ~(1 << gpio_pin);
break;
case GPIO_PIN_PULL_DOWN:
/* Set R-Type */
LPMCU_MISC_REGS0->RTYPE_PAD_0.reg |= (1 << gpio_pin);
/* Set REN */
LPMCU_MISC_REGS0->PULL_ENABLE.reg &= ~(1 << gpio_pin);
break;
default:
status = STATUS_ERR_INVALID_ARG;
break;
}
}
} else if(config->direction == GPIO_PIN_DIR_OUTPUT) {
if (gpio_pin < 16) {
GPIO0->OUTENSET.reg = (1 << gpio_pin);
} else if (gpio_pin < 32) {
GPIO1->OUTENSET.reg = (1 << (gpio_pin % 16));
} else {
GPIO2->OUTENSET.reg = (1 << (gpio_pin % 16));
}
}
}
}
return status;
}
/**
* \brief Retrieves the state of a gpio pin that is configured as an input.
*
* Reads the current logic level of a gpio pin and returns the current
* level as a boolean value.
*
* \param[in] gpio_pin Index of the GPIO pin to read.
*
* \return Status of the gpio pin's input buffer.
*/
bool gpio_pin_get_input_level(const uint8_t gpio_pin)
{
uint32_t regval = 0;
if (gpio_pin < 16) {
regval = GPIO0->DATA.reg;
regval &= (1 << gpio_pin);
} else if (gpio_pin < 32) {
regval = GPIO1->DATA.reg;
regval &= (1 << (gpio_pin % 16));
} else {
regval = GPIO2->DATA.reg;
regval &= (1 << (gpio_pin % 16));
}
return regval;
}
/**
* \brief Retrieves the state of a gpio pin that is configured as an output.
*
* Reads the current logical output level of a gpio pin and returns the current
* level as a boolean value.
*
* \param[in] gpio_pin Index of the GPIO pin to read.
*
* \return Status of the gpio pin's output buffer.
*/
bool gpio_pin_get_output_level(const uint8_t gpio_pin)
{
uint32_t regval = 0;
if (gpio_pin < 16) {
regval = GPIO0->DATAOUT.reg;
regval &= (1 << gpio_pin);
} else if (gpio_pin < 32) {
regval = GPIO1->DATAOUT.reg;
regval &= (1 << (gpio_pin % 16));
} else {
regval = GPIO2->DATAOUT.reg;
regval &= (1 << (gpio_pin % 16));
}
return regval;
}
/**
* \brief Sets the state of a gpio pin that is configured as an output.
*
* Sets the current output level of a gpio pin to a given logic level.
*
* \param[in] gpio_pin Index of the GPIO pin to write to.
* \param[in] level Logical level to set the given pin to.
*/
void gpio_pin_set_output_level(const uint8_t gpio_pin, const bool level)
{
if (gpio_pin < 16) {
if(level) {
GPIO0->DATAOUT.reg |= (1 << gpio_pin);
} else {
GPIO0->DATAOUT.reg &= ~(1 << gpio_pin);
}
} else if (gpio_pin < 32) {
if(level) {
GPIO1->DATAOUT.reg |= (1 << (gpio_pin % 16));
} else {
GPIO1->DATAOUT.reg &= ~(1 << (gpio_pin % 16));
}
} else {
if(level) {
GPIO2->DATAOUT.reg |= (1 << (gpio_pin % 16));
} else {
GPIO2->DATAOUT.reg &= ~(1 << (gpio_pin % 16));
}
}
}
/**
* \brief Toggles the state of a gpio pin that is configured as an output.
*
* Toggles the current output level of a gpio pin.
*
* \param[in] gpio_pin Index of the GPIO pin to toggle.
*/
void gpio_pin_toggle_output_level(const uint8_t gpio_pin)
{
if (gpio_pin < 16) {
GPIO0->DATAOUT.reg ^= (1 << gpio_pin);
} else if (gpio_pin < 32) {
GPIO1->DATAOUT.reg ^= (1 << (gpio_pin % 16));
} else {
GPIO2->DATAOUT.reg ^= (1 << (gpio_pin % 16));
}
}
/**
* \brief Writes a GPIO pin configuration to the hardware module.
*
* Writes out a given configuration of a GPIO pin configuration to the hardware
* module.
*
* \param[in] gpio_pin Index of the GPIO pin to toggle.
* \param[in] pinmux_sel PINMUX selection.
*/
void gpio_pinmux_cofiguration(const uint8_t gpio_pin, uint16_t pinmux_sel)
{
uint8_t megamux_sel = (pinmux_sel >> 8) & 0xFF;
pinmux_sel &= 0xFF;
if (gpio_pin <= 7) {
LPMCU_MISC_REGS0->PINMUX_SEL_0.reg &= ~(7 << ((gpio_pin % 8) * 4));
LPMCU_MISC_REGS0->PINMUX_SEL_0.reg |= (pinmux_sel << ((gpio_pin % 8)*4));
if (pinmux_sel == 0x01) {
if (gpio_pin <= 3) {
LPMCU_MISC_REGS0->MEGA_MUX_IO_SEL_0.reg &= ~(0x3F << ((gpio_pin % 4) * 8));
LPMCU_MISC_REGS0->MEGA_MUX_IO_SEL_0.reg |= (megamux_sel << ((gpio_pin % 4) * 8));
} else if (gpio_pin <= 7) {
LPMCU_MISC_REGS0->MEGA_MUX_IO_SEL_1.reg &= ~(0x3F << ((gpio_pin % 4) * 8));
LPMCU_MISC_REGS0->MEGA_MUX_IO_SEL_1.reg |= (megamux_sel << ((gpio_pin % 4) * 8));
}
}
} else if (gpio_pin <= 15) {
LPMCU_MISC_REGS0->PINMUX_SEL_1.reg &= ~(7 << ((gpio_pin % 8) * 4));
LPMCU_MISC_REGS0->PINMUX_SEL_1.reg |= (pinmux_sel << ((gpio_pin % 8)*4));
if (pinmux_sel == 0x01) {
if (gpio_pin <= 11) {
LPMCU_MISC_REGS0->MEGA_MUX_IO_SEL_2.reg &= ~(0x3F << ((gpio_pin % 4) * 8));
LPMCU_MISC_REGS0->MEGA_MUX_IO_SEL_2.reg |= (megamux_sel << ((gpio_pin % 4) * 8));
} else if (gpio_pin <= 15) {
LPMCU_MISC_REGS0->MEGA_MUX_IO_SEL_3.reg &= ~(0x3F << ((gpio_pin % 4) * 8));
LPMCU_MISC_REGS0->MEGA_MUX_IO_SEL_3.reg |= (megamux_sel << ((gpio_pin % 4) * 8));
}
}
} else if (gpio_pin <= 23) {
LPMCU_MISC_REGS0->PINMUX_SEL_2.reg &= ~(7 << ((gpio_pin % 8) * 4));
LPMCU_MISC_REGS0->PINMUX_SEL_2.reg |= (pinmux_sel << ((gpio_pin % 8)*4));
if (pinmux_sel == 0x01) {
if (gpio_pin <= 19) {
LPMCU_MISC_REGS0->MEGA_MUX_IO_SEL_4.reg &= ~(0x3F << ((gpio_pin % 4) * 8));
LPMCU_MISC_REGS0->MEGA_MUX_IO_SEL_4.reg |= (megamux_sel << ((gpio_pin % 4) * 8));
} else if (gpio_pin <= 23) {
LPMCU_MISC_REGS0->MEGA_MUX_IO_SEL_5.reg &= ~(0x3F << ((gpio_pin % 4) * 8));
LPMCU_MISC_REGS0->MEGA_MUX_IO_SEL_5.reg |= (megamux_sel << ((gpio_pin % 4) * 8));
}
}
}
}
/**
* \brief Registers a callback
*
* Registers a callback function which is implemented by the user.
*
* \note The callback must be enabled by \ref gpio_enable_callback,
* in order for the interrupt handler to call it when the conditions for
* the callback type are met.
*
* \param[in] gpio_pin GPIO pin number
* \param[in] callback_func Pointer to callback function
* \param[in] callback_type Callback type given by an enum
*
*/
void gpio_register_callback(uint8_t gpio_pin, gpio_callback_t callback_func,
enum gpio_callback callback_type)
{
/* Sanity check arguments */
Assert(callback_func);
Assert(gpio_pin < 48);
uint8_t gpio_port = 0;
if (gpio_pin < 16) {
gpio_port = 0;
} else if (gpio_pin < 32) {
gpio_port = 1;
} else {
gpio_port = 2;
}
switch (callback_type) {
case GPIO_CALLBACK_LOW:
_gpio_instances[gpio_port].hw->INTTYPECLR.reg = 1 << (gpio_pin % 16);
_gpio_instances[gpio_port].hw->INTPOLCLR.reg = 1 << (gpio_pin % 16);
break;
case GPIO_CALLBACK_HIGH:
_gpio_instances[gpio_port].hw->INTTYPECLR.reg = 1 << (gpio_pin % 16);
_gpio_instances[gpio_port].hw->INTPOLSET.reg = 1 << (gpio_pin % 16);
break;
case GPIO_CALLBACK_RISING:
_gpio_instances[gpio_port].hw->INTTYPESET.reg = 1 << (gpio_pin % 16);
_gpio_instances[gpio_port].hw->INTPOLSET.reg = 1 << (gpio_pin % 16);
break;
case GPIO_CALLBACK_FALLING:
_gpio_instances[gpio_port].hw->INTTYPESET.reg = 1 << (gpio_pin % 16);
_gpio_instances[gpio_port].hw->INTPOLCLR.reg = (1 << (gpio_pin % 16));
break;
case GPIO_CALLBACK_N:
break;
}
/* Register callback function */
_gpio_instances[gpio_port].callback[gpio_pin % 16] = callback_func;
/* Set the bit corresponding to the gpio pin */
_gpio_instances[gpio_port].callback_reg_mask |= (1 << (gpio_pin % 16));
}
/**
* \brief Unregisters a callback
*
* Unregisters a callback function which is implemented by the user.
*
*
* \param[in] gpio_pin GPIO pin number
* \param[in] callback_type Callback type given by an enum
*
*/
void gpio_unregister_callback(uint8_t gpio_pin,
enum gpio_callback callback_type)
{
/* Sanity check arguments */
Assert(callback_func);
Assert(gpio_pin < 48);
uint8_t gpio_port = 0;
if (gpio_pin < 16) {
gpio_port = 0;
} else if (gpio_pin < 32) {
gpio_port = 1;
} else {
gpio_port = 2;
}
/* Unregister callback function */
_gpio_instances[gpio_port].callback[gpio_pin % 16] = NULL;
/* Set the bit corresponding to the gpio pin */
_gpio_instances[gpio_port].callback_reg_mask &= ~(1 << (gpio_pin % 16));
}
/**
* \brief Enables callback
*
* Enables the callback function registered by the \ref gpio_register_callback.
* The callback function will be called from the interrupt handler when the
* conditions for the callback type are met.
*
* \param[in] gpio_pin GPIO pin
*/
void gpio_enable_callback(uint8_t gpio_pin)
{
Assert(gpio_pin < 48);
uint8_t gpio_port = 0;
if (gpio_pin < 16) {
gpio_port = 0;
NVIC_EnableIRQ(GPIO0_IRQn);
} else if (gpio_pin < 32) {
gpio_port = 1;
NVIC_EnableIRQ(GPIO1_IRQn);
} else {
gpio_port = 2;
NVIC_EnableIRQ(GPIO2_IRQn);
}
/* Enable callback */
_gpio_instances[gpio_port].callback_enable_mask |= (1 << (gpio_pin % 16));
_gpio_instances[gpio_port].hw->INTENSET.reg = (1 << (gpio_pin % 16));
}
/**
* \brief Disables callback
*
* Disables the callback function registered by the \ref usart_register_callback.
* The callback function will not be called from the interrupt handler.
*
* \param[in] gpio_pin GPIO pin
*/
void gpio_disable_callback(uint8_t gpio_pin)
{
Assert(gpio_pin < 48);
uint8_t gpio_port = 0;
if (gpio_pin < 16) {
gpio_port = 0;
} else if (gpio_pin < 32) {
gpio_port = 1;
} else {
gpio_port = 2;
}
/* Enable callback */
_gpio_instances[gpio_port].callback_enable_mask &= ~(1 << (gpio_pin % 16));
_gpio_instances[gpio_port].hw->INTENCLR.reg = (1 << (gpio_pin % 16));
}
/**
* \internal GPIO port0 isr handler.
*
* This function will enter interrupt.
*
*/
static void gpio_port0_isr_handler(void)
{
uint32_t flag = _gpio_instances[0].hw->INTSTATUSCLEAR.reg;
for (uint8_t i = 0; i < 16; i++){
if (flag & (1 << i)) {
/* Clear interrupt flag */
_gpio_instances[0].hw->INTSTATUSCLEAR.reg = (1 << i);
if ((_gpio_instances[0].callback_enable_mask & (1 << i)) && \
(_gpio_instances[0].callback_reg_mask & (1 << i)))
_gpio_instances[0].callback[i]();
break;
}
}
NVIC_ClearPendingIRQ(GPIO0_IRQn);
}
/**
* \internal GPIO port1 isr handler.
*
* This function will enter interrupt.
*
*/
static void gpio_port1_isr_handler(void)
{
uint32_t flag = _gpio_instances[1].hw->INTSTATUSCLEAR.reg;
for (uint8_t i = 0; i < 16; i++){
/* For AON wakeup pin clear interrupt */
if (flag & ((1<<15) | (1<<14) | (1<<13))) {
aon_handle_ext_wakeup_isr();
}
if (flag & (1 << i)) {
/* Clear interrupt flag */
_gpio_instances[1].hw->INTSTATUSCLEAR.reg = (1 << i);
if ((_gpio_instances[1].callback_enable_mask & (1 << i)) && \
(_gpio_instances[1].callback_reg_mask & (1 << i))) {
_gpio_instances[1].callback[i]();
break;
}
}
}
NVIC_ClearPendingIRQ(GPIO1_IRQn);
}
/**
* \internal GPIO port2 isr handler.
*
* This function will enter interrupt.
*
*/
static void gpio_port2_isr_handler(void)
{
uint32_t flag = _gpio_instances[2].hw->INTSTATUSCLEAR.reg;
for (uint8_t i = 12; i < 16; i++){
if (flag & (1 << i)) {
/* Clear interrupt flag */
_gpio_instances[2].hw->INTSTATUSCLEAR.reg = (1 << i);
if ((_gpio_instances[2].callback_enable_mask & (1 << i)) && \
(_gpio_instances[2].callback_reg_mask & (1 << i)))
_gpio_instances[2].callback[i]();
break;
}
}
NVIC_ClearPendingIRQ(GPIO2_IRQn);
}
/**
* \internal GPIO callback init.
*
* This function will init GPIO callback.
*
*/
void gpio_init(void)
{
uint8_t i, j;
for(i = 0; i < 3; i++) {
for(j = 0; j < 16; j++) {
_gpio_instances[i].callback[j] = NULL;
}
_gpio_instances[i].callback_enable_mask = 0;
_gpio_instances[i].callback_reg_mask = 0;
}
_gpio_instances[0].hw = (void *)GPIO0;
_gpio_instances[1].hw = (void *)GPIO1;
_gpio_instances[2].hw = (void *)GPIO2;
system_register_isr(RAM_ISR_TABLE_PORT0_COMB_INDEX, (uint32_t)gpio_port0_isr_handler);
system_register_isr(RAM_ISR_TABLE_PORT1_COMB_INDEX, (uint32_t)gpio_port1_isr_handler);
system_register_isr(RAM_ISR_TABLE_PORT2_COMB_INDEX, (uint32_t)gpio_port2_isr_handler);
}