mbed official / mbed-dev

mbed library sources. Supersedes mbed-src.

Dependents:   Nucleo_Hello_Encoder BLE_iBeaconScan AM1805_DEMO DISCO-F429ZI_ExportTemplate1 ... more

targets/TARGET_STM/TARGET_STM32L0/serial_device.c@180:96ed750bd169, 2018-01-17 (annotated)

Committer:
Anna Bridge
Date:
Wed Jan 17 15:23:54 2018 +0000
Revision:
180:96ed750bd169
Parent:
177:d650f5d4c87a
Child:
181:57724642e740
mbed-dev libray. Release version 158

Who changed what in which revision?

UserRevisionLine numberNew contents of line
AnnaBridge 167:e84263d55307 1 /* mbed Microcontroller Library
AnnaBridge 167:e84263d55307 2 *******************************************************************************
Anna Bridge 180:96ed750bd169 3 * Copyright (c) 2017, STMicroelectronics
AnnaBridge 167:e84263d55307 4 * All rights reserved.
AnnaBridge 167:e84263d55307 5 *
AnnaBridge 167:e84263d55307 6 * Redistribution and use in source and binary forms, with or without
AnnaBridge 167:e84263d55307 7 * modification, are permitted provided that the following conditions are met:
AnnaBridge 167:e84263d55307 8 *
AnnaBridge 167:e84263d55307 9 * 1. Redistributions of source code must retain the above copyright notice,
AnnaBridge 167:e84263d55307 10 * this list of conditions and the following disclaimer.
AnnaBridge 167:e84263d55307 11 * 2. Redistributions in binary form must reproduce the above copyright notice,
AnnaBridge 167:e84263d55307 12 * this list of conditions and the following disclaimer in the documentation
AnnaBridge 167:e84263d55307 13 * and/or other materials provided with the distribution.
AnnaBridge 167:e84263d55307 14 * 3. Neither the name of STMicroelectronics nor the names of its contributors
AnnaBridge 167:e84263d55307 15 * may be used to endorse or promote products derived from this software
AnnaBridge 167:e84263d55307 16 * without specific prior written permission.
AnnaBridge 167:e84263d55307 17 *
AnnaBridge 167:e84263d55307 18 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
AnnaBridge 167:e84263d55307 19 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
AnnaBridge 167:e84263d55307 20 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
AnnaBridge 167:e84263d55307 21 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
AnnaBridge 167:e84263d55307 22 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
AnnaBridge 167:e84263d55307 23 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
AnnaBridge 167:e84263d55307 24 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
AnnaBridge 167:e84263d55307 25 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
AnnaBridge 167:e84263d55307 26 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
AnnaBridge 167:e84263d55307 27 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
AnnaBridge 167:e84263d55307 28 *******************************************************************************
AnnaBridge 167:e84263d55307 29 */
AnnaBridge 167:e84263d55307 30
AnnaBridge 167:e84263d55307 31 #if DEVICE_SERIAL
AnnaBridge 167:e84263d55307 32
Anna Bridge 180:96ed750bd169 33 #include "serial_api_hal.h"
AnnaBridge 167:e84263d55307 34
Anna Bridge 180:96ed750bd169 35 #if defined (TARGET_STM32L011K4) || defined (TARGET_STM32L031K6)
Anna Bridge 180:96ed750bd169 36 #define UART_NUM (2)
Anna Bridge 180:96ed750bd169 37 #elif defined (TARGET_STM32L053x8)
Anna Bridge 180:96ed750bd169 38 #define UART_NUM (3)
Anna Bridge 180:96ed750bd169 39 #else
Anna Bridge 180:96ed750bd169 40 #define UART_NUM (5)
Anna Bridge 180:96ed750bd169 41 #endif
AnnaBridge 167:e84263d55307 42
Anna Bridge 180:96ed750bd169 43 uint32_t serial_irq_ids[UART_NUM] = {0};
AnnaBridge 167:e84263d55307 44 UART_HandleTypeDef uart_handlers[UART_NUM];
AnnaBridge 167:e84263d55307 45
AnnaBridge 167:e84263d55307 46 static uart_irq_handler irq_handler;
AnnaBridge 167:e84263d55307 47
AnnaBridge 167:e84263d55307 48 /******************************************************************************
AnnaBridge 167:e84263d55307 49 * INTERRUPTS HANDLING
AnnaBridge 167:e84263d55307 50 ******************************************************************************/
AnnaBridge 167:e84263d55307 51
AnnaBridge 167:e84263d55307 52 static void uart_irq(int id)
AnnaBridge 167:e84263d55307 53 {
AnnaBridge 167:e84263d55307 54 UART_HandleTypeDef * huart = &uart_handlers[id];
AnnaBridge 167:e84263d55307 55
AnnaBridge 167:e84263d55307 56 if (serial_irq_ids[id] != 0) {
Kojto 170:19eb464bc2be 57 if (__HAL_UART_GET_FLAG(huart, UART_FLAG_TXE) != RESET) {
Kojto 170:19eb464bc2be 58 if (__HAL_UART_GET_IT(huart, UART_IT_TXE) != RESET) {
AnnaBridge 167:e84263d55307 59 irq_handler(serial_irq_ids[id], TxIrq);
AnnaBridge 167:e84263d55307 60 }
AnnaBridge 167:e84263d55307 61 }
AnnaBridge 167:e84263d55307 62 if (__HAL_UART_GET_FLAG(huart, UART_FLAG_RXNE) != RESET) {
Kojto 169:e3b6fe271b81 63 if (__HAL_UART_GET_IT(huart, UART_IT_RXNE) != RESET) {
AnnaBridge 167:e84263d55307 64 irq_handler(serial_irq_ids[id], RxIrq);
Kojto 170:19eb464bc2be 65 /* Flag has been cleared when reading the content */
AnnaBridge 167:e84263d55307 66 }
AnnaBridge 167:e84263d55307 67 }
AnnaBridge 167:e84263d55307 68 if (__HAL_UART_GET_FLAG(huart, UART_FLAG_ORE) != RESET) {
Kojto 169:e3b6fe271b81 69 if (__HAL_UART_GET_IT(huart, UART_IT_ORE) != RESET) {
AnnaBridge 167:e84263d55307 70 __HAL_UART_CLEAR_FLAG(huart, UART_CLEAR_OREF);
AnnaBridge 167:e84263d55307 71 }
AnnaBridge 167:e84263d55307 72 }
AnnaBridge 167:e84263d55307 73 }
AnnaBridge 167:e84263d55307 74 }
AnnaBridge 167:e84263d55307 75
AnnaBridge 167:e84263d55307 76 #if defined(USART1_BASE)
AnnaBridge 167:e84263d55307 77 static void uart1_irq(void)
AnnaBridge 167:e84263d55307 78 {
AnnaBridge 167:e84263d55307 79 uart_irq(0);
AnnaBridge 167:e84263d55307 80 }
AnnaBridge 167:e84263d55307 81 #endif
AnnaBridge 167:e84263d55307 82
AnnaBridge 167:e84263d55307 83 static void uart2_irq(void)
AnnaBridge 167:e84263d55307 84 {
AnnaBridge 167:e84263d55307 85 uart_irq(1);
AnnaBridge 167:e84263d55307 86 }
AnnaBridge 167:e84263d55307 87
AnnaBridge 167:e84263d55307 88 static void lpuart1_irq(void)
AnnaBridge 167:e84263d55307 89 {
AnnaBridge 167:e84263d55307 90 uart_irq(2);
AnnaBridge 167:e84263d55307 91 }
AnnaBridge 167:e84263d55307 92
AnnaBridge 167:e84263d55307 93 #if defined(USART4_BASE)
AnnaBridge 167:e84263d55307 94 static void uart4_irq(void)
AnnaBridge 167:e84263d55307 95 {
AnnaBridge 167:e84263d55307 96 uart_irq(3);
AnnaBridge 167:e84263d55307 97 }
AnnaBridge 167:e84263d55307 98 #endif
AnnaBridge 167:e84263d55307 99
AnnaBridge 167:e84263d55307 100 #if defined(USART5_BASE)
AnnaBridge 167:e84263d55307 101 static void uart5_irq(void)
AnnaBridge 167:e84263d55307 102 {
AnnaBridge 167:e84263d55307 103 uart_irq(4);
AnnaBridge 167:e84263d55307 104 }
AnnaBridge 167:e84263d55307 105 #endif
AnnaBridge 167:e84263d55307 106
AnnaBridge 167:e84263d55307 107 void serial_irq_handler(serial_t *obj, uart_irq_handler handler, uint32_t id)
AnnaBridge 167:e84263d55307 108 {
AnnaBridge 167:e84263d55307 109 struct serial_s *obj_s = SERIAL_S(obj);
AnnaBridge 167:e84263d55307 110
AnnaBridge 167:e84263d55307 111 irq_handler = handler;
AnnaBridge 167:e84263d55307 112 serial_irq_ids[obj_s->index] = id;
AnnaBridge 167:e84263d55307 113 }
AnnaBridge 167:e84263d55307 114
AnnaBridge 167:e84263d55307 115 void serial_irq_set(serial_t *obj, SerialIrq irq, uint32_t enable)
AnnaBridge 167:e84263d55307 116 {
AnnaBridge 167:e84263d55307 117 struct serial_s *obj_s = SERIAL_S(obj);
AnnaBridge 167:e84263d55307 118 UART_HandleTypeDef *huart = &uart_handlers[obj_s->index];
AnnaBridge 167:e84263d55307 119 IRQn_Type irq_n = (IRQn_Type)0;
AnnaBridge 167:e84263d55307 120 uint32_t vector = 0;
AnnaBridge 167:e84263d55307 121
AnnaBridge 167:e84263d55307 122 #if defined(USART1_BASE)
AnnaBridge 167:e84263d55307 123 if (obj_s->uart == UART_1) {
AnnaBridge 167:e84263d55307 124 irq_n = USART1_IRQn;
AnnaBridge 167:e84263d55307 125 vector = (uint32_t)&uart1_irq;
AnnaBridge 167:e84263d55307 126 }
AnnaBridge 167:e84263d55307 127 #endif
AnnaBridge 167:e84263d55307 128
AnnaBridge 167:e84263d55307 129 if (obj_s->uart == UART_2) {
AnnaBridge 167:e84263d55307 130 irq_n = USART2_IRQn;
AnnaBridge 167:e84263d55307 131 vector = (uint32_t)&uart2_irq;
AnnaBridge 167:e84263d55307 132 }
AnnaBridge 167:e84263d55307 133
AnnaBridge 167:e84263d55307 134 if (obj_s->uart == LPUART_1) {
AnnaBridge 167:e84263d55307 135 irq_n = RNG_LPUART1_IRQn;
AnnaBridge 167:e84263d55307 136 vector = (uint32_t)&lpuart1_irq;
AnnaBridge 167:e84263d55307 137 }
AnnaBridge 167:e84263d55307 138
AnnaBridge 167:e84263d55307 139 #if defined(USART4_BASE)
AnnaBridge 167:e84263d55307 140 if (obj_s->uart == UART_4) {
AnnaBridge 167:e84263d55307 141 irq_n = USART4_5_IRQn;
AnnaBridge 167:e84263d55307 142 vector = (uint32_t)&uart4_irq;
AnnaBridge 167:e84263d55307 143 }
AnnaBridge 167:e84263d55307 144 #endif
AnnaBridge 167:e84263d55307 145
AnnaBridge 167:e84263d55307 146 #if defined(USART5_BASE)
AnnaBridge 167:e84263d55307 147 if (obj_s->uart == UART_5) {
AnnaBridge 167:e84263d55307 148 irq_n = USART4_5_IRQn;
AnnaBridge 167:e84263d55307 149 vector = (uint32_t)&uart5_irq;
AnnaBridge 167:e84263d55307 150 }
AnnaBridge 167:e84263d55307 151 #endif
AnnaBridge 167:e84263d55307 152
AnnaBridge 167:e84263d55307 153 if (enable) {
AnnaBridge 167:e84263d55307 154 if (irq == RxIrq) {
AnnaBridge 167:e84263d55307 155 __HAL_UART_ENABLE_IT(huart, UART_IT_RXNE);
AnnaBridge 167:e84263d55307 156 } else { // TxIrq
Kojto 170:19eb464bc2be 157 __HAL_UART_ENABLE_IT(huart, UART_IT_TXE);
AnnaBridge 167:e84263d55307 158 }
AnnaBridge 167:e84263d55307 159 NVIC_SetVector(irq_n, vector);
AnnaBridge 167:e84263d55307 160 NVIC_EnableIRQ(irq_n);
AnnaBridge 167:e84263d55307 161
AnnaBridge 167:e84263d55307 162 } else { // disable
AnnaBridge 167:e84263d55307 163 int all_disabled = 0;
AnnaBridge 167:e84263d55307 164 if (irq == RxIrq) {
AnnaBridge 167:e84263d55307 165 __HAL_UART_DISABLE_IT(huart, UART_IT_RXNE);
AnnaBridge 167:e84263d55307 166 // Check if TxIrq is disabled too
AnnaBridge 167:e84263d55307 167 if ((huart->Instance->CR1 & USART_CR1_TXEIE) == 0) {
AnnaBridge 167:e84263d55307 168 all_disabled = 1;
AnnaBridge 167:e84263d55307 169 }
AnnaBridge 167:e84263d55307 170 } else { // TxIrq
Kojto 170:19eb464bc2be 171 __HAL_UART_DISABLE_IT(huart, UART_IT_TXE);
AnnaBridge 167:e84263d55307 172 // Check if RxIrq is disabled too
AnnaBridge 167:e84263d55307 173 if ((huart->Instance->CR1 & USART_CR1_RXNEIE) == 0) {
AnnaBridge 167:e84263d55307 174 all_disabled = 1;
AnnaBridge 167:e84263d55307 175 }
AnnaBridge 167:e84263d55307 176 }
AnnaBridge 167:e84263d55307 177
AnnaBridge 167:e84263d55307 178 if (all_disabled) {
AnnaBridge 167:e84263d55307 179 NVIC_DisableIRQ(irq_n);
AnnaBridge 167:e84263d55307 180 }
AnnaBridge 167:e84263d55307 181 }
AnnaBridge 167:e84263d55307 182 }
AnnaBridge 167:e84263d55307 183
AnnaBridge 167:e84263d55307 184 /******************************************************************************
AnnaBridge 167:e84263d55307 185 * READ/WRITE
AnnaBridge 167:e84263d55307 186 ******************************************************************************/
AnnaBridge 167:e84263d55307 187
AnnaBridge 167:e84263d55307 188 int serial_getc(serial_t *obj)
AnnaBridge 167:e84263d55307 189 {
AnnaBridge 167:e84263d55307 190 struct serial_s *obj_s = SERIAL_S(obj);
AnnaBridge 167:e84263d55307 191 UART_HandleTypeDef *huart = &uart_handlers[obj_s->index];
AnnaBridge 167:e84263d55307 192
AnnaBridge 167:e84263d55307 193 while (!serial_readable(obj));
AnnaBridge 167:e84263d55307 194 return (int)(huart->Instance->RDR & (uint16_t)0xFF);
AnnaBridge 167:e84263d55307 195 }
AnnaBridge 167:e84263d55307 196
AnnaBridge 167:e84263d55307 197 void serial_putc(serial_t *obj, int c)
AnnaBridge 167:e84263d55307 198 {
AnnaBridge 167:e84263d55307 199 struct serial_s *obj_s = SERIAL_S(obj);
AnnaBridge 167:e84263d55307 200 UART_HandleTypeDef *huart = &uart_handlers[obj_s->index];
AnnaBridge 167:e84263d55307 201
AnnaBridge 167:e84263d55307 202 while (!serial_writable(obj));
AnnaBridge 167:e84263d55307 203 huart->Instance->TDR = (uint32_t)(c & (uint16_t)0xFF);
AnnaBridge 167:e84263d55307 204 }
AnnaBridge 167:e84263d55307 205
AnnaBridge 167:e84263d55307 206 void serial_clear(serial_t *obj)
AnnaBridge 167:e84263d55307 207 {
AnnaBridge 167:e84263d55307 208 struct serial_s *obj_s = SERIAL_S(obj);
AnnaBridge 167:e84263d55307 209 UART_HandleTypeDef *huart = &uart_handlers[obj_s->index];
AnnaBridge 167:e84263d55307 210
AnnaBridge 167:e84263d55307 211 huart->TxXferCount = 0;
AnnaBridge 167:e84263d55307 212 huart->RxXferCount = 0;
AnnaBridge 167:e84263d55307 213 }
AnnaBridge 167:e84263d55307 214
AnnaBridge 167:e84263d55307 215 void serial_break_set(serial_t *obj)
AnnaBridge 167:e84263d55307 216 {
AnnaBridge 167:e84263d55307 217 struct serial_s *obj_s = SERIAL_S(obj);
AnnaBridge 167:e84263d55307 218 UART_HandleTypeDef *huart = &uart_handlers[obj_s->index];
AnnaBridge 167:e84263d55307 219
AnnaBridge 167:e84263d55307 220 __HAL_UART_SEND_REQ(huart, UART_SENDBREAK_REQUEST);
AnnaBridge 167:e84263d55307 221 }
AnnaBridge 167:e84263d55307 222
AnnaBridge 167:e84263d55307 223 #if DEVICE_SERIAL_ASYNCH
AnnaBridge 167:e84263d55307 224
AnnaBridge 167:e84263d55307 225 /******************************************************************************
AnnaBridge 167:e84263d55307 226 * LOCAL HELPER FUNCTIONS
AnnaBridge 167:e84263d55307 227 ******************************************************************************/
AnnaBridge 167:e84263d55307 228
AnnaBridge 167:e84263d55307 229 /**
AnnaBridge 167:e84263d55307 230 * Configure the TX buffer for an asynchronous write serial transaction
AnnaBridge 167:e84263d55307 231 *
AnnaBridge 167:e84263d55307 232 * @param obj The serial object.
AnnaBridge 167:e84263d55307 233 * @param tx The buffer for sending.
AnnaBridge 167:e84263d55307 234 * @param tx_length The number of words to transmit.
AnnaBridge 167:e84263d55307 235 */
AnnaBridge 167:e84263d55307 236 static void serial_tx_buffer_set(serial_t *obj, void *tx, int tx_length, uint8_t width)
AnnaBridge 167:e84263d55307 237 {
AnnaBridge 167:e84263d55307 238 (void)width;
AnnaBridge 167:e84263d55307 239
AnnaBridge 167:e84263d55307 240 // Exit if a transmit is already on-going
AnnaBridge 167:e84263d55307 241 if (serial_tx_active(obj)) {
AnnaBridge 167:e84263d55307 242 return;
AnnaBridge 167:e84263d55307 243 }
AnnaBridge 167:e84263d55307 244
AnnaBridge 167:e84263d55307 245 obj->tx_buff.buffer = tx;
AnnaBridge 167:e84263d55307 246 obj->tx_buff.length = tx_length;
AnnaBridge 167:e84263d55307 247 obj->tx_buff.pos = 0;
AnnaBridge 167:e84263d55307 248 }
AnnaBridge 167:e84263d55307 249
AnnaBridge 167:e84263d55307 250 /**
AnnaBridge 167:e84263d55307 251 * Configure the RX buffer for an asynchronous write serial transaction
AnnaBridge 167:e84263d55307 252 *
AnnaBridge 167:e84263d55307 253 * @param obj The serial object.
AnnaBridge 167:e84263d55307 254 * @param tx The buffer for sending.
AnnaBridge 167:e84263d55307 255 * @param tx_length The number of words to transmit.
AnnaBridge 167:e84263d55307 256 */
AnnaBridge 167:e84263d55307 257 static void serial_rx_buffer_set(serial_t *obj, void *rx, int rx_length, uint8_t width)
AnnaBridge 167:e84263d55307 258 {
AnnaBridge 167:e84263d55307 259 (void)width;
AnnaBridge 167:e84263d55307 260
AnnaBridge 167:e84263d55307 261 // Exit if a reception is already on-going
AnnaBridge 167:e84263d55307 262 if (serial_rx_active(obj)) {
AnnaBridge 167:e84263d55307 263 return;
AnnaBridge 167:e84263d55307 264 }
AnnaBridge 167:e84263d55307 265
AnnaBridge 167:e84263d55307 266 obj->rx_buff.buffer = rx;
AnnaBridge 167:e84263d55307 267 obj->rx_buff.length = rx_length;
AnnaBridge 167:e84263d55307 268 obj->rx_buff.pos = 0;
AnnaBridge 167:e84263d55307 269 }
AnnaBridge 167:e84263d55307 270
AnnaBridge 167:e84263d55307 271 /**
AnnaBridge 167:e84263d55307 272 * Configure events
AnnaBridge 167:e84263d55307 273 *
AnnaBridge 167:e84263d55307 274 * @param obj The serial object
AnnaBridge 167:e84263d55307 275 * @param event The logical OR of the events to configure
AnnaBridge 167:e84263d55307 276 * @param enable Set to non-zero to enable events, or zero to disable them
AnnaBridge 167:e84263d55307 277 */
AnnaBridge 167:e84263d55307 278 static void serial_enable_event(serial_t *obj, int event, uint8_t enable)
AnnaBridge 167:e84263d55307 279 {
AnnaBridge 167:e84263d55307 280 struct serial_s *obj_s = SERIAL_S(obj);
AnnaBridge 167:e84263d55307 281
AnnaBridge 167:e84263d55307 282 // Shouldn't have to enable interrupt here, just need to keep track of the requested events.
AnnaBridge 167:e84263d55307 283 if (enable) {
AnnaBridge 167:e84263d55307 284 obj_s->events |= event;
AnnaBridge 167:e84263d55307 285 } else {
AnnaBridge 167:e84263d55307 286 obj_s->events &= ~event;
AnnaBridge 167:e84263d55307 287 }
AnnaBridge 167:e84263d55307 288 }
AnnaBridge 167:e84263d55307 289
AnnaBridge 167:e84263d55307 290
AnnaBridge 167:e84263d55307 291 /**
AnnaBridge 167:e84263d55307 292 * Get index of serial object TX IRQ, relating it to the physical peripheral.
AnnaBridge 167:e84263d55307 293 *
AnnaBridge 167:e84263d55307 294 * @param obj pointer to serial object
AnnaBridge 167:e84263d55307 295 * @return internal NVIC TX IRQ index of U(S)ART peripheral
AnnaBridge 167:e84263d55307 296 */
AnnaBridge 167:e84263d55307 297 static IRQn_Type serial_get_irq_n(serial_t *obj)
AnnaBridge 167:e84263d55307 298 {
AnnaBridge 167:e84263d55307 299 struct serial_s *obj_s = SERIAL_S(obj);
AnnaBridge 167:e84263d55307 300 IRQn_Type irq_n;
AnnaBridge 167:e84263d55307 301
AnnaBridge 167:e84263d55307 302 switch (obj_s->index) {
AnnaBridge 167:e84263d55307 303 #if defined(USART1_BASE)
AnnaBridge 167:e84263d55307 304 case 0:
AnnaBridge 167:e84263d55307 305 irq_n = USART1_IRQn;
AnnaBridge 167:e84263d55307 306 break;
AnnaBridge 167:e84263d55307 307 #endif
AnnaBridge 167:e84263d55307 308 case 1:
AnnaBridge 167:e84263d55307 309 irq_n = USART2_IRQn;
AnnaBridge 167:e84263d55307 310 break;
AnnaBridge 167:e84263d55307 311
AnnaBridge 167:e84263d55307 312 case 2:
AnnaBridge 167:e84263d55307 313 irq_n = RNG_LPUART1_IRQn;
AnnaBridge 167:e84263d55307 314 break;
AnnaBridge 167:e84263d55307 315 #if defined(USART4_BASE)
AnnaBridge 167:e84263d55307 316 case 3:
AnnaBridge 167:e84263d55307 317 irq_n = USART4_5_IRQn;
AnnaBridge 167:e84263d55307 318 break;
AnnaBridge 167:e84263d55307 319 #endif
AnnaBridge 167:e84263d55307 320 #if defined(USART5_BASE)
AnnaBridge 167:e84263d55307 321 case 4:
AnnaBridge 167:e84263d55307 322 irq_n = USART4_5_IRQn;
AnnaBridge 167:e84263d55307 323 break;
AnnaBridge 167:e84263d55307 324 #endif
AnnaBridge 167:e84263d55307 325 default:
AnnaBridge 167:e84263d55307 326 irq_n = (IRQn_Type)0;
AnnaBridge 167:e84263d55307 327 }
AnnaBridge 167:e84263d55307 328
AnnaBridge 167:e84263d55307 329 return irq_n;
AnnaBridge 167:e84263d55307 330 }
AnnaBridge 167:e84263d55307 331
AnnaBridge 167:e84263d55307 332
AnnaBridge 167:e84263d55307 333 /******************************************************************************
AnnaBridge 167:e84263d55307 334 * MBED API FUNCTIONS
AnnaBridge 167:e84263d55307 335 ******************************************************************************/
AnnaBridge 167:e84263d55307 336
AnnaBridge 167:e84263d55307 337 /**
AnnaBridge 167:e84263d55307 338 * Begin asynchronous TX transfer. The used buffer is specified in the serial
AnnaBridge 167:e84263d55307 339 * object, tx_buff
AnnaBridge 167:e84263d55307 340 *
AnnaBridge 167:e84263d55307 341 * @param obj The serial object
AnnaBridge 167:e84263d55307 342 * @param tx The buffer for sending
AnnaBridge 167:e84263d55307 343 * @param tx_length The number of words to transmit
AnnaBridge 167:e84263d55307 344 * @param tx_width The bit width of buffer word
AnnaBridge 167:e84263d55307 345 * @param handler The serial handler
AnnaBridge 167:e84263d55307 346 * @param event The logical OR of events to be registered
AnnaBridge 167:e84263d55307 347 * @param hint A suggestion for how to use DMA with this transfer
AnnaBridge 167:e84263d55307 348 * @return Returns number of data transfered, or 0 otherwise
AnnaBridge 167:e84263d55307 349 */
AnnaBridge 167:e84263d55307 350 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)
AnnaBridge 167:e84263d55307 351 {
AnnaBridge 167:e84263d55307 352 // TODO: DMA usage is currently ignored
AnnaBridge 167:e84263d55307 353 (void) hint;
AnnaBridge 167:e84263d55307 354
AnnaBridge 167:e84263d55307 355 // Check buffer is ok
AnnaBridge 167:e84263d55307 356 MBED_ASSERT(tx != (void*)0);
AnnaBridge 167:e84263d55307 357 MBED_ASSERT(tx_width == 8); // support only 8b width
AnnaBridge 167:e84263d55307 358
AnnaBridge 167:e84263d55307 359 struct serial_s *obj_s = SERIAL_S(obj);
AnnaBridge 167:e84263d55307 360 UART_HandleTypeDef * huart = &uart_handlers[obj_s->index];
AnnaBridge 167:e84263d55307 361
AnnaBridge 167:e84263d55307 362 if (tx_length == 0) {
AnnaBridge 167:e84263d55307 363 return 0;
AnnaBridge 167:e84263d55307 364 }
AnnaBridge 167:e84263d55307 365
AnnaBridge 167:e84263d55307 366 // Set up buffer
AnnaBridge 167:e84263d55307 367 serial_tx_buffer_set(obj, (void *)tx, tx_length, tx_width);
AnnaBridge 167:e84263d55307 368
AnnaBridge 167:e84263d55307 369 // Set up events
AnnaBridge 167:e84263d55307 370 serial_enable_event(obj, SERIAL_EVENT_TX_ALL, 0); // Clear all events
AnnaBridge 167:e84263d55307 371 serial_enable_event(obj, event, 1); // Set only the wanted events
AnnaBridge 167:e84263d55307 372
AnnaBridge 167:e84263d55307 373 // Enable interrupt
AnnaBridge 167:e84263d55307 374 IRQn_Type irq_n = serial_get_irq_n(obj);
AnnaBridge 167:e84263d55307 375 NVIC_ClearPendingIRQ(irq_n);
AnnaBridge 167:e84263d55307 376 NVIC_DisableIRQ(irq_n);
AnnaBridge 167:e84263d55307 377 NVIC_SetPriority(irq_n, 1);
AnnaBridge 167:e84263d55307 378 NVIC_SetVector(irq_n, (uint32_t)handler);
AnnaBridge 167:e84263d55307 379 NVIC_EnableIRQ(irq_n);
AnnaBridge 167:e84263d55307 380
AnnaBridge 167:e84263d55307 381 // the following function will enable UART_IT_TXE and error interrupts
AnnaBridge 167:e84263d55307 382 if (HAL_UART_Transmit_IT(huart, (uint8_t*)tx, tx_length) != HAL_OK) {
AnnaBridge 167:e84263d55307 383 return 0;
AnnaBridge 167:e84263d55307 384 }
AnnaBridge 167:e84263d55307 385
AnnaBridge 167:e84263d55307 386 return tx_length;
AnnaBridge 167:e84263d55307 387 }
AnnaBridge 167:e84263d55307 388
AnnaBridge 167:e84263d55307 389 /**
AnnaBridge 167:e84263d55307 390 * Begin asynchronous RX transfer (enable interrupt for data collecting)
AnnaBridge 167:e84263d55307 391 * The used buffer is specified in the serial object, rx_buff
AnnaBridge 167:e84263d55307 392 *
AnnaBridge 167:e84263d55307 393 * @param obj The serial object
AnnaBridge 167:e84263d55307 394 * @param rx The buffer for sending
AnnaBridge 167:e84263d55307 395 * @param rx_length The number of words to transmit
AnnaBridge 167:e84263d55307 396 * @param rx_width The bit width of buffer word
AnnaBridge 167:e84263d55307 397 * @param handler The serial handler
AnnaBridge 167:e84263d55307 398 * @param event The logical OR of events to be registered
AnnaBridge 167:e84263d55307 399 * @param handler The serial handler
AnnaBridge 167:e84263d55307 400 * @param char_match A character in range 0-254 to be matched
AnnaBridge 167:e84263d55307 401 * @param hint A suggestion for how to use DMA with this transfer
AnnaBridge 167:e84263d55307 402 */
AnnaBridge 167:e84263d55307 403 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)
AnnaBridge 167:e84263d55307 404 {
AnnaBridge 167:e84263d55307 405 // TODO: DMA usage is currently ignored
AnnaBridge 167:e84263d55307 406 (void) hint;
AnnaBridge 167:e84263d55307 407
AnnaBridge 167:e84263d55307 408 /* Sanity check arguments */
AnnaBridge 167:e84263d55307 409 MBED_ASSERT(obj);
AnnaBridge 167:e84263d55307 410 MBED_ASSERT(rx != (void*)0);
AnnaBridge 167:e84263d55307 411 MBED_ASSERT(rx_width == 8); // support only 8b width
AnnaBridge 167:e84263d55307 412
AnnaBridge 167:e84263d55307 413 struct serial_s *obj_s = SERIAL_S(obj);
AnnaBridge 167:e84263d55307 414 UART_HandleTypeDef *huart = &uart_handlers[obj_s->index];
AnnaBridge 167:e84263d55307 415
AnnaBridge 167:e84263d55307 416 serial_enable_event(obj, SERIAL_EVENT_RX_ALL, 0);
AnnaBridge 167:e84263d55307 417 serial_enable_event(obj, event, 1);
AnnaBridge 167:e84263d55307 418
AnnaBridge 167:e84263d55307 419 // set CharMatch
AnnaBridge 167:e84263d55307 420 obj->char_match = char_match;
AnnaBridge 167:e84263d55307 421
AnnaBridge 167:e84263d55307 422 serial_rx_buffer_set(obj, rx, rx_length, rx_width);
AnnaBridge 167:e84263d55307 423
AnnaBridge 167:e84263d55307 424 IRQn_Type irq_n = serial_get_irq_n(obj);
AnnaBridge 167:e84263d55307 425 NVIC_ClearPendingIRQ(irq_n);
AnnaBridge 167:e84263d55307 426 NVIC_DisableIRQ(irq_n);
AnnaBridge 167:e84263d55307 427 NVIC_SetPriority(irq_n, 0);
AnnaBridge 167:e84263d55307 428 NVIC_SetVector(irq_n, (uint32_t)handler);
AnnaBridge 167:e84263d55307 429 NVIC_EnableIRQ(irq_n);
AnnaBridge 167:e84263d55307 430
AnnaBridge 167:e84263d55307 431 // following HAL function will enable the RXNE interrupt + error interrupts
AnnaBridge 167:e84263d55307 432 HAL_UART_Receive_IT(huart, (uint8_t*)rx, rx_length);
AnnaBridge 167:e84263d55307 433 }
AnnaBridge 167:e84263d55307 434
AnnaBridge 167:e84263d55307 435 /**
AnnaBridge 167:e84263d55307 436 * Attempts to determine if the serial peripheral is already in use for TX
AnnaBridge 167:e84263d55307 437 *
AnnaBridge 167:e84263d55307 438 * @param obj The serial object
AnnaBridge 167:e84263d55307 439 * @return Non-zero if the TX transaction is ongoing, 0 otherwise
AnnaBridge 167:e84263d55307 440 */
AnnaBridge 167:e84263d55307 441 uint8_t serial_tx_active(serial_t *obj)
AnnaBridge 167:e84263d55307 442 {
AnnaBridge 167:e84263d55307 443 MBED_ASSERT(obj);
AnnaBridge 167:e84263d55307 444
AnnaBridge 167:e84263d55307 445 struct serial_s *obj_s = SERIAL_S(obj);
AnnaBridge 167:e84263d55307 446 UART_HandleTypeDef *huart = &uart_handlers[obj_s->index];
AnnaBridge 167:e84263d55307 447
AnnaBridge 167:e84263d55307 448 return ((HAL_UART_GetState(huart) == HAL_UART_STATE_BUSY_TX) ? 1 : 0);
AnnaBridge 167:e84263d55307 449 }
AnnaBridge 167:e84263d55307 450
AnnaBridge 167:e84263d55307 451 /**
AnnaBridge 167:e84263d55307 452 * Attempts to determine if the serial peripheral is already in use for RX
AnnaBridge 167:e84263d55307 453 *
AnnaBridge 167:e84263d55307 454 * @param obj The serial object
AnnaBridge 167:e84263d55307 455 * @return Non-zero if the RX transaction is ongoing, 0 otherwise
AnnaBridge 167:e84263d55307 456 */
AnnaBridge 167:e84263d55307 457 uint8_t serial_rx_active(serial_t *obj)
AnnaBridge 167:e84263d55307 458 {
AnnaBridge 167:e84263d55307 459 MBED_ASSERT(obj);
AnnaBridge 167:e84263d55307 460
AnnaBridge 167:e84263d55307 461 struct serial_s *obj_s = SERIAL_S(obj);
AnnaBridge 167:e84263d55307 462 UART_HandleTypeDef *huart = &uart_handlers[obj_s->index];
AnnaBridge 167:e84263d55307 463
AnnaBridge 167:e84263d55307 464 return ((HAL_UART_GetState(huart) == HAL_UART_STATE_BUSY_RX) ? 1 : 0);
AnnaBridge 167:e84263d55307 465 }
AnnaBridge 167:e84263d55307 466
AnnaBridge 167:e84263d55307 467 void HAL_UART_TxCpltCallback(UART_HandleTypeDef *huart) {
AnnaBridge 167:e84263d55307 468 if (__HAL_UART_GET_FLAG(huart, UART_FLAG_TC) != RESET) {
AnnaBridge 167:e84263d55307 469 __HAL_UART_CLEAR_FLAG(huart, UART_CLEAR_TCF);
AnnaBridge 167:e84263d55307 470 }
AnnaBridge 167:e84263d55307 471 }
AnnaBridge 167:e84263d55307 472
AnnaBridge 167:e84263d55307 473 /**
AnnaBridge 167:e84263d55307 474 * The asynchronous TX and RX handler.
AnnaBridge 167:e84263d55307 475 *
AnnaBridge 167:e84263d55307 476 * @param obj The serial object
AnnaBridge 167:e84263d55307 477 * @return Returns event flags if a TX/RX transfer termination condition was met or 0 otherwise
AnnaBridge 167:e84263d55307 478 */
AnnaBridge 167:e84263d55307 479 int serial_irq_handler_asynch(serial_t *obj)
AnnaBridge 167:e84263d55307 480 {
AnnaBridge 167:e84263d55307 481 struct serial_s *obj_s = SERIAL_S(obj);
AnnaBridge 167:e84263d55307 482 UART_HandleTypeDef *huart = &uart_handlers[obj_s->index];
AnnaBridge 167:e84263d55307 483
AnnaBridge 167:e84263d55307 484 volatile int return_event = 0;
AnnaBridge 167:e84263d55307 485 uint8_t *buf = (uint8_t*)(obj->rx_buff.buffer);
AnnaBridge 167:e84263d55307 486 uint8_t i = 0;
AnnaBridge 167:e84263d55307 487
AnnaBridge 167:e84263d55307 488 // TX PART:
AnnaBridge 167:e84263d55307 489 if (__HAL_UART_GET_FLAG(huart, UART_FLAG_TC) != RESET) {
AnnaBridge 167:e84263d55307 490 if (__HAL_UART_GET_IT_SOURCE(huart, UART_IT_TC) != RESET) {
AnnaBridge 167:e84263d55307 491 // Return event SERIAL_EVENT_TX_COMPLETE if requested
AnnaBridge 167:e84263d55307 492 if ((obj_s->events & SERIAL_EVENT_TX_COMPLETE ) != 0) {
AnnaBridge 167:e84263d55307 493 return_event |= (SERIAL_EVENT_TX_COMPLETE & obj_s->events);
AnnaBridge 167:e84263d55307 494 }
AnnaBridge 167:e84263d55307 495 }
AnnaBridge 167:e84263d55307 496 }
AnnaBridge 167:e84263d55307 497
AnnaBridge 167:e84263d55307 498 // Handle error events
AnnaBridge 167:e84263d55307 499 if (__HAL_UART_GET_FLAG(huart, UART_FLAG_PE) != RESET) {
AnnaBridge 167:e84263d55307 500 __HAL_UART_CLEAR_FLAG(huart, UART_CLEAR_PEF);
Kojto 169:e3b6fe271b81 501 if (__HAL_UART_GET_IT(huart, USART_IT_ERR) != RESET) {
AnnaBridge 167:e84263d55307 502 return_event |= (SERIAL_EVENT_RX_PARITY_ERROR & obj_s->events);
AnnaBridge 167:e84263d55307 503 }
AnnaBridge 167:e84263d55307 504 }
AnnaBridge 167:e84263d55307 505
AnnaBridge 167:e84263d55307 506 if (__HAL_UART_GET_FLAG(huart, UART_FLAG_FE) != RESET) {
Kojto 169:e3b6fe271b81 507 if (__HAL_UART_GET_IT(huart, UART_IT_FE) != RESET) {
AnnaBridge 167:e84263d55307 508 __HAL_UART_CLEAR_FLAG(huart, UART_CLEAR_FEF);
AnnaBridge 167:e84263d55307 509 return_event |= (SERIAL_EVENT_RX_FRAMING_ERROR & obj_s->events);
AnnaBridge 167:e84263d55307 510 }
AnnaBridge 167:e84263d55307 511 }
AnnaBridge 167:e84263d55307 512
AnnaBridge 167:e84263d55307 513 if (__HAL_UART_GET_FLAG(huart, UART_FLAG_NE) != RESET) {
Kojto 169:e3b6fe271b81 514 if (__HAL_UART_GET_IT(huart, UART_IT_NE) != RESET) {
AnnaBridge 167:e84263d55307 515 __HAL_UART_CLEAR_FLAG(huart, UART_CLEAR_NEF);
AnnaBridge 167:e84263d55307 516 }
AnnaBridge 167:e84263d55307 517 }
AnnaBridge 167:e84263d55307 518
AnnaBridge 167:e84263d55307 519 if (__HAL_UART_GET_FLAG(huart, UART_FLAG_ORE) != RESET) {
Kojto 169:e3b6fe271b81 520 if (__HAL_UART_GET_IT(huart, UART_IT_ORE) != RESET) {
AnnaBridge 167:e84263d55307 521 __HAL_UART_CLEAR_FLAG(huart, UART_CLEAR_OREF);
AnnaBridge 167:e84263d55307 522 return_event |= (SERIAL_EVENT_RX_OVERRUN_ERROR & obj_s->events);
AnnaBridge 167:e84263d55307 523 }
AnnaBridge 167:e84263d55307 524 }
AnnaBridge 167:e84263d55307 525
AnnaBridge 167:e84263d55307 526 HAL_UART_IRQHandler(huart);
AnnaBridge 167:e84263d55307 527
AnnaBridge 167:e84263d55307 528 // Abort if an error occurs
AnnaBridge 177:d650f5d4c87a 529 if ((return_event & SERIAL_EVENT_RX_PARITY_ERROR) ||
AnnaBridge 177:d650f5d4c87a 530 (return_event & SERIAL_EVENT_RX_FRAMING_ERROR) ||
AnnaBridge 177:d650f5d4c87a 531 (return_event & SERIAL_EVENT_RX_OVERRUN_ERROR)) {
AnnaBridge 167:e84263d55307 532 return return_event;
AnnaBridge 167:e84263d55307 533 }
AnnaBridge 167:e84263d55307 534
AnnaBridge 167:e84263d55307 535 //RX PART
AnnaBridge 167:e84263d55307 536 if (huart->RxXferSize != 0) {
AnnaBridge 167:e84263d55307 537 obj->rx_buff.pos = huart->RxXferSize - huart->RxXferCount;
AnnaBridge 167:e84263d55307 538 }
AnnaBridge 167:e84263d55307 539 if ((huart->RxXferCount == 0) && (obj->rx_buff.pos >= (obj->rx_buff.length - 1))) {
AnnaBridge 167:e84263d55307 540 return_event |= (SERIAL_EVENT_RX_COMPLETE & obj_s->events);
AnnaBridge 167:e84263d55307 541 }
AnnaBridge 167:e84263d55307 542
AnnaBridge 167:e84263d55307 543 // Check if char_match is present
AnnaBridge 167:e84263d55307 544 if (obj_s->events & SERIAL_EVENT_RX_CHARACTER_MATCH) {
AnnaBridge 167:e84263d55307 545 if (buf != NULL) {
AnnaBridge 167:e84263d55307 546 for (i = 0; i < obj->rx_buff.pos; i++) {
AnnaBridge 167:e84263d55307 547 if (buf[i] == obj->char_match) {
AnnaBridge 167:e84263d55307 548 obj->rx_buff.pos = i;
AnnaBridge 167:e84263d55307 549 return_event |= (SERIAL_EVENT_RX_CHARACTER_MATCH & obj_s->events);
AnnaBridge 167:e84263d55307 550 serial_rx_abort_asynch(obj);
AnnaBridge 167:e84263d55307 551 break;
AnnaBridge 167:e84263d55307 552 }
AnnaBridge 167:e84263d55307 553 }
AnnaBridge 167:e84263d55307 554 }
AnnaBridge 167:e84263d55307 555 }
AnnaBridge 167:e84263d55307 556
AnnaBridge 167:e84263d55307 557 return return_event;
AnnaBridge 167:e84263d55307 558 }
AnnaBridge 167:e84263d55307 559
AnnaBridge 167:e84263d55307 560 /**
AnnaBridge 167:e84263d55307 561 * Abort the ongoing TX transaction. It disables the enabled interupt for TX and
AnnaBridge 167:e84263d55307 562 * flush TX hardware buffer if TX FIFO is used
AnnaBridge 167:e84263d55307 563 *
AnnaBridge 167:e84263d55307 564 * @param obj The serial object
AnnaBridge 167:e84263d55307 565 */
AnnaBridge 167:e84263d55307 566 void serial_tx_abort_asynch(serial_t *obj)
AnnaBridge 167:e84263d55307 567 {
AnnaBridge 167:e84263d55307 568 struct serial_s *obj_s = SERIAL_S(obj);
AnnaBridge 167:e84263d55307 569 UART_HandleTypeDef *huart = &uart_handlers[obj_s->index];
AnnaBridge 167:e84263d55307 570
AnnaBridge 167:e84263d55307 571 __HAL_UART_DISABLE_IT(huart, UART_IT_TC);
AnnaBridge 167:e84263d55307 572 __HAL_UART_DISABLE_IT(huart, UART_IT_TXE);
AnnaBridge 167:e84263d55307 573
AnnaBridge 167:e84263d55307 574 // clear flags
AnnaBridge 167:e84263d55307 575 __HAL_UART_CLEAR_FLAG(huart, UART_CLEAR_TCF);
AnnaBridge 167:e84263d55307 576
AnnaBridge 167:e84263d55307 577 // reset states
AnnaBridge 167:e84263d55307 578 huart->TxXferCount = 0;
AnnaBridge 167:e84263d55307 579 // update handle state
AnnaBridge 167:e84263d55307 580 if(huart->gState == HAL_UART_STATE_BUSY_TX_RX) {
AnnaBridge 167:e84263d55307 581 huart->gState = HAL_UART_STATE_BUSY_RX;
AnnaBridge 167:e84263d55307 582 } else {
AnnaBridge 167:e84263d55307 583 huart->gState = HAL_UART_STATE_READY;
AnnaBridge 167:e84263d55307 584 }
AnnaBridge 167:e84263d55307 585 }
AnnaBridge 167:e84263d55307 586
AnnaBridge 167:e84263d55307 587 /**
AnnaBridge 167:e84263d55307 588 * Abort the ongoing RX transaction It disables the enabled interrupt for RX and
AnnaBridge 167:e84263d55307 589 * flush RX hardware buffer if RX FIFO is used
AnnaBridge 167:e84263d55307 590 *
AnnaBridge 167:e84263d55307 591 * @param obj The serial object
AnnaBridge 167:e84263d55307 592 */
AnnaBridge 167:e84263d55307 593 void serial_rx_abort_asynch(serial_t *obj)
AnnaBridge 167:e84263d55307 594 {
AnnaBridge 167:e84263d55307 595 struct serial_s *obj_s = SERIAL_S(obj);
AnnaBridge 167:e84263d55307 596 UART_HandleTypeDef *huart = &uart_handlers[obj_s->index];
AnnaBridge 167:e84263d55307 597
AnnaBridge 167:e84263d55307 598 // disable interrupts
AnnaBridge 167:e84263d55307 599 __HAL_UART_DISABLE_IT(huart, UART_IT_RXNE);
AnnaBridge 167:e84263d55307 600 __HAL_UART_DISABLE_IT(huart, UART_IT_PE);
AnnaBridge 167:e84263d55307 601 __HAL_UART_DISABLE_IT(huart, UART_IT_ERR);
AnnaBridge 167:e84263d55307 602
AnnaBridge 167:e84263d55307 603 // clear flags
AnnaBridge 167:e84263d55307 604 __HAL_UART_CLEAR_FLAG(huart, UART_CLEAR_PEF | UART_CLEAR_FEF | UART_CLEAR_OREF);
AnnaBridge 177:d650f5d4c87a 605 volatile uint32_t tmpval __attribute__((unused)) = huart->Instance->RDR; // Clear RXNE flag
AnnaBridge 167:e84263d55307 606
AnnaBridge 167:e84263d55307 607 // reset states
AnnaBridge 167:e84263d55307 608 huart->RxXferCount = 0;
AnnaBridge 167:e84263d55307 609 // update handle state
AnnaBridge 167:e84263d55307 610 if(huart->RxState == HAL_UART_STATE_BUSY_TX_RX) {
AnnaBridge 167:e84263d55307 611 huart->RxState = HAL_UART_STATE_BUSY_TX;
AnnaBridge 167:e84263d55307 612 } else {
AnnaBridge 167:e84263d55307 613 huart->RxState = HAL_UART_STATE_READY;
AnnaBridge 167:e84263d55307 614 }
AnnaBridge 167:e84263d55307 615 }
AnnaBridge 167:e84263d55307 616
Anna Bridge 180:96ed750bd169 617 #endif /* DEVICE_SERIAL_ASYNCH */
AnnaBridge 167:e84263d55307 618
AnnaBridge 167:e84263d55307 619 #if DEVICE_SERIAL_FC
AnnaBridge 167:e84263d55307 620
AnnaBridge 167:e84263d55307 621 /**
AnnaBridge 167:e84263d55307 622 * Set HW Control Flow
AnnaBridge 167:e84263d55307 623 * @param obj The serial object
AnnaBridge 167:e84263d55307 624 * @param type The Control Flow type (FlowControlNone, FlowControlRTS, FlowControlCTS, FlowControlRTSCTS)
AnnaBridge 167:e84263d55307 625 * @param rxflow Pin for the rxflow
AnnaBridge 167:e84263d55307 626 * @param txflow Pin for the txflow
AnnaBridge 167:e84263d55307 627 */
AnnaBridge 167:e84263d55307 628 void serial_set_flow_control(serial_t *obj, FlowControl type, PinName rxflow, PinName txflow)
AnnaBridge 167:e84263d55307 629 {
AnnaBridge 167:e84263d55307 630 struct serial_s *obj_s = SERIAL_S(obj);
AnnaBridge 167:e84263d55307 631
AnnaBridge 167:e84263d55307 632 // Determine the UART to use (UART_1, UART_2, ...)
AnnaBridge 167:e84263d55307 633 UARTName uart_rts = (UARTName)pinmap_peripheral(rxflow, PinMap_UART_RTS);
AnnaBridge 167:e84263d55307 634 UARTName uart_cts = (UARTName)pinmap_peripheral(txflow, PinMap_UART_CTS);
AnnaBridge 167:e84263d55307 635
AnnaBridge 167:e84263d55307 636 // Get the peripheral name (UART_1, UART_2, ...) from the pin and assign it to the object
AnnaBridge 167:e84263d55307 637 obj_s->uart = (UARTName)pinmap_merge(uart_cts, uart_rts);
AnnaBridge 167:e84263d55307 638 MBED_ASSERT(obj_s->uart != (UARTName)NC);
AnnaBridge 167:e84263d55307 639
AnnaBridge 167:e84263d55307 640 if(type == FlowControlNone) {
AnnaBridge 167:e84263d55307 641 // Disable hardware flow control
AnnaBridge 167:e84263d55307 642 obj_s->hw_flow_ctl = UART_HWCONTROL_NONE;
AnnaBridge 167:e84263d55307 643 }
AnnaBridge 167:e84263d55307 644 if (type == FlowControlRTS) {
AnnaBridge 167:e84263d55307 645 // Enable RTS
AnnaBridge 167:e84263d55307 646 MBED_ASSERT(uart_rts != (UARTName)NC);
AnnaBridge 167:e84263d55307 647 obj_s->hw_flow_ctl = UART_HWCONTROL_RTS;
AnnaBridge 167:e84263d55307 648 obj_s->pin_rts = rxflow;
AnnaBridge 167:e84263d55307 649 // Enable the pin for RTS function
AnnaBridge 167:e84263d55307 650 pinmap_pinout(rxflow, PinMap_UART_RTS);
AnnaBridge 167:e84263d55307 651 }
AnnaBridge 167:e84263d55307 652 if (type == FlowControlCTS) {
AnnaBridge 167:e84263d55307 653 // Enable CTS
AnnaBridge 167:e84263d55307 654 MBED_ASSERT(uart_cts != (UARTName)NC);
AnnaBridge 167:e84263d55307 655 obj_s->hw_flow_ctl = UART_HWCONTROL_CTS;
AnnaBridge 167:e84263d55307 656 obj_s->pin_cts = txflow;
AnnaBridge 167:e84263d55307 657 // Enable the pin for CTS function
AnnaBridge 167:e84263d55307 658 pinmap_pinout(txflow, PinMap_UART_CTS);
AnnaBridge 167:e84263d55307 659 }
AnnaBridge 167:e84263d55307 660 if (type == FlowControlRTSCTS) {
AnnaBridge 167:e84263d55307 661 // Enable CTS & RTS
AnnaBridge 167:e84263d55307 662 MBED_ASSERT(uart_rts != (UARTName)NC);
AnnaBridge 167:e84263d55307 663 MBED_ASSERT(uart_cts != (UARTName)NC);
AnnaBridge 167:e84263d55307 664 obj_s->hw_flow_ctl = UART_HWCONTROL_RTS_CTS;
AnnaBridge 167:e84263d55307 665 obj_s->pin_rts = rxflow;
AnnaBridge 167:e84263d55307 666 obj_s->pin_cts = txflow;
AnnaBridge 167:e84263d55307 667 // Enable the pin for CTS function
AnnaBridge 167:e84263d55307 668 pinmap_pinout(txflow, PinMap_UART_CTS);
AnnaBridge 167:e84263d55307 669 // Enable the pin for RTS function
AnnaBridge 167:e84263d55307 670 pinmap_pinout(rxflow, PinMap_UART_RTS);
AnnaBridge 167:e84263d55307 671 }
AnnaBridge 167:e84263d55307 672
AnnaBridge 167:e84263d55307 673 init_uart(obj);
AnnaBridge 167:e84263d55307 674 }
AnnaBridge 167:e84263d55307 675
Anna Bridge 180:96ed750bd169 676 #endif /* DEVICE_SERIAL_FC */
AnnaBridge 167:e84263d55307 677
Anna Bridge 180:96ed750bd169 678 #endif /* DEVICE_SERIAL */