Morpheus / target-freescale-ksdk

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 target-freescale-ksdk by -deleted-

serial_api.c@0:e4d670b91a9a, 2016-03-23 (annotated)

Committer:
screamer
Date:
Wed Mar 23 21:26:50 2016 +0000
Revision:
0:e4d670b91a9a
Initial revision

Who changed what in which revision?

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