Abdessamad El Abbassi / mbed-src-temp

mbed library sources

Fork of mbed-src by mbed official

targets/hal/TARGET_STM/TARGET_NUCLEO_F401RE/serial_api.c@115:4f0cb9cdc478, 2014-03-11 (annotated)

Committer:
mbed_official
Date:
Tue Mar 11 12:00:07 2014 +0000
Revision:
115:4f0cb9cdc478
Parent:
87:085cde657901
Child:
125:23cc3068a9e4
Synchronized with git revision 2bb462f5a37de3bf6e9c9ad9dc33e60be35d06a7



Full URL: https://github.com/mbedmicro/mbed/commit/2bb462f5a37de3bf6e9c9ad9dc33e60be35d06a7/

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