gpio_ll_arch.h

Go to the documentation of this file.

/*
 * Copyright (C) 2022 Christian Amsüss
 *
 * 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 GPIO_LL_ARCH_H
#define GPIO_LL_ARCH_H
 
#include "cpu.h"
#include "periph_cpu.h"
 
#include "em_gpio.h"
 
#ifdef __cplusplus
extern "C" {
#endif
 
#ifndef DOXYGEN /* hide implementation specific details from Doxygen */
 
#define GPIO_PORT_NUMBERING_ALPHABETIC  1
 
/* Note: The pin count may be defined as zero to indicate the port not existing.
 * Hence, don't to `#if defined(foo)` but only `#if foo`
 */
#if _GPIO_PORT_A_PIN_COUNT
#  define GPIO_PORT_0   0
#endif
 
#if _GPIO_PORT_B_PIN_COUNT
#  define GPIO_PORT_1   1
#endif
 
#if _GPIO_PORT_C_PIN_COUNT
#  define GPIO_PORT_2   2
#endif
 
#if _GPIO_PORT_D_PIN_COUNT
#  define GPIO_PORT_3   3
#endif
 
#if _GPIO_PORT_E_PIN_COUNT
#  define GPIO_PORT_4   4
#endif
 
#if _GPIO_PORT_F_PIN_COUNT
#  define GPIO_PORT_6   6
#endif
 
#if _GPIO_PORT_G_PIN_COUNT
#  define GPIO_PORT_7   7
#endif
 
#if _GPIO_PORT_H_PIN_COUNT
#  define GPIO_PORT_8   8
#endif
 
#if _GPIO_PORT_I_PIN_COUNT
#  define GPIO_PORT_9   9
#endif
 
#if _GPIO_PORT_J_PIN_COUNT
#  define GPIO_PORT_10  10
#endif
 
#if _GPIO_PORT_K_PIN_COUNT
#  define GPIO_PORT_11  11
#endif
 
/* We could do
 *
 * static inline gpio_port_t gpio_port(uword_t num)
 * {
 *     return GPIO->P[num];
 * }
 *
 * which works for some operations, but at latest when _ll_set needs to fan out
 * for some EFM32 families to
 *
#if defined(_GPIO_P_DOUTSET_MASK)
  GPIO->P[port].DOUTSET = pins;
#elif defined(GPIO_HAS_SET_CLEAR)
  GPIO->P_SET[port].DOUT = pins;
#else
  (some bit-banding-style interaction on P)
#endif
 *
 * that approach becomes an unbearable burden, because P_SET is not necessarily
 * as large as P, and getting from a P pointer to a P_SET pointer would involve
 * division and multiplication. Instead, falling back to addressing ports by
 * their index number, which does require an additional multiplication for most
 * accesses, but at least does that consistently.
 *
 * (It also makes things easier because it allows going through the helper
 * functions).
 *
 * There appears to be one truly viable alternative: implementing gpio_ll only
 * for those EFM32 that do have DOUTSET etc. in P, with no way of having such
 * an implementation for other EFM32 families. For the time being, the
 * suboptimal-but-works-for-all version is the best we have.
 */
static inline gpio_port_t gpio_port(uword_t num)
{
    return num;
}
 
static inline uword_t gpio_port_num(gpio_port_t port)
{
    return port;
}
 
static inline uword_t gpio_ll_read(gpio_port_t port)
{
    return GPIO_PortInGet(port);
}
 
static inline uword_t gpio_ll_read_output(gpio_port_t port)
{
    return GPIO_PortOutGet(port);
}
 
static inline void gpio_ll_set(gpio_port_t port, uword_t mask)
{
    GPIO_PortOutSet(port, mask);
}
 
static inline void gpio_ll_clear(gpio_port_t port, uword_t mask)
{
    GPIO_PortOutClear(port, mask);
}
 
static inline void gpio_ll_toggle(gpio_port_t port, uword_t mask)
{
    GPIO_PortOutToggle(port, mask);
}
 
static inline void gpio_ll_write(gpio_port_t port, uword_t value)
{
    GPIO->P[port].DOUT = value;
}
 
static inline gpio_port_t gpio_get_port(gpio_t pin)
{
    return (pin >> 4);
}
 
static inline uint8_t gpio_get_pin_num(gpio_t pin)
{
    return (pin & 0x0f);
}
 
static inline gpio_port_t gpio_port_pack_addr(void *addr)
{
    return (gpio_port_t)addr;
}
 
static inline bool is_gpio_port_num_valid(uint_fast8_t num)
{
    return GPIO_PORT_VALID(num);
}
 
static inline void * gpio_port_unpack_addr(gpio_port_t port)
{
    if ((port & ~0xff) == 0 && is_gpio_port_num_valid(port)) {
        return NULL;
    }
 
    return (void *)port;
}
 
#endif /* DOXYGEN */
#ifdef __cplusplus
}
#endif
 
#endif /* GPIO_LL_ARCH_H */