b263efca7f400e189bc6b1d7aab8e3ac1be8b8a1
[bertos.git] / bertos / cpu / msp430 / drv / kdebug_msp430.c
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 2003, 2004, 2005, 2006, 2007 Develer S.r.l. (http://www.develer.com/)
30  * Copyright 2010 Mohamed <mtarek16@gmail.com>
31  *
32  * -->
33  *
34  * \brief MSP430 debug support (implementation).
35  *
36  * \author Mohamed Tarek <mtarek16@gmail.com>
37  */
38
39 #include <hw/hw_cpufreq.h>      /* for CPU_FREQ */
40 #include "hw/hw_ser.h"          /* bus macros overrides */
41
42 #include "cfg/cfg_debug.h"
43 #include <cfg/macros.h>         /* for DIV_ROUND */
44
45 #include <cpu/types.h>
46 #include <cpu/attr.h>
47
48 #include <io.h>
49
50 #if CONFIG_KDEBUG_PORT == 0
51
52         #ifndef KDBG_UART0_BUS_INIT
53         #define KDBG_UART0_BUS_INIT  do {} while (0)
54         #endif
55         #ifndef KDBG_UART0_BUS_RX
56         #define KDBG_UART0_BUS_RX    do {} while (0)
57         #endif
58         #ifndef KDBG_UART0_BUS_TX
59         #define KDBG_UART0_BUS_TX    do {} while (0)
60         #endif
61
62         /* USCI Register definitions */
63         #define UCSTAT  UCA0STAT
64         #define UCTXBUF UCA0TXBUF
65         #define UCRXBUF UCA0RXBUF
66         #define UCTXIFG UCA0TXIFG
67         #define UCRXIFG UCA0RXIFG
68         #define UCTXIE  UCA0TXIE
69         #define UCRXIE  UCA0RXIE
70         #define UCCTL0  UCA0CTL0
71         #define UCCTL1  UCA0CTL1
72         #define UCBR0   UCA0BR0
73         #define UCBR1   UCA0BR1
74         #define UCMCTL  UCA0MCTL
75         #define IE              IE2
76         #define IFG             IFG2
77
78         #if (CPU_MSP430_2274)
79                 #define KDBG_MSP430_UART_PINS_INIT()    do{ P3SEL = 0x30; }while(0)
80         #endif
81
82 #else
83
84         #if (CPU_MSP430_2274)
85                 #error only 1 UART availbale, CONFIG_KDEBUG_PORT should be 0
86         #endif
87
88 #endif
89
90 #define KDBG_WAIT_READY()     do { while((UCSTAT & UCBUSY)); } while(0)
91 #define KDBG_WAIT_TXDONE()    do { while(!(IFG & UCTXIFG)); } while(0)
92
93 #define KDBG_WRITE_CHAR(c)    do { UCTXBUF = (c); } while(0)
94
95 #define KDBG_MASK_IRQ(old)    do { \
96         (old) = IE; \
97         IE &= ~(UCTXIE|UCRXIE);\
98 } while(0)
99
100 #define KDBG_RESTORE_IRQ(old) do { \
101         KDBG_WAIT_TXDONE(); \
102         IE = (old); \
103 } while(0)
104
105 typedef uint8_t kdbg_irqsave_t;
106
107 INLINE void kdbg_hw_init(void)
108 {
109         /* Assume SMCLK = MCLK = DCO = CPU_FREQ */
110         /* Compute the baud rate */
111         uint16_t quot = DIV_ROUND(CPU_FREQ, CONFIG_KDEBUG_BAUDRATE);
112         KDBG_MSP430_UART_PINS_INIT();           // Configure USCI TX/RX pins
113         UCCTL1 |= UCSSEL_2;                                     // use SMCLK
114         UCBR0   = quot & 0xFF;
115         UCBR1   = quot >> 8;
116         UCMCTL  = UCBRS0;                                       // No Modulation
117         UCCTL0  = 0;                                            // Default UART settings (8N1)
118         UCCTL1 &= ~UCSWRST;                                     // Initialize USCI state machine
119         KDBG_MASK_IRQ(IE2);                                     // Disable USCI interrupts
120 }
121