shao ziyang / mbed-src-kl05

mbed library sources

Dependents:   frdm_kl05z_gpio_test

Fork of mbed-src by mbed official

targets/hal/TARGET_STM/TARGET_NUCLEO_F401RE/serial_api.c@125:23cc3068a9e4, 2014-03-19 (annotated)

Committer:
mbed_official
Date:
Wed Mar 19 10:15:22 2014 +0000
Revision:
125:23cc3068a9e4
Parent:
115:4f0cb9cdc478
Child:
172:2f4f8c56b261
Synchronized with git revision ace35dfba3748c7cdc102eb38ec6b9e1067c3252



Full URL: https://github.com/mbedmicro/mbed/commit/ace35dfba3748c7cdc102eb38ec6b9e1067c3252/



[NUCLEO_F302R8] Add cmsis and hal files + change F401RE clock to 84MHz

Who changed what in which revision?

UserRevisionLine numberNew contents of line
mbed_official 87:085cde657901 1 /* mbed Microcontroller Library
mbed_official 87:085cde657901 2 *******************************************************************************
mbed_official 87:085cde657901 3 * Copyright (c) 2014, STMicroelectronics
mbed_official 87:085cde657901 4 * All rights reserved.
mbed_official 87:085cde657901 5 *
mbed_official 87:085cde657901 6 * Redistribution and use in source and binary forms, with or without
mbed_official 87:085cde657901 7 * modification, are permitted provided that the following conditions are met:
mbed_official 87:085cde657901 8 *
mbed_official 87:085cde657901 9 * 1. Redistributions of source code must retain the above copyright notice,
mbed_official 87:085cde657901 10 * this list of conditions and the following disclaimer.
mbed_official 87:085cde657901 11 * 2. Redistributions in binary form must reproduce the above copyright notice,
mbed_official 87:085cde657901 12 * this list of conditions and the following disclaimer in the documentation
mbed_official 87:085cde657901 13 * and/or other materials provided with the distribution.
mbed_official 87:085cde657901 14 * 3. Neither the name of STMicroelectronics nor the names of its contributors
mbed_official 87:085cde657901 15 * may be used to endorse or promote products derived from this software
mbed_official 87:085cde657901 16 * without specific prior written permission.
mbed_official 87:085cde657901 17 *
mbed_official 87:085cde657901 18 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
mbed_official 87:085cde657901 19 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
mbed_official 87:085cde657901 20 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
mbed_official 87:085cde657901 21 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
mbed_official 87:085cde657901 22 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
mbed_official 87:085cde657901 23 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
mbed_official 87:085cde657901 24 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
mbed_official 87:085cde657901 25 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
mbed_official 87:085cde657901 26 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
mbed_official 87:085cde657901 27 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
mbed_official 87:085cde657901 28 *******************************************************************************
mbed_official 87:085cde657901 29 */
mbed_official 87:085cde657901 30 #include "serial_api.h"
mbed_official 87:085cde657901 31 #include "cmsis.h"
mbed_official 87:085cde657901 32 #include "pinmap.h"
mbed_official 87:085cde657901 33 #include "error.h"
mbed_official 87:085cde657901 34 #include <string.h>
mbed_official 87:085cde657901 35 #include "stm32f4xx_hal.h"
mbed_official 87:085cde657901 36
mbed_official 87:085cde657901 37 static const PinMap PinMap_UART_TX[] = {
mbed_official 125:23cc3068a9e4 38 {PA_2, UART_2, STM_PIN_DATA(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF7_USART2)},
mbed_official 87:085cde657901 39 {PA_9, UART_1, STM_PIN_DATA(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF7_USART1)},
mbed_official 125:23cc3068a9e4 40 {PA_11, UART_6, STM_PIN_DATA(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF8_USART6)},
mbed_official 125:23cc3068a9e4 41 {PB_6, UART_1, STM_PIN_DATA(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF7_USART1)},
mbed_official 125:23cc3068a9e4 42 {PC_6, UART_6, STM_PIN_DATA(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF8_USART6)},
mbed_official 87:085cde657901 43 {NC, NC, 0}
mbed_official 87:085cde657901 44 };
mbed_official 87:085cde657901 45
mbed_official 87:085cde657901 46 static const PinMap PinMap_UART_RX[] = {
mbed_official 125:23cc3068a9e4 47 {PA_3, UART_2, STM_PIN_DATA(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF7_USART2)},
mbed_official 87:085cde657901 48 {PA_10, UART_1, STM_PIN_DATA(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF7_USART1)},
mbed_official 125:23cc3068a9e4 49 {PA_12, UART_6, STM_PIN_DATA(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF8_USART6)},
mbed_official 125:23cc3068a9e4 50 {PB_7, UART_1, STM_PIN_DATA(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF7_USART1)},
mbed_official 125:23cc3068a9e4 51 {PC_7, UART_6, STM_PIN_DATA(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF8_USART6)},
mbed_official 87:085cde657901 52 {NC, NC, 0}
mbed_official 87:085cde657901 53 };
mbed_official 87:085cde657901 54
mbed_official 115:4f0cb9cdc478 55 #define UART_NUM (3)
mbed_official 87:085cde657901 56
mbed_official 87:085cde657901 57 static uint32_t serial_irq_ids[UART_NUM] = {0};
mbed_official 87:085cde657901 58
mbed_official 87:085cde657901 59 static uart_irq_handler irq_handler;
mbed_official 87:085cde657901 60
mbed_official 87:085cde657901 61 UART_HandleTypeDef UartHandle;
mbed_official 87:085cde657901 62
mbed_official 87:085cde657901 63 int stdio_uart_inited = 0;
mbed_official 87:085cde657901 64 serial_t stdio_uart;
mbed_official 87:085cde657901 65
mbed_official 87:085cde657901 66 static void init_uart(serial_t *obj) {
mbed_official 87:085cde657901 67 UartHandle.Instance = (USART_TypeDef *)(obj->uart);
mbed_official 87:085cde657901 68
mbed_official 87:085cde657901 69 UartHandle.Init.BaudRate = obj->baudrate;
mbed_official 87:085cde657901 70 UartHandle.Init.WordLength = obj->databits;
mbed_official 87:085cde657901 71 UartHandle.Init.StopBits = obj->stopbits;
mbed_official 87:085cde657901 72 UartHandle.Init.Parity = obj->parity;
mbed_official 87:085cde657901 73 UartHandle.Init.HwFlowCtl = UART_HWCONTROL_NONE;
mbed_official 87:085cde657901 74 UartHandle.Init.Mode = UART_MODE_TX_RX;
mbed_official 87:085cde657901 75
mbed_official 87:085cde657901 76 HAL_UART_Init(&UartHandle);
mbed_official 87:085cde657901 77 }
mbed_official 87:085cde657901 78
mbed_official 87:085cde657901 79 void serial_init(serial_t *obj, PinName tx, PinName rx) {
mbed_official 87:085cde657901 80 // Determine the UART to use (UART_1, UART_2, ...)
mbed_official 87:085cde657901 81 UARTName uart_tx = (UARTName)pinmap_peripheral(tx, PinMap_UART_TX);
mbed_official 87:085cde657901 82 UARTName uart_rx = (UARTName)pinmap_peripheral(rx, PinMap_UART_RX);
mbed_official 87:085cde657901 83
mbed_official 87:085cde657901 84 // Get the peripheral name (UART_1, UART_2, ...) from the pin and assign it to the object
mbed_official 87:085cde657901 85 obj->uart = (UARTName)pinmap_merge(uart_tx, uart_rx);
mbed_official 87:085cde657901 86
mbed_official 87:085cde657901 87 if (obj->uart == (UARTName)NC) {
mbed_official 87:085cde657901 88 error("Serial error: pinout mapping failed.");
mbed_official 87:085cde657901 89 }
mbed_official 87:085cde657901 90
mbed_official 87:085cde657901 91 // Enable USART clock
mbed_official 87:085cde657901 92 if (obj->uart == UART_1) {
mbed_official 87:085cde657901 93 __USART1_CLK_ENABLE();
mbed_official 87:085cde657901 94 }
mbed_official 87:085cde657901 95 if (obj->uart == UART_2) {
mbed_official 87:085cde657901 96 __USART2_CLK_ENABLE();
mbed_official 87:085cde657901 97 }
mbed_official 125:23cc3068a9e4 98 if (obj->uart == UART_6) {
mbed_official 125:23cc3068a9e4 99 __USART6_CLK_ENABLE();
mbed_official 115:4f0cb9cdc478 100 }
mbed_official 125:23cc3068a9e4 101
mbed_official 87:085cde657901 102 // Configure the UART pins
mbed_official 87:085cde657901 103 pinmap_pinout(tx, PinMap_UART_TX);
mbed_official 87:085cde657901 104 pinmap_pinout(rx, PinMap_UART_RX);
mbed_official 87:085cde657901 105 pin_mode(tx, PullUp);
mbed_official 87:085cde657901 106 pin_mode(rx, PullUp);
mbed_official 87:085cde657901 107
mbed_official 87:085cde657901 108 // Configure UART
mbed_official 87:085cde657901 109 obj->baudrate = 9600;
mbed_official 87:085cde657901 110 obj->databits = UART_WORDLENGTH_8B;
mbed_official 87:085cde657901 111 obj->stopbits = UART_STOPBITS_1;
mbed_official 87:085cde657901 112 obj->parity = UART_PARITY_NONE;
mbed_official 87:085cde657901 113
mbed_official 87:085cde657901 114 init_uart(obj);
mbed_official 87:085cde657901 115
mbed_official 87:085cde657901 116 // The index is used by irq
mbed_official 87:085cde657901 117 if (obj->uart == UART_1) obj->index = 0;
mbed_official 87:085cde657901 118 if (obj->uart == UART_2) obj->index = 1;
mbed_official 125:23cc3068a9e4 119 if (obj->uart == UART_6) obj->index = 2;
mbed_official 87:085cde657901 120
mbed_official 87:085cde657901 121 // For stdio management
mbed_official 87:085cde657901 122 if (obj->uart == STDIO_UART) {
mbed_official 87:085cde657901 123 stdio_uart_inited = 1;
mbed_official 87:085cde657901 124 memcpy(&stdio_uart, obj, sizeof(serial_t));
mbed_official 87:085cde657901 125 }
mbed_official 87:085cde657901 126
mbed_official 87:085cde657901 127 }
mbed_official 87:085cde657901 128
mbed_official 87:085cde657901 129 void serial_free(serial_t *obj) {
mbed_official 87:085cde657901 130 serial_irq_ids[obj->index] = 0;
mbed_official 87:085cde657901 131 }
mbed_official 87:085cde657901 132
mbed_official 87:085cde657901 133 void serial_baud(serial_t *obj, int baudrate) {
mbed_official 87:085cde657901 134 obj->baudrate = baudrate;
mbed_official 87:085cde657901 135 init_uart(obj);
mbed_official 87:085cde657901 136 }
mbed_official 87:085cde657901 137
mbed_official 87:085cde657901 138 void serial_format(serial_t *obj, int data_bits, SerialParity parity, int stop_bits) {
mbed_official 87:085cde657901 139 if (data_bits == 8) {
mbed_official 87:085cde657901 140 obj->databits = UART_WORDLENGTH_8B;
mbed_official 87:085cde657901 141 }
mbed_official 87:085cde657901 142 else {
mbed_official 87:085cde657901 143 obj->databits = UART_WORDLENGTH_9B;
mbed_official 87:085cde657901 144 }
mbed_official 87:085cde657901 145
mbed_official 87:085cde657901 146 switch (parity) {
mbed_official 87:085cde657901 147 case ParityOdd:
mbed_official 87:085cde657901 148 case ParityForced0:
mbed_official 87:085cde657901 149 obj->parity = UART_PARITY_ODD;
mbed_official 87:085cde657901 150 break;
mbed_official 87:085cde657901 151 case ParityEven:
mbed_official 87:085cde657901 152 case ParityForced1:
mbed_official 87:085cde657901 153 obj->parity = UART_PARITY_EVEN;
mbed_official 87:085cde657901 154 break;
mbed_official 87:085cde657901 155 default: // ParityNone
mbed_official 87:085cde657901 156 obj->parity = UART_PARITY_NONE;
mbed_official 87:085cde657901 157 break;
mbed_official 87:085cde657901 158 }
mbed_official 87:085cde657901 159
mbed_official 87:085cde657901 160 if (stop_bits == 2) {
mbed_official 87:085cde657901 161 obj->stopbits = UART_STOPBITS_2;
mbed_official 87:085cde657901 162 }
mbed_official 87:085cde657901 163 else {
mbed_official 87:085cde657901 164 obj->stopbits = UART_STOPBITS_1;
mbed_official 87:085cde657901 165 }
mbed_official 87:085cde657901 166
mbed_official 87:085cde657901 167 init_uart(obj);
mbed_official 87:085cde657901 168 }
mbed_official 87:085cde657901 169
mbed_official 87:085cde657901 170 /******************************************************************************
mbed_official 87:085cde657901 171 * INTERRUPTS HANDLING
mbed_official 87:085cde657901 172 ******************************************************************************/
mbed_official 87:085cde657901 173
mbed_official 87:085cde657901 174 // Not part of mbed api
mbed_official 87:085cde657901 175 static void uart_irq(UARTName name, int id) {
mbed_official 87:085cde657901 176 UartHandle.Instance = (USART_TypeDef *)name;
mbed_official 87:085cde657901 177
mbed_official 87:085cde657901 178 if (serial_irq_ids[id] != 0) {
mbed_official 87:085cde657901 179 if (__HAL_UART_GET_FLAG(&UartHandle, UART_FLAG_TC) != RESET) {
mbed_official 87:085cde657901 180 irq_handler(serial_irq_ids[id], TxIrq);
mbed_official 87:085cde657901 181 __HAL_UART_CLEAR_FLAG(&UartHandle, UART_FLAG_TC);
mbed_official 87:085cde657901 182 }
mbed_official 87:085cde657901 183 if (__HAL_UART_GET_FLAG(&UartHandle, UART_FLAG_RXNE) != RESET) {
mbed_official 87:085cde657901 184 irq_handler(serial_irq_ids[id], RxIrq);
mbed_official 87:085cde657901 185 __HAL_UART_CLEAR_FLAG(&UartHandle, UART_FLAG_RXNE);
mbed_official 87:085cde657901 186 }
mbed_official 87:085cde657901 187 }
mbed_official 87:085cde657901 188 }
mbed_official 87:085cde657901 189
mbed_official 87:085cde657901 190 // Not part of mbed api
mbed_official 87:085cde657901 191 static void uart1_irq(void) {uart_irq(UART_1, 0);}
mbed_official 87:085cde657901 192 static void uart2_irq(void) {uart_irq(UART_2, 1);}
mbed_official 125:23cc3068a9e4 193 static void uart6_irq(void) {uart_irq(UART_6, 2);}
mbed_official 87:085cde657901 194
mbed_official 87:085cde657901 195 void serial_irq_handler(serial_t *obj, uart_irq_handler handler, uint32_t id) {
mbed_official 87:085cde657901 196 irq_handler = handler;
mbed_official 87:085cde657901 197 serial_irq_ids[obj->index] = id;
mbed_official 87:085cde657901 198 }
mbed_official 87:085cde657901 199
mbed_official 87:085cde657901 200 void serial_irq_set(serial_t *obj, SerialIrq irq, uint32_t enable) {
mbed_official 87:085cde657901 201 IRQn_Type irq_n = (IRQn_Type)0;
mbed_official 87:085cde657901 202 uint32_t vector = 0;
mbed_official 87:085cde657901 203
mbed_official 87:085cde657901 204 UartHandle.Instance = (USART_TypeDef *)(obj->uart);
mbed_official 87:085cde657901 205
mbed_official 87:085cde657901 206 if (obj->uart == UART_1) {
mbed_official 87:085cde657901 207 irq_n = USART1_IRQn;
mbed_official 87:085cde657901 208 vector = (uint32_t)&uart1_irq;
mbed_official 87:085cde657901 209 }
mbed_official 87:085cde657901 210
mbed_official 87:085cde657901 211 if (obj->uart == UART_2) {
mbed_official 87:085cde657901 212 irq_n = USART2_IRQn;
mbed_official 87:085cde657901 213 vector = (uint32_t)&uart2_irq;
mbed_official 87:085cde657901 214 }
mbed_official 125:23cc3068a9e4 215
mbed_official 125:23cc3068a9e4 216 if (obj->uart == UART_6) {
mbed_official 125:23cc3068a9e4 217 irq_n = USART6_IRQn;
mbed_official 125:23cc3068a9e4 218 vector = (uint32_t)&uart6_irq;
mbed_official 125:23cc3068a9e4 219 }
mbed_official 87:085cde657901 220
mbed_official 87:085cde657901 221 if (enable) {
mbed_official 87:085cde657901 222
mbed_official 87:085cde657901 223 if (irq == RxIrq) {
mbed_official 87:085cde657901 224 __HAL_UART_ENABLE_IT(&UartHandle, UART_IT_RXNE);
mbed_official 87:085cde657901 225 }
mbed_official 87:085cde657901 226 else { // TxIrq
mbed_official 87:085cde657901 227 __HAL_UART_ENABLE_IT(&UartHandle, UART_IT_TC);
mbed_official 87:085cde657901 228 }
mbed_official 87:085cde657901 229
mbed_official 87:085cde657901 230 NVIC_SetVector(irq_n, vector);
mbed_official 87:085cde657901 231 NVIC_EnableIRQ(irq_n);
mbed_official 87:085cde657901 232
mbed_official 87:085cde657901 233 } else { // disable
mbed_official 87:085cde657901 234
mbed_official 87:085cde657901 235 int all_disabled = 0;
mbed_official 87:085cde657901 236
mbed_official 87:085cde657901 237 if (irq == RxIrq) {
mbed_official 87:085cde657901 238 __HAL_UART_DISABLE_IT(&UartHandle, UART_IT_RXNE);
mbed_official 87:085cde657901 239 // Check if TxIrq is disabled too
mbed_official 87:085cde657901 240 if ((UartHandle.Instance->CR1 & USART_CR1_TXEIE) == 0) all_disabled = 1;
mbed_official 87:085cde657901 241 }
mbed_official 87:085cde657901 242 else { // TxIrq
mbed_official 87:085cde657901 243 __HAL_UART_DISABLE_IT(&UartHandle, UART_IT_TXE);
mbed_official 87:085cde657901 244 // Check if RxIrq is disabled too
mbed_official 87:085cde657901 245 if ((UartHandle.Instance->CR1 & USART_CR1_RXNEIE) == 0) all_disabled = 1;
mbed_official 87:085cde657901 246 }
mbed_official 87:085cde657901 247
mbed_official 87:085cde657901 248 if (all_disabled) NVIC_DisableIRQ(irq_n);
mbed_official 87:085cde657901 249
mbed_official 87:085cde657901 250 }
mbed_official 87:085cde657901 251 }
mbed_official 87:085cde657901 252
mbed_official 87:085cde657901 253 /******************************************************************************
mbed_official 87:085cde657901 254 * READ/WRITE
mbed_official 87:085cde657901 255 ******************************************************************************/
mbed_official 87:085cde657901 256
mbed_official 87:085cde657901 257 int serial_getc(serial_t *obj) {
mbed_official 87:085cde657901 258 USART_TypeDef *uart = (USART_TypeDef *)(obj->uart);
mbed_official 87:085cde657901 259 while (!serial_readable(obj));
mbed_official 87:085cde657901 260 return (int)(uart->DR & 0x1FF);
mbed_official 87:085cde657901 261 }
mbed_official 87:085cde657901 262
mbed_official 87:085cde657901 263 void serial_putc(serial_t *obj, int c) {
mbed_official 87:085cde657901 264 USART_TypeDef *uart = (USART_TypeDef *)(obj->uart);
mbed_official 87:085cde657901 265 while (!serial_writable(obj));
mbed_official 87:085cde657901 266 uart->DR = (uint32_t)(c & 0x1FF);
mbed_official 87:085cde657901 267 }
mbed_official 87:085cde657901 268
mbed_official 87:085cde657901 269 int serial_readable(serial_t *obj) {
mbed_official 87:085cde657901 270 int status;
mbed_official 87:085cde657901 271 UartHandle.Instance = (USART_TypeDef *)(obj->uart);
mbed_official 87:085cde657901 272 // Check if data is received
mbed_official 87:085cde657901 273 status = ((__HAL_UART_GET_FLAG(&UartHandle, UART_FLAG_RXNE) != RESET) ? 1 : 0);
mbed_official 87:085cde657901 274 return status;
mbed_official 87:085cde657901 275 }
mbed_official 87:085cde657901 276
mbed_official 87:085cde657901 277 int serial_writable(serial_t *obj) {
mbed_official 87:085cde657901 278 int status;
mbed_official 87:085cde657901 279 UartHandle.Instance = (USART_TypeDef *)(obj->uart);
mbed_official 87:085cde657901 280 // Check if data is transmitted
mbed_official 87:085cde657901 281 status = ((__HAL_UART_GET_FLAG(&UartHandle, UART_FLAG_TXE) != RESET) ? 1 : 0);
mbed_official 87:085cde657901 282 return status;
mbed_official 87:085cde657901 283 }
mbed_official 87:085cde657901 284
mbed_official 87:085cde657901 285 void serial_clear(serial_t *obj) {
mbed_official 87:085cde657901 286 UartHandle.Instance = (USART_TypeDef *)(obj->uart);
mbed_official 87:085cde657901 287 __HAL_UART_CLEAR_FLAG(&UartHandle, UART_FLAG_TXE);
mbed_official 87:085cde657901 288 __HAL_UART_CLEAR_FLAG(&UartHandle, UART_FLAG_RXNE);
mbed_official 87:085cde657901 289 }
mbed_official 87:085cde657901 290
mbed_official 87:085cde657901 291 void serial_pinout_tx(PinName tx) {
mbed_official 87:085cde657901 292 pinmap_pinout(tx, PinMap_UART_TX);
mbed_official 87:085cde657901 293 }
mbed_official 87:085cde657901 294
mbed_official 87:085cde657901 295 void serial_break_set(serial_t *obj) {
mbed_official 87:085cde657901 296 UartHandle.Instance = (USART_TypeDef *)(obj->uart);
mbed_official 87:085cde657901 297 HAL_LIN_SendBreak(&UartHandle);
mbed_official 87:085cde657901 298 }
mbed_official 87:085cde657901 299
mbed_official 87:085cde657901 300 void serial_break_clear(serial_t *obj) {
mbed_official 87:085cde657901 301 }