Rizky Ardi Maulana / mbed-os

mbed os rtos

targets/TARGET_STM/TARGET_STM32F2/serial_api.c@1:2b6e8130a0ac, 2018-02-22 (annotated)

Committer:
calmantara186
Date:
Thu Feb 22 14:05:19 2018 +0000
Revision:
1:2b6e8130a0ac
Parent:
0:f269e3021894 
mbed os

Who changed what in which revision?

UserRevisionLine numberNew contents of line
elessair 0:f269e3021894 1 /* mbed Microcontroller Library
elessair 0:f269e3021894 2 *******************************************************************************
elessair 0:f269e3021894 3 * Copyright (c) 2016, STMicroelectronics
elessair 0:f269e3021894 4 * All rights reserved.
elessair 0:f269e3021894 5 *
elessair 0:f269e3021894 6 * Redistribution and use in source and binary forms, with or without
elessair 0:f269e3021894 7 * modification, are permitted provided that the following conditions are met:
elessair 0:f269e3021894 8 *
elessair 0:f269e3021894 9 * 1. Redistributions of source code must retain the above copyright notice,
elessair 0:f269e3021894 10 * this list of conditions and the following disclaimer.
elessair 0:f269e3021894 11 * 2. Redistributions in binary form must reproduce the above copyright notice,
elessair 0:f269e3021894 12 * this list of conditions and the following disclaimer in the documentation
elessair 0:f269e3021894 13 * and/or other materials provided with the distribution.
elessair 0:f269e3021894 14 * 3. Neither the name of STMicroelectronics nor the names of its contributors
elessair 0:f269e3021894 15 * may be used to endorse or promote products derived from this software
elessair 0:f269e3021894 16 * without specific prior written permission.
elessair 0:f269e3021894 17 *
elessair 0:f269e3021894 18 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
elessair 0:f269e3021894 19 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
elessair 0:f269e3021894 20 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
elessair 0:f269e3021894 21 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
elessair 0:f269e3021894 22 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
elessair 0:f269e3021894 23 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
elessair 0:f269e3021894 24 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
elessair 0:f269e3021894 25 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
elessair 0:f269e3021894 26 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
elessair 0:f269e3021894 27 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
elessair 0:f269e3021894 28 *******************************************************************************
elessair 0:f269e3021894 29 */
elessair 0:f269e3021894 30 #include "mbed_assert.h"
elessair 0:f269e3021894 31 #include "serial_api.h"
elessair 0:f269e3021894 32
elessair 0:f269e3021894 33 #if DEVICE_SERIAL
elessair 0:f269e3021894 34
elessair 0:f269e3021894 35 #include "cmsis.h"
elessair 0:f269e3021894 36 #include "pinmap.h"
elessair 0:f269e3021894 37 #include <string.h>
elessair 0:f269e3021894 38 #include "PeripheralPins.h"
elessair 0:f269e3021894 39 #include "mbed_error.h"
elessair 0:f269e3021894 40
elessair 0:f269e3021894 41 #define UART_NUM (8)
elessair 0:f269e3021894 42
elessair 0:f269e3021894 43 static uint32_t serial_irq_ids[UART_NUM] = {0};
elessair 0:f269e3021894 44 static UART_HandleTypeDef uart_handlers[UART_NUM];
elessair 0:f269e3021894 45
elessair 0:f269e3021894 46 static uart_irq_handler irq_handler;
elessair 0:f269e3021894 47
elessair 0:f269e3021894 48 int stdio_uart_inited = 0;
elessair 0:f269e3021894 49 serial_t stdio_uart;
elessair 0:f269e3021894 50
elessair 0:f269e3021894 51 #if DEVICE_SERIAL_ASYNCH
elessair 0:f269e3021894 52 #define SERIAL_S(obj) (&((obj)->serial))
elessair 0:f269e3021894 53 #else
elessair 0:f269e3021894 54 #define SERIAL_S(obj) (obj)
elessair 0:f269e3021894 55 #endif
elessair 0:f269e3021894 56
elessair 0:f269e3021894 57 static void init_uart(serial_t *obj)
elessair 0:f269e3021894 58 {
elessair 0:f269e3021894 59 struct serial_s *obj_s = SERIAL_S(obj);
elessair 0:f269e3021894 60 UART_HandleTypeDef *huart = &uart_handlers[obj_s->index];
elessair 0:f269e3021894 61 huart->Instance = (USART_TypeDef *)(obj_s->uart);
elessair 0:f269e3021894 62
elessair 0:f269e3021894 63 huart->Init.BaudRate = obj_s->baudrate;
elessair 0:f269e3021894 64 huart->Init.WordLength = obj_s->databits;
elessair 0:f269e3021894 65 huart->Init.StopBits = obj_s->stopbits;
elessair 0:f269e3021894 66 huart->Init.Parity = obj_s->parity;
elessair 0:f269e3021894 67 #if DEVICE_SERIAL_FC
elessair 0:f269e3021894 68 huart->Init.HwFlowCtl = obj_s->hw_flow_ctl;
elessair 0:f269e3021894 69 #else
elessair 0:f269e3021894 70 huart->Init.HwFlowCtl = UART_HWCONTROL_NONE;
elessair 0:f269e3021894 71 #endif
elessair 0:f269e3021894 72 huart->TxXferCount = 0;
elessair 0:f269e3021894 73 huart->TxXferSize = 0;
elessair 0:f269e3021894 74 huart->RxXferCount = 0;
elessair 0:f269e3021894 75 huart->RxXferSize = 0;
elessair 0:f269e3021894 76
elessair 0:f269e3021894 77 if (obj_s->pin_rx == NC) {
elessair 0:f269e3021894 78 huart->Init.Mode = UART_MODE_TX;
elessair 0:f269e3021894 79 } else if (obj_s->pin_tx == NC) {
elessair 0:f269e3021894 80 huart->Init.Mode = UART_MODE_RX;
elessair 0:f269e3021894 81 } else {
elessair 0:f269e3021894 82 huart->Init.Mode = UART_MODE_TX_RX;
elessair 0:f269e3021894 83 }
elessair 0:f269e3021894 84
elessair 0:f269e3021894 85 if (HAL_UART_Init(huart) != HAL_OK) {
elessair 0:f269e3021894 86 error("Cannot initialize UART\n");
elessair 0:f269e3021894 87 }
elessair 0:f269e3021894 88 }
elessair 0:f269e3021894 89
elessair 0:f269e3021894 90 void serial_init(serial_t *obj, PinName tx, PinName rx)
elessair 0:f269e3021894 91 {
elessair 0:f269e3021894 92 struct serial_s *obj_s = SERIAL_S(obj);
elessair 0:f269e3021894 93
elessair 0:f269e3021894 94 // Determine the UART to use (UART_1, UART_2, ...)
elessair 0:f269e3021894 95 UARTName uart_tx = (UARTName)pinmap_peripheral(tx, PinMap_UART_TX);
elessair 0:f269e3021894 96 UARTName uart_rx = (UARTName)pinmap_peripheral(rx, PinMap_UART_RX);
elessair 0:f269e3021894 97
elessair 0:f269e3021894 98 // Get the peripheral name (UART_1, UART_2, ...) from the pin and assign it to the object
elessair 0:f269e3021894 99 obj_s->uart = (UARTName)pinmap_merge(uart_tx, uart_rx);
elessair 0:f269e3021894 100 MBED_ASSERT(obj_s->uart != (UARTName)NC);
elessair 0:f269e3021894 101
elessair 0:f269e3021894 102 // Enable USART clock
elessair 0:f269e3021894 103 switch (obj_s->uart) {
elessair 0:f269e3021894 104 case UART_1:
elessair 0:f269e3021894 105 __HAL_RCC_USART1_FORCE_RESET();
elessair 0:f269e3021894 106 __HAL_RCC_USART1_RELEASE_RESET();
elessair 0:f269e3021894 107 __HAL_RCC_USART1_CLK_ENABLE();
elessair 0:f269e3021894 108 obj_s->index = 0;
elessair 0:f269e3021894 109 break;
elessair 0:f269e3021894 110
elessair 0:f269e3021894 111 case UART_2:
elessair 0:f269e3021894 112 __HAL_RCC_USART2_FORCE_RESET();
elessair 0:f269e3021894 113 __HAL_RCC_USART2_RELEASE_RESET();
elessair 0:f269e3021894 114 __HAL_RCC_USART2_CLK_ENABLE();
elessair 0:f269e3021894 115 obj_s->index = 1;
elessair 0:f269e3021894 116 break;
elessair 0:f269e3021894 117
elessair 0:f269e3021894 118 #if defined(USART3_BASE)
elessair 0:f269e3021894 119 case UART_3:
elessair 0:f269e3021894 120 __HAL_RCC_USART3_FORCE_RESET();
elessair 0:f269e3021894 121 __HAL_RCC_USART3_RELEASE_RESET();
elessair 0:f269e3021894 122 __HAL_RCC_USART3_CLK_ENABLE();
elessair 0:f269e3021894 123 obj_s->index = 2;
elessair 0:f269e3021894 124 break;
elessair 0:f269e3021894 125 #endif
elessair 0:f269e3021894 126 #if defined(UART4_BASE)
elessair 0:f269e3021894 127 case UART_4:
elessair 0:f269e3021894 128 __HAL_RCC_UART4_FORCE_RESET();
elessair 0:f269e3021894 129 __HAL_RCC_UART4_RELEASE_RESET();
elessair 0:f269e3021894 130 __HAL_RCC_UART4_CLK_ENABLE();
elessair 0:f269e3021894 131 obj_s->index = 3;
elessair 0:f269e3021894 132 break;
elessair 0:f269e3021894 133 #endif
elessair 0:f269e3021894 134 #if defined(UART5_BASE)
elessair 0:f269e3021894 135 case UART_5:
elessair 0:f269e3021894 136 __HAL_RCC_UART5_FORCE_RESET();
elessair 0:f269e3021894 137 __HAL_RCC_UART5_RELEASE_RESET();
elessair 0:f269e3021894 138 __HAL_RCC_UART5_CLK_ENABLE();
elessair 0:f269e3021894 139 obj_s->index = 4;
elessair 0:f269e3021894 140 break;
elessair 0:f269e3021894 141 #endif
elessair 0:f269e3021894 142 #if defined(USART6_BASE)
elessair 0:f269e3021894 143 case UART_6:
elessair 0:f269e3021894 144 __HAL_RCC_USART6_FORCE_RESET();
elessair 0:f269e3021894 145 __HAL_RCC_USART6_RELEASE_RESET();
elessair 0:f269e3021894 146 __HAL_RCC_USART6_CLK_ENABLE();
elessair 0:f269e3021894 147 obj_s->index = 5;
elessair 0:f269e3021894 148 break;
elessair 0:f269e3021894 149 #endif
elessair 0:f269e3021894 150 #if defined(UART7_BASE)
elessair 0:f269e3021894 151 case UART_7:
elessair 0:f269e3021894 152 __HAL_RCC_UART7_FORCE_RESET();
elessair 0:f269e3021894 153 __HAL_RCC_UART7_RELEASE_RESET();
elessair 0:f269e3021894 154 __HAL_RCC_UART7_CLK_ENABLE();
elessair 0:f269e3021894 155 obj_s->index = 6;
elessair 0:f269e3021894 156 break;
elessair 0:f269e3021894 157 #endif
elessair 0:f269e3021894 158 #if defined(UART8_BASE)
elessair 0:f269e3021894 159 case UART_8:
elessair 0:f269e3021894 160 __HAL_RCC_UART8_FORCE_RESET();
elessair 0:f269e3021894 161 __HAL_RCC_UART8_RELEASE_RESET();
elessair 0:f269e3021894 162 __HAL_RCC_UART8_CLK_ENABLE();
elessair 0:f269e3021894 163 obj_s->index = 7;
elessair 0:f269e3021894 164 break;
elessair 0:f269e3021894 165 #endif
elessair 0:f269e3021894 166 }
elessair 0:f269e3021894 167
elessair 0:f269e3021894 168 // Configure the UART pins
elessair 0:f269e3021894 169 pinmap_pinout(tx, PinMap_UART_TX);
elessair 0:f269e3021894 170 pinmap_pinout(rx, PinMap_UART_RX);
elessair 0:f269e3021894 171
elessair 0:f269e3021894 172 if (tx != NC) {
elessair 0:f269e3021894 173 pin_mode(tx, PullUp);
elessair 0:f269e3021894 174 }
elessair 0:f269e3021894 175 if (rx != NC) {
elessair 0:f269e3021894 176 pin_mode(rx, PullUp);
elessair 0:f269e3021894 177 }
elessair 0:f269e3021894 178
elessair 0:f269e3021894 179 // Configure UART
elessair 0:f269e3021894 180 obj_s->baudrate = 9600;
elessair 0:f269e3021894 181 obj_s->databits = UART_WORDLENGTH_8B;
elessair 0:f269e3021894 182 obj_s->stopbits = UART_STOPBITS_1;
elessair 0:f269e3021894 183 obj_s->parity = UART_PARITY_NONE;
elessair 0:f269e3021894 184
elessair 0:f269e3021894 185 #if DEVICE_SERIAL_FC
elessair 0:f269e3021894 186 obj_s->hw_flow_ctl = UART_HWCONTROL_NONE;
elessair 0:f269e3021894 187 #endif
elessair 0:f269e3021894 188
elessair 0:f269e3021894 189 obj_s->pin_tx = tx;
elessair 0:f269e3021894 190 obj_s->pin_rx = rx;
elessair 0:f269e3021894 191
elessair 0:f269e3021894 192 init_uart(obj);
elessair 0:f269e3021894 193
elessair 0:f269e3021894 194 // For stdio management
elessair 0:f269e3021894 195 if (obj_s->uart == STDIO_UART) {
elessair 0:f269e3021894 196 stdio_uart_inited = 1;
elessair 0:f269e3021894 197 memcpy(&stdio_uart, obj, sizeof(serial_t));
elessair 0:f269e3021894 198 }
elessair 0:f269e3021894 199 }
elessair 0:f269e3021894 200
elessair 0:f269e3021894 201 void serial_free(serial_t *obj)
elessair 0:f269e3021894 202 {
elessair 0:f269e3021894 203 struct serial_s *obj_s = SERIAL_S(obj);
elessair 0:f269e3021894 204
elessair 0:f269e3021894 205 // Reset UART and disable clock
elessair 0:f269e3021894 206 switch (obj_s->index) {
elessair 0:f269e3021894 207 case 0:
elessair 0:f269e3021894 208 __USART1_FORCE_RESET();
elessair 0:f269e3021894 209 __USART1_RELEASE_RESET();
elessair 0:f269e3021894 210 __USART1_CLK_DISABLE();
elessair 0:f269e3021894 211 break;
elessair 0:f269e3021894 212
elessair 0:f269e3021894 213 case 1:
elessair 0:f269e3021894 214 __USART2_FORCE_RESET();
elessair 0:f269e3021894 215 __USART2_RELEASE_RESET();
elessair 0:f269e3021894 216 __USART2_CLK_DISABLE();
elessair 0:f269e3021894 217 break;
elessair 0:f269e3021894 218
elessair 0:f269e3021894 219 #if defined(USART3_BASE)
elessair 0:f269e3021894 220 case 2:
elessair 0:f269e3021894 221 __USART3_FORCE_RESET();
elessair 0:f269e3021894 222 __USART3_RELEASE_RESET();
elessair 0:f269e3021894 223 __USART3_CLK_DISABLE();
elessair 0:f269e3021894 224 break;
elessair 0:f269e3021894 225 #endif
elessair 0:f269e3021894 226 #if defined(UART4_BASE)
elessair 0:f269e3021894 227 case 3:
elessair 0:f269e3021894 228 __UART4_FORCE_RESET();
elessair 0:f269e3021894 229 __UART4_RELEASE_RESET();
elessair 0:f269e3021894 230 __UART4_CLK_DISABLE();
elessair 0:f269e3021894 231 break;
elessair 0:f269e3021894 232 #endif
elessair 0:f269e3021894 233 #if defined(UART5_BASE)
elessair 0:f269e3021894 234 case 4:
elessair 0:f269e3021894 235 __UART5_FORCE_RESET();
elessair 0:f269e3021894 236 __UART5_RELEASE_RESET();
elessair 0:f269e3021894 237 __UART5_CLK_DISABLE();
elessair 0:f269e3021894 238 break;
elessair 0:f269e3021894 239 #endif
elessair 0:f269e3021894 240 #if defined(USART6_BASE)
elessair 0:f269e3021894 241 case 5:
elessair 0:f269e3021894 242 __USART6_FORCE_RESET();
elessair 0:f269e3021894 243 __USART6_RELEASE_RESET();
elessair 0:f269e3021894 244 __USART6_CLK_DISABLE();
elessair 0:f269e3021894 245 break;
elessair 0:f269e3021894 246 #endif
elessair 0:f269e3021894 247 #if defined(UART7_BASE)
elessair 0:f269e3021894 248 case 6:
elessair 0:f269e3021894 249 __UART7_FORCE_RESET();
elessair 0:f269e3021894 250 __UART7_RELEASE_RESET();
elessair 0:f269e3021894 251 __UART7_CLK_DISABLE();
elessair 0:f269e3021894 252 break;
elessair 0:f269e3021894 253 #endif
elessair 0:f269e3021894 254 #if defined(UART8_BASE)
elessair 0:f269e3021894 255 case 7:
elessair 0:f269e3021894 256 __UART8_FORCE_RESET();
elessair 0:f269e3021894 257 __UART8_RELEASE_RESET();
elessair 0:f269e3021894 258 __UART8_CLK_DISABLE();
elessair 0:f269e3021894 259 break;
elessair 0:f269e3021894 260 #endif
elessair 0:f269e3021894 261 }
elessair 0:f269e3021894 262
elessair 0:f269e3021894 263 // Configure GPIOs
elessair 0:f269e3021894 264 pin_function(obj_s->pin_tx, STM_PIN_DATA(STM_MODE_INPUT, GPIO_NOPULL, 0));
elessair 0:f269e3021894 265 pin_function(obj_s->pin_rx, STM_PIN_DATA(STM_MODE_INPUT, GPIO_NOPULL, 0));
elessair 0:f269e3021894 266
elessair 0:f269e3021894 267 serial_irq_ids[obj_s->index] = 0;
elessair 0:f269e3021894 268 }
elessair 0:f269e3021894 269
elessair 0:f269e3021894 270 void serial_baud(serial_t *obj, int baudrate)
elessair 0:f269e3021894 271 {
elessair 0:f269e3021894 272 struct serial_s *obj_s = SERIAL_S(obj);
elessair 0:f269e3021894 273
elessair 0:f269e3021894 274 obj_s->baudrate = baudrate;
elessair 0:f269e3021894 275 init_uart(obj);
elessair 0:f269e3021894 276 }
elessair 0:f269e3021894 277
elessair 0:f269e3021894 278 void serial_format(serial_t *obj, int data_bits, SerialParity parity, int stop_bits)
elessair 0:f269e3021894 279 {
elessair 0:f269e3021894 280 struct serial_s *obj_s = SERIAL_S(obj);
elessair 0:f269e3021894 281
elessair 0:f269e3021894 282 if (data_bits == 9) {
elessair 0:f269e3021894 283 obj_s->databits = UART_WORDLENGTH_9B;
elessair 0:f269e3021894 284 } else {
elessair 0:f269e3021894 285 obj_s->databits = UART_WORDLENGTH_8B;
elessair 0:f269e3021894 286 }
elessair 0:f269e3021894 287
elessair 0:f269e3021894 288 switch (parity) {
elessair 0:f269e3021894 289 case ParityOdd:
elessair 0:f269e3021894 290 obj_s->parity = UART_PARITY_ODD;
elessair 0:f269e3021894 291 break;
elessair 0:f269e3021894 292 case ParityEven:
elessair 0:f269e3021894 293 obj_s->parity = UART_PARITY_EVEN;
elessair 0:f269e3021894 294 break;
elessair 0:f269e3021894 295 default: // ParityNone
elessair 0:f269e3021894 296 case ParityForced0: // unsupported!
elessair 0:f269e3021894 297 case ParityForced1: // unsupported!
elessair 0:f269e3021894 298 obj_s->parity = UART_PARITY_NONE;
elessair 0:f269e3021894 299 break;
elessair 0:f269e3021894 300 }
elessair 0:f269e3021894 301
elessair 0:f269e3021894 302 if (stop_bits == 2) {
elessair 0:f269e3021894 303 obj_s->stopbits = UART_STOPBITS_2;
elessair 0:f269e3021894 304 } else {
elessair 0:f269e3021894 305 obj_s->stopbits = UART_STOPBITS_1;
elessair 0:f269e3021894 306 }
elessair 0:f269e3021894 307
elessair 0:f269e3021894 308 init_uart(obj);
elessair 0:f269e3021894 309 }
elessair 0:f269e3021894 310
elessair 0:f269e3021894 311 /******************************************************************************
elessair 0:f269e3021894 312 * INTERRUPTS HANDLING
elessair 0:f269e3021894 313 ******************************************************************************/
elessair 0:f269e3021894 314
elessair 0:f269e3021894 315 static void uart_irq(int id)
elessair 0:f269e3021894 316 {
elessair 0:f269e3021894 317 UART_HandleTypeDef * huart = &uart_handlers[id];
elessair 0:f269e3021894 318
elessair 0:f269e3021894 319 if (serial_irq_ids[id] != 0) {
elessair 0:f269e3021894 320 if (__HAL_UART_GET_FLAG(huart, UART_FLAG_TC) != RESET) {
elessair 0:f269e3021894 321 if (__HAL_UART_GET_IT_SOURCE(huart, UART_IT_TC) != RESET) {
elessair 0:f269e3021894 322 irq_handler(serial_irq_ids[id], TxIrq);
elessair 0:f269e3021894 323 __HAL_UART_CLEAR_FLAG(huart, UART_FLAG_TC);
elessair 0:f269e3021894 324 }
elessair 0:f269e3021894 325 }
elessair 0:f269e3021894 326 if (__HAL_UART_GET_FLAG(huart, UART_FLAG_RXNE) != RESET) {
elessair 0:f269e3021894 327 if (__HAL_UART_GET_IT_SOURCE(huart, UART_IT_RXNE) != RESET) {
elessair 0:f269e3021894 328 irq_handler(serial_irq_ids[id], RxIrq);
elessair 0:f269e3021894 329 __HAL_UART_CLEAR_FLAG(huart, UART_FLAG_RXNE);
elessair 0:f269e3021894 330 }
elessair 0:f269e3021894 331 }
elessair 0:f269e3021894 332 if (__HAL_UART_GET_FLAG(huart, UART_FLAG_ORE) != RESET) {
elessair 0:f269e3021894 333 if (__HAL_UART_GET_IT_SOURCE(huart, USART_IT_ERR) != RESET) {
elessair 0:f269e3021894 334 volatile uint32_t tmpval = huart->Instance->DR; // Clear ORE flag
elessair 0:f269e3021894 335 }
elessair 0:f269e3021894 336 }
elessair 0:f269e3021894 337 }
elessair 0:f269e3021894 338 }
elessair 0:f269e3021894 339
elessair 0:f269e3021894 340 static void uart1_irq(void)
elessair 0:f269e3021894 341 {
elessair 0:f269e3021894 342 uart_irq(0);
elessair 0:f269e3021894 343 }
elessair 0:f269e3021894 344
elessair 0:f269e3021894 345 static void uart2_irq(void)
elessair 0:f269e3021894 346 {
elessair 0:f269e3021894 347 uart_irq(1);
elessair 0:f269e3021894 348 }
elessair 0:f269e3021894 349
elessair 0:f269e3021894 350 #if defined(USART3_BASE)
elessair 0:f269e3021894 351 static void uart3_irq(void)
elessair 0:f269e3021894 352 {
elessair 0:f269e3021894 353 uart_irq(2);
elessair 0:f269e3021894 354 }
elessair 0:f269e3021894 355 #endif
elessair 0:f269e3021894 356
elessair 0:f269e3021894 357 #if defined(UART4_BASE)
elessair 0:f269e3021894 358 static void uart4_irq(void)
elessair 0:f269e3021894 359 {
elessair 0:f269e3021894 360 uart_irq(3);
elessair 0:f269e3021894 361 }
elessair 0:f269e3021894 362 #endif
elessair 0:f269e3021894 363
elessair 0:f269e3021894 364 #if defined(UART5_BASE)
elessair 0:f269e3021894 365 static void uart5_irq(void)
elessair 0:f269e3021894 366 {
elessair 0:f269e3021894 367 uart_irq(4);
elessair 0:f269e3021894 368 }
elessair 0:f269e3021894 369 #endif
elessair 0:f269e3021894 370
elessair 0:f269e3021894 371 #if defined(USART6_BASE)
elessair 0:f269e3021894 372 static void uart6_irq(void)
elessair 0:f269e3021894 373 {
elessair 0:f269e3021894 374 uart_irq(5);
elessair 0:f269e3021894 375 }
elessair 0:f269e3021894 376 #endif
elessair 0:f269e3021894 377
elessair 0:f269e3021894 378 #if defined(UART7_BASE)
elessair 0:f269e3021894 379 static void uart7_irq(void)
elessair 0:f269e3021894 380 {
elessair 0:f269e3021894 381 uart_irq(6);
elessair 0:f269e3021894 382 }
elessair 0:f269e3021894 383 #endif
elessair 0:f269e3021894 384
elessair 0:f269e3021894 385 #if defined(UART8_BASE)
elessair 0:f269e3021894 386 static void uart8_irq(void)
elessair 0:f269e3021894 387 {
elessair 0:f269e3021894 388 uart_irq(7);
elessair 0:f269e3021894 389 }
elessair 0:f269e3021894 390 #endif
elessair 0:f269e3021894 391
elessair 0:f269e3021894 392 void serial_irq_handler(serial_t *obj, uart_irq_handler handler, uint32_t id)
elessair 0:f269e3021894 393 {
elessair 0:f269e3021894 394 struct serial_s *obj_s = SERIAL_S(obj);
elessair 0:f269e3021894 395
elessair 0:f269e3021894 396 irq_handler = handler;
elessair 0:f269e3021894 397 serial_irq_ids[obj_s->index] = id;
elessair 0:f269e3021894 398 }
elessair 0:f269e3021894 399
elessair 0:f269e3021894 400 void serial_irq_set(serial_t *obj, SerialIrq irq, uint32_t enable)
elessair 0:f269e3021894 401 {
elessair 0:f269e3021894 402 struct serial_s *obj_s = SERIAL_S(obj);
elessair 0:f269e3021894 403 UART_HandleTypeDef *huart = &uart_handlers[obj_s->index];
elessair 0:f269e3021894 404 IRQn_Type irq_n = (IRQn_Type)0;
elessair 0:f269e3021894 405 uint32_t vector = 0;
elessair 0:f269e3021894 406
elessair 0:f269e3021894 407 switch (obj_s->index) {
elessair 0:f269e3021894 408 case 0:
elessair 0:f269e3021894 409 irq_n = USART1_IRQn;
elessair 0:f269e3021894 410 vector = (uint32_t)&uart1_irq;
elessair 0:f269e3021894 411 break;
elessair 0:f269e3021894 412
elessair 0:f269e3021894 413 case 1:
elessair 0:f269e3021894 414 irq_n = USART2_IRQn;
elessair 0:f269e3021894 415 vector = (uint32_t)&uart2_irq;
elessair 0:f269e3021894 416 break;
elessair 0:f269e3021894 417 #if defined(USART3_BASE)
elessair 0:f269e3021894 418 case 2:
elessair 0:f269e3021894 419 irq_n = USART3_IRQn;
elessair 0:f269e3021894 420 vector = (uint32_t)&uart3_irq;
elessair 0:f269e3021894 421 break;
elessair 0:f269e3021894 422 #endif
elessair 0:f269e3021894 423 #if defined(UART4_BASE)
elessair 0:f269e3021894 424 case 3:
elessair 0:f269e3021894 425 irq_n = UART4_IRQn;
elessair 0:f269e3021894 426 vector = (uint32_t)&uart4_irq;
elessair 0:f269e3021894 427 break;
elessair 0:f269e3021894 428 #endif
elessair 0:f269e3021894 429 #if defined(UART5_BASE)
elessair 0:f269e3021894 430 case 4:
elessair 0:f269e3021894 431 irq_n = UART5_IRQn;
elessair 0:f269e3021894 432 vector = (uint32_t)&uart5_irq;
elessair 0:f269e3021894 433 break;
elessair 0:f269e3021894 434 #endif
elessair 0:f269e3021894 435 #if defined(USART6_BASE)
elessair 0:f269e3021894 436 case 5:
elessair 0:f269e3021894 437 irq_n = USART6_IRQn;
elessair 0:f269e3021894 438 vector = (uint32_t)&uart6_irq;
elessair 0:f269e3021894 439 break;
elessair 0:f269e3021894 440 #endif
elessair 0:f269e3021894 441 #if defined(UART7_BASE)
elessair 0:f269e3021894 442 case 6:
elessair 0:f269e3021894 443 irq_n = UART7_IRQn;
elessair 0:f269e3021894 444 vector = (uint32_t)&uart7_irq;
elessair 0:f269e3021894 445 break;
elessair 0:f269e3021894 446 #endif
elessair 0:f269e3021894 447 #if defined(UART8_BASE)
elessair 0:f269e3021894 448 case 7:
elessair 0:f269e3021894 449 irq_n = UART8_IRQn;
elessair 0:f269e3021894 450 vector = (uint32_t)&uart8_irq;
elessair 0:f269e3021894 451 break;
elessair 0:f269e3021894 452 #endif
elessair 0:f269e3021894 453 }
elessair 0:f269e3021894 454
elessair 0:f269e3021894 455 if (enable) {
elessair 0:f269e3021894 456 if (irq == RxIrq) {
elessair 0:f269e3021894 457 __HAL_UART_ENABLE_IT(huart, UART_IT_RXNE);
elessair 0:f269e3021894 458 } else { // TxIrq
elessair 0:f269e3021894 459 __HAL_UART_ENABLE_IT(huart, UART_IT_TC);
elessair 0:f269e3021894 460 }
elessair 0:f269e3021894 461 NVIC_SetVector(irq_n, vector);
elessair 0:f269e3021894 462 NVIC_EnableIRQ(irq_n);
elessair 0:f269e3021894 463
elessair 0:f269e3021894 464 } else { // disable
elessair 0:f269e3021894 465 int all_disabled = 0;
elessair 0:f269e3021894 466 if (irq == RxIrq) {
elessair 0:f269e3021894 467 __HAL_UART_DISABLE_IT(huart, UART_IT_RXNE);
elessair 0:f269e3021894 468 // Check if TxIrq is disabled too
elessair 0:f269e3021894 469 if ((huart->Instance->CR1 & USART_CR1_TXEIE) == 0) {
elessair 0:f269e3021894 470 all_disabled = 1;
elessair 0:f269e3021894 471 }
elessair 0:f269e3021894 472 } else { // TxIrq
elessair 0:f269e3021894 473 __HAL_UART_DISABLE_IT(huart, UART_IT_TC);
elessair 0:f269e3021894 474 // Check if RxIrq is disabled too
elessair 0:f269e3021894 475 if ((huart->Instance->CR1 & USART_CR1_RXNEIE) == 0) {
elessair 0:f269e3021894 476 all_disabled = 1;
elessair 0:f269e3021894 477 }
elessair 0:f269e3021894 478 }
elessair 0:f269e3021894 479
elessair 0:f269e3021894 480 if (all_disabled) {
elessair 0:f269e3021894 481 NVIC_DisableIRQ(irq_n);
elessair 0:f269e3021894 482 }
elessair 0:f269e3021894 483 }
elessair 0:f269e3021894 484 }
elessair 0:f269e3021894 485
elessair 0:f269e3021894 486 /******************************************************************************
elessair 0:f269e3021894 487 * READ/WRITE
elessair 0:f269e3021894 488 ******************************************************************************/
elessair 0:f269e3021894 489
elessair 0:f269e3021894 490 int serial_getc(serial_t *obj)
elessair 0:f269e3021894 491 {
elessair 0:f269e3021894 492 struct serial_s *obj_s = SERIAL_S(obj);
elessair 0:f269e3021894 493 UART_HandleTypeDef *huart = &uart_handlers[obj_s->index];
elessair 0:f269e3021894 494
elessair 0:f269e3021894 495 while (!serial_readable(obj));
elessair 0:f269e3021894 496 return (int)(huart->Instance->DR & (uint16_t)0x1FF);
elessair 0:f269e3021894 497 }
elessair 0:f269e3021894 498
elessair 0:f269e3021894 499 void serial_putc(serial_t *obj, int c)
elessair 0:f269e3021894 500 {
elessair 0:f269e3021894 501 struct serial_s *obj_s = SERIAL_S(obj);
elessair 0:f269e3021894 502 UART_HandleTypeDef *huart = &uart_handlers[obj_s->index];
elessair 0:f269e3021894 503
elessair 0:f269e3021894 504 while (!serial_writable(obj));
elessair 0:f269e3021894 505 huart->Instance->DR = (uint32_t)(c & (uint16_t)0x1FF);
elessair 0:f269e3021894 506 }
elessair 0:f269e3021894 507
elessair 0:f269e3021894 508 int serial_readable(serial_t *obj)
elessair 0:f269e3021894 509 {
elessair 0:f269e3021894 510 struct serial_s *obj_s = SERIAL_S(obj);
elessair 0:f269e3021894 511 UART_HandleTypeDef *huart = &uart_handlers[obj_s->index];
elessair 0:f269e3021894 512
elessair 0:f269e3021894 513 // Check if data is received
elessair 0:f269e3021894 514 return (__HAL_UART_GET_FLAG(huart, UART_FLAG_RXNE) != RESET) ? 1 : 0;
elessair 0:f269e3021894 515 }
elessair 0:f269e3021894 516
elessair 0:f269e3021894 517 int serial_writable(serial_t *obj)
elessair 0:f269e3021894 518 {
elessair 0:f269e3021894 519 struct serial_s *obj_s = SERIAL_S(obj);
elessair 0:f269e3021894 520 UART_HandleTypeDef *huart = &uart_handlers[obj_s->index];
elessair 0:f269e3021894 521
elessair 0:f269e3021894 522 // Check if data is transmitted
elessair 0:f269e3021894 523 return (__HAL_UART_GET_FLAG(huart, UART_FLAG_TXE) != RESET) ? 1 : 0;
elessair 0:f269e3021894 524 }
elessair 0:f269e3021894 525
elessair 0:f269e3021894 526 void serial_clear(serial_t *obj)
elessair 0:f269e3021894 527 {
elessair 0:f269e3021894 528 struct serial_s *obj_s = SERIAL_S(obj);
elessair 0:f269e3021894 529 UART_HandleTypeDef *huart = &uart_handlers[obj_s->index];
elessair 0:f269e3021894 530
elessair 0:f269e3021894 531 huart->TxXferCount = 0;
elessair 0:f269e3021894 532 huart->RxXferCount = 0;
elessair 0:f269e3021894 533 }
elessair 0:f269e3021894 534
elessair 0:f269e3021894 535 void serial_pinout_tx(PinName tx)
elessair 0:f269e3021894 536 {
elessair 0:f269e3021894 537 pinmap_pinout(tx, PinMap_UART_TX);
elessair 0:f269e3021894 538 }
elessair 0:f269e3021894 539
elessair 0:f269e3021894 540 void serial_break_set(serial_t *obj)
elessair 0:f269e3021894 541 {
elessair 0:f269e3021894 542 struct serial_s *obj_s = SERIAL_S(obj);
elessair 0:f269e3021894 543 UART_HandleTypeDef *huart = &uart_handlers[obj_s->index];
elessair 0:f269e3021894 544
elessair 0:f269e3021894 545 HAL_LIN_SendBreak(huart);
elessair 0:f269e3021894 546 }
elessair 0:f269e3021894 547
elessair 0:f269e3021894 548 void serial_break_clear(serial_t *obj)
elessair 0:f269e3021894 549 {
elessair 0:f269e3021894 550 (void)obj;
elessair 0:f269e3021894 551 }
elessair 0:f269e3021894 552
elessair 0:f269e3021894 553 #if DEVICE_SERIAL_ASYNCH
elessair 0:f269e3021894 554
elessair 0:f269e3021894 555 /******************************************************************************
elessair 0:f269e3021894 556 * LOCAL HELPER FUNCTIONS
elessair 0:f269e3021894 557 ******************************************************************************/
elessair 0:f269e3021894 558
elessair 0:f269e3021894 559 /**
elessair 0:f269e3021894 560 * Configure the TX buffer for an asynchronous write serial transaction
elessair 0:f269e3021894 561 *
elessair 0:f269e3021894 562 * @param obj The serial object.
elessair 0:f269e3021894 563 * @param tx The buffer for sending.
elessair 0:f269e3021894 564 * @param tx_length The number of words to transmit.
elessair 0:f269e3021894 565 */
elessair 0:f269e3021894 566 static void serial_tx_buffer_set(serial_t *obj, void *tx, int tx_length, uint8_t width)
elessair 0:f269e3021894 567 {
elessair 0:f269e3021894 568 (void)width;
elessair 0:f269e3021894 569
elessair 0:f269e3021894 570 // Exit if a transmit is already on-going
elessair 0:f269e3021894 571 if (serial_tx_active(obj)) {
elessair 0:f269e3021894 572 return;
elessair 0:f269e3021894 573 }
elessair 0:f269e3021894 574
elessair 0:f269e3021894 575 obj->tx_buff.buffer = tx;
elessair 0:f269e3021894 576 obj->tx_buff.length = tx_length;
elessair 0:f269e3021894 577 obj->tx_buff.pos = 0;
elessair 0:f269e3021894 578 }
elessair 0:f269e3021894 579
elessair 0:f269e3021894 580 /**
elessair 0:f269e3021894 581 * Configure the RX buffer for an asynchronous write serial transaction
elessair 0:f269e3021894 582 *
elessair 0:f269e3021894 583 * @param obj The serial object.
elessair 0:f269e3021894 584 * @param tx The buffer for sending.
elessair 0:f269e3021894 585 * @param tx_length The number of words to transmit.
elessair 0:f269e3021894 586 */
elessair 0:f269e3021894 587 static void serial_rx_buffer_set(serial_t *obj, void *rx, int rx_length, uint8_t width)
elessair 0:f269e3021894 588 {
elessair 0:f269e3021894 589 (void)width;
elessair 0:f269e3021894 590
elessair 0:f269e3021894 591 // Exit if a reception is already on-going
elessair 0:f269e3021894 592 if (serial_rx_active(obj)) {
elessair 0:f269e3021894 593 return;
elessair 0:f269e3021894 594 }
elessair 0:f269e3021894 595
elessair 0:f269e3021894 596 obj->rx_buff.buffer = rx;
elessair 0:f269e3021894 597 obj->rx_buff.length = rx_length;
elessair 0:f269e3021894 598 obj->rx_buff.pos = 0;
elessair 0:f269e3021894 599 }
elessair 0:f269e3021894 600
elessair 0:f269e3021894 601 /**
elessair 0:f269e3021894 602 * Configure events
elessair 0:f269e3021894 603 *
elessair 0:f269e3021894 604 * @param obj The serial object
elessair 0:f269e3021894 605 * @param event The logical OR of the events to configure
elessair 0:f269e3021894 606 * @param enable Set to non-zero to enable events, or zero to disable them
elessair 0:f269e3021894 607 */
elessair 0:f269e3021894 608 static void serial_enable_event(serial_t *obj, int event, uint8_t enable)
elessair 0:f269e3021894 609 {
elessair 0:f269e3021894 610 struct serial_s *obj_s = SERIAL_S(obj);
elessair 0:f269e3021894 611
elessair 0:f269e3021894 612 // Shouldn't have to enable interrupt here, just need to keep track of the requested events.
elessair 0:f269e3021894 613 if (enable) {
elessair 0:f269e3021894 614 obj_s->events |= event;
elessair 0:f269e3021894 615 } else {
elessair 0:f269e3021894 616 obj_s->events &= ~event;
elessair 0:f269e3021894 617 }
elessair 0:f269e3021894 618 }
elessair 0:f269e3021894 619
elessair 0:f269e3021894 620
elessair 0:f269e3021894 621 /**
elessair 0:f269e3021894 622 * Get index of serial object TX IRQ, relating it to the physical peripheral.
elessair 0:f269e3021894 623 *
elessair 0:f269e3021894 624 * @param obj pointer to serial object
elessair 0:f269e3021894 625 * @return internal NVIC TX IRQ index of U(S)ART peripheral
elessair 0:f269e3021894 626 */
elessair 0:f269e3021894 627 static IRQn_Type serial_get_irq_n(serial_t *obj)
elessair 0:f269e3021894 628 {
elessair 0:f269e3021894 629 struct serial_s *obj_s = SERIAL_S(obj);
elessair 0:f269e3021894 630 IRQn_Type irq_n;
elessair 0:f269e3021894 631
elessair 0:f269e3021894 632 switch (obj_s->index) {
elessair 0:f269e3021894 633 #if defined(USART1_BASE)
elessair 0:f269e3021894 634 case 0:
elessair 0:f269e3021894 635 irq_n = USART1_IRQn;
elessair 0:f269e3021894 636 break;
elessair 0:f269e3021894 637 #endif
elessair 0:f269e3021894 638 #if defined(USART2_BASE)
elessair 0:f269e3021894 639 case 1:
elessair 0:f269e3021894 640 irq_n = USART2_IRQn;
elessair 0:f269e3021894 641 break;
elessair 0:f269e3021894 642 #endif
elessair 0:f269e3021894 643 #if defined(USART3_BASE)
elessair 0:f269e3021894 644 case 2:
elessair 0:f269e3021894 645 irq_n = USART3_IRQn;
elessair 0:f269e3021894 646 break;
elessair 0:f269e3021894 647 #endif
elessair 0:f269e3021894 648 #if defined(UART4_BASE)
elessair 0:f269e3021894 649 case 3:
elessair 0:f269e3021894 650 irq_n = UART4_IRQn;
elessair 0:f269e3021894 651 break;
elessair 0:f269e3021894 652 #endif
elessair 0:f269e3021894 653 #if defined(UART5_BASE)
elessair 0:f269e3021894 654 case 4:
elessair 0:f269e3021894 655 irq_n = UART5_IRQn;
elessair 0:f269e3021894 656 break;
elessair 0:f269e3021894 657 #endif
elessair 0:f269e3021894 658 #if defined(USART6_BASE)
elessair 0:f269e3021894 659 case 5:
elessair 0:f269e3021894 660 irq_n = USART6_IRQn;
elessair 0:f269e3021894 661 break;
elessair 0:f269e3021894 662 #endif
elessair 0:f269e3021894 663 #if defined(UART7_BASE)
elessair 0:f269e3021894 664 case 6:
elessair 0:f269e3021894 665 irq_n = UART7_IRQn;
elessair 0:f269e3021894 666 break;
elessair 0:f269e3021894 667 #endif
elessair 0:f269e3021894 668 #if defined(UART8_BASE)
elessair 0:f269e3021894 669 case 7:
elessair 0:f269e3021894 670 irq_n = UART8_IRQn;
elessair 0:f269e3021894 671 break;
elessair 0:f269e3021894 672 #endif
elessair 0:f269e3021894 673 default:
elessair 0:f269e3021894 674 irq_n = (IRQn_Type)0;
elessair 0:f269e3021894 675 }
elessair 0:f269e3021894 676
elessair 0:f269e3021894 677 return irq_n;
elessair 0:f269e3021894 678 }
elessair 0:f269e3021894 679
elessair 0:f269e3021894 680
elessair 0:f269e3021894 681 /******************************************************************************
elessair 0:f269e3021894 682 * MBED API FUNCTIONS
elessair 0:f269e3021894 683 ******************************************************************************/
elessair 0:f269e3021894 684
elessair 0:f269e3021894 685 /**
elessair 0:f269e3021894 686 * Begin asynchronous TX transfer. The used buffer is specified in the serial
elessair 0:f269e3021894 687 * object, tx_buff
elessair 0:f269e3021894 688 *
elessair 0:f269e3021894 689 * @param obj The serial object
elessair 0:f269e3021894 690 * @param tx The buffer for sending
elessair 0:f269e3021894 691 * @param tx_length The number of words to transmit
elessair 0:f269e3021894 692 * @param tx_width The bit width of buffer word
elessair 0:f269e3021894 693 * @param handler The serial handler
elessair 0:f269e3021894 694 * @param event The logical OR of events to be registered
elessair 0:f269e3021894 695 * @param hint A suggestion for how to use DMA with this transfer
elessair 0:f269e3021894 696 * @return Returns number of data transfered, or 0 otherwise
elessair 0:f269e3021894 697 */
elessair 0:f269e3021894 698 int serial_tx_asynch(serial_t *obj, const void *tx, size_t tx_length, uint8_t tx_width, uint32_t handler, uint32_t event, DMAUsage hint)
elessair 0:f269e3021894 699 {
elessair 0:f269e3021894 700 // TODO: DMA usage is currently ignored
elessair 0:f269e3021894 701 (void) hint;
elessair 0:f269e3021894 702
elessair 0:f269e3021894 703 // Check buffer is ok
elessair 0:f269e3021894 704 MBED_ASSERT(tx != (void*)0);
elessair 0:f269e3021894 705 MBED_ASSERT(tx_width == 8); // support only 8b width
elessair 0:f269e3021894 706
elessair 0:f269e3021894 707 struct serial_s *obj_s = SERIAL_S(obj);
elessair 0:f269e3021894 708 UART_HandleTypeDef * huart = &uart_handlers[obj_s->index];
elessair 0:f269e3021894 709
elessair 0:f269e3021894 710 if (tx_length == 0) {
elessair 0:f269e3021894 711 return 0;
elessair 0:f269e3021894 712 }
elessair 0:f269e3021894 713
elessair 0:f269e3021894 714 // Set up buffer
elessair 0:f269e3021894 715 serial_tx_buffer_set(obj, (void *)tx, tx_length, tx_width);
elessair 0:f269e3021894 716
elessair 0:f269e3021894 717 // Set up events
elessair 0:f269e3021894 718 serial_enable_event(obj, SERIAL_EVENT_TX_ALL, 0); // Clear all events
elessair 0:f269e3021894 719 serial_enable_event(obj, event, 1); // Set only the wanted events
elessair 0:f269e3021894 720
elessair 0:f269e3021894 721 // Enable interrupt
elessair 0:f269e3021894 722 IRQn_Type irq_n = serial_get_irq_n(obj);
elessair 0:f269e3021894 723 NVIC_ClearPendingIRQ(irq_n);
elessair 0:f269e3021894 724 NVIC_DisableIRQ(irq_n);
elessair 0:f269e3021894 725 NVIC_SetPriority(irq_n, 1);
elessair 0:f269e3021894 726 NVIC_SetVector(irq_n, (uint32_t)handler);
elessair 0:f269e3021894 727 NVIC_EnableIRQ(irq_n);
elessair 0:f269e3021894 728
elessair 0:f269e3021894 729 // the following function will enable UART_IT_TXE and error interrupts
elessair 0:f269e3021894 730 if (HAL_UART_Transmit_IT(huart, (uint8_t*)tx, tx_length) != HAL_OK) {
elessair 0:f269e3021894 731 return 0;
elessair 0:f269e3021894 732 }
elessair 0:f269e3021894 733
elessair 0:f269e3021894 734 return tx_length;
elessair 0:f269e3021894 735 }
elessair 0:f269e3021894 736
elessair 0:f269e3021894 737 /**
elessair 0:f269e3021894 738 * Begin asynchronous RX transfer (enable interrupt for data collecting)
elessair 0:f269e3021894 739 * The used buffer is specified in the serial object, rx_buff
elessair 0:f269e3021894 740 *
elessair 0:f269e3021894 741 * @param obj The serial object
elessair 0:f269e3021894 742 * @param rx The buffer for sending
elessair 0:f269e3021894 743 * @param rx_length The number of words to transmit
elessair 0:f269e3021894 744 * @param rx_width The bit width of buffer word
elessair 0:f269e3021894 745 * @param handler The serial handler
elessair 0:f269e3021894 746 * @param event The logical OR of events to be registered
elessair 0:f269e3021894 747 * @param handler The serial handler
elessair 0:f269e3021894 748 * @param char_match A character in range 0-254 to be matched
elessair 0:f269e3021894 749 * @param hint A suggestion for how to use DMA with this transfer
elessair 0:f269e3021894 750 */
elessair 0:f269e3021894 751 void serial_rx_asynch(serial_t *obj, void *rx, size_t rx_length, uint8_t rx_width, uint32_t handler, uint32_t event, uint8_t char_match, DMAUsage hint)
elessair 0:f269e3021894 752 {
elessair 0:f269e3021894 753 // TODO: DMA usage is currently ignored
elessair 0:f269e3021894 754 (void) hint;
elessair 0:f269e3021894 755
elessair 0:f269e3021894 756 /* Sanity check arguments */
elessair 0:f269e3021894 757 MBED_ASSERT(obj);
elessair 0:f269e3021894 758 MBED_ASSERT(rx != (void*)0);
elessair 0:f269e3021894 759 MBED_ASSERT(rx_width == 8); // support only 8b width
elessair 0:f269e3021894 760
elessair 0:f269e3021894 761 struct serial_s *obj_s = SERIAL_S(obj);
elessair 0:f269e3021894 762 UART_HandleTypeDef *huart = &uart_handlers[obj_s->index];
elessair 0:f269e3021894 763
elessair 0:f269e3021894 764 serial_enable_event(obj, SERIAL_EVENT_RX_ALL, 0);
elessair 0:f269e3021894 765 serial_enable_event(obj, event, 1);
elessair 0:f269e3021894 766
elessair 0:f269e3021894 767 // set CharMatch
elessair 0:f269e3021894 768 obj->char_match = char_match;
elessair 0:f269e3021894 769
elessair 0:f269e3021894 770 serial_rx_buffer_set(obj, rx, rx_length, rx_width);
elessair 0:f269e3021894 771
elessair 0:f269e3021894 772 IRQn_Type irq_n = serial_get_irq_n(obj);
elessair 0:f269e3021894 773 NVIC_ClearPendingIRQ(irq_n);
elessair 0:f269e3021894 774 NVIC_DisableIRQ(irq_n);
elessair 0:f269e3021894 775 NVIC_SetPriority(irq_n, 0);
elessair 0:f269e3021894 776 NVIC_SetVector(irq_n, (uint32_t)handler);
elessair 0:f269e3021894 777 NVIC_EnableIRQ(irq_n);
elessair 0:f269e3021894 778
elessair 0:f269e3021894 779 // following HAL function will enable the RXNE interrupt + error interrupts
elessair 0:f269e3021894 780 HAL_UART_Receive_IT(huart, (uint8_t*)rx, rx_length);
elessair 0:f269e3021894 781 }
elessair 0:f269e3021894 782
elessair 0:f269e3021894 783 /**
elessair 0:f269e3021894 784 * Attempts to determine if the serial peripheral is already in use for TX
elessair 0:f269e3021894 785 *
elessair 0:f269e3021894 786 * @param obj The serial object
elessair 0:f269e3021894 787 * @return Non-zero if the TX transaction is ongoing, 0 otherwise
elessair 0:f269e3021894 788 */
elessair 0:f269e3021894 789 uint8_t serial_tx_active(serial_t *obj)
elessair 0:f269e3021894 790 {
elessair 0:f269e3021894 791 MBED_ASSERT(obj);
elessair 0:f269e3021894 792
elessair 0:f269e3021894 793 struct serial_s *obj_s = SERIAL_S(obj);
elessair 0:f269e3021894 794 UART_HandleTypeDef *huart = &uart_handlers[obj_s->index];
elessair 0:f269e3021894 795
elessair 0:f269e3021894 796 return ((HAL_UART_GetState(huart) == HAL_UART_STATE_BUSY_TX) ? 1 : 0);
elessair 0:f269e3021894 797 }
elessair 0:f269e3021894 798
elessair 0:f269e3021894 799 /**
elessair 0:f269e3021894 800 * Attempts to determine if the serial peripheral is already in use for RX
elessair 0:f269e3021894 801 *
elessair 0:f269e3021894 802 * @param obj The serial object
elessair 0:f269e3021894 803 * @return Non-zero if the RX transaction is ongoing, 0 otherwise
elessair 0:f269e3021894 804 */
elessair 0:f269e3021894 805 uint8_t serial_rx_active(serial_t *obj)
elessair 0:f269e3021894 806 {
elessair 0:f269e3021894 807 MBED_ASSERT(obj);
elessair 0:f269e3021894 808
elessair 0:f269e3021894 809 struct serial_s *obj_s = SERIAL_S(obj);
elessair 0:f269e3021894 810 UART_HandleTypeDef *huart = &uart_handlers[obj_s->index];
elessair 0:f269e3021894 811
elessair 0:f269e3021894 812 return ((HAL_UART_GetState(huart) == HAL_UART_STATE_BUSY_RX) ? 1 : 0);
elessair 0:f269e3021894 813 }
elessair 0:f269e3021894 814
elessair 0:f269e3021894 815 void HAL_UART_TxCpltCallback(UART_HandleTypeDef *huart) {
elessair 0:f269e3021894 816 if (__HAL_UART_GET_FLAG(huart, UART_FLAG_TC) != RESET) {
elessair 0:f269e3021894 817 __HAL_UART_CLEAR_FLAG(huart, UART_FLAG_TC);
elessair 0:f269e3021894 818 }
elessair 0:f269e3021894 819 }
elessair 0:f269e3021894 820
elessair 0:f269e3021894 821 void HAL_UART_ErrorCallback(UART_HandleTypeDef *huart) {
elessair 0:f269e3021894 822 if (__HAL_UART_GET_FLAG(huart, UART_FLAG_PE) != RESET) {
elessair 0:f269e3021894 823 volatile uint32_t tmpval = huart->Instance->DR; // Clear PE flag
elessair 0:f269e3021894 824 } else if (__HAL_UART_GET_FLAG(huart, UART_FLAG_FE) != RESET) {
elessair 0:f269e3021894 825 volatile uint32_t tmpval = huart->Instance->DR; // Clear FE flag
elessair 0:f269e3021894 826 } else if (__HAL_UART_GET_FLAG(huart, UART_FLAG_NE) != RESET) {
elessair 0:f269e3021894 827 volatile uint32_t tmpval = huart->Instance->DR; // Clear NE flag
elessair 0:f269e3021894 828 } else if (__HAL_UART_GET_FLAG(huart, UART_FLAG_ORE) != RESET) {
elessair 0:f269e3021894 829 volatile uint32_t tmpval = huart->Instance->DR; // Clear ORE flag
elessair 0:f269e3021894 830 }
elessair 0:f269e3021894 831 }
elessair 0:f269e3021894 832
elessair 0:f269e3021894 833 /**
elessair 0:f269e3021894 834 * The asynchronous TX and RX handler.
elessair 0:f269e3021894 835 *
elessair 0:f269e3021894 836 * @param obj The serial object
elessair 0:f269e3021894 837 * @return Returns event flags if a TX/RX transfer termination condition was met or 0 otherwise
elessair 0:f269e3021894 838 */
elessair 0:f269e3021894 839 int serial_irq_handler_asynch(serial_t *obj)
elessair 0:f269e3021894 840 {
elessair 0:f269e3021894 841 struct serial_s *obj_s = SERIAL_S(obj);
elessair 0:f269e3021894 842 UART_HandleTypeDef *huart = &uart_handlers[obj_s->index];
elessair 0:f269e3021894 843
elessair 0:f269e3021894 844 volatile int return_event = 0;
elessair 0:f269e3021894 845 uint8_t *buf = (uint8_t*)(obj->rx_buff.buffer);
elessair 0:f269e3021894 846 uint8_t i = 0;
elessair 0:f269e3021894 847
elessair 0:f269e3021894 848 // TX PART:
elessair 0:f269e3021894 849 if (__HAL_UART_GET_FLAG(huart, UART_FLAG_TC) != RESET) {
elessair 0:f269e3021894 850 if (__HAL_UART_GET_IT_SOURCE(huart, UART_IT_TC) != RESET) {
elessair 0:f269e3021894 851 // Return event SERIAL_EVENT_TX_COMPLETE if requested
elessair 0:f269e3021894 852 if ((obj_s->events & SERIAL_EVENT_TX_COMPLETE ) != 0) {
elessair 0:f269e3021894 853 return_event |= (SERIAL_EVENT_TX_COMPLETE & obj_s->events);
elessair 0:f269e3021894 854 }
elessair 0:f269e3021894 855 }
elessair 0:f269e3021894 856 }
elessair 0:f269e3021894 857
elessair 0:f269e3021894 858 // Handle error events
elessair 0:f269e3021894 859 if (__HAL_UART_GET_FLAG(huart, UART_FLAG_PE) != RESET) {
elessair 0:f269e3021894 860 if (__HAL_UART_GET_IT_SOURCE(huart, USART_IT_ERR) != RESET) {
elessair 0:f269e3021894 861 return_event |= (SERIAL_EVENT_RX_PARITY_ERROR & obj_s->events);
elessair 0:f269e3021894 862 }
elessair 0:f269e3021894 863 }
elessair 0:f269e3021894 864
elessair 0:f269e3021894 865 if (__HAL_UART_GET_FLAG(huart, UART_FLAG_FE) != RESET) {
elessair 0:f269e3021894 866 if (__HAL_UART_GET_IT_SOURCE(huart, USART_IT_ERR) != RESET) {
elessair 0:f269e3021894 867 return_event |= (SERIAL_EVENT_RX_FRAMING_ERROR & obj_s->events);
elessair 0:f269e3021894 868 }
elessair 0:f269e3021894 869 }
elessair 0:f269e3021894 870
elessair 0:f269e3021894 871 if (__HAL_UART_GET_FLAG(huart, UART_FLAG_ORE) != RESET) {
elessair 0:f269e3021894 872 if (__HAL_UART_GET_IT_SOURCE(huart, USART_IT_ERR) != RESET) {
elessair 0:f269e3021894 873 return_event |= (SERIAL_EVENT_RX_OVERRUN_ERROR & obj_s->events);
elessair 0:f269e3021894 874 }
elessair 0:f269e3021894 875 }
elessair 0:f269e3021894 876
elessair 0:f269e3021894 877 HAL_UART_IRQHandler(huart);
elessair 0:f269e3021894 878
elessair 0:f269e3021894 879 // Abort if an error occurs
elessair 0:f269e3021894 880 if (return_event & SERIAL_EVENT_RX_PARITY_ERROR ||
elessair 0:f269e3021894 881 return_event & SERIAL_EVENT_RX_FRAMING_ERROR ||
elessair 0:f269e3021894 882 return_event & SERIAL_EVENT_RX_OVERRUN_ERROR) {
elessair 0:f269e3021894 883 return return_event;
elessair 0:f269e3021894 884 }
elessair 0:f269e3021894 885
elessair 0:f269e3021894 886 //RX PART
elessair 0:f269e3021894 887 if (huart->RxXferSize != 0) {
elessair 0:f269e3021894 888 obj->rx_buff.pos = huart->RxXferSize - huart->RxXferCount;
elessair 0:f269e3021894 889 }
elessair 0:f269e3021894 890 if ((huart->RxXferCount == 0) && (obj->rx_buff.pos >= (obj->rx_buff.length - 1))) {
elessair 0:f269e3021894 891 return_event |= (SERIAL_EVENT_RX_COMPLETE & obj_s->events);
elessair 0:f269e3021894 892 }
elessair 0:f269e3021894 893
elessair 0:f269e3021894 894 // Check if char_match is present
elessair 0:f269e3021894 895 if (obj_s->events & SERIAL_EVENT_RX_CHARACTER_MATCH) {
elessair 0:f269e3021894 896 if (buf != NULL) {
elessair 0:f269e3021894 897 for (i = 0; i < obj->rx_buff.pos; i++) {
elessair 0:f269e3021894 898 if (buf[i] == obj->char_match) {
elessair 0:f269e3021894 899 obj->rx_buff.pos = i;
elessair 0:f269e3021894 900 return_event |= (SERIAL_EVENT_RX_CHARACTER_MATCH & obj_s->events);
elessair 0:f269e3021894 901 serial_rx_abort_asynch(obj);
elessair 0:f269e3021894 902 break;
elessair 0:f269e3021894 903 }
elessair 0:f269e3021894 904 }
elessair 0:f269e3021894 905 }
elessair 0:f269e3021894 906 }
elessair 0:f269e3021894 907
elessair 0:f269e3021894 908 return return_event;
elessair 0:f269e3021894 909 }
elessair 0:f269e3021894 910
elessair 0:f269e3021894 911 /**
elessair 0:f269e3021894 912 * Abort the ongoing TX transaction. It disables the enabled interupt for TX and
elessair 0:f269e3021894 913 * flush TX hardware buffer if TX FIFO is used
elessair 0:f269e3021894 914 *
elessair 0:f269e3021894 915 * @param obj The serial object
elessair 0:f269e3021894 916 */
elessair 0:f269e3021894 917 void serial_tx_abort_asynch(serial_t *obj)
elessair 0:f269e3021894 918 {
elessair 0:f269e3021894 919 struct serial_s *obj_s = SERIAL_S(obj);
elessair 0:f269e3021894 920 UART_HandleTypeDef *huart = &uart_handlers[obj_s->index];
elessair 0:f269e3021894 921
elessair 0:f269e3021894 922 __HAL_UART_DISABLE_IT(huart, UART_IT_TC);
elessair 0:f269e3021894 923 __HAL_UART_DISABLE_IT(huart, UART_IT_TXE);
elessair 0:f269e3021894 924
elessair 0:f269e3021894 925 // clear flags
elessair 0:f269e3021894 926 __HAL_UART_CLEAR_FLAG(huart, UART_FLAG_TC);
elessair 0:f269e3021894 927
elessair 0:f269e3021894 928 // reset states
elessair 0:f269e3021894 929 huart->TxXferCount = 0;
elessair 0:f269e3021894 930 // update handle state
elessair 0:f269e3021894 931 if(huart->gState == HAL_UART_STATE_BUSY_TX_RX) {
elessair 0:f269e3021894 932 huart->gState = HAL_UART_STATE_BUSY_RX;
elessair 0:f269e3021894 933 } else {
elessair 0:f269e3021894 934 huart->gState = HAL_UART_STATE_READY;
elessair 0:f269e3021894 935 }
elessair 0:f269e3021894 936 }
elessair 0:f269e3021894 937
elessair 0:f269e3021894 938 /**
elessair 0:f269e3021894 939 * Abort the ongoing RX transaction It disables the enabled interrupt for RX and
elessair 0:f269e3021894 940 * flush RX hardware buffer if RX FIFO is used
elessair 0:f269e3021894 941 *
elessair 0:f269e3021894 942 * @param obj The serial object
elessair 0:f269e3021894 943 */
elessair 0:f269e3021894 944 void serial_rx_abort_asynch(serial_t *obj)
elessair 0:f269e3021894 945 {
elessair 0:f269e3021894 946 struct serial_s *obj_s = SERIAL_S(obj);
elessair 0:f269e3021894 947 UART_HandleTypeDef *huart = &uart_handlers[obj_s->index];
elessair 0:f269e3021894 948
elessair 0:f269e3021894 949 // disable interrupts
elessair 0:f269e3021894 950 __HAL_UART_DISABLE_IT(huart, UART_IT_RXNE);
elessair 0:f269e3021894 951 __HAL_UART_DISABLE_IT(huart, UART_IT_PE);
elessair 0:f269e3021894 952 __HAL_UART_DISABLE_IT(huart, UART_IT_ERR);
elessair 0:f269e3021894 953
elessair 0:f269e3021894 954 // clear flags
elessair 0:f269e3021894 955 __HAL_UART_CLEAR_FLAG(huart, UART_FLAG_RXNE);
elessair 0:f269e3021894 956 volatile uint32_t tmpval = huart->Instance->DR; // Clear error flags
elessair 0:f269e3021894 957
elessair 0:f269e3021894 958 // reset states
elessair 0:f269e3021894 959 huart->RxXferCount = 0;
elessair 0:f269e3021894 960 // update handle state
elessair 0:f269e3021894 961 if(huart->RxState == HAL_UART_STATE_BUSY_TX_RX) {
elessair 0:f269e3021894 962 huart->RxState = HAL_UART_STATE_BUSY_TX;
elessair 0:f269e3021894 963 } else {
elessair 0:f269e3021894 964 huart->RxState = HAL_UART_STATE_READY;
elessair 0:f269e3021894 965 }
elessair 0:f269e3021894 966 }
elessair 0:f269e3021894 967
elessair 0:f269e3021894 968 #endif
elessair 0:f269e3021894 969
elessair 0:f269e3021894 970 #if DEVICE_SERIAL_FC
elessair 0:f269e3021894 971
elessair 0:f269e3021894 972 /**
elessair 0:f269e3021894 973 * Set HW Control Flow
elessair 0:f269e3021894 974 * @param obj The serial object
elessair 0:f269e3021894 975 * @param type The Control Flow type (FlowControlNone, FlowControlRTS, FlowControlCTS, FlowControlRTSCTS)
elessair 0:f269e3021894 976 * @param rxflow Pin for the rxflow
elessair 0:f269e3021894 977 * @param txflow Pin for the txflow
elessair 0:f269e3021894 978 */
elessair 0:f269e3021894 979 void serial_set_flow_control(serial_t *obj, FlowControl type, PinName rxflow, PinName txflow)
elessair 0:f269e3021894 980 {
elessair 0:f269e3021894 981 struct serial_s *obj_s = SERIAL_S(obj);
elessair 0:f269e3021894 982
elessair 0:f269e3021894 983 // Determine the UART to use (UART_1, UART_2, ...)
elessair 0:f269e3021894 984 UARTName uart_rts = (UARTName)pinmap_peripheral(rxflow, PinMap_UART_RTS);
elessair 0:f269e3021894 985 UARTName uart_cts = (UARTName)pinmap_peripheral(txflow, PinMap_UART_CTS);
elessair 0:f269e3021894 986
elessair 0:f269e3021894 987 // Get the peripheral name (UART_1, UART_2, ...) from the pin and assign it to the object
elessair 0:f269e3021894 988 obj_s->uart = (UARTName)pinmap_merge(uart_cts, uart_rts);
elessair 0:f269e3021894 989 MBED_ASSERT(obj_s->uart != (UARTName)NC);
elessair 0:f269e3021894 990
elessair 0:f269e3021894 991 if(type == FlowControlNone) {
elessair 0:f269e3021894 992 // Disable hardware flow control
elessair 0:f269e3021894 993 obj_s->hw_flow_ctl = UART_HWCONTROL_NONE;
elessair 0:f269e3021894 994 }
elessair 0:f269e3021894 995 if (type == FlowControlRTS) {
elessair 0:f269e3021894 996 // Enable RTS
elessair 0:f269e3021894 997 MBED_ASSERT(uart_rts != (UARTName)NC);
elessair 0:f269e3021894 998 obj_s->hw_flow_ctl = UART_HWCONTROL_RTS;
elessair 0:f269e3021894 999 obj_s->pin_rts = rxflow;
elessair 0:f269e3021894 1000 // Enable the pin for RTS function
elessair 0:f269e3021894 1001 pinmap_pinout(rxflow, PinMap_UART_RTS);
elessair 0:f269e3021894 1002 }
elessair 0:f269e3021894 1003 if (type == FlowControlCTS) {
elessair 0:f269e3021894 1004 // Enable CTS
elessair 0:f269e3021894 1005 MBED_ASSERT(uart_cts != (UARTName)NC);
elessair 0:f269e3021894 1006 obj_s->hw_flow_ctl = UART_HWCONTROL_CTS;
elessair 0:f269e3021894 1007 obj_s->pin_cts = txflow;
elessair 0:f269e3021894 1008 // Enable the pin for CTS function
elessair 0:f269e3021894 1009 pinmap_pinout(txflow, PinMap_UART_CTS);
elessair 0:f269e3021894 1010 }
elessair 0:f269e3021894 1011 if (type == FlowControlRTSCTS) {
elessair 0:f269e3021894 1012 // Enable CTS & RTS
elessair 0:f269e3021894 1013 MBED_ASSERT(uart_rts != (UARTName)NC);
elessair 0:f269e3021894 1014 MBED_ASSERT(uart_cts != (UARTName)NC);
elessair 0:f269e3021894 1015 obj_s->hw_flow_ctl = UART_HWCONTROL_RTS_CTS;
elessair 0:f269e3021894 1016 obj_s->pin_rts = rxflow;
elessair 0:f269e3021894 1017 obj_s->pin_cts = txflow;
elessair 0:f269e3021894 1018 // Enable the pin for CTS function
elessair 0:f269e3021894 1019 pinmap_pinout(txflow, PinMap_UART_CTS);
elessair 0:f269e3021894 1020 // Enable the pin for RTS function
elessair 0:f269e3021894 1021 pinmap_pinout(rxflow, PinMap_UART_RTS);
elessair 0:f269e3021894 1022 }
elessair 0:f269e3021894 1023
elessair 0:f269e3021894 1024 init_uart(obj);
elessair 0:f269e3021894 1025 }
elessair 0:f269e3021894 1026
elessair 0:f269e3021894 1027 #endif
elessair 0:f269e3021894 1028
elessair 0:f269e3021894 1029 #endif