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