mbed official / mbed-src

mbed library sources

Dependents:   Encrypted my_mbed lklk CyaSSL_DTLS_Cellular ... more

Superseded

This library was superseded by mbed-dev - https://os.mbed.com/users/mbed_official/code/mbed-dev/.

Development branch of the mbed library sources. This library is kept in synch with the latest changes from the mbed SDK and it is not guaranteed to work.

If you are looking for a stable and tested release, please import one of the official mbed library releases:

Import librarymbed

The official Mbed 2 C/C++ SDK provides the software platform and libraries to build your applications.

Last commit 20 Feb 2019 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 }