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@87:085cde657901, 2014-02-08 (annotated)

Committer:
mbed_official
Date:
Sat Feb 08 19:45:06 2014 +0000
Revision:
87:085cde657901
Child:
115:4f0cb9cdc478
Synchronized with git revision 9272cdeb45ec7e6077641536509413da8fd2ebc2



Full URL: https://github.com/mbedmicro/mbed/commit/9272cdeb45ec7e6077641536509413da8fd2ebc2/



Add NUCLEO_F401RE, improvements

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 87:085cde657901 38 {PA_9, UART_1, STM_PIN_DATA(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF7_USART1)},
mbed_official 87:085cde657901 39 {PA_2, UART_2, STM_PIN_DATA(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF7_USART2)},
mbed_official 87:085cde657901 40 {NC, NC, 0}
mbed_official 87:085cde657901 41 };
mbed_official 87:085cde657901 42
mbed_official 87:085cde657901 43 static const PinMap PinMap_UART_RX[] = {
mbed_official 87:085cde657901 44 {PA_10, UART_1, STM_PIN_DATA(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF7_USART1)},
mbed_official 87:085cde657901 45 {PA_3, UART_2, STM_PIN_DATA(STM_MODE_AF_PP, GPIO_PULLUP, GPIO_AF7_USART2)},
mbed_official 87:085cde657901 46 {NC, NC, 0}
mbed_official 87:085cde657901 47 };
mbed_official 87:085cde657901 48
mbed_official 87:085cde657901 49 #define UART_NUM (2)
mbed_official 87:085cde657901 50
mbed_official 87:085cde657901 51 static uint32_t serial_irq_ids[UART_NUM] = {0};
mbed_official 87:085cde657901 52
mbed_official 87:085cde657901 53 static uart_irq_handler irq_handler;
mbed_official 87:085cde657901 54
mbed_official 87:085cde657901 55 UART_HandleTypeDef UartHandle;
mbed_official 87:085cde657901 56
mbed_official 87:085cde657901 57 int stdio_uart_inited = 0;
mbed_official 87:085cde657901 58 serial_t stdio_uart;
mbed_official 87:085cde657901 59
mbed_official 87:085cde657901 60 static void init_uart(serial_t *obj) {
mbed_official 87:085cde657901 61 UartHandle.Instance = (USART_TypeDef *)(obj->uart);
mbed_official 87:085cde657901 62
mbed_official 87:085cde657901 63 UartHandle.Init.BaudRate = obj->baudrate;
mbed_official 87:085cde657901 64 UartHandle.Init.WordLength = obj->databits;
mbed_official 87:085cde657901 65 UartHandle.Init.StopBits = obj->stopbits;
mbed_official 87:085cde657901 66 UartHandle.Init.Parity = obj->parity;
mbed_official 87:085cde657901 67 UartHandle.Init.HwFlowCtl = UART_HWCONTROL_NONE;
mbed_official 87:085cde657901 68 UartHandle.Init.Mode = UART_MODE_TX_RX;
mbed_official 87:085cde657901 69
mbed_official 87:085cde657901 70 HAL_UART_Init(&UartHandle);
mbed_official 87:085cde657901 71 }
mbed_official 87:085cde657901 72
mbed_official 87:085cde657901 73 void serial_init(serial_t *obj, PinName tx, PinName rx) {
mbed_official 87:085cde657901 74 // Determine the UART to use (UART_1, UART_2, ...)
mbed_official 87:085cde657901 75 UARTName uart_tx = (UARTName)pinmap_peripheral(tx, PinMap_UART_TX);
mbed_official 87:085cde657901 76 UARTName uart_rx = (UARTName)pinmap_peripheral(rx, PinMap_UART_RX);
mbed_official 87:085cde657901 77
mbed_official 87:085cde657901 78 // Get the peripheral name (UART_1, UART_2, ...) from the pin and assign it to the object
mbed_official 87:085cde657901 79 obj->uart = (UARTName)pinmap_merge(uart_tx, uart_rx);
mbed_official 87:085cde657901 80
mbed_official 87:085cde657901 81 if (obj->uart == (UARTName)NC) {
mbed_official 87:085cde657901 82 error("Serial error: pinout mapping failed.");
mbed_official 87:085cde657901 83 }
mbed_official 87:085cde657901 84
mbed_official 87:085cde657901 85 // Enable USART clock
mbed_official 87:085cde657901 86 if (obj->uart == UART_1) {
mbed_official 87:085cde657901 87 __USART1_CLK_ENABLE();
mbed_official 87:085cde657901 88 }
mbed_official 87:085cde657901 89 if (obj->uart == UART_2) {
mbed_official 87:085cde657901 90 __USART2_CLK_ENABLE();
mbed_official 87:085cde657901 91 }
mbed_official 87:085cde657901 92
mbed_official 87:085cde657901 93 // Configure the UART pins
mbed_official 87:085cde657901 94 pinmap_pinout(tx, PinMap_UART_TX);
mbed_official 87:085cde657901 95 pinmap_pinout(rx, PinMap_UART_RX);
mbed_official 87:085cde657901 96 pin_mode(tx, PullUp);
mbed_official 87:085cde657901 97 pin_mode(rx, PullUp);
mbed_official 87:085cde657901 98
mbed_official 87:085cde657901 99 // Configure UART
mbed_official 87:085cde657901 100 obj->baudrate = 9600;
mbed_official 87:085cde657901 101 obj->databits = UART_WORDLENGTH_8B;
mbed_official 87:085cde657901 102 obj->stopbits = UART_STOPBITS_1;
mbed_official 87:085cde657901 103 obj->parity = UART_PARITY_NONE;
mbed_official 87:085cde657901 104
mbed_official 87:085cde657901 105 init_uart(obj);
mbed_official 87:085cde657901 106
mbed_official 87:085cde657901 107 // The index is used by irq
mbed_official 87:085cde657901 108 if (obj->uart == UART_1) obj->index = 0;
mbed_official 87:085cde657901 109 if (obj->uart == UART_2) obj->index = 1;
mbed_official 87:085cde657901 110
mbed_official 87:085cde657901 111 // For stdio management
mbed_official 87:085cde657901 112 if (obj->uart == STDIO_UART) {
mbed_official 87:085cde657901 113 stdio_uart_inited = 1;
mbed_official 87:085cde657901 114 memcpy(&stdio_uart, obj, sizeof(serial_t));
mbed_official 87:085cde657901 115 }
mbed_official 87:085cde657901 116
mbed_official 87:085cde657901 117 }
mbed_official 87:085cde657901 118
mbed_official 87:085cde657901 119 void serial_free(serial_t *obj) {
mbed_official 87:085cde657901 120 serial_irq_ids[obj->index] = 0;
mbed_official 87:085cde657901 121 }
mbed_official 87:085cde657901 122
mbed_official 87:085cde657901 123 void serial_baud(serial_t *obj, int baudrate) {
mbed_official 87:085cde657901 124 obj->baudrate = baudrate;
mbed_official 87:085cde657901 125 init_uart(obj);
mbed_official 87:085cde657901 126 }
mbed_official 87:085cde657901 127
mbed_official 87:085cde657901 128 void serial_format(serial_t *obj, int data_bits, SerialParity parity, int stop_bits) {
mbed_official 87:085cde657901 129 if (data_bits == 8) {
mbed_official 87:085cde657901 130 obj->databits = UART_WORDLENGTH_8B;
mbed_official 87:085cde657901 131 }
mbed_official 87:085cde657901 132 else {
mbed_official 87:085cde657901 133 obj->databits = UART_WORDLENGTH_9B;
mbed_official 87:085cde657901 134 }
mbed_official 87:085cde657901 135
mbed_official 87:085cde657901 136 switch (parity) {
mbed_official 87:085cde657901 137 case ParityOdd:
mbed_official 87:085cde657901 138 case ParityForced0:
mbed_official 87:085cde657901 139 obj->parity = UART_PARITY_ODD;
mbed_official 87:085cde657901 140 break;
mbed_official 87:085cde657901 141 case ParityEven:
mbed_official 87:085cde657901 142 case ParityForced1:
mbed_official 87:085cde657901 143 obj->parity = UART_PARITY_EVEN;
mbed_official 87:085cde657901 144 break;
mbed_official 87:085cde657901 145 default: // ParityNone
mbed_official 87:085cde657901 146 obj->parity = UART_PARITY_NONE;
mbed_official 87:085cde657901 147 break;
mbed_official 87:085cde657901 148 }
mbed_official 87:085cde657901 149
mbed_official 87:085cde657901 150 if (stop_bits == 2) {
mbed_official 87:085cde657901 151 obj->stopbits = UART_STOPBITS_2;
mbed_official 87:085cde657901 152 }
mbed_official 87:085cde657901 153 else {
mbed_official 87:085cde657901 154 obj->stopbits = UART_STOPBITS_1;
mbed_official 87:085cde657901 155 }
mbed_official 87:085cde657901 156
mbed_official 87:085cde657901 157 init_uart(obj);
mbed_official 87:085cde657901 158 }
mbed_official 87:085cde657901 159
mbed_official 87:085cde657901 160 /******************************************************************************
mbed_official 87:085cde657901 161 * INTERRUPTS HANDLING
mbed_official 87:085cde657901 162 ******************************************************************************/
mbed_official 87:085cde657901 163
mbed_official 87:085cde657901 164 // Not part of mbed api
mbed_official 87:085cde657901 165 static void uart_irq(UARTName name, int id) {
mbed_official 87:085cde657901 166 UartHandle.Instance = (USART_TypeDef *)name;
mbed_official 87:085cde657901 167
mbed_official 87:085cde657901 168 if (serial_irq_ids[id] != 0) {
mbed_official 87:085cde657901 169 if (__HAL_UART_GET_FLAG(&UartHandle, UART_FLAG_TC) != RESET) {
mbed_official 87:085cde657901 170 irq_handler(serial_irq_ids[id], TxIrq);
mbed_official 87:085cde657901 171 __HAL_UART_CLEAR_FLAG(&UartHandle, UART_FLAG_TC);
mbed_official 87:085cde657901 172 }
mbed_official 87:085cde657901 173 if (__HAL_UART_GET_FLAG(&UartHandle, UART_FLAG_RXNE) != RESET) {
mbed_official 87:085cde657901 174 irq_handler(serial_irq_ids[id], RxIrq);
mbed_official 87:085cde657901 175 __HAL_UART_CLEAR_FLAG(&UartHandle, UART_FLAG_RXNE);
mbed_official 87:085cde657901 176 }
mbed_official 87:085cde657901 177 }
mbed_official 87:085cde657901 178 }
mbed_official 87:085cde657901 179
mbed_official 87:085cde657901 180 // Not part of mbed api
mbed_official 87:085cde657901 181 static void uart1_irq(void) {uart_irq(UART_1, 0);}
mbed_official 87:085cde657901 182 static void uart2_irq(void) {uart_irq(UART_2, 1);}
mbed_official 87:085cde657901 183
mbed_official 87:085cde657901 184 void serial_irq_handler(serial_t *obj, uart_irq_handler handler, uint32_t id) {
mbed_official 87:085cde657901 185 irq_handler = handler;
mbed_official 87:085cde657901 186 serial_irq_ids[obj->index] = id;
mbed_official 87:085cde657901 187 }
mbed_official 87:085cde657901 188
mbed_official 87:085cde657901 189 void serial_irq_set(serial_t *obj, SerialIrq irq, uint32_t enable) {
mbed_official 87:085cde657901 190 IRQn_Type irq_n = (IRQn_Type)0;
mbed_official 87:085cde657901 191 uint32_t vector = 0;
mbed_official 87:085cde657901 192
mbed_official 87:085cde657901 193 UartHandle.Instance = (USART_TypeDef *)(obj->uart);
mbed_official 87:085cde657901 194
mbed_official 87:085cde657901 195 if (obj->uart == UART_1) {
mbed_official 87:085cde657901 196 irq_n = USART1_IRQn;
mbed_official 87:085cde657901 197 vector = (uint32_t)&uart1_irq;
mbed_official 87:085cde657901 198 }
mbed_official 87:085cde657901 199
mbed_official 87:085cde657901 200 if (obj->uart == UART_2) {
mbed_official 87:085cde657901 201 irq_n = USART2_IRQn;
mbed_official 87:085cde657901 202 vector = (uint32_t)&uart2_irq;
mbed_official 87:085cde657901 203 }
mbed_official 87:085cde657901 204
mbed_official 87:085cde657901 205 if (enable) {
mbed_official 87:085cde657901 206
mbed_official 87:085cde657901 207 if (irq == RxIrq) {
mbed_official 87:085cde657901 208 __HAL_UART_ENABLE_IT(&UartHandle, UART_IT_RXNE);
mbed_official 87:085cde657901 209 }
mbed_official 87:085cde657901 210 else { // TxIrq
mbed_official 87:085cde657901 211 __HAL_UART_ENABLE_IT(&UartHandle, UART_IT_TC);
mbed_official 87:085cde657901 212 }
mbed_official 87:085cde657901 213
mbed_official 87:085cde657901 214 NVIC_SetVector(irq_n, vector);
mbed_official 87:085cde657901 215 NVIC_EnableIRQ(irq_n);
mbed_official 87:085cde657901 216
mbed_official 87:085cde657901 217 } else { // disable
mbed_official 87:085cde657901 218
mbed_official 87:085cde657901 219 int all_disabled = 0;
mbed_official 87:085cde657901 220
mbed_official 87:085cde657901 221 if (irq == RxIrq) {
mbed_official 87:085cde657901 222 __HAL_UART_DISABLE_IT(&UartHandle, UART_IT_RXNE);
mbed_official 87:085cde657901 223 // Check if TxIrq is disabled too
mbed_official 87:085cde657901 224 if ((UartHandle.Instance->CR1 & USART_CR1_TXEIE) == 0) all_disabled = 1;
mbed_official 87:085cde657901 225 }
mbed_official 87:085cde657901 226 else { // TxIrq
mbed_official 87:085cde657901 227 __HAL_UART_DISABLE_IT(&UartHandle, UART_IT_TXE);
mbed_official 87:085cde657901 228 // Check if RxIrq is disabled too
mbed_official 87:085cde657901 229 if ((UartHandle.Instance->CR1 & USART_CR1_RXNEIE) == 0) all_disabled = 1;
mbed_official 87:085cde657901 230 }
mbed_official 87:085cde657901 231
mbed_official 87:085cde657901 232 if (all_disabled) NVIC_DisableIRQ(irq_n);
mbed_official 87:085cde657901 233
mbed_official 87:085cde657901 234 }
mbed_official 87:085cde657901 235 }
mbed_official 87:085cde657901 236
mbed_official 87:085cde657901 237 /******************************************************************************
mbed_official 87:085cde657901 238 * READ/WRITE
mbed_official 87:085cde657901 239 ******************************************************************************/
mbed_official 87:085cde657901 240
mbed_official 87:085cde657901 241 int serial_getc(serial_t *obj) {
mbed_official 87:085cde657901 242 USART_TypeDef *uart = (USART_TypeDef *)(obj->uart);
mbed_official 87:085cde657901 243 while (!serial_readable(obj));
mbed_official 87:085cde657901 244 return (int)(uart->DR & 0x1FF);
mbed_official 87:085cde657901 245 }
mbed_official 87:085cde657901 246
mbed_official 87:085cde657901 247 void serial_putc(serial_t *obj, int c) {
mbed_official 87:085cde657901 248 USART_TypeDef *uart = (USART_TypeDef *)(obj->uart);
mbed_official 87:085cde657901 249 while (!serial_writable(obj));
mbed_official 87:085cde657901 250 uart->DR = (uint32_t)(c & 0x1FF);
mbed_official 87:085cde657901 251 }
mbed_official 87:085cde657901 252
mbed_official 87:085cde657901 253 int serial_readable(serial_t *obj) {
mbed_official 87:085cde657901 254 int status;
mbed_official 87:085cde657901 255 UartHandle.Instance = (USART_TypeDef *)(obj->uart);
mbed_official 87:085cde657901 256 // Check if data is received
mbed_official 87:085cde657901 257 status = ((__HAL_UART_GET_FLAG(&UartHandle, UART_FLAG_RXNE) != RESET) ? 1 : 0);
mbed_official 87:085cde657901 258 return status;
mbed_official 87:085cde657901 259 }
mbed_official 87:085cde657901 260
mbed_official 87:085cde657901 261 int serial_writable(serial_t *obj) {
mbed_official 87:085cde657901 262 int status;
mbed_official 87:085cde657901 263 UartHandle.Instance = (USART_TypeDef *)(obj->uart);
mbed_official 87:085cde657901 264 // Check if data is transmitted
mbed_official 87:085cde657901 265 status = ((__HAL_UART_GET_FLAG(&UartHandle, UART_FLAG_TXE) != RESET) ? 1 : 0);
mbed_official 87:085cde657901 266 return status;
mbed_official 87:085cde657901 267 }
mbed_official 87:085cde657901 268
mbed_official 87:085cde657901 269 void serial_clear(serial_t *obj) {
mbed_official 87:085cde657901 270 UartHandle.Instance = (USART_TypeDef *)(obj->uart);
mbed_official 87:085cde657901 271 __HAL_UART_CLEAR_FLAG(&UartHandle, UART_FLAG_TXE);
mbed_official 87:085cde657901 272 __HAL_UART_CLEAR_FLAG(&UartHandle, UART_FLAG_RXNE);
mbed_official 87:085cde657901 273 }
mbed_official 87:085cde657901 274
mbed_official 87:085cde657901 275 void serial_pinout_tx(PinName tx) {
mbed_official 87:085cde657901 276 pinmap_pinout(tx, PinMap_UART_TX);
mbed_official 87:085cde657901 277 }
mbed_official 87:085cde657901 278
mbed_official 87:085cde657901 279 void serial_break_set(serial_t *obj) {
mbed_official 87:085cde657901 280 UartHandle.Instance = (USART_TypeDef *)(obj->uart);
mbed_official 87:085cde657901 281 HAL_LIN_SendBreak(&UartHandle);
mbed_official 87:085cde657901 282 }
mbed_official 87:085cde657901 283
mbed_official 87:085cde657901 284 void serial_break_clear(serial_t *obj) {
mbed_official 87:085cde657901 285 }