2da1b09e44a1464ae82afa4a6d821a8947d09df0
[bertos.git] / bertos / cpu / cortex-m3 / drv / ser_stm32.h
1 /**
2  * \file
3  * <!--
4  * This file is part of BeRTOS.
5  *
6  * Bertos is free software; you can redistribute it and/or modify
7  * it under the terms of the GNU General Public License as published by
8  * the Free Software Foundation; either version 2 of the License, or
9  * (at your option) any later version.
10  *
11  * This program is distributed in the hope that it will be useful,
12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
14  * GNU General Public License for more details.
15  *
16  * You should have received a copy of the GNU General Public License
17  * along with this program; if not, write to the Free Software
18  * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
19  *
20  * As a special exception, you may use this file as part of a free software
21  * library without restriction.  Specifically, if other files instantiate
22  * templates or use macros or inline functions from this file, or you compile
23  * this file and link it with other files to produce an executable, this
24  * file does not by itself cause the resulting executable to be covered by
25  * the GNU General Public License.  This exception does not however
26  * invalidate any other reasons why the executable file might be covered by
27  * the GNU General Public License.
28  *
29  * Copyright 2010 Develer S.r.l. (http://www.develer.com/)
30  *
31  * -->
32  *
33  * \brief STM32F10xx UART interface driver.
34  *
35  * \author Daniele Basile <asterix@develer.com>
36  */
37
38 #ifndef SER_STM32_H
39 #define SER_STM32_H
40
41 #include <cfg/debug.h>
42
43 #include <cpu/power.h> /* cpu_relax() */
44
45 #include <io/stm32.h>
46
47 /* Serial hardware numbers */
48 enum
49 {
50         SER_UART1 = 0,
51         SER_UART2,
52         SER_UART3,
53
54         SER_CNT //< Number of serial ports
55 };
56
57 /* Software errors */
58 #define SERRF_RXFIFOOVERRUN  BV(0) //< Rx FIFO buffer overrun
59 #define SERRF_RXTIMEOUT      BV(1) //< Receive timeout
60 #define SERRF_TXTIMEOUT      BV(2) //< Transmit timeout
61
62 /*
63  * Hardware errors.
64  */
65 #define SERRF_RXSROVERRUN    0 //< Input overrun
66 #define SERRF_FRAMEERROR     0 //< Stop bit missing
67 #define SERRF_PARITYERROR    0 //< Parity error
68 #define SERRF_NOISEERROR     0 //< Noise error
69
70 /* Serial error/status flags */
71 typedef uint32_t serstatus_t;
72
73 INLINE void stm32_uartDisable(uint32_t base)
74 {
75         struct stm32_usart *_base = (struct stm32_usart *)base;
76         _base->CR1 &= ~CR1_RUN_RESET;
77 }
78
79 INLINE void stm32_uartEnable(uint32_t base)
80 {
81         struct stm32_usart *_base = (struct stm32_usart *)base;
82         _base->CR1 |= CR1_RUN_SET;
83 }
84
85 /* Clear the flags register */
86 INLINE void stm32_uartClear(uint32_t base)
87 {
88         struct stm32_usart *_base = (struct stm32_usart *)base;
89         _base->SR &= ~USART_FLAG_MASK;
90 }
91
92 INLINE bool stm32_uartTxDone(uint32_t base)
93 {
94         struct stm32_usart *_base = (struct stm32_usart *)base;
95         return (_base->SR & USART_FLAG_TC);
96 }
97
98 INLINE bool stm32_uartTxReady(uint32_t base)
99 {
100         struct stm32_usart *_base = (struct stm32_usart *)base;
101         return (_base->SR & (BV(7) | BV(6)));
102 }
103
104 INLINE bool stm32_uartRxReady(uint32_t base)
105 {
106         struct stm32_usart *_base = (struct stm32_usart *)base;
107         return (_base->SR & BV(5));
108 }
109
110 INLINE int stm32_uartPutChar(uint32_t base, unsigned char c)
111 {
112         struct stm32_usart *_base = (struct stm32_usart *)base;
113         while (!stm32_uartTxReady(base))
114                 cpu_relax();
115         _base->DR = c;
116         return c;
117 }
118
119 INLINE int stm32_uartGetChar(uint32_t base)
120 {
121         struct stm32_usart * _base = (struct stm32_usart *)base;
122         return _base->DR;
123 }
124
125 void stm32_uartSetBaudRate(uint32_t base, unsigned long baud);
126 void stm32_uartSetParity(uint32_t base, int parity);
127 void stm32_uartInit(int port);
128
129 #endif /* SER_STM32_H */