Intelligent Systems / 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_Freescale/TARGET_KPSDK_MCUS/TARGET_K64F/serial_api.c@265:9632ea190e16, 2014-07-23 (annotated)

Committer:
mbed_official
Date:
Wed Jul 23 21:15:06 2014 +0100
Revision:
265:9632ea190e16
Parent:
227:7bd0639b8911
Child:
267:8673334f2cbe
Synchronized with git revision 7a5896cba254ab45829b43f6cef5563706ebba2b



Full URL: https://github.com/mbedmicro/mbed/commit/7a5896cba254ab45829b43f6cef5563706ebba2b/



[MTS_GAMBIT] Add new target support

Who changed what in which revision?

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