cpu_gpio_ll.h

Go to the documentation of this file.

/*
 * Copyright (C) 2021 Otto-von-Guericke-Universität Magdeburg
 *
 * This file is subject to the terms and conditions of the GNU Lesser
 * General Public License v2.1. See the file LICENSE in the top level
 * directory for more details.
 */
 
#ifndef PERIPH_CPU_GPIO_LL_H
#define PERIPH_CPU_GPIO_LL_H
 
#include <stdalign.h>
#include <stdint.h>
#include "periph_cpu.h"
 
#ifdef __cplusplus
extern "C" {
#endif
 
/* Hide this from Doxygen to avoid merging implementation details into
 * public view on type */
#ifndef DOXYGEN
 
#if !defined(CPU_FAM_STM32F1)
/* For the STM32F1 GPIO peripheral, the gpio_ll_switch_dir is not supported */
#  define HAVE_GPIO_LL_PREPARE_SWITCH_DIR
#endif
 
#define HAVE_GPIO_PULL_STRENGTH_T
typedef enum {
    GPIO_PULL_WEAKEST = 0,
    GPIO_PULL_WEAK = 0,
    GPIO_PULL_STRONG = 0,
    GPIO_PULL_STRONGEST = 0
} gpio_pull_strength_t;
 
#define HAVE_GPIO_DRIVE_STRENGTH_T
typedef enum {
    GPIO_DRIVE_WEAKEST = 0,
    GPIO_DRIVE_WEAK = 0,
    GPIO_DRIVE_STRONG = 0,
    GPIO_DRIVE_STRONGEST = 0
} gpio_drive_strength_t;
 
/* Modern STM32 GPIO config registers with the OSPEEDR register support full
 * 4 slew rates, legacy STM32F1 style only have three slew rates. We define
 * slow and fast to the same value, so that we have three options:
 * 1. SLOWEST: 2 MHZ
 * 2. SLOW: 10 MHZ
 * 3. FAST/FASTEST: 50 MHz
 */
#if defined(GPIO_OSPEEDR_OSPEED0) || defined(GPIO_OSPEEDER_OSPEEDR0) \
    || defined(GPIO_OSPEEDER_OSPEED0) || defined(GPIO_OSPEEDR_OSPEEDR0)
#  define STM32_HAS_OSPEED  1
#else
#  define STM32_HAS_OSPEED  0
#endif
 
#define HAVE_GPIO_SLEW_T
#if STM32_HAS_OSPEED
typedef enum {
    GPIO_SLEW_SLOWEST = 0,
    GPIO_SLEW_SLOW = 1,
    GPIO_SLEW_FAST = 2,
    GPIO_SLEW_FASTEST = 3,
} gpio_slew_t;
#else
typedef enum {
    GPIO_SLEW_SLOWEST = 0,
    GPIO_SLEW_SLOW = 0,
    GPIO_SLEW_FAST = 1,
    GPIO_SLEW_FASTEST = 2,
} gpio_slew_t;
#endif
 
#define HAVE_GPIO_IRQ_TRIG_T
/*
 * Layout:
 *      7 6 5 4 3 2 1 0
 *      +-+-+-+-+-+-+-+-+
 *      |   RFU   |T|L|H|
 *      +-+-+-+-+-+-+-+-+
 *
 * RFU = Reserved for future use
 * T   = Trigger mode (1 = Level triggered, 0 = Edge triggered)
 * L   = Low (1 = low level / falling edge)
 * H   = High (1 = high level / rising edge)
 *
 * Note: This layout overlaps with gpio_flank_t by intent
 */
typedef enum {
    GPIO_TRIGGER_EDGE_RISING    = 0x1,
    GPIO_TRIGGER_EDGE_FALLING   = 0x2,
    GPIO_TRIGGER_EDGE_BOTH      = GPIO_TRIGGER_EDGE_RISING | GPIO_TRIGGER_EDGE_FALLING,
    GPIO_TRIGGER_LEVEL          = 0x4,
    GPIO_TRIGGER_LEVEL_HIGH     = GPIO_TRIGGER_LEVEL | GPIO_TRIGGER_EDGE_RISING,
    GPIO_TRIGGER_LEVEL_LOW      = GPIO_TRIGGER_LEVEL | GPIO_TRIGGER_EDGE_FALLING,
} gpio_irq_trig_t;
 
typedef enum {
    GPIOX_MODER_INPUT   = 0x0,  
    GPIOX_MODER_OUTPUT  = 0x1,  
    GPIOX_MODER_AF      = 0x2,  
    GPIOX_MODER_ANALOG  = 0x3,  
} gpiox_moder_t;
 
#define GPIO_STATE_T_OPEN_DRAIN_FLAG    0x4
#define GPIO_STATE_T_MODER_Msk          0x3
 
#define HAVE_GPIO_STATE_T
typedef enum {
    GPIO_INPUT              = GPIOX_MODER_INPUT,
    GPIO_OUTPUT_PUSH_PULL   = GPIOX_MODER_OUTPUT,
    GPIO_OUTPUT_OPEN_DRAIN  = GPIOX_MODER_OUTPUT | GPIO_STATE_T_OPEN_DRAIN_FLAG,
    GPIO_USED_BY_PERIPHERAL = GPIOX_MODER_AF,
    GPIO_DISCONNECT         = GPIOX_MODER_ANALOG,
    GPIO_OUTPUT_OPEN_SOURCE = 0x7,  
} gpio_state_t;
 
#define HAVE_GPIO_PULL_T
typedef enum {
    GPIO_FLOATING,
    GPIO_PULL_UP,
    GPIO_PULL_DOWN,
    GPIO_PULL_KEEP,
} gpio_pull_t;
 
#define HAVE_GPIO_CONF_T
typedef union gpio_conf_stm32 gpio_conf_t;
 
#endif /* ndef Doxygen */
 
union gpio_conf_stm32 {
    uint8_t bits;  
    struct {
        gpio_state_t state              : 3;
        gpio_pull_t pull                : 2;
        gpio_slew_t slew_rate           : 2;
        bool initial_value          : 1;
    };
};
 
#ifdef __cplusplus
}
#endif
 
#endif /* PERIPH_CPU_GPIO_LL_H */