usart.h

Go to the documentation of this file.

 
#ifndef USART_H
#define USART_H
 
/* -- Includes -- */
#include <stdint.h>
#include "stm32f4xx.h"
#include "defines.h"
 
/* -- Structs -- */
struct __attribute__((packed)) USARTRegs {
  REG32 SR;
  REG32 DR;
  REG32 BRR;
  REG32 CR1;
  REG32 CR2;
  REG32 CR3;
  REG32 GTPR;
};
 
_Static_assert((sizeof(struct USARTRegs)) == (sizeof(uint32_t) * 7U),
               "USART register struct size mismatch. Is it aligned?");
 
#define USART(x) (struct USARTRegs *)(x)
 
struct __attribute__((packed)) USARTISR {
  volatile _Bool TXEI  : 1;
  volatile _Bool CTSI  : 1;
  volatile _Bool TCI   : 1;
  volatile _Bool RXNEI : 1;
  volatile _Bool IDLEI : 1;
  volatile _Bool PEI   : 1;
  volatile _Bool LBDI  : 1;
  volatile _Bool EI    : 1;
};
 
_Static_assert((sizeof(struct USARTISR)) == (sizeof(uint8_t) * 1U),
               "USART interrupt struct size mismatch. Is it aligned?");
 
/* -- Enums -- */
typedef enum usart_peripheral {
#ifdef USART1_BASE
  USART_PERIPH_1,
#endif
#ifdef USART2_BASE
  USART_PERIPH_2,
#endif
#ifdef USART3_BASE
  USART_PERIPH_3,
#endif
#ifdef USART6_BASE
  USART_PERIPH_6,
#endif
#ifdef UART4_BASE
  UART_PERIPH_4,
#endif
#ifdef UART5_BASE
  UART_PERIPH_5
#endif
} usart_peripheral_t;
 
typedef enum usart_mode {
  USART_MODE_TX = 0x00,
  USART_MODE_RX = 0x01,
  USART_MODE_BO = 0x02
} usart_mode_t;
 
typedef enum usart_databits {
  USART_DATABITS_DB8 = 0x00,
  USART_DATABITS_DB9 = 0x01
} usart_databits_t;
 
typedef enum usart_stopbits {
  USART_STOPBITS_SB1 = 0x00,
  USART_STOPBITS_SBH = 0x01,
  USART_STOPBITS_SB2 = 0x02,
  USART_STOPBITS_SBO = 0x03
} usart_stopbits_t;
 
typedef enum usart_parity {
  USART_PARITY_EVN = 0x00,
  USART_PARITY_ODD = 0x01,
  USART_PARITY_OFF = 0x02
} usart_parity_t;
 
void usart_start(const usart_peripheral_t usart, const uint32_t baudrate,
                 const usart_mode_t mode);
 
void usart_set_dma(const usart_peripheral_t usart, const _Bool forTX,
                   const _Bool forRX);
 
void usart_set_interrupts(const usart_peripheral_t usart,
                          const struct USARTISR config);
 
void usart_set_databits(const usart_peripheral_t usart,
                        const usart_stopbits_t stopbits,
                        const usart_databits_t databits);
 
void usart_set_parity(const usart_peripheral_t usart,
                      const usart_parity_t parity);
 
void usart_tx_message(const usart_peripheral_t usart, const char *message);
 
uint16_t usart_rx_byte(const usart_peripheral_t usart);
 
void usart_stop(const usart_peripheral_t usart);
 
#endif