uart.h

Go to the documentation of this file.

/*
 * Copyright (C) 2014-2015 Freie Universität Berlin
 *
 * 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_UART_H
#define PERIPH_UART_H
 
#include <stddef.h>
#include <stdint.h>
#include <limits.h>
 
#include "periph_cpu.h"
#include "periph_conf.h"
 
#ifdef __cplusplus
extern "C" {
#endif
 
#ifndef HAVE_UART_T
typedef unsigned int uart_t;
#endif
 
#ifndef UART_UNDEF
#define UART_UNDEF          (UINT_MAX)
#endif
 
#ifndef UART_DEV
#define UART_DEV(x)         (x)
#endif
 
typedef void(*uart_rx_cb_t)(void *arg, uint8_t data);
 
#ifndef HAVE_UART_ISR_CTX_T
typedef struct {
    uart_rx_cb_t rx_cb;     
    void *arg;              
} uart_isr_ctx_t;
#endif
 
enum {
    UART_OK         =  0,   
    UART_NODEV      = -1,   
    UART_NOBAUD     = -2,   
    UART_INTERR     = -3,   
    UART_NOMODE     = -4    
};
 
#ifndef HAVE_UART_PARITY_T
typedef enum {
   UART_PARITY_NONE,   
   UART_PARITY_EVEN,   
   UART_PARITY_ODD,    
   UART_PARITY_MARK,   
   UART_PARITY_SPACE   
} uart_parity_t;
#endif
 
#ifndef HAVE_UART_DATA_BITS_T
typedef enum {
    UART_DATA_BITS_5,   
    UART_DATA_BITS_6,   
    UART_DATA_BITS_7,   
    UART_DATA_BITS_8,   
} uart_data_bits_t;
#endif
 
#ifndef HAVE_UART_STOP_BITS_T
typedef enum {
   UART_STOP_BITS_1,   
   UART_STOP_BITS_2,   
} uart_stop_bits_t;
#endif
 
int uart_init(uart_t uart, uint32_t baudrate, uart_rx_cb_t rx_cb, void *arg);
 
#if defined(MODULE_PERIPH_UART_RECONFIGURE) || DOXYGEN
 
void uart_deinit_pins(uart_t uart);
 
void uart_init_pins(uart_t uart);
 
#if DOXYGEN
 
gpio_t uart_pin_rx(uart_t uart);
 
gpio_t uart_pin_tx(uart_t uart);
 
#endif /* DOXYGEN */
#endif /* MODULE_PERIPH_UART_RECONFIGURE */
 
int uart_mode(uart_t uart, uart_data_bits_t data_bits, uart_parity_t parity,
              uart_stop_bits_t stop_bits);
 
void uart_write(uart_t uart, const uint8_t *data, size_t len);
 
void uart_poweron(uart_t uart);
 
void uart_poweroff(uart_t uart);
 
#ifdef __cplusplus
}
#endif
 
#endif /* PERIPH_UART_H */