Contiki 3.x
pic32_uart.h
Go to the documentation of this file.
1 /*
2  * Contiki PIC32 Port project
3  *
4  * Copyright (c) 2012,
5  * Scuola Superiore Sant'Anna (http://www.sssup.it) and
6  * Consorzio Nazionale Interuniversitario per le Telecomunicazioni
7  * (http://www.cnit.it).
8  *
9  * All rights reserved.
10  *
11  * Redistribution and use in source and binary forms, with or without
12  * modification, are permitted provided that the following conditions
13  * are met:
14  * 1. Redistributions of source code must retain the above copyright
15  * notice, this list of conditions and the following disclaimer.
16  * 2. Redistributions in binary form must reproduce the above copyright
17  * notice, this list of conditions and the following disclaimer in the
18  * documentation and/or other materials provided with the distribution.
19  * 3. Neither the name of the Institute nor the names of its contributors
20  * may be used to endorse or promote products derived from this software
21  * without specific prior written permission.
22  *
23  * THIS SOFTWARE IS PROVIDED BY THE INSTITUTE AND CONTRIBUTORS ``AS IS'' AND
24  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
25  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
26  * ARE DISCLAIMED. IN NO EVENT SHALL THE INSTITUTE OR CONTRIBUTORS BE LIABLE
27  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
28  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
29  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
30  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
31  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
32  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
33  * SUCH DAMAGE.
34  *
35  */
36 
37 /**
38  * \addtogroup pic32 PIC32 Contiki Port
39  *
40  * @{
41  */
42 
43 /**
44  * \file pic32_uart.h
45  * \brief UART Interface for PIC32MX (pic32mx795f512l)
46  * \author Giovanni Pellerano <giovanni.pellerano@evilaliv3.org>
47  * \date 2012-03-21
48  */
49 
50 /*
51  * PIC32MX795F512L - Specific Functions
52  *
53  * All the functions in this part of the file are specific for the
54  * pic32mx795f512l that is characterized by registers' name that differ from
55  * the 3xx and 4xx families of the pic32mx.
56  */
57 
58 #ifndef INCLUDE_PIC32_UART_H_
59 #define INCLUDE_PIC32_UART_H_
60 
61 #ifdef __USE_UART__
62 
63 #include <pic32_irq.h>
64 
65 #include <p32xxxx.h>
66 
67 #include <stdint.h>
68 
69 #include "dev/leds.h"
70 
71 #define BAUD2UBR(x) x
72 
73 /* Returned Messages */
74 #define UART_NO_ERROR 0
75 #define UART_ERR_NO_DATA 1
76 #define UART_ERR_OVERFLOW 2
77 
78 #define UART_PORT_DEF(XX) \
79  int8_t pic32_uart##XX##_init(uint32_t baudrate, uint16_t byte_format); \
80  int8_t pic32_uart##XX##_write(uint8_t data);
81 
82 #define UART_INTERRUPT(XX, YY, CALLBACK) \
83  ISR(_UART_##XX##_VECTOR) \
84  { \
85  volatile uint8_t byte; \
86  if(IFS##YY##bits.U##XX##RXIF) { \
87  if((U##XX##STAbits.PERR == 0) && (U##XX##STAbits.FERR == 0)) { \
88  CALLBACK(U##XX##RXREG); \
89  } else { \
90  byte = U##XX##RXREG; /* NULL READ */ \
91  } \
92  IFS##YY##CLR = _IFS##YY##_U##XX##RXIF_MASK; \
93  } \
94  if(U##XX##STAbits.OERR) { \
95  U##XX##STACLR = _U##XX##STA_OERR_MASK; \
96  } \
97  }
98 
99 #ifdef __USE_UART_PORT1A__
100 UART_PORT_DEF(1A)
101 #endif /* __USE_UART_PORT1A__ */
102 
103 #ifdef __USE_UART_PORT1B__
104 UART_PORT_DEF(1B)
105 #endif /* __USE_UART_PORT1B__ */
106 
107 #ifdef __USE_UART_PORT2A__
108 UART_PORT_DEF(2A)
109 #endif /* __USE_UART_PORT2A__ */
110 
111 #ifdef __USE_UART_PORT2B__
112 UART_PORT_DEF(2B)
113 #endif /* __USE_UART_PORT2B__ */
114 
115 #ifdef __USE_UART_PORT3A__
116 UART_PORT_DEF(3A)
117 #endif /* __USE_UART_PORT3A__ */
118 
119 #ifdef __USE_UART_PORT3B__
120 UART_PORT_DEF(3B)
121 #endif /* __USE_UART_PORT3B__ */
122 
123 #endif /* __USE_UART__ */
124 
125 #endif /* INCLUDE_PIC32_UART_H_ */
126 
127 /** @} */
INTERRUPT interface for PIC32MX (pic32mx795f512l)