EL4121 Embedded System / mbed-os

mbed-os

Dependents:   cobaLCDJoyMotor_Thread odometry_omni_3roda_v3 odometry_omni_3roda_v1 odometry_omni_3roda_v2 ... more

targets/TARGET_STM/serial_api.c@0:b74591d5ab33, 2017-12-11 (annotated)

Committer:
be_bryan
Date:
Mon Dec 11 17:54:04 2017 +0000
Revision:
0:b74591d5ab33
motor ++

Who changed what in which revision?

UserRevisionLine numberNew contents of line
be_bryan 0:b74591d5ab33 1 /* mbed Microcontroller Library
be_bryan 0:b74591d5ab33 2 *******************************************************************************
be_bryan 0:b74591d5ab33 3 * Copyright (c) 2015, STMicroelectronics
be_bryan 0:b74591d5ab33 4 * All rights reserved.
be_bryan 0:b74591d5ab33 5 *
be_bryan 0:b74591d5ab33 6 * Redistribution and use in source and binary forms, with or without
be_bryan 0:b74591d5ab33 7 * modification, are permitted provided that the following conditions are met:
be_bryan 0:b74591d5ab33 8 *
be_bryan 0:b74591d5ab33 9 * 1. Redistributions of source code must retain the above copyright notice,
be_bryan 0:b74591d5ab33 10 * this list of conditions and the following disclaimer.
be_bryan 0:b74591d5ab33 11 * 2. Redistributions in binary form must reproduce the above copyright notice,
be_bryan 0:b74591d5ab33 12 * this list of conditions and the following disclaimer in the documentation
be_bryan 0:b74591d5ab33 13 * and/or other materials provided with the distribution.
be_bryan 0:b74591d5ab33 14 * 3. Neither the name of STMicroelectronics nor the names of its contributors
be_bryan 0:b74591d5ab33 15 * may be used to endorse or promote products derived from this software
be_bryan 0:b74591d5ab33 16 * without specific prior written permission.
be_bryan 0:b74591d5ab33 17 *
be_bryan 0:b74591d5ab33 18 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
be_bryan 0:b74591d5ab33 19 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
be_bryan 0:b74591d5ab33 20 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
be_bryan 0:b74591d5ab33 21 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
be_bryan 0:b74591d5ab33 22 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
be_bryan 0:b74591d5ab33 23 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
be_bryan 0:b74591d5ab33 24 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
be_bryan 0:b74591d5ab33 25 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
be_bryan 0:b74591d5ab33 26 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
be_bryan 0:b74591d5ab33 27 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
be_bryan 0:b74591d5ab33 28 *******************************************************************************
be_bryan 0:b74591d5ab33 29 */
be_bryan 0:b74591d5ab33 30 #include "mbed_assert.h"
be_bryan 0:b74591d5ab33 31 #include "mbed_error.h"
be_bryan 0:b74591d5ab33 32 #include "serial_api.h"
be_bryan 0:b74591d5ab33 33 #include "serial_api_hal.h"
be_bryan 0:b74591d5ab33 34 #include "PeripheralPins.h"
be_bryan 0:b74591d5ab33 35
be_bryan 0:b74591d5ab33 36 #if DEVICE_SERIAL
be_bryan 0:b74591d5ab33 37
be_bryan 0:b74591d5ab33 38 void init_uart(serial_t *obj)
be_bryan 0:b74591d5ab33 39 {
be_bryan 0:b74591d5ab33 40 struct serial_s *obj_s = SERIAL_S(obj);
be_bryan 0:b74591d5ab33 41 UART_HandleTypeDef *huart = &uart_handlers[obj_s->index];
be_bryan 0:b74591d5ab33 42 huart->Instance = (USART_TypeDef *)(obj_s->uart);
be_bryan 0:b74591d5ab33 43
be_bryan 0:b74591d5ab33 44 huart->Init.BaudRate = obj_s->baudrate;
be_bryan 0:b74591d5ab33 45 huart->Init.WordLength = obj_s->databits;
be_bryan 0:b74591d5ab33 46 huart->Init.StopBits = obj_s->stopbits;
be_bryan 0:b74591d5ab33 47 huart->Init.Parity = obj_s->parity;
be_bryan 0:b74591d5ab33 48 #if DEVICE_SERIAL_FC
be_bryan 0:b74591d5ab33 49 huart->Init.HwFlowCtl = obj_s->hw_flow_ctl;
be_bryan 0:b74591d5ab33 50 #else
be_bryan 0:b74591d5ab33 51 huart->Init.HwFlowCtl = UART_HWCONTROL_NONE;
be_bryan 0:b74591d5ab33 52 #endif
be_bryan 0:b74591d5ab33 53 huart->Init.OverSampling = UART_OVERSAMPLING_16;
be_bryan 0:b74591d5ab33 54 huart->TxXferCount = 0;
be_bryan 0:b74591d5ab33 55 huart->TxXferSize = 0;
be_bryan 0:b74591d5ab33 56 huart->RxXferCount = 0;
be_bryan 0:b74591d5ab33 57 huart->RxXferSize = 0;
be_bryan 0:b74591d5ab33 58
be_bryan 0:b74591d5ab33 59 if (obj_s->pin_rx == NC) {
be_bryan 0:b74591d5ab33 60 huart->Init.Mode = UART_MODE_TX;
be_bryan 0:b74591d5ab33 61 } else if (obj_s->pin_tx == NC) {
be_bryan 0:b74591d5ab33 62 huart->Init.Mode = UART_MODE_RX;
be_bryan 0:b74591d5ab33 63 } else {
be_bryan 0:b74591d5ab33 64 huart->Init.Mode = UART_MODE_TX_RX;
be_bryan 0:b74591d5ab33 65 }
be_bryan 0:b74591d5ab33 66
be_bryan 0:b74591d5ab33 67 if (HAL_UART_Init(huart) != HAL_OK) {
be_bryan 0:b74591d5ab33 68 error("Cannot initialize UART\n");
be_bryan 0:b74591d5ab33 69 }
be_bryan 0:b74591d5ab33 70 }
be_bryan 0:b74591d5ab33 71
be_bryan 0:b74591d5ab33 72 void serial_format(serial_t *obj, int data_bits, SerialParity parity, int stop_bits)
be_bryan 0:b74591d5ab33 73 {
be_bryan 0:b74591d5ab33 74 struct serial_s *obj_s = SERIAL_S(obj);
be_bryan 0:b74591d5ab33 75
be_bryan 0:b74591d5ab33 76 switch (parity) {
be_bryan 0:b74591d5ab33 77 case ParityOdd:
be_bryan 0:b74591d5ab33 78 obj_s->parity = UART_PARITY_ODD;
be_bryan 0:b74591d5ab33 79 break;
be_bryan 0:b74591d5ab33 80 case ParityEven:
be_bryan 0:b74591d5ab33 81 obj_s->parity = UART_PARITY_EVEN;
be_bryan 0:b74591d5ab33 82 break;
be_bryan 0:b74591d5ab33 83 default: // ParityNone
be_bryan 0:b74591d5ab33 84 case ParityForced0: // unsupported!
be_bryan 0:b74591d5ab33 85 case ParityForced1: // unsupported!
be_bryan 0:b74591d5ab33 86 obj_s->parity = UART_PARITY_NONE;
be_bryan 0:b74591d5ab33 87 break;
be_bryan 0:b74591d5ab33 88 }
be_bryan 0:b74591d5ab33 89
be_bryan 0:b74591d5ab33 90 switch (data_bits) {
be_bryan 0:b74591d5ab33 91 case 9:
be_bryan 0:b74591d5ab33 92 MBED_ASSERT(parity == UART_PARITY_NONE);
be_bryan 0:b74591d5ab33 93 obj_s->databits = UART_WORDLENGTH_9B;
be_bryan 0:b74591d5ab33 94 break;
be_bryan 0:b74591d5ab33 95 default:
be_bryan 0:b74591d5ab33 96 case 8:
be_bryan 0:b74591d5ab33 97 if (parity != UART_PARITY_NONE) {
be_bryan 0:b74591d5ab33 98 obj_s->databits = UART_WORDLENGTH_9B;
be_bryan 0:b74591d5ab33 99 } else {
be_bryan 0:b74591d5ab33 100 obj_s->databits = UART_WORDLENGTH_8B;
be_bryan 0:b74591d5ab33 101 }
be_bryan 0:b74591d5ab33 102 break;
be_bryan 0:b74591d5ab33 103 #if defined UART_WORDLENGTH_7B
be_bryan 0:b74591d5ab33 104 case 7:
be_bryan 0:b74591d5ab33 105 if (parity != UART_PARITY_NONE) {
be_bryan 0:b74591d5ab33 106 obj_s->databits = UART_WORDLENGTH_8B;
be_bryan 0:b74591d5ab33 107 } else {
be_bryan 0:b74591d5ab33 108 obj_s->databits = UART_WORDLENGTH_7B;
be_bryan 0:b74591d5ab33 109 }
be_bryan 0:b74591d5ab33 110 break;
be_bryan 0:b74591d5ab33 111 #endif
be_bryan 0:b74591d5ab33 112 }
be_bryan 0:b74591d5ab33 113
be_bryan 0:b74591d5ab33 114 if (stop_bits == 2) {
be_bryan 0:b74591d5ab33 115 obj_s->stopbits = UART_STOPBITS_2;
be_bryan 0:b74591d5ab33 116 } else {
be_bryan 0:b74591d5ab33 117 obj_s->stopbits = UART_STOPBITS_1;
be_bryan 0:b74591d5ab33 118 }
be_bryan 0:b74591d5ab33 119
be_bryan 0:b74591d5ab33 120 init_uart(obj);
be_bryan 0:b74591d5ab33 121 }
be_bryan 0:b74591d5ab33 122
be_bryan 0:b74591d5ab33 123 /******************************************************************************
be_bryan 0:b74591d5ab33 124 * READ/WRITE
be_bryan 0:b74591d5ab33 125 ******************************************************************************/
be_bryan 0:b74591d5ab33 126
be_bryan 0:b74591d5ab33 127 int serial_readable(serial_t *obj)
be_bryan 0:b74591d5ab33 128 {
be_bryan 0:b74591d5ab33 129 struct serial_s *obj_s = SERIAL_S(obj);
be_bryan 0:b74591d5ab33 130 UART_HandleTypeDef *huart = &uart_handlers[obj_s->index];
be_bryan 0:b74591d5ab33 131 /* To avoid a target blocking case, let's check for
be_bryan 0:b74591d5ab33 132 * possible OVERRUN error and discard it
be_bryan 0:b74591d5ab33 133 */
be_bryan 0:b74591d5ab33 134 if(__HAL_UART_GET_FLAG(huart, UART_FLAG_ORE)) {
be_bryan 0:b74591d5ab33 135 __HAL_UART_CLEAR_OREFLAG(huart);
be_bryan 0:b74591d5ab33 136 }
be_bryan 0:b74591d5ab33 137 // Check if data is received
be_bryan 0:b74591d5ab33 138 return (__HAL_UART_GET_FLAG(huart, UART_FLAG_RXNE) != RESET) ? 1 : 0;
be_bryan 0:b74591d5ab33 139 }
be_bryan 0:b74591d5ab33 140
be_bryan 0:b74591d5ab33 141 int serial_writable(serial_t *obj)
be_bryan 0:b74591d5ab33 142 {
be_bryan 0:b74591d5ab33 143 struct serial_s *obj_s = SERIAL_S(obj);
be_bryan 0:b74591d5ab33 144 UART_HandleTypeDef *huart = &uart_handlers[obj_s->index];
be_bryan 0:b74591d5ab33 145
be_bryan 0:b74591d5ab33 146 // Check if data is transmitted
be_bryan 0:b74591d5ab33 147 return (__HAL_UART_GET_FLAG(huart, UART_FLAG_TXE) != RESET) ? 1 : 0;
be_bryan 0:b74591d5ab33 148 }
be_bryan 0:b74591d5ab33 149
be_bryan 0:b74591d5ab33 150 void serial_pinout_tx(PinName tx)
be_bryan 0:b74591d5ab33 151 {
be_bryan 0:b74591d5ab33 152 pinmap_pinout(tx, PinMap_UART_TX);
be_bryan 0:b74591d5ab33 153 }
be_bryan 0:b74591d5ab33 154
be_bryan 0:b74591d5ab33 155 void serial_break_clear(serial_t *obj)
be_bryan 0:b74591d5ab33 156 {
be_bryan 0:b74591d5ab33 157 (void)obj;
be_bryan 0:b74591d5ab33 158 }
be_bryan 0:b74591d5ab33 159
be_bryan 0:b74591d5ab33 160 #endif /* DEVICE_SERIAL */