Blame view

RIOT/cpu/msp430fxyz/periph/uart.c 5.42 KB
a752c7ab   elopes   add first test an...
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
  /*
   * Copyright (C) 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.
   */
  
  /**
   * @ingroup     cpu_msp430fxyz
   * @ingroup     drivers_periph_uart
   * @{
   *
   * @file
   * @brief       Low-level UART driver implementation
   *
   * @author      Hauke Petersen <hauke.petersen@fu-berlin.de>
   *
   * @}
   */
  
  #include "cpu.h"
  #include "periph_cpu.h"
  #include "periph_conf.h"
  #include "periph/uart.h"
  
  /**
   * @brief   Keep track of the interrupt context
   * @{
   */
  static uart_rx_cb_t ctx_rx_cb;
  static void *ctx_isr_arg;
  /** @} */
  
  static int init_base(uart_t uart, uint32_t baudrate);
  
  /* per default, we use the legacy MSP430 USART module for UART functionality */
  #ifndef UART_USE_USCI
  
  int uart_init(uart_t uart, uint32_t baudrate, uart_rx_cb_t rx_cb, void *arg)
  {
      int res = init_base(uart, baudrate);
      if (res != UART_OK) {
          return res;
      }
  
      /* save interrupt context */
      ctx_rx_cb = rx_cb;
      ctx_isr_arg = arg;
      /* reset interrupt flags and enable RX interrupt */
      UART_IE &= ~(UART_IE_TX_BIT);
      UART_IF &= ~(UART_IE_RX_BIT);
      UART_IF |=  (UART_IE_TX_BIT);
      UART_IE |=  (UART_IE_RX_BIT);
      return UART_OK;
  }
  
  static int init_base(uart_t uart, uint32_t baudrate)
  {
      if (uart != 0) {
          return UART_NODEV;
      }
  
      /* get the default UART for now -> TODO: enable for multiple devices */
      msp_usart_t *dev = UART_BASE;
  
      /* power off and reset device */
      uart_poweroff(uart);
      dev->CTL = USART_CTL_SWRST;
      /* configure to 8N1 and using the SMCLK*/
      dev->CTL |= USART_CTL_CHAR;
      dev->TCTL = (USART_TCTL_TXEPT | USART_TCTL_SSEL_SMCLK);
      dev->RCTL = 0x00;
      /* baudrate configuration */
      uint16_t br = (uint16_t)(CLOCK_CMCLK / baudrate);
      dev->BR0 = (uint8_t)br;
      dev->BR1 = (uint8_t)(br >> 8);
      /* TODO: calculate value for modulation register */
      dev->MCTL = 0;
      /* configure pins -> TODO: move into GPIO driver (once implemented) */
      UART_PORT->SEL |= (UART_RX_PIN | UART_TX_PIN);
      UART_PORT->OD |= UART_RX_PIN;
      UART_PORT->OD &= ~(UART_TX_PIN);
      UART_PORT->DIR |= UART_TX_PIN;
      UART_PORT->DIR &= ~(UART_RX_PIN);
      /* enable receiver and transmitter */
      uart_poweron(uart);
      /* and finally release the software reset bit */
      dev->CTL &= ~(USART_CTL_SWRST);
      return UART_OK;
  }
  
  void uart_write(uart_t uart, const uint8_t *data, size_t len)
  {
      (void)uart;
      msp_usart_t *dev = UART_BASE;
  
      for (size_t i = 0; i < len; i++) {
          while (!(dev->TCTL & USART_TCTL_TXEPT)) {}
          dev->TXBUF = data[i];
      }
  }
  
  void uart_poweron(uart_t uart)
  {
      UART_ME |= UART_ME_BITS;
  }
  
  void uart_poweroff(uart_t uart)
  {
      UART_ME &= ~(UART_ME_BITS);
  }
  
  ISR(UART_RX_ISR, isr_uart_0_rx)
  {
      __enter_isr();
  
      /* read character (resets interrupt flag) */
      char c = UART_BASE->RXBUF;
  
      /* only call callback if there was no receive error */
      if(! (UART_BASE->RCTL & RXERR)) {
          ctx_rx_cb(ctx_isr_arg, c);
      }
  
      __exit_isr();
  }
  
  /* we use alternative UART code in case the board used the USCI module for UART
   * in case of the (older) USART module */
  #else
  
  int uart_init(uart_t uart, uint32_t baudrate, uart_rx_cb_t rx_cb, void *arg)
  {
      if (init_base(uart, baudrate) < 0) {
          return -1;
      }
  
      /* save interrupt context */
      ctx_rx_cb = rx_cb;
      ctx_isr_arg = arg;
      /* reset interrupt flags and enable RX interrupt */
      UART_IF &= ~(UART_IE_RX_BIT);
      UART_IF |=  (UART_IE_TX_BIT);
      UART_IE |=  (UART_IE_RX_BIT);
      UART_IE &= ~(UART_IE_TX_BIT);
      return 0;
  }
  
  static int init_base(uart_t uart, uint32_t baudrate)
  {
      if (uart != 0) {
          return -1;
      }
  
      /* get the default UART for now -> TODO: enable for multiple devices */
      msp_usci_t *dev = UART_BASE;
  
      /* put device in reset mode while configuration is going on */
      dev->ACTL1 = USCI_ACTL1_SWRST;
      /* configure to UART, using SMCLK in 8N1 mode */
      dev->ACTL1 |= USCI_ACTL1_SSEL_SMCLK;
      dev->ACTL0 = 0;
      dev->ASTAT = 0;
      /* configure baudrate */
      uint32_t base = ((CLOCK_CMCLK << 7)  / baudrate);
      uint16_t br = (uint16_t)(base >> 7);
      uint8_t brs = (((base & 0x3f) * 8) >> 7);
      dev->ABR0 = (uint8_t)br;
      dev->ABR1 = (uint8_t)(br >> 8);
      dev->AMCTL = (brs << USCI_AMCTL_BRS_SHIFT);
      /* pin configuration -> TODO: move to GPIO driver once implemented */
      UART_RX_PORT->SEL |= UART_RX_PIN;
      UART_TX_PORT->SEL |= UART_TX_PIN;
      UART_RX_PORT->DIR &= ~(UART_RX_PIN);
      UART_TX_PORT->DIR |= UART_TX_PIN;
      /* releasing the software reset bit starts the UART */
      dev->ACTL1 &= ~(USCI_ACTL1_SWRST);
      return 0;
  }
  
  void uart_write(uart_t uart, const uint8_t *data, size_t len)
  {
      (void)uart;
  
      for (size_t i = 0; i < len; i++) {
          while (!(UART_IF & UART_IE_TX_BIT)) {}
          UART_BASE->ATXBUF = data[i];
      }
  }
  
  void uart_poweron(uart_t uart)
  {
      (void)uart;
      /* n/a */
  }
  
  void uart_poweroff(uart_t uart)
  {
      (void)uart;
      /* n/a */
  }
  
  ISR(UART_RX_ISR, isr_uart_0_rx)
  {
      __enter_isr();
  
      uint8_t stat = UART_BASE->ASTAT;
      uint8_t data = (uint8_t)UART_BASE->ARXBUF;
  
      if (stat & (USCI_ASTAT_FE | USCI_ASTAT_OE | USCI_ASTAT_PE | USCI_ASTAT_BRK)) {
          /* some error which we do not handle, just do a pseudo read to reset the
           * status register */
          (void)data;
      }
      else {
          ctx_rx_cb(ctx_isr_arg, data);
      }
  
      __exit_isr();
  }
  
  #endif