mbed official / mbed-dev

mbed library sources. Supersedes mbed-src.

Dependents:   Nucleo_Hello_Encoder BLE_iBeaconScan AM1805_DEMO DISCO-F429ZI_ExportTemplate1 ... more

targets/TARGET_GigaDevice/TARGET_GD32F30X/gpio_api.c@189:f392fc9709a3, 2019-02-20 (annotated)

Committer:
AnnaBridge
Date:
Wed Feb 20 22:31:08 2019 +0000
Revision:
189:f392fc9709a3
mbed library release version 165

Who changed what in which revision?

UserRevisionLine numberNew contents of line
AnnaBridge 189:f392fc9709a3 1 /* mbed Microcontroller Library
AnnaBridge 189:f392fc9709a3 2 * Copyright (c) 2018 GigaDevice Semiconductor Inc.
AnnaBridge 189:f392fc9709a3 3 *
AnnaBridge 189:f392fc9709a3 4 * SPDX-License-Identifier: Apache-2.0
AnnaBridge 189:f392fc9709a3 5 *
AnnaBridge 189:f392fc9709a3 6 * Licensed under the Apache License, Version 2.0 (the "License");
AnnaBridge 189:f392fc9709a3 7 * you may not use this file except in compliance with the License.
AnnaBridge 189:f392fc9709a3 8 * You may obtain a copy of the License at
AnnaBridge 189:f392fc9709a3 9 *
AnnaBridge 189:f392fc9709a3 10 * http://www.apache.org/licenses/LICENSE-2.0
AnnaBridge 189:f392fc9709a3 11 *
AnnaBridge 189:f392fc9709a3 12 * Unless required by applicable law or agreed to in writing, software
AnnaBridge 189:f392fc9709a3 13 * distributed under the License is distributed on an "AS IS" BASIS,
AnnaBridge 189:f392fc9709a3 14 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
AnnaBridge 189:f392fc9709a3 15 * See the License for the specific language governing permissions and
AnnaBridge 189:f392fc9709a3 16 * limitations under the License.
AnnaBridge 189:f392fc9709a3 17 */
AnnaBridge 189:f392fc9709a3 18 #include "gd32f30x_gpio.h"
AnnaBridge 189:f392fc9709a3 19 #include "mbed_assert.h"
AnnaBridge 189:f392fc9709a3 20 #include "gpio_api.h"
AnnaBridge 189:f392fc9709a3 21 #include "pinmap.h"
AnnaBridge 189:f392fc9709a3 22 #include "mbed_error.h"
AnnaBridge 189:f392fc9709a3 23
AnnaBridge 189:f392fc9709a3 24 extern const int GD_GPIO_REMAP[];
AnnaBridge 189:f392fc9709a3 25 extern const int GD_GPIO_SPEED[];
AnnaBridge 189:f392fc9709a3 26 extern const int GD_GPIO_MODE[];
AnnaBridge 189:f392fc9709a3 27
AnnaBridge 189:f392fc9709a3 28 /* Enable GPIO clock and return GPIO base address */
AnnaBridge 189:f392fc9709a3 29 uint32_t gpio_clock_enable(uint32_t port_idx)
AnnaBridge 189:f392fc9709a3 30 {
AnnaBridge 189:f392fc9709a3 31 uint32_t gpio_add = 0;
AnnaBridge 189:f392fc9709a3 32 switch (port_idx) {
AnnaBridge 189:f392fc9709a3 33 case PORTA:
AnnaBridge 189:f392fc9709a3 34 gpio_add = GPIOA;
AnnaBridge 189:f392fc9709a3 35 rcu_periph_clock_enable(RCU_GPIOA);
AnnaBridge 189:f392fc9709a3 36 break;
AnnaBridge 189:f392fc9709a3 37 case PORTB:
AnnaBridge 189:f392fc9709a3 38 gpio_add = GPIOB;
AnnaBridge 189:f392fc9709a3 39 rcu_periph_clock_enable(RCU_GPIOB);
AnnaBridge 189:f392fc9709a3 40 break;
AnnaBridge 189:f392fc9709a3 41 case PORTC:
AnnaBridge 189:f392fc9709a3 42 gpio_add = GPIOC;
AnnaBridge 189:f392fc9709a3 43 rcu_periph_clock_enable(RCU_GPIOC);
AnnaBridge 189:f392fc9709a3 44 break;
AnnaBridge 189:f392fc9709a3 45 case PORTD:
AnnaBridge 189:f392fc9709a3 46 gpio_add = GPIOD;
AnnaBridge 189:f392fc9709a3 47 rcu_periph_clock_enable(RCU_GPIOD);
AnnaBridge 189:f392fc9709a3 48 break;
AnnaBridge 189:f392fc9709a3 49 case PORTE:
AnnaBridge 189:f392fc9709a3 50 gpio_add = GPIOE;
AnnaBridge 189:f392fc9709a3 51 rcu_periph_clock_enable(RCU_GPIOE);
AnnaBridge 189:f392fc9709a3 52 break;
AnnaBridge 189:f392fc9709a3 53 default:
AnnaBridge 189:f392fc9709a3 54 error("port number not exist");
AnnaBridge 189:f392fc9709a3 55 break;
AnnaBridge 189:f392fc9709a3 56 }
AnnaBridge 189:f392fc9709a3 57 return gpio_add;
AnnaBridge 189:f392fc9709a3 58 }
AnnaBridge 189:f392fc9709a3 59
AnnaBridge 189:f392fc9709a3 60 /** Set the given pin as GPIO
AnnaBridge 189:f392fc9709a3 61 *
AnnaBridge 189:f392fc9709a3 62 * @param pin The pin to be set as GPIO
AnnaBridge 189:f392fc9709a3 63 * @return The GPIO port mask for this pin
AnnaBridge 189:f392fc9709a3 64 */
AnnaBridge 189:f392fc9709a3 65 uint32_t gpio_set(PinName pin)
AnnaBridge 189:f392fc9709a3 66 {
AnnaBridge 189:f392fc9709a3 67
AnnaBridge 189:f392fc9709a3 68 MBED_ASSERT(pin != (PinName)NC);
AnnaBridge 189:f392fc9709a3 69 pin_function(pin, MODE_IN_FLOATING);
AnnaBridge 189:f392fc9709a3 70 /* return pin mask */
AnnaBridge 189:f392fc9709a3 71 return (uint32_t)(1 << ((uint32_t)pin & 0xF));
AnnaBridge 189:f392fc9709a3 72 }
AnnaBridge 189:f392fc9709a3 73
AnnaBridge 189:f392fc9709a3 74 /** Initialize the GPIO pin
AnnaBridge 189:f392fc9709a3 75 *
AnnaBridge 189:f392fc9709a3 76 * @param obj The GPIO object to initialize
AnnaBridge 189:f392fc9709a3 77 * @param pin The GPIO pin to initialize
AnnaBridge 189:f392fc9709a3 78 */
AnnaBridge 189:f392fc9709a3 79 void gpio_init(gpio_t *obj, PinName pin)
AnnaBridge 189:f392fc9709a3 80 {
AnnaBridge 189:f392fc9709a3 81 obj->pin = pin;
AnnaBridge 189:f392fc9709a3 82 if (pin == (PinName)NC) {
AnnaBridge 189:f392fc9709a3 83 return;
AnnaBridge 189:f392fc9709a3 84 }
AnnaBridge 189:f392fc9709a3 85 /* fill struct parameter for future use */
AnnaBridge 189:f392fc9709a3 86 uint32_t port_index = GD_PORT_GET(pin);
AnnaBridge 189:f392fc9709a3 87 uint32_t gpio = gpio_clock_enable(port_index);
AnnaBridge 189:f392fc9709a3 88 obj->mask = gpio_set(pin);
AnnaBridge 189:f392fc9709a3 89 obj->gpio_periph = gpio;
AnnaBridge 189:f392fc9709a3 90 }
AnnaBridge 189:f392fc9709a3 91
AnnaBridge 189:f392fc9709a3 92 /** Set the input pin mode
AnnaBridge 189:f392fc9709a3 93 *
AnnaBridge 189:f392fc9709a3 94 * @param obj The GPIO object
AnnaBridge 189:f392fc9709a3 95 * @param mode The pin mode to be set
AnnaBridge 189:f392fc9709a3 96 */
AnnaBridge 189:f392fc9709a3 97 void gpio_mode(gpio_t *obj, PinMode mode)
AnnaBridge 189:f392fc9709a3 98 {
AnnaBridge 189:f392fc9709a3 99 pin_mode(obj->pin, mode);
AnnaBridge 189:f392fc9709a3 100 }
AnnaBridge 189:f392fc9709a3 101
AnnaBridge 189:f392fc9709a3 102 /** Set the output value
AnnaBridge 189:f392fc9709a3 103 *
AnnaBridge 189:f392fc9709a3 104 * @param obj The GPIO object
AnnaBridge 189:f392fc9709a3 105 * @param value The value to be set
AnnaBridge 189:f392fc9709a3 106 */
AnnaBridge 189:f392fc9709a3 107 void gpio_write(gpio_t *obj, int value)
AnnaBridge 189:f392fc9709a3 108 {
AnnaBridge 189:f392fc9709a3 109 /* set or reset GPIO pin */
AnnaBridge 189:f392fc9709a3 110 if (value) {
AnnaBridge 189:f392fc9709a3 111 GPIO_BOP(obj->gpio_periph) = (1 << (uint32_t)GD_PIN_GET(obj->pin));
AnnaBridge 189:f392fc9709a3 112 } else {
AnnaBridge 189:f392fc9709a3 113 GPIO_BC(obj->gpio_periph) = (1 << (uint32_t)GD_PIN_GET(obj->pin));
AnnaBridge 189:f392fc9709a3 114 }
AnnaBridge 189:f392fc9709a3 115 }
AnnaBridge 189:f392fc9709a3 116
AnnaBridge 189:f392fc9709a3 117 /** Read the input value
AnnaBridge 189:f392fc9709a3 118 *
AnnaBridge 189:f392fc9709a3 119 * @param obj The GPIO object
AnnaBridge 189:f392fc9709a3 120 * @return An integer value 1 or 0
AnnaBridge 189:f392fc9709a3 121 */
AnnaBridge 189:f392fc9709a3 122 int gpio_read(gpio_t *obj)
AnnaBridge 189:f392fc9709a3 123 {
AnnaBridge 189:f392fc9709a3 124 /* return state of GPIO pin */
AnnaBridge 189:f392fc9709a3 125 return ((GPIO_ISTAT(obj->gpio_periph) & obj->mask) ? 1 : 0);
AnnaBridge 189:f392fc9709a3 126 }
AnnaBridge 189:f392fc9709a3 127
AnnaBridge 189:f392fc9709a3 128 /* Checks if gpio object is connected (pin was not initialized with NC)
AnnaBridge 189:f392fc9709a3 129 * @param pin The pin to be set as GPIO
AnnaBridge 189:f392fc9709a3 130 * @return 0 if port is initialized with NC
AnnaBridge 189:f392fc9709a3 131 **/
AnnaBridge 189:f392fc9709a3 132 int gpio_is_connected(const gpio_t *obj)
AnnaBridge 189:f392fc9709a3 133 {
AnnaBridge 189:f392fc9709a3 134 return obj->pin != (PinName)NC;
AnnaBridge 189:f392fc9709a3 135 }
AnnaBridge 189:f392fc9709a3 136
AnnaBridge 189:f392fc9709a3 137 /** Set the pin direction
AnnaBridge 189:f392fc9709a3 138 *
AnnaBridge 189:f392fc9709a3 139 * @param obj The GPIO object
AnnaBridge 189:f392fc9709a3 140 * @param direction The pin direction to be set
AnnaBridge 189:f392fc9709a3 141 */
AnnaBridge 189:f392fc9709a3 142 void gpio_dir(gpio_t *obj, PinDirection direction)
AnnaBridge 189:f392fc9709a3 143 {
AnnaBridge 189:f392fc9709a3 144
AnnaBridge 189:f392fc9709a3 145 /* config GPIO pin as input or output */
AnnaBridge 189:f392fc9709a3 146 if (direction == PIN_INPUT) {
AnnaBridge 189:f392fc9709a3 147 gpio_para_init(obj->gpio_periph, GD_GPIO_MODE[MODE_IN_FLOATING], GD_GPIO_SPEED[0], (1 << (uint32_t)GD_PIN_GET(obj->pin)));
AnnaBridge 189:f392fc9709a3 148 } else {
AnnaBridge 189:f392fc9709a3 149 gpio_para_init(obj->gpio_periph, GD_GPIO_MODE[MODE_OUT_PP], GD_GPIO_SPEED[0], (1 << (uint32_t)GD_PIN_GET(obj->pin)));
AnnaBridge 189:f392fc9709a3 150 }
AnnaBridge 189:f392fc9709a3 151 }