Lancaster University / mbed-src

Important changes to repositories hosted on mbed.com

Mbed hosted mercurial repositories are deprecated and are due to be permanently deleted in July 2026.

To keep a copy of this software download the repository Zip archive or clone locally using Mercurial.

It is also possible to export all your personal repositories from the account settings page.

Fork of mbed-src by mbed official

targets/hal/TARGET_NORDIC/TARGET_MCU_NRF51822/serial_api.c@433:73d4f6083dd2, 2014-12-10 (annotated)

Committer:
mbed_official
Date:
Wed Dec 10 08:15:06 2014 +0000
Revision:
433:73d4f6083dd2
Parent:
407:bbbab616ce8f
Child:
501:36015dec7d16
Synchronized with git revision 87c17ed748337226aaa7b4a335fb700e7af21c96



Full URL: https://github.com/mbedmicro/mbed/commit/87c17ed748337226aaa7b4a335fb700e7af21c96/



Targets: NRF51822 - With the old logic if Serial::writeable() was called before and/or used ...

Who changed what in which revision?

UserRevisionLine numberNew contents of line
mbed_official 85:e1a8e879a6a9 1 /* mbed Microcontroller Library
mbed_official 104:a6a92e2e5a92 2 * Copyright (c) 2013 Nordic Semiconductor
mbed_official 85:e1a8e879a6a9 3 *
mbed_official 85:e1a8e879a6a9 4 * Licensed under the Apache License, Version 2.0 (the "License");
mbed_official 85:e1a8e879a6a9 5 * you may not use this file except in compliance with the License.
mbed_official 85:e1a8e879a6a9 6 * You may obtain a copy of the License at
mbed_official 85:e1a8e879a6a9 7 *
mbed_official 85:e1a8e879a6a9 8 * http://www.apache.org/licenses/LICENSE-2.0
mbed_official 85:e1a8e879a6a9 9 *
mbed_official 85:e1a8e879a6a9 10 * Unless required by applicable law or agreed to in writing, software
mbed_official 85:e1a8e879a6a9 11 * distributed under the License is distributed on an "AS IS" BASIS,
mbed_official 85:e1a8e879a6a9 12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
mbed_official 85:e1a8e879a6a9 13 * See the License for the specific language governing permissions and
mbed_official 85:e1a8e879a6a9 14 * limitations under the License.
mbed_official 85:e1a8e879a6a9 15 */
mbed_official 85:e1a8e879a6a9 16 // math.h required for floating point operations for baud rate calculation
mbed_official 85:e1a8e879a6a9 17 //#include <math.h>
mbed_official 85:e1a8e879a6a9 18 #include <string.h>
mbed_official 227:7bd0639b8911 19 #include "mbed_assert.h"
mbed_official 85:e1a8e879a6a9 20
mbed_official 85:e1a8e879a6a9 21 #include "serial_api.h"
mbed_official 85:e1a8e879a6a9 22 #include "cmsis.h"
mbed_official 85:e1a8e879a6a9 23 #include "pinmap.h"
mbed_official 227:7bd0639b8911 24
mbed_official 85:e1a8e879a6a9 25 /******************************************************************************
mbed_official 85:e1a8e879a6a9 26 * INITIALIZATION
mbed_official 85:e1a8e879a6a9 27 ******************************************************************************/
mbed_official 85:e1a8e879a6a9 28 #define UART_NUM 1
mbed_official 85:e1a8e879a6a9 29
mbed_official 85:e1a8e879a6a9 30 static uint32_t serial_irq_ids[UART_NUM] = {0};
mbed_official 85:e1a8e879a6a9 31 static uart_irq_handler irq_handler;
mbed_official 407:bbbab616ce8f 32 static uint32_t acceptedSpeeds[17][2] = {{1200, UART_BAUDRATE_BAUDRATE_Baud1200},
mbed_official 300:55638feb26a4 33 {2400, UART_BAUDRATE_BAUDRATE_Baud2400},
mbed_official 300:55638feb26a4 34 {4800, UART_BAUDRATE_BAUDRATE_Baud4800},
mbed_official 300:55638feb26a4 35 {9600, UART_BAUDRATE_BAUDRATE_Baud9600},
mbed_official 300:55638feb26a4 36 {14400, UART_BAUDRATE_BAUDRATE_Baud14400},
mbed_official 300:55638feb26a4 37 {19200, UART_BAUDRATE_BAUDRATE_Baud19200},
mbed_official 300:55638feb26a4 38 {28800, UART_BAUDRATE_BAUDRATE_Baud28800},
mbed_official 407:bbbab616ce8f 39 {31250, (0x00800000UL) /* 31250 baud */},
mbed_official 300:55638feb26a4 40 {38400, UART_BAUDRATE_BAUDRATE_Baud38400},
mbed_official 300:55638feb26a4 41 {57600, UART_BAUDRATE_BAUDRATE_Baud57600},
mbed_official 300:55638feb26a4 42 {76800, UART_BAUDRATE_BAUDRATE_Baud76800},
mbed_official 300:55638feb26a4 43 {115200, UART_BAUDRATE_BAUDRATE_Baud115200},
mbed_official 300:55638feb26a4 44 {230400, UART_BAUDRATE_BAUDRATE_Baud230400},
mbed_official 300:55638feb26a4 45 {250000, UART_BAUDRATE_BAUDRATE_Baud250000},
mbed_official 300:55638feb26a4 46 {460800, UART_BAUDRATE_BAUDRATE_Baud460800},
mbed_official 300:55638feb26a4 47 {921600, UART_BAUDRATE_BAUDRATE_Baud921600},
mbed_official 300:55638feb26a4 48 {1000000, UART_BAUDRATE_BAUDRATE_Baud1M}};
mbed_official 85:e1a8e879a6a9 49
mbed_official 85:e1a8e879a6a9 50 int stdio_uart_inited = 0;
mbed_official 85:e1a8e879a6a9 51 serial_t stdio_uart;
mbed_official 85:e1a8e879a6a9 52
mbed_official 85:e1a8e879a6a9 53
mbed_official 85:e1a8e879a6a9 54 void serial_init(serial_t *obj, PinName tx, PinName rx) {
mbed_official 288:17565898c031 55 UARTName uart = UART_0;
mbed_official 85:e1a8e879a6a9 56 obj->uart = (NRF_UART_Type *)uart;
mbed_official 300:55638feb26a4 57
mbed_official 227:7bd0639b8911 58 //pin configurations --
mbed_official 300:55638feb26a4 59 NRF_GPIO->DIR |= (1 << tx); //TX_PIN_NUMBER);
mbed_official 300:55638feb26a4 60 NRF_GPIO->DIR |= (1 << RTS_PIN_NUMBER);
mbed_official 85:e1a8e879a6a9 61
mbed_official 300:55638feb26a4 62 NRF_GPIO->DIR &= ~(1 << rx); //RX_PIN_NUMBER);
mbed_official 300:55638feb26a4 63 NRF_GPIO->DIR &= ~(1 << CTS_PIN_NUMBER);
mbed_official 300:55638feb26a4 64
mbed_official 300:55638feb26a4 65
mbed_official 85:e1a8e879a6a9 66 // set default baud rate and format
mbed_official 85:e1a8e879a6a9 67 serial_baud (obj, 9600);
mbed_official 85:e1a8e879a6a9 68 serial_format(obj, 8, ParityNone, 1);
mbed_official 300:55638feb26a4 69
mbed_official 300:55638feb26a4 70 obj->uart->ENABLE = (UART_ENABLE_ENABLE_Enabled << UART_ENABLE_ENABLE_Pos);
mbed_official 85:e1a8e879a6a9 71 obj->uart->TASKS_STARTTX = 1;
mbed_official 85:e1a8e879a6a9 72 obj->uart->TASKS_STARTRX = 1;
mbed_official 300:55638feb26a4 73 obj->uart->EVENTS_RXDRDY = 0;
mbed_official 433:73d4f6083dd2 74 // dummy write needed or TXDRDY trails write rather than leads write.
mbed_official 433:73d4f6083dd2 75 // pins are disconnected so nothing is physically transmitted on the wire
mbed_official 433:73d4f6083dd2 76 obj->uart->TXD = 0;
mbed_official 300:55638feb26a4 77
mbed_official 85:e1a8e879a6a9 78 obj->index = 0;
mbed_official 433:73d4f6083dd2 79
mbed_official 433:73d4f6083dd2 80 obj->uart->PSELRTS = RTS_PIN_NUMBER;
mbed_official 433:73d4f6083dd2 81 obj->uart->PSELTXD = tx; //TX_PIN_NUMBER;
mbed_official 433:73d4f6083dd2 82 obj->uart->PSELCTS = CTS_PIN_NUMBER;
mbed_official 433:73d4f6083dd2 83 obj->uart->PSELRXD = rx; //RX_PIN_NUMBER;
mbed_official 300:55638feb26a4 84
mbed_official 85:e1a8e879a6a9 85 // set rx/tx pins in PullUp mode
mbed_official 339:40bd4701f3e2 86 if (tx != NC) {
mbed_official 339:40bd4701f3e2 87 pin_mode(tx, PullUp);
mbed_official 339:40bd4701f3e2 88 }
mbed_official 339:40bd4701f3e2 89 if (rx != NC) {
mbed_official 339:40bd4701f3e2 90 pin_mode(rx, PullUp);
mbed_official 339:40bd4701f3e2 91 }
mbed_official 300:55638feb26a4 92
mbed_official 85:e1a8e879a6a9 93 if (uart == STDIO_UART) {
mbed_official 85:e1a8e879a6a9 94 stdio_uart_inited = 1;
mbed_official 85:e1a8e879a6a9 95 memcpy(&stdio_uart, obj, sizeof(serial_t));
mbed_official 85:e1a8e879a6a9 96 }
mbed_official 85:e1a8e879a6a9 97 }
mbed_official 85:e1a8e879a6a9 98
mbed_official 300:55638feb26a4 99 void serial_free(serial_t *obj)
mbed_official 300:55638feb26a4 100 {
mbed_official 85:e1a8e879a6a9 101 serial_irq_ids[obj->index] = 0;
mbed_official 85:e1a8e879a6a9 102 }
mbed_official 85:e1a8e879a6a9 103
mbed_official 85:e1a8e879a6a9 104 // serial_baud
mbed_official 85:e1a8e879a6a9 105 // set the baud rate, taking in to account the current SystemFrequency
mbed_official 300:55638feb26a4 106 void serial_baud(serial_t *obj, int baudrate)
mbed_official 300:55638feb26a4 107 {
mbed_official 300:55638feb26a4 108 if (baudrate<=1200) {
mbed_official 85:e1a8e879a6a9 109 obj->uart->BAUDRATE = UART_BAUDRATE_BAUDRATE_Baud1200;
mbed_official 85:e1a8e879a6a9 110 return;
mbed_official 227:7bd0639b8911 111 }
mbed_official 300:55638feb26a4 112
mbed_official 407:bbbab616ce8f 113 for (int i = 1; i<17; i++) {
mbed_official 300:55638feb26a4 114 if (baudrate<acceptedSpeeds[i][0]) {
mbed_official 300:55638feb26a4 115 obj->uart->BAUDRATE = acceptedSpeeds[i - 1][1];
mbed_official 85:e1a8e879a6a9 116 return;
mbed_official 85:e1a8e879a6a9 117 }
mbed_official 85:e1a8e879a6a9 118 }
mbed_official 85:e1a8e879a6a9 119 obj->uart->BAUDRATE = UART_BAUDRATE_BAUDRATE_Baud1M;
mbed_official 85:e1a8e879a6a9 120 }
mbed_official 85:e1a8e879a6a9 121
mbed_official 300:55638feb26a4 122 void serial_format(serial_t *obj, int data_bits, SerialParity parity, int stop_bits)
mbed_official 300:55638feb26a4 123 {
mbed_official 85:e1a8e879a6a9 124 // 0: 1 stop bits, 1: 2 stop bits
mbed_official 300:55638feb26a4 125 // int parity_enable, parity_select;
mbed_official 85:e1a8e879a6a9 126 switch (parity) {
mbed_official 227:7bd0639b8911 127 case ParityNone:
mbed_official 300:55638feb26a4 128 obj->uart->CONFIG = 0;
mbed_official 300:55638feb26a4 129 break;
mbed_official 85:e1a8e879a6a9 130 default:
mbed_official 300:55638feb26a4 131 obj->uart->CONFIG = (UART_CONFIG_PARITY_Included << UART_CONFIG_PARITY_Pos);
mbed_official 85:e1a8e879a6a9 132 return;
mbed_official 85:e1a8e879a6a9 133 }
mbed_official 85:e1a8e879a6a9 134 //no Flow Control
mbed_official 85:e1a8e879a6a9 135 }
mbed_official 85:e1a8e879a6a9 136
mbed_official 85:e1a8e879a6a9 137 //******************************************************************************
mbed_official 85:e1a8e879a6a9 138 // * INTERRUPT HANDLING
mbed_official 85:e1a8e879a6a9 139 //******************************************************************************
mbed_official 300:55638feb26a4 140 static inline void uart_irq(uint32_t iir, uint32_t index)
mbed_official 300:55638feb26a4 141 {
mbed_official 85:e1a8e879a6a9 142 SerialIrq irq_type;
mbed_official 85:e1a8e879a6a9 143 switch (iir) {
mbed_official 227:7bd0639b8911 144 case 1:
mbed_official 227:7bd0639b8911 145 irq_type = TxIrq;
mbed_official 300:55638feb26a4 146 break;
mbed_official 227:7bd0639b8911 147 case 2:
mbed_official 227:7bd0639b8911 148 irq_type = RxIrq;
mbed_official 300:55638feb26a4 149 break;
mbed_official 300:55638feb26a4 150
mbed_official 300:55638feb26a4 151 default:
mbed_official 300:55638feb26a4 152 return;
mbed_official 85:e1a8e879a6a9 153 }
mbed_official 300:55638feb26a4 154
mbed_official 300:55638feb26a4 155 if (serial_irq_ids[index] != 0) {
mbed_official 85:e1a8e879a6a9 156 irq_handler(serial_irq_ids[index], irq_type);
mbed_official 85:e1a8e879a6a9 157 }
mbed_official 85:e1a8e879a6a9 158 }
mbed_official 300:55638feb26a4 159
mbed_official 85:e1a8e879a6a9 160 #ifdef __cplusplus
mbed_official 85:e1a8e879a6a9 161 extern "C" {
mbed_official 227:7bd0639b8911 162 #endif
mbed_official 85:e1a8e879a6a9 163 void UART0_IRQHandler()
mbed_official 85:e1a8e879a6a9 164 {
mbed_official 300:55638feb26a4 165 uint32_t irtype = 0;
mbed_official 300:55638feb26a4 166
mbed_official 340:28d1f895c6fe 167 if((NRF_UART0->INTENSET & 0x80) && NRF_UART0->EVENTS_TXDRDY) {
mbed_official 300:55638feb26a4 168 irtype = 1;
mbed_official 340:28d1f895c6fe 169 } else if((NRF_UART0->INTENSET & 0x04) && NRF_UART0->EVENTS_RXDRDY) {
mbed_official 300:55638feb26a4 170 irtype = 2;
mbed_official 85:e1a8e879a6a9 171 }
mbed_official 85:e1a8e879a6a9 172 uart_irq(irtype, 0);
mbed_official 85:e1a8e879a6a9 173 }
mbed_official 300:55638feb26a4 174
mbed_official 85:e1a8e879a6a9 175 #ifdef __cplusplus
mbed_official 85:e1a8e879a6a9 176 }
mbed_official 227:7bd0639b8911 177 #endif
mbed_official 300:55638feb26a4 178 void serial_irq_handler(serial_t *obj, uart_irq_handler handler, uint32_t id)
mbed_official 300:55638feb26a4 179 {
mbed_official 300:55638feb26a4 180 irq_handler = handler;
mbed_official 85:e1a8e879a6a9 181 serial_irq_ids[obj->index] = id;
mbed_official 85:e1a8e879a6a9 182 }
mbed_official 85:e1a8e879a6a9 183
mbed_official 300:55638feb26a4 184 void serial_irq_set(serial_t *obj, SerialIrq irq, uint32_t enable)
mbed_official 300:55638feb26a4 185 {
mbed_official 85:e1a8e879a6a9 186 IRQn_Type irq_n = (IRQn_Type)0;
mbed_official 85:e1a8e879a6a9 187
mbed_official 85:e1a8e879a6a9 188 switch ((int)obj->uart) {
mbed_official 300:55638feb26a4 189 case UART_0:
mbed_official 300:55638feb26a4 190 irq_n = UART0_IRQn;
mbed_official 85:e1a8e879a6a9 191 break;
mbed_official 85:e1a8e879a6a9 192 }
mbed_official 300:55638feb26a4 193
mbed_official 85:e1a8e879a6a9 194 if (enable) {
mbed_official 85:e1a8e879a6a9 195 switch (irq) {
mbed_official 300:55638feb26a4 196 case RxIrq:
mbed_official 433:73d4f6083dd2 197 obj->uart->INTEN |= (UART_INTENSET_RXDRDY_Msk);
mbed_official 300:55638feb26a4 198 break;
mbed_official 300:55638feb26a4 199 case TxIrq:
mbed_official 433:73d4f6083dd2 200 obj->uart->INTEN |= (UART_INTENSET_TXDRDY_Msk);
mbed_official 300:55638feb26a4 201 break;
mbed_official 85:e1a8e879a6a9 202 }
mbed_official 85:e1a8e879a6a9 203 NVIC_SetPriority(irq_n, 3);
mbed_official 85:e1a8e879a6a9 204 NVIC_EnableIRQ(irq_n);
mbed_official 300:55638feb26a4 205 } else { // disable
mbed_official 433:73d4f6083dd2 206 // maseked writes to INTENSET dont disable and masked writes to
mbed_official 433:73d4f6083dd2 207 // INTENCLR seemed to clear the entire register, not bits.
mbed_official 433:73d4f6083dd2 208 // Added INTEN to memory map and seems to allow set and clearing of specific bits as desired
mbed_official 85:e1a8e879a6a9 209 int all_disabled = 0;
mbed_official 85:e1a8e879a6a9 210 switch (irq) {
mbed_official 300:55638feb26a4 211 case RxIrq:
mbed_official 433:73d4f6083dd2 212 obj->uart->INTEN &= ~(UART_INTENCLR_RXDRDY_Msk);
mbed_official 433:73d4f6083dd2 213 all_disabled = (obj->uart->INTENCLR & (UART_INTENCLR_TXDRDY_Msk)) == 0;
mbed_official 300:55638feb26a4 214 break;
mbed_official 300:55638feb26a4 215 case TxIrq:
mbed_official 433:73d4f6083dd2 216 obj->uart->INTEN &= ~(UART_INTENCLR_TXDRDY_Msk);
mbed_official 433:73d4f6083dd2 217 all_disabled = (obj->uart->INTENCLR & (UART_INTENCLR_RXDRDY_Msk)) == 0;
mbed_official 300:55638feb26a4 218 break;
mbed_official 85:e1a8e879a6a9 219 }
mbed_official 300:55638feb26a4 220
mbed_official 300:55638feb26a4 221 if (all_disabled) {
mbed_official 85:e1a8e879a6a9 222 NVIC_DisableIRQ(irq_n);
mbed_official 85:e1a8e879a6a9 223 }
mbed_official 85:e1a8e879a6a9 224 }
mbed_official 85:e1a8e879a6a9 225 }
mbed_official 85:e1a8e879a6a9 226
mbed_official 85:e1a8e879a6a9 227 //******************************************************************************
mbed_official 85:e1a8e879a6a9 228 //* READ/WRITE
mbed_official 85:e1a8e879a6a9 229 //******************************************************************************
mbed_official 300:55638feb26a4 230 int serial_getc(serial_t *obj)
mbed_official 300:55638feb26a4 231 {
mbed_official 300:55638feb26a4 232 while (!serial_readable(obj)) {
mbed_official 300:55638feb26a4 233 }
mbed_official 300:55638feb26a4 234
mbed_official 85:e1a8e879a6a9 235 obj->uart->EVENTS_RXDRDY = 0;
mbed_official 300:55638feb26a4 236
mbed_official 85:e1a8e879a6a9 237 return (uint8_t)obj->uart->RXD;
mbed_official 85:e1a8e879a6a9 238 }
mbed_official 85:e1a8e879a6a9 239
mbed_official 300:55638feb26a4 240 void serial_putc(serial_t *obj, int c)
mbed_official 300:55638feb26a4 241 {
mbed_official 300:55638feb26a4 242 while (!serial_writable(obj)) {
mbed_official 300:55638feb26a4 243 }
mbed_official 300:55638feb26a4 244
mbed_official 300:55638feb26a4 245 obj->uart->EVENTS_TXDRDY = 0;
mbed_official 433:73d4f6083dd2 246 obj->uart->TXD = (uint8_t)c;
mbed_official 85:e1a8e879a6a9 247 }
mbed_official 85:e1a8e879a6a9 248
mbed_official 300:55638feb26a4 249 int serial_readable(serial_t *obj)
mbed_official 300:55638feb26a4 250 {
mbed_official 85:e1a8e879a6a9 251 return (obj->uart->EVENTS_RXDRDY == 1);
mbed_official 85:e1a8e879a6a9 252 }
mbed_official 85:e1a8e879a6a9 253
mbed_official 300:55638feb26a4 254 int serial_writable(serial_t *obj)
mbed_official 300:55638feb26a4 255 {
mbed_official 433:73d4f6083dd2 256 return (obj->uart->EVENTS_TXDRDY == 1);
mbed_official 85:e1a8e879a6a9 257 }
mbed_official 85:e1a8e879a6a9 258
mbed_official 300:55638feb26a4 259 void serial_break_set(serial_t *obj)
mbed_official 300:55638feb26a4 260 {
mbed_official 85:e1a8e879a6a9 261 obj->uart->TASKS_SUSPEND = 1;
mbed_official 85:e1a8e879a6a9 262 }
mbed_official 85:e1a8e879a6a9 263
mbed_official 300:55638feb26a4 264 void serial_break_clear(serial_t *obj)
mbed_official 300:55638feb26a4 265 {
mbed_official 85:e1a8e879a6a9 266 obj->uart->TASKS_STARTTX = 1;
mbed_official 85:e1a8e879a6a9 267 obj->uart->TASKS_STARTRX = 1;
mbed_official 85:e1a8e879a6a9 268 }
mbed_official 340:28d1f895c6fe 269
mbed_official 340:28d1f895c6fe 270 void serial_set_flow_control(serial_t *obj, FlowControl type, PinName rxflow, PinName txflow)
mbed_official 340:28d1f895c6fe 271 {
mbed_official 340:28d1f895c6fe 272
mbed_official 340:28d1f895c6fe 273 if (type == FlowControlRTSCTS || type == FlowControlRTS) {
mbed_official 340:28d1f895c6fe 274 NRF_GPIO->DIR |= (1<<rxflow);
mbed_official 340:28d1f895c6fe 275 pin_mode(rxflow, PullUp);
mbed_official 340:28d1f895c6fe 276 obj->uart->PSELRTS = rxflow;
mbed_official 340:28d1f895c6fe 277
mbed_official 340:28d1f895c6fe 278 obj->uart->CONFIG |= 0x01; // Enable HWFC
mbed_official 340:28d1f895c6fe 279 }
mbed_official 340:28d1f895c6fe 280
mbed_official 340:28d1f895c6fe 281 if (type == FlowControlRTSCTS || type == FlowControlCTS) {
mbed_official 340:28d1f895c6fe 282 NRF_GPIO->DIR &= ~(1<<txflow);
mbed_official 340:28d1f895c6fe 283 pin_mode(txflow, PullUp);
mbed_official 340:28d1f895c6fe 284 obj->uart->PSELCTS = txflow;
mbed_official 340:28d1f895c6fe 285
mbed_official 340:28d1f895c6fe 286 obj->uart->CONFIG |= 0x01; // Enable HWFC;
mbed_official 340:28d1f895c6fe 287 }
mbed_official 340:28d1f895c6fe 288
mbed_official 340:28d1f895c6fe 289 if (type == FlowControlNone) {
mbed_official 340:28d1f895c6fe 290 obj->uart->PSELRTS = 0xFFFFFFFF; // Disable RTS
mbed_official 340:28d1f895c6fe 291 obj->uart->PSELCTS = 0xFFFFFFFF; // Disable CTS
mbed_official 340:28d1f895c6fe 292
mbed_official 340:28d1f895c6fe 293 obj->uart->CONFIG &= ~0x01; // Enable HWFC;
mbed_official 340:28d1f895c6fe 294 }
mbed_official 340:28d1f895c6fe 295 }
mbed_official 340:28d1f895c6fe 296
mbed_official 340:28d1f895c6fe 297 void serial_clear(serial_t *obj) {
mbed_official 340:28d1f895c6fe 298 }