Stuart Northfield / mbed-src

mbed library sources

Fork of mbed-src by mbed official

targets/hal/TARGET_Freescale/TARGET_KPSDK_MCUS/serial_api.c@400:3234c374c245, 2014-11-15 (annotated)

Committer:
BigDotStu
Date:
Sat Nov 15 19:39:06 2014 +0000
Revision:
400:3234c374c245
Parent:
396:16d0d69d12f5 
Added serial IRQ getc to HAL

Who changed what in which revision?

UserRevisionLine numberNew contents of line
mbed_official 324:406fd2029f23 1 /* mbed Microcontroller Library
mbed_official 324:406fd2029f23 2 * Copyright (c) 2006-2013 ARM Limited
mbed_official 324:406fd2029f23 3 *
mbed_official 324:406fd2029f23 4 * Licensed under the Apache License, Version 2.0 (the "License");
mbed_official 324:406fd2029f23 5 * you may not use this file except in compliance with the License.
mbed_official 324:406fd2029f23 6 * You may obtain a copy of the License at
mbed_official 324:406fd2029f23 7 *
mbed_official 324:406fd2029f23 8 * http://www.apache.org/licenses/LICENSE-2.0
mbed_official 324:406fd2029f23 9 *
mbed_official 324:406fd2029f23 10 * Unless required by applicable law or agreed to in writing, software
mbed_official 324:406fd2029f23 11 * distributed under the License is distributed on an "AS IS" BASIS,
mbed_official 324:406fd2029f23 12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
mbed_official 324:406fd2029f23 13 * See the License for the specific language governing permissions and
mbed_official 324:406fd2029f23 14 * limitations under the License.
mbed_official 324:406fd2029f23 15 */
mbed_official 324:406fd2029f23 16 #include "serial_api.h"
mbed_official 324:406fd2029f23 17
mbed_official 324:406fd2029f23 18 #if DEVICE_SERIAL
mbed_official 324:406fd2029f23 19
mbed_official 324:406fd2029f23 20 // math.h required for floating point operations for baud rate calculation
mbed_official 324:406fd2029f23 21 #include <math.h>
mbed_official 324:406fd2029f23 22 #include "mbed_assert.h"
mbed_official 324:406fd2029f23 23
mbed_official 324:406fd2029f23 24 #include <string.h>
mbed_official 324:406fd2029f23 25
mbed_official 324:406fd2029f23 26 #include "cmsis.h"
mbed_official 324:406fd2029f23 27 #include "pinmap.h"
mbed_official 324:406fd2029f23 28 #include "fsl_uart_hal.h"
mbed_official 324:406fd2029f23 29 #include "fsl_clock_manager.h"
mbed_official 324:406fd2029f23 30 #include "fsl_uart_features.h"
mbed_official 324:406fd2029f23 31 #include "PeripheralPins.h"
mbed_official 324:406fd2029f23 32
mbed_official 324:406fd2029f23 33 /* TODO:
mbed_official 324:406fd2029f23 34 putchar/getchar 9 and 10 bits support
mbed_official 324:406fd2029f23 35 */
mbed_official 324:406fd2029f23 36 #ifndef UART3_BASE
mbed_official 324:406fd2029f23 37 #define UART_NUM 3
mbed_official 324:406fd2029f23 38 #else
mbed_official 324:406fd2029f23 39 #define UART_NUM 5
mbed_official 324:406fd2029f23 40 #endif
mbed_official 324:406fd2029f23 41
mbed_official 324:406fd2029f23 42 static uint32_t serial_irq_ids[UART_NUM] = {0};
mbed_official 324:406fd2029f23 43 static uart_irq_handler irq_handler;
mbed_official 324:406fd2029f23 44
mbed_official 324:406fd2029f23 45 int stdio_uart_inited = 0;
mbed_official 324:406fd2029f23 46 serial_t stdio_uart;
mbed_official 324:406fd2029f23 47
mbed_official 324:406fd2029f23 48 void serial_init(serial_t *obj, PinName tx, PinName rx) {
mbed_official 324:406fd2029f23 49 uint32_t uart_tx = pinmap_peripheral(tx, PinMap_UART_TX);
mbed_official 324:406fd2029f23 50 uint32_t uart_rx = pinmap_peripheral(rx, PinMap_UART_RX);
mbed_official 324:406fd2029f23 51 obj->index = pinmap_merge(uart_tx, uart_rx);
mbed_official 324:406fd2029f23 52 MBED_ASSERT((int)obj->index != NC);
mbed_official 324:406fd2029f23 53
mbed_official 324:406fd2029f23 54 uint32_t uartSourceClock = CLOCK_SYS_GetUartFreq(obj->index);
mbed_official 324:406fd2029f23 55
mbed_official 324:406fd2029f23 56 CLOCK_SYS_EnableUartClock(obj->index);
mbed_official 324:406fd2029f23 57 uint32_t uart_addrs[] = UART_BASE_ADDRS;
mbed_official 324:406fd2029f23 58 UART_HAL_Init(uart_addrs[obj->index]);
mbed_official 324:406fd2029f23 59 UART_HAL_SetBaudRate(uart_addrs[obj->index], uartSourceClock, 9600);
mbed_official 324:406fd2029f23 60 UART_HAL_SetParityMode(uart_addrs[obj->index], kUartParityDisabled);
mbed_official 324:406fd2029f23 61 #if FSL_FEATURE_UART_HAS_STOP_BIT_CONFIG_SUPPORT
mbed_official 324:406fd2029f23 62 UART_HAL_SetStopBitCount(uart_addrs[obj->index], kUartOneStopBit);
mbed_official 324:406fd2029f23 63 #endif
mbed_official 324:406fd2029f23 64 UART_HAL_SetBitCountPerChar(uart_addrs[obj->index], kUart8BitsPerChar);
mbed_official 324:406fd2029f23 65 UART_HAL_EnableTransmitter(uart_addrs[obj->index]);
mbed_official 324:406fd2029f23 66 UART_HAL_EnableReceiver(uart_addrs[obj->index]);
mbed_official 324:406fd2029f23 67
mbed_official 324:406fd2029f23 68 pinmap_pinout(tx, PinMap_UART_TX);
mbed_official 324:406fd2029f23 69 pinmap_pinout(rx, PinMap_UART_RX);
mbed_official 324:406fd2029f23 70
mbed_official 339:40bd4701f3e2 71 if (tx != NC) {
mbed_official 339:40bd4701f3e2 72 pin_mode(tx, PullUp);
mbed_official 339:40bd4701f3e2 73 }
mbed_official 339:40bd4701f3e2 74 if (rx != NC) {
mbed_official 339:40bd4701f3e2 75 pin_mode(rx, PullUp);
mbed_official 339:40bd4701f3e2 76 }
mbed_official 324:406fd2029f23 77
mbed_official 324:406fd2029f23 78 if (obj->index == STDIO_UART) {
mbed_official 324:406fd2029f23 79 stdio_uart_inited = 1;
mbed_official 324:406fd2029f23 80 memcpy(&stdio_uart, obj, sizeof(serial_t));
mbed_official 324:406fd2029f23 81 }
mbed_official 396:16d0d69d12f5 82 while(!UART_HAL_IsTxDataRegEmpty(uart_addrs[obj->index]));
mbed_official 324:406fd2029f23 83 }
mbed_official 324:406fd2029f23 84
mbed_official 324:406fd2029f23 85 void serial_free(serial_t *obj) {
mbed_official 324:406fd2029f23 86 serial_irq_ids[obj->index] = 0;
mbed_official 324:406fd2029f23 87 }
mbed_official 324:406fd2029f23 88
mbed_official 324:406fd2029f23 89 void serial_baud(serial_t *obj, int baudrate) {
mbed_official 324:406fd2029f23 90 uint32_t uart_addrs[] = UART_BASE_ADDRS;
mbed_official 324:406fd2029f23 91 UART_HAL_SetBaudRate(uart_addrs[obj->index], CLOCK_SYS_GetUartFreq(obj->index), (uint32_t)baudrate);
mbed_official 324:406fd2029f23 92 }
mbed_official 324:406fd2029f23 93
mbed_official 324:406fd2029f23 94 void serial_format(serial_t *obj, int data_bits, SerialParity parity, int stop_bits) {
mbed_official 324:406fd2029f23 95 uint32_t uart_addrs[] = UART_BASE_ADDRS;
mbed_official 324:406fd2029f23 96 UART_HAL_SetBitCountPerChar(uart_addrs[obj->index], (uart_bit_count_per_char_t)data_bits);
mbed_official 324:406fd2029f23 97 UART_HAL_SetParityMode(uart_addrs[obj->index], (uart_parity_mode_t)parity);
mbed_official 324:406fd2029f23 98 #if FSL_FEATURE_UART_HAS_STOP_BIT_CONFIG_SUPPORT
mbed_official 324:406fd2029f23 99 UART_HAL_SetStopBitCount(uart_addrs[obj->index], (uart_stop_bit_count_t)stop_bits);
mbed_official 324:406fd2029f23 100 #endif
mbed_official 324:406fd2029f23 101 }
mbed_official 324:406fd2029f23 102
mbed_official 324:406fd2029f23 103 /******************************************************************************
mbed_official 324:406fd2029f23 104 * INTERRUPTS HANDLING
mbed_official 324:406fd2029f23 105 ******************************************************************************/
mbed_official 324:406fd2029f23 106 static inline void uart_irq(uint32_t transmit_empty, uint32_t receive_full, uint32_t index) {
mbed_official 324:406fd2029f23 107 if (serial_irq_ids[index] != 0) {
mbed_official 324:406fd2029f23 108 if (transmit_empty)
mbed_official 324:406fd2029f23 109 irq_handler(serial_irq_ids[index], TxIrq);
mbed_official 324:406fd2029f23 110
mbed_official 324:406fd2029f23 111 if (receive_full)
mbed_official 324:406fd2029f23 112 irq_handler(serial_irq_ids[index], RxIrq);
mbed_official 324:406fd2029f23 113 }
mbed_official 324:406fd2029f23 114 }
mbed_official 324:406fd2029f23 115
mbed_official 324:406fd2029f23 116 void uart0_irq() {
mbed_official 324:406fd2029f23 117 uart_irq(UART_HAL_IsTxDataRegEmpty(UART0_BASE), UART_HAL_IsRxDataRegFull(UART0_BASE), 0);
mbed_official 324:406fd2029f23 118 if (UART_HAL_GetStatusFlag(UART0_BASE, kUartRxOverrun))
mbed_official 324:406fd2029f23 119 UART_HAL_ClearStatusFlag(UART0_BASE, kUartRxOverrun);
mbed_official 324:406fd2029f23 120 }
mbed_official 324:406fd2029f23 121 void uart1_irq() {
mbed_official 324:406fd2029f23 122 uart_irq(UART_HAL_IsTxDataRegEmpty(UART1_BASE), UART_HAL_IsRxDataRegFull(UART1_BASE), 1);
mbed_official 324:406fd2029f23 123 }
mbed_official 324:406fd2029f23 124
mbed_official 324:406fd2029f23 125 void uart2_irq() {
mbed_official 324:406fd2029f23 126 uart_irq(UART_HAL_IsTxDataRegEmpty(UART2_BASE), UART_HAL_IsRxDataRegFull(UART2_BASE), 2);
mbed_official 324:406fd2029f23 127 }
mbed_official 324:406fd2029f23 128
mbed_official 324:406fd2029f23 129 #if (UART_NUM > 3)
mbed_official 324:406fd2029f23 130
mbed_official 324:406fd2029f23 131 void uart3_irq() {
mbed_official 324:406fd2029f23 132 uart_irq(UART_HAL_IsTxDataRegEmpty(UART3_BASE), UART_HAL_IsRxDataRegFull(UART3_BASE), 3);
mbed_official 324:406fd2029f23 133 }
mbed_official 324:406fd2029f23 134
mbed_official 324:406fd2029f23 135 void uart4_irq() {
mbed_official 324:406fd2029f23 136 uart_irq(UART_HAL_IsTxDataRegEmpty(UART4_BASE), UART_HAL_IsRxDataRegFull(UART4_BASE), 4);
mbed_official 324:406fd2029f23 137 }
mbed_official 324:406fd2029f23 138 #endif
mbed_official 324:406fd2029f23 139
mbed_official 324:406fd2029f23 140 void serial_irq_handler(serial_t *obj, uart_irq_handler handler, uint32_t id) {
mbed_official 324:406fd2029f23 141 irq_handler = handler;
mbed_official 324:406fd2029f23 142 serial_irq_ids[obj->index] = id;
mbed_official 324:406fd2029f23 143 }
mbed_official 324:406fd2029f23 144
mbed_official 324:406fd2029f23 145 void serial_irq_set(serial_t *obj, SerialIrq irq, uint32_t enable) {
mbed_official 324:406fd2029f23 146 IRQn_Type irq_n = (IRQn_Type)0;
mbed_official 324:406fd2029f23 147 uint32_t vector = 0;
mbed_official 324:406fd2029f23 148
mbed_official 324:406fd2029f23 149 switch (obj->index) {
mbed_official 324:406fd2029f23 150 case 0: irq_n=UART0_RX_TX_IRQn; vector = (uint32_t)&uart0_irq; break;
mbed_official 324:406fd2029f23 151 case 1: irq_n=UART1_RX_TX_IRQn; vector = (uint32_t)&uart1_irq; break;
mbed_official 324:406fd2029f23 152 case 2: irq_n=UART2_RX_TX_IRQn; vector = (uint32_t)&uart2_irq; break;
mbed_official 324:406fd2029f23 153 #if (NUM_UART > 3)
mbed_official 324:406fd2029f23 154 case 3: irq_n=UART3_RX_TX_IRQn; vector = (uint32_t)&uart3_irq; break;
mbed_official 324:406fd2029f23 155 case 4: irq_n=UART4_RX_TX_IRQn; vector = (uint32_t)&uart4_irq; break;
mbed_official 324:406fd2029f23 156 #endif
mbed_official 324:406fd2029f23 157 }
mbed_official 324:406fd2029f23 158 uint32_t uart_addrs[] = UART_BASE_ADDRS;
mbed_official 324:406fd2029f23 159 if (enable) {
mbed_official 324:406fd2029f23 160 switch (irq) {
mbed_official 324:406fd2029f23 161 case RxIrq: UART_HAL_SetRxDataRegFullIntCmd(uart_addrs[obj->index], true); break;
mbed_official 324:406fd2029f23 162 case TxIrq: UART_HAL_SetTxDataRegEmptyIntCmd(uart_addrs[obj->index], true); break;
mbed_official 324:406fd2029f23 163 }
mbed_official 324:406fd2029f23 164 NVIC_SetVector(irq_n, vector);
mbed_official 324:406fd2029f23 165 NVIC_EnableIRQ(irq_n);
mbed_official 324:406fd2029f23 166
mbed_official 324:406fd2029f23 167 } else { // disable
mbed_official 324:406fd2029f23 168 int all_disabled = 0;
mbed_official 324:406fd2029f23 169 SerialIrq other_irq = (irq == RxIrq) ? (TxIrq) : (RxIrq);
mbed_official 324:406fd2029f23 170 switch (irq) {
mbed_official 324:406fd2029f23 171 case RxIrq: UART_HAL_SetRxDataRegFullIntCmd(uart_addrs[obj->index], false); break;
mbed_official 324:406fd2029f23 172 case TxIrq: UART_HAL_SetTxDataRegEmptyIntCmd(uart_addrs[obj->index], false); break;
mbed_official 324:406fd2029f23 173 }
mbed_official 324:406fd2029f23 174 switch (other_irq) {
mbed_official 324:406fd2029f23 175 case RxIrq: all_disabled = UART_HAL_GetRxDataRegFullIntCmd(uart_addrs[obj->index]) == 0; break;
mbed_official 324:406fd2029f23 176 case TxIrq: all_disabled = UART_HAL_GetTxDataRegEmptyIntCmd(uart_addrs[obj->index]) == 0; break;
mbed_official 324:406fd2029f23 177 }
mbed_official 324:406fd2029f23 178 if (all_disabled)
mbed_official 324:406fd2029f23 179 NVIC_DisableIRQ(irq_n);
mbed_official 324:406fd2029f23 180 }
mbed_official 324:406fd2029f23 181 }
mbed_official 324:406fd2029f23 182
mbed_official 324:406fd2029f23 183 int serial_getc(serial_t *obj) {
mbed_official 324:406fd2029f23 184 while (!serial_readable(obj));
mbed_official 324:406fd2029f23 185 uint8_t data;
mbed_official 324:406fd2029f23 186 uint32_t uart_addrs[] = UART_BASE_ADDRS;
mbed_official 324:406fd2029f23 187 UART_HAL_Getchar(uart_addrs[obj->index], &data);
mbed_official 324:406fd2029f23 188
mbed_official 324:406fd2029f23 189 return data;
mbed_official 324:406fd2029f23 190 }
mbed_official 324:406fd2029f23 191
BigDotStu 400:3234c374c245 192 int serial_getc_irq(serial_t *obj) {
BigDotStu 400:3234c374c245 193 uint8_t data;
BigDotStu 400:3234c374c245 194 uint32_t uart_addrs[] = UART_BASE_ADDRS;
BigDotStu 400:3234c374c245 195 UART_HAL_Getchar(uart_addrs[obj->index], &data);
BigDotStu 400:3234c374c245 196
BigDotStu 400:3234c374c245 197 return data;
BigDotStu 400:3234c374c245 198 }
mbed_official 324:406fd2029f23 199 void serial_putc(serial_t *obj, int c) {
mbed_official 324:406fd2029f23 200 while (!serial_writable(obj));
mbed_official 324:406fd2029f23 201 uint32_t uart_addrs[] = UART_BASE_ADDRS;
mbed_official 324:406fd2029f23 202 UART_HAL_Putchar(uart_addrs[obj->index], (uint8_t)c);
mbed_official 324:406fd2029f23 203 }
mbed_official 324:406fd2029f23 204
mbed_official 324:406fd2029f23 205 int serial_readable(serial_t *obj) {
mbed_official 324:406fd2029f23 206 uint32_t uart_address[] = UART_BASE_ADDRS;
mbed_official 324:406fd2029f23 207 if (UART_HAL_GetStatusFlag(uart_address[obj->index], kUartRxOverrun))
mbed_official 324:406fd2029f23 208 UART_HAL_ClearStatusFlag(uart_address[obj->index], kUartRxOverrun);
mbed_official 324:406fd2029f23 209 return UART_HAL_IsRxDataRegFull(uart_address[obj->index]);
mbed_official 324:406fd2029f23 210 }
mbed_official 324:406fd2029f23 211
mbed_official 324:406fd2029f23 212 int serial_writable(serial_t *obj) {
mbed_official 324:406fd2029f23 213 uint32_t uart_address[] = UART_BASE_ADDRS;
mbed_official 324:406fd2029f23 214 if (UART_HAL_GetStatusFlag(uart_address[obj->index], kUartRxOverrun))
mbed_official 324:406fd2029f23 215 UART_HAL_ClearStatusFlag(uart_address[obj->index], kUartRxOverrun);
mbed_official 324:406fd2029f23 216
mbed_official 324:406fd2029f23 217 return UART_HAL_IsTxDataRegEmpty(uart_address[obj->index]);
mbed_official 324:406fd2029f23 218 }
mbed_official 324:406fd2029f23 219
mbed_official 324:406fd2029f23 220 void serial_clear(serial_t *obj) {
mbed_official 324:406fd2029f23 221 }
mbed_official 324:406fd2029f23 222
mbed_official 324:406fd2029f23 223 void serial_pinout_tx(PinName tx) {
mbed_official 324:406fd2029f23 224 pinmap_pinout(tx, PinMap_UART_TX);
mbed_official 324:406fd2029f23 225 }
mbed_official 324:406fd2029f23 226
mbed_official 324:406fd2029f23 227 void serial_break_set(serial_t *obj) {
mbed_official 324:406fd2029f23 228 uint32_t uart_address[] = UART_BASE_ADDRS;
mbed_official 324:406fd2029f23 229 UART_HAL_SetBreakCharCmd(uart_address[obj->index], true);
mbed_official 324:406fd2029f23 230 }
mbed_official 324:406fd2029f23 231
mbed_official 324:406fd2029f23 232 void serial_break_clear(serial_t *obj) {
mbed_official 324:406fd2029f23 233 uint32_t uart_address[] = UART_BASE_ADDRS;
mbed_official 324:406fd2029f23 234 UART_HAL_SetBreakCharCmd(uart_address[obj->index], false);
mbed_official 324:406fd2029f23 235 }
mbed_official 324:406fd2029f23 236
mbed_official 324:406fd2029f23 237 #endif