periph_cpu.h

Go to the documentation of this file.

/*
 * SPDX-FileCopyrightText: 2015 Freie Universität Berlin
 * SPDX-License-Identifier: LGPL-2.1-only
 */
 
#pragma once

 
#include <stdbool.h>
 
#include "compiler_hints.h"
#include "periph_cpu_common.h"
#include "macros/units.h"
 
#ifdef __cplusplus
extern "C" {
#endif

#define USART_NUMOF         2

#define USART_MIN_BR_SPI    2

#define USART_MIN_BR_UART   3

#define HAVE_SPI_MODE_T     
typedef enum {
    SPI_MODE_0 = (CKPH),                
    SPI_MODE_1 = 0,                     
    SPI_MODE_2 = (CKPL | CKPH),         
    SPI_MODE_3 = (CKPL)                 
} spi_mode_t;


#define HAVE_SPI_CLK_T     
typedef enum {
    SPI_CLK_100KHZ = KHZ(100),      
    SPI_CLK_400KHZ = KHZ(400),      
    SPI_CLK_1MHZ   = MHZ(1),        
    SPI_CLK_5MHZ   = MHZ(5),        
    SPI_CLK_10MHZ  = SPI_CLK_5MHZ,  
} spi_clk_t;


typedef struct {
    msp430_usart_t *dev;        
    msp430_usart_sfr_t *sfr;    
    uint8_t tx_irq_mask;        
    uint8_t rx_irq_mask;        
    uint8_t num;                
} msp430_usart_params_t;

typedef enum {
    USART_CLK_UCLKI     = UXTCTL_SSEL_UCLKI,    
    USART_CLK_AUX       = UXTCTL_SSEL_ACLK,     
    USART_CLK_SUBMAIN   = UXTCTL_SSEL_SMCLK,    
} msp430_usart_clk_t;

typedef struct {
    msp430_usart_clk_t clk_source; 
    uint8_t br0;                
    uint8_t br1;                
    uint8_t mctl;               
} msp430_usart_prescaler_t;

typedef struct {
    msp430_usart_prescaler_t prescaler; 
    uint8_t ctl;                        
} msp430_usart_conf_t;

typedef struct {
    msp430_usart_params_t usart_params; 
    uint8_t tx_enable_mask;
    uint8_t rxtx_enable_mask;
    gpio_t rxd;                     
    gpio_t txd;                     
} msp430_usart_uart_params_t;

typedef struct {
    const msp430_usart_uart_params_t *uart; 
} uart_conf_t;

typedef struct {
    msp430_usart_params_t usart_params;    
    uint8_t enable_mask;
    gpio_t miso;                    
    gpio_t mosi;                    
    gpio_t sck;                     
} msp430_usart_spi_params_t;

typedef struct {
    const msp430_usart_spi_params_t *spi;    
} spi_conf_t;

extern const msp430_usart_uart_params_t usart0_as_uart;

extern const msp430_usart_uart_params_t usart1_as_uart;

extern const msp430_usart_spi_params_t usart0_as_spi;

extern const msp430_usart_spi_params_t usart1_as_spi;

#define PERIPH_SPI_NEEDS_INIT_CS        
#define PERIPH_SPI_NEEDS_TRANSFER_BYTE  
#define PERIPH_SPI_NEEDS_TRANSFER_REG   
#define PERIPH_SPI_NEEDS_TRANSFER_REGS  

static inline void msp430_usart_enable_tx_irq(const msp430_usart_params_t *usart_conf)
{
    usart_conf->sfr->IE |= usart_conf->tx_irq_mask;
}

static inline void msp430_usart_enable_rx_irq(const msp430_usart_params_t *usart_conf)
{
    usart_conf->sfr->IE |= usart_conf->rx_irq_mask;
}

static inline void msp430_usart_disable_tx_irq(const msp430_usart_params_t *usart_conf)
{
    usart_conf->sfr->IE &= ~(usart_conf->tx_irq_mask);
}

static inline void msp430_usart_disable_rx_irq(const msp430_usart_params_t *usart_conf)
{
    usart_conf->sfr->IE &= ~(usart_conf->rx_irq_mask);
}

static inline bool msp430_usart_get_tx_irq_flag(const msp430_usart_params_t *usart_conf)
{
    return usart_conf->sfr->IFG & usart_conf->tx_irq_mask;
}

static inline bool msp430_usart_get_rx_irq_flag(const msp430_usart_params_t *usart_conf)
{
    return usart_conf->sfr->IFG & usart_conf->rx_irq_mask;
}

static inline bool msp430_usart_are_both_irq_flags_set(const msp430_usart_params_t *usart_conf)
{
    const uint8_t mask = usart_conf->tx_irq_mask | usart_conf->rx_irq_mask;
    return (usart_conf->sfr->IFG & mask) == mask;
}

static inline void msp430_usart_clear_tx_irq_flag(const msp430_usart_params_t *usart_conf)
{
    usart_conf->sfr->IFG &= ~(usart_conf->tx_irq_mask);
}

static inline void msp430_usart_clear_rx_irq_flag(const msp430_usart_params_t *usart_conf)
{
    usart_conf->sfr->IFG &= ~(usart_conf->rx_irq_mask);
}

void msp430_usart_acquire(const msp430_usart_params_t *params,
                       const msp430_usart_conf_t *conf,
                       uint8_t enable_mask);

void msp430_usart_release(const msp430_usart_params_t *params);

msp430_usart_prescaler_t msp430_usart_prescale(uint32_t clock, uint16_t min_br);
#ifdef __cplusplus
}
#endif