/**************************************************************************** * arch/arm/src/stm32f0l0g0/stm32_gpio.c * * Licensed to the Apache Software Foundation (ASF) under one or more * contributor license agreements. See the NOTICE file distributed with * this work for additional information regarding copyright ownership. The * ASF licenses this file to you under the Apache License, Version 2.0 (the * "License"); you may not use this file except in compliance with the * License. You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the * License for the specific language governing permissions and limitations * under the License. * ****************************************************************************/ /**************************************************************************** * Included Files ****************************************************************************/ #include #include #include #include #include #include #include #include #include "arm_arch.h" #include "chip.h" #include "stm32_gpio.h" #if defined(CONFIG_STM32F0L0G0_HAVE_IP_EXTI_V1) # include "hardware/stm32_syscfg.h" #elif defined(CONFIG_STM32F0L0G0_HAVE_IP_EXTI_V2) # include "hardware/stm32_exti.h" #endif /**************************************************************************** * Public Data ****************************************************************************/ /* Base addresses for each GPIO block */ const uint32_t g_gpiobase[STM32_NPORTS] = { #if STM32_NPORTS > 0 STM32_GPIOA_BASE, /* One GPIO ports, GPIOA */ #endif #if STM32_NPORTS > 1 STM32_GPIOB_BASE, /* Two GPIO ports, GPIOA-B */ #endif #if STM32_NPORTS > 2 STM32_GPIOC_BASE, /* Three GPIO ports, GPIOA-C */ #endif #if STM32_NPORTS > 3 STM32_GPIOD_BASE, /* Four GPIO ports, GPIOA-D */ #endif #if defined(STM32_GPIOE_BASE) STM32_GPIOE_BASE, /* GPIOE */ #endif #if defined(STM32_GPIOF_BASE) STM32_GPIOF_BASE, /* GPIOF */ #endif #if defined(STM32_GPIOH_BASE) STM32_GPIOH_BASE, /* GPIOH */ #endif }; /**************************************************************************** * Public Functions ****************************************************************************/ /**************************************************************************** * Function: stm32_gpioinit * * Description: * Based on configuration within the .config file, it does: * - Remaps positions of alternative functions. * * Typically called from stm32_start(). * * Assumptions: * This function is called early in the initialization sequence so that * no mutual exclusion is necessary. * ****************************************************************************/ void stm32_gpioinit(void) { } /**************************************************************************** * Name: stm32_configgpio * * Description: * Configure a GPIO pin based on bit-encoded description of the pin. * Once it is configured as Alternative (GPIO_ALT|GPIO_CNF_AFPP|...) * function, it must be unconfigured with stm32_unconfiggpio() with * the same cfgset first before it can be set to non-alternative function. * * Returned Value: * OK on success * A negated errno value on invalid port, or when pin is locked as ALT * function. * * To-Do: Auto Power Enable ****************************************************************************/ int stm32_configgpio(uint32_t cfgset) { uintptr_t base; uint32_t regval; uint32_t setting; unsigned int regoffset; unsigned int port; unsigned int pin; unsigned int pos; unsigned int pinmode; irqstate_t flags; /* Verify that this hardware supports the select GPIO port */ port = (cfgset & GPIO_PORT_MASK) >> GPIO_PORT_SHIFT; if (port >= STM32_NPORTS) { return -EINVAL; } /* Get the port base address */ base = g_gpiobase[port]; /* Get the pin number and select the port configuration register for that * pin */ pin = (cfgset & GPIO_PIN_MASK) >> GPIO_PIN_SHIFT; /* Set up the mode register (and remember whether the pin mode) */ switch (cfgset & GPIO_MODE_MASK) { default: case GPIO_INPUT: /* Input mode */ pinmode = GPIO_MODER_INPUT; break; case GPIO_OUTPUT: /* General purpose output mode */ stm32_gpiowrite(cfgset, (cfgset & GPIO_OUTPUT_SET) != 0); /* Set the initial output value */ pinmode = GPIO_MODER_OUTPUT; break; case GPIO_ALT: /* Alternate function mode */ pinmode = GPIO_MODER_ALT; break; case GPIO_ANALOG: /* Analog mode */ pinmode = GPIO_MODER_ANALOG; break; } /* Interrupts must be disabled from here on out so that we have mutually * exclusive access to all of the GPIO configuration registers. */ flags = enter_critical_section(); /* Now apply the configuration to the mode register */ regval = getreg32(base + STM32_GPIO_MODER_OFFSET); regval &= ~GPIO_MODER_MASK(pin); regval |= ((uint32_t)pinmode << GPIO_MODER_SHIFT(pin)); putreg32(regval, base + STM32_GPIO_MODER_OFFSET); /* Set up the pull-up/pull-down configuration (all but analog pins) */ setting = GPIO_PUPDR_NONE; if (pinmode != GPIO_MODER_ANALOG) { switch (cfgset & GPIO_PUPD_MASK) { default: case GPIO_FLOAT: /* No pull-up, pull-down */ break; case GPIO_PULLUP: /* Pull-up */ setting = GPIO_PUPDR_PULLUP; break; case GPIO_PULLDOWN: /* Pull-down */ setting = GPIO_PUPDR_PULLDOWN; break; } } regval = getreg32(base + STM32_GPIO_PUPDR_OFFSET); regval &= ~GPIO_PUPDR_MASK(pin); regval |= (setting << GPIO_PUPDR_SHIFT(pin)); putreg32(regval, base + STM32_GPIO_PUPDR_OFFSET); /* Set the alternate function (Only alternate function pins) */ if (pinmode == GPIO_MODER_ALT) { setting = (cfgset & GPIO_AF_MASK) >> GPIO_AF_SHIFT; } else { setting = 0; } if (pin < 8) { regoffset = STM32_GPIO_AFRL_OFFSET; pos = pin; } else { regoffset = STM32_GPIO_AFRH_OFFSET; pos = pin - 8; } regval = getreg32(base + regoffset); regval &= ~GPIO_AFR_MASK(pos); regval |= (setting << GPIO_AFR_SHIFT(pos)); putreg32(regval, base + regoffset); /* Set speed (Only outputs and alternate function pins) */ if (pinmode == GPIO_MODER_OUTPUT || pinmode == GPIO_MODER_ALT) { switch (cfgset & GPIO_SPEED_MASK) { default: #if defined(STM32_GPIO_VERY_LOW_SPEED) case GPIO_SPPED_VERYLOW: /* Very Low speed output */ setting = GPIO_OSPEED_VERYLOW; break; case GPIO_SPEED_LOW: /* Low speed output */ setting = GPIO_OSPEED_LOW; break; case GPIO_SPEED_MEDIUM: /* Medium speed output */ setting = GPIO_OSPEED_MEDIUM; break; case GPIO_SPEED_HIGH: /* High speed output */ setting = GPIO_OSPEED_HIGH; break; #else case GPIO_SPEED_LOW: /* Low speed output */ setting = GPIO_OSPEED_LOW; break; case GPIO_SPEED_MEDIUM: /* Medium speed output */ setting = GPIO_OSPEED_MEDIUM; break; case GPIO_SPEED_HIGH: /* High speed output */ setting = GPIO_OSPEED_HIGH; break; #endif } } else { setting = 0; } regval = getreg32(base + STM32_GPIO_OSPEED_OFFSET); regval &= ~GPIO_OSPEED_MASK(pin); regval |= (setting << GPIO_OSPEED_SHIFT(pin)); putreg32(regval, base + STM32_GPIO_OSPEED_OFFSET); /* Set push-pull/open-drain (Only outputs and alternate function pins) */ regval = getreg32(base + STM32_GPIO_OTYPER_OFFSET); setting = GPIO_OTYPER_OD(pin); if ((pinmode == GPIO_MODER_OUTPUT || pinmode == GPIO_MODER_ALT) && (cfgset & GPIO_OPENDRAIN) != 0) { regval |= setting; } else { regval &= ~setting; } putreg32(regval, base + STM32_GPIO_OTYPER_OFFSET); /* Otherwise, it is an input pin. * Should it configured as an EXTI interrupt? */ if ((cfgset & GPIO_EXTI) != 0) { uint32_t regaddr; int shift; #if defined(CONFIG_STM32F0L0G0_HAVE_IP_EXTI_V1) /* Set the bits in the SYSCFG EXTICR register */ regaddr = STM32_SYSCFG_EXTICR(pin); regval = getreg32(regaddr); shift = SYSCFG_EXTICR_EXTI_SHIFT(pin); regval &= ~(SYSCFG_EXTICR_PORT_MASK << shift); regval |= (((uint32_t)port) << shift); putreg32(regval, regaddr); #elif defined(CONFIG_STM32F0L0G0_HAVE_IP_EXTI_V2) /* Set the bits in the EXTI EXTICR register */ regaddr = STM32_EXTI_EXTICR(pin); regval = getreg32(regaddr); shift = EXTI_EXTICR_EXTI_SHIFT(pin); regval &= ~(EXTI_EXTICR_PORT_MASK << shift); regval |= (((uint32_t)port) << shift); putreg32(regval, regaddr); #else # error unknown EXTI IP core #endif } leave_critical_section(flags); return OK; } /**************************************************************************** * Name: stm32_unconfiggpio * * Description: * Unconfigure a GPIO pin based on bit-encoded description of the pin, set * it into default HiZ state (and possibly mark it's unused) and unlock it * whether it was previously selected as alternative function * (GPIO_ALT|GPIO_CNF_AFPP|...). * * This is a safety function and prevents hardware from shocks, as * unexpected write to the Timer Channel Output GPIO to fixed '1' or '0' * while it should operate in PWM mode could produce excessive on-board * currents and trigger over-current/alarm function. * * Returned Value: * OK on success * A negated errno value on invalid port * * To-Do: Auto Power Disable ****************************************************************************/ int stm32_unconfiggpio(uint32_t cfgset) { /* Reuse port and pin number and set it to default HiZ INPUT */ cfgset &= GPIO_PORT_MASK | GPIO_PIN_MASK; cfgset |= GPIO_INPUT | GPIO_FLOAT; /* To-Do: Mark its unuse for automatic power saving options */ return stm32_configgpio(cfgset); } /**************************************************************************** * Name: stm32_gpiowrite * * Description: * Write one or zero to the selected GPIO pin * ****************************************************************************/ void stm32_gpiowrite(uint32_t pinset, bool value) { uint32_t base; uint32_t bit; unsigned int port; unsigned int pin; port = (pinset & GPIO_PORT_MASK) >> GPIO_PORT_SHIFT; if (port < STM32_NPORTS) { /* Get the port base address */ base = g_gpiobase[port]; /* Get the pin number */ pin = (pinset & GPIO_PIN_MASK) >> GPIO_PIN_SHIFT; /* Set or clear the output on the pin */ if (value) { bit = GPIO_BSRR_SET(pin); } else { bit = GPIO_BSRR_RESET(pin); } putreg32(bit, base + STM32_GPIO_BSRR_OFFSET); } } /**************************************************************************** * Name: stm32_gpioread * * Description: * Read one or zero from the selected GPIO pin * ****************************************************************************/ bool stm32_gpioread(uint32_t pinset) { uint32_t base; unsigned int port; unsigned int pin; port = (pinset & GPIO_PORT_MASK) >> GPIO_PORT_SHIFT; if (port < STM32_NPORTS) { /* Get the port base address */ base = g_gpiobase[port]; /* Get the pin number and return the input state of that pin */ pin = (pinset & GPIO_PIN_MASK) >> GPIO_PIN_SHIFT; return ((getreg32(base + STM32_GPIO_IDR_OFFSET) & (1 << pin)) != 0); } return 0; }