SDK Development / mbed-src

mbed SDK library sources

Fork of mbed-src by mbed official

Development branch of the mbed library sources. This library is kept in synch with the latest changes from the mbed SDK and it is not guaranteed to work.

If you are looking for a stable and tested release, please import one of the official mbed library releases:

Import librarymbed

The official Mbed 2 C/C++ SDK provides the software platform and libraries to build your applications.

Last commit 20 Feb 2019 by mbed official

targets/hal/TARGET_STM/TARGET_NUCLEO_F030R8/serial_api.c@77:b5886236e6f0, 2014-01-27 (annotated)

Committer:
mbed_official
Date:
Mon Jan 27 15:30:04 2014 +0000
Revision:
77:b5886236e6f0
Parent:
76:aeb1df146756 
Synchronized with git revision 84a8f2bcd4fff802c20a78cc2edf304135d243d2



Full URL: https://github.com/mbedmicro/mbed/commit/84a8f2bcd4fff802c20a78cc2edf304135d243d2/

Who changed what in which revision?

UserRevisionLine numberNew contents of line
mbed_official 76:aeb1df146756 1 /* mbed Microcontroller Library
mbed_official 76:aeb1df146756 2 *******************************************************************************
mbed_official 76:aeb1df146756 3 * Copyright (c) 2014, STMicroelectronics
mbed_official 76:aeb1df146756 4 * All rights reserved.
mbed_official 76:aeb1df146756 5 *
mbed_official 76:aeb1df146756 6 * Redistribution and use in source and binary forms, with or without
mbed_official 76:aeb1df146756 7 * modification, are permitted provided that the following conditions are met:
mbed_official 76:aeb1df146756 8 *
mbed_official 76:aeb1df146756 9 * 1. Redistributions of source code must retain the above copyright notice,
mbed_official 76:aeb1df146756 10 * this list of conditions and the following disclaimer.
mbed_official 76:aeb1df146756 11 * 2. Redistributions in binary form must reproduce the above copyright notice,
mbed_official 76:aeb1df146756 12 * this list of conditions and the following disclaimer in the documentation
mbed_official 76:aeb1df146756 13 * and/or other materials provided with the distribution.
mbed_official 76:aeb1df146756 14 * 3. Neither the name of STMicroelectronics nor the names of its contributors
mbed_official 76:aeb1df146756 15 * may be used to endorse or promote products derived from this software
mbed_official 76:aeb1df146756 16 * without specific prior written permission.
mbed_official 76:aeb1df146756 17 *
mbed_official 76:aeb1df146756 18 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
mbed_official 76:aeb1df146756 19 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
mbed_official 76:aeb1df146756 20 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
mbed_official 76:aeb1df146756 21 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
mbed_official 76:aeb1df146756 22 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
mbed_official 76:aeb1df146756 23 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
mbed_official 76:aeb1df146756 24 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
mbed_official 76:aeb1df146756 25 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
mbed_official 76:aeb1df146756 26 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
mbed_official 76:aeb1df146756 27 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
mbed_official 76:aeb1df146756 28 *******************************************************************************
mbed_official 76:aeb1df146756 29 */
mbed_official 76:aeb1df146756 30 #include "serial_api.h"
mbed_official 76:aeb1df146756 31 #include "cmsis.h"
mbed_official 76:aeb1df146756 32 #include "pinmap.h"
mbed_official 76:aeb1df146756 33 #include "error.h"
mbed_official 76:aeb1df146756 34 #include <string.h>
mbed_official 76:aeb1df146756 35
mbed_official 76:aeb1df146756 36 static const PinMap PinMap_UART_TX[] = {
mbed_official 76:aeb1df146756 37 {PA_9, UART_1, STM_PIN_DATA(GPIO_Mode_AF, GPIO_OType_PP, GPIO_PuPd_UP, GPIO_AF_1)},
mbed_official 76:aeb1df146756 38 {PA_2, UART_2, STM_PIN_DATA(GPIO_Mode_AF, GPIO_OType_PP, GPIO_PuPd_UP, GPIO_AF_1)},
mbed_official 76:aeb1df146756 39 {NC, NC, 0}
mbed_official 76:aeb1df146756 40 };
mbed_official 76:aeb1df146756 41
mbed_official 76:aeb1df146756 42 static const PinMap PinMap_UART_RX[] = {
mbed_official 76:aeb1df146756 43 {PA_10, UART_1, STM_PIN_DATA(GPIO_Mode_AF, GPIO_OType_PP, GPIO_PuPd_UP, GPIO_AF_1)},
mbed_official 76:aeb1df146756 44 {PA_3, UART_2, STM_PIN_DATA(GPIO_Mode_AF, GPIO_OType_PP, GPIO_PuPd_UP, GPIO_AF_1)},
mbed_official 76:aeb1df146756 45 {NC, NC, 0}
mbed_official 76:aeb1df146756 46 };
mbed_official 76:aeb1df146756 47
mbed_official 76:aeb1df146756 48 #define UART_NUM (2)
mbed_official 76:aeb1df146756 49
mbed_official 76:aeb1df146756 50 static uint32_t serial_irq_ids[UART_NUM] = {0};
mbed_official 76:aeb1df146756 51
mbed_official 76:aeb1df146756 52 static uart_irq_handler irq_handler;
mbed_official 76:aeb1df146756 53
mbed_official 76:aeb1df146756 54 int stdio_uart_inited = 0;
mbed_official 76:aeb1df146756 55 serial_t stdio_uart;
mbed_official 76:aeb1df146756 56
mbed_official 76:aeb1df146756 57 static void init_usart(serial_t *obj) {
mbed_official 76:aeb1df146756 58 USART_TypeDef *usart = (USART_TypeDef *)(obj->uart);
mbed_official 76:aeb1df146756 59 USART_InitTypeDef USART_InitStructure;
mbed_official 76:aeb1df146756 60
mbed_official 76:aeb1df146756 61 USART_Cmd(usart, DISABLE);
mbed_official 76:aeb1df146756 62
mbed_official 76:aeb1df146756 63 USART_InitStructure.USART_BaudRate = obj->baudrate;
mbed_official 76:aeb1df146756 64 USART_InitStructure.USART_WordLength = obj->databits;
mbed_official 76:aeb1df146756 65 USART_InitStructure.USART_StopBits = obj->stopbits;
mbed_official 76:aeb1df146756 66 USART_InitStructure.USART_Parity = obj->parity;
mbed_official 76:aeb1df146756 67 USART_InitStructure.USART_HardwareFlowControl = USART_HardwareFlowControl_None;
mbed_official 76:aeb1df146756 68 USART_InitStructure.USART_Mode = USART_Mode_Rx | USART_Mode_Tx;
mbed_official 76:aeb1df146756 69 USART_Init(usart, &USART_InitStructure);
mbed_official 76:aeb1df146756 70
mbed_official 76:aeb1df146756 71 USART_Cmd(usart, ENABLE);
mbed_official 76:aeb1df146756 72 }
mbed_official 76:aeb1df146756 73
mbed_official 76:aeb1df146756 74 void serial_init(serial_t *obj, PinName tx, PinName rx) {
mbed_official 76:aeb1df146756 75 // Determine the UART to use (UART_1, UART_2, ...)
mbed_official 76:aeb1df146756 76 UARTName uart_tx = (UARTName)pinmap_peripheral(tx, PinMap_UART_TX);
mbed_official 76:aeb1df146756 77 UARTName uart_rx = (UARTName)pinmap_peripheral(rx, PinMap_UART_RX);
mbed_official 76:aeb1df146756 78
mbed_official 76:aeb1df146756 79 // Get the peripheral name (UART_1, UART_2, ...) from the pin and assign it to the object
mbed_official 76:aeb1df146756 80 obj->uart = (UARTName)pinmap_merge(uart_tx, uart_rx);
mbed_official 76:aeb1df146756 81
mbed_official 76:aeb1df146756 82 if (obj->uart == (UARTName)NC) {
mbed_official 76:aeb1df146756 83 error("Serial pinout mapping failed");
mbed_official 76:aeb1df146756 84 }
mbed_official 76:aeb1df146756 85
mbed_official 76:aeb1df146756 86 // Enable USART clock
mbed_official 76:aeb1df146756 87 if (obj->uart == UART_1) {
mbed_official 76:aeb1df146756 88 RCC_APB2PeriphClockCmd(RCC_APB2Periph_USART1, ENABLE);
mbed_official 76:aeb1df146756 89 }
mbed_official 76:aeb1df146756 90 if (obj->uart == UART_2) {
mbed_official 76:aeb1df146756 91 RCC_APB1PeriphClockCmd(RCC_APB1Periph_USART2, ENABLE);
mbed_official 76:aeb1df146756 92 }
mbed_official 76:aeb1df146756 93
mbed_official 76:aeb1df146756 94 // Configure the UART pins
mbed_official 76:aeb1df146756 95 pinmap_pinout(tx, PinMap_UART_TX);
mbed_official 76:aeb1df146756 96 pinmap_pinout(rx, PinMap_UART_RX);
mbed_official 76:aeb1df146756 97 pin_mode(tx, PullUp);
mbed_official 76:aeb1df146756 98 pin_mode(rx, PullUp);
mbed_official 77:b5886236e6f0 99
mbed_official 76:aeb1df146756 100 // Configure UART
mbed_official 76:aeb1df146756 101 obj->baudrate = 9600;
mbed_official 76:aeb1df146756 102 obj->databits = USART_WordLength_8b;
mbed_official 76:aeb1df146756 103 obj->stopbits = USART_StopBits_1;
mbed_official 76:aeb1df146756 104 obj->parity = USART_Parity_No;
mbed_official 76:aeb1df146756 105
mbed_official 76:aeb1df146756 106 init_usart(obj);
mbed_official 76:aeb1df146756 107
mbed_official 76:aeb1df146756 108 // The index is used by irq
mbed_official 76:aeb1df146756 109 if (obj->uart == UART_1) obj->index = 0;
mbed_official 76:aeb1df146756 110 if (obj->uart == UART_2) obj->index = 1;
mbed_official 76:aeb1df146756 111
mbed_official 76:aeb1df146756 112 // For stdio management
mbed_official 76:aeb1df146756 113 if (obj->uart == STDIO_UART) {
mbed_official 76:aeb1df146756 114 stdio_uart_inited = 1;
mbed_official 76:aeb1df146756 115 memcpy(&stdio_uart, obj, sizeof(serial_t));
mbed_official 76:aeb1df146756 116 }
mbed_official 76:aeb1df146756 117
mbed_official 76:aeb1df146756 118 }
mbed_official 76:aeb1df146756 119
mbed_official 76:aeb1df146756 120 void serial_free(serial_t *obj) {
mbed_official 76:aeb1df146756 121 serial_irq_ids[obj->index] = 0;
mbed_official 76:aeb1df146756 122 }
mbed_official 76:aeb1df146756 123
mbed_official 76:aeb1df146756 124 void serial_baud(serial_t *obj, int baudrate) {
mbed_official 76:aeb1df146756 125 obj->baudrate = baudrate;
mbed_official 76:aeb1df146756 126 init_usart(obj);
mbed_official 76:aeb1df146756 127 }
mbed_official 76:aeb1df146756 128
mbed_official 76:aeb1df146756 129 void serial_format(serial_t *obj, int data_bits, SerialParity parity, int stop_bits) {
mbed_official 76:aeb1df146756 130 if (data_bits == 8) {
mbed_official 76:aeb1df146756 131 obj->databits = USART_WordLength_8b;
mbed_official 76:aeb1df146756 132 }
mbed_official 76:aeb1df146756 133 else {
mbed_official 76:aeb1df146756 134 obj->databits = USART_WordLength_9b;
mbed_official 76:aeb1df146756 135 }
mbed_official 76:aeb1df146756 136
mbed_official 76:aeb1df146756 137 switch (parity) {
mbed_official 76:aeb1df146756 138 case ParityOdd:
mbed_official 76:aeb1df146756 139 case ParityForced0:
mbed_official 76:aeb1df146756 140 obj->parity = USART_Parity_Odd;
mbed_official 76:aeb1df146756 141 break;
mbed_official 76:aeb1df146756 142 case ParityEven:
mbed_official 76:aeb1df146756 143 case ParityForced1:
mbed_official 76:aeb1df146756 144 obj->parity = USART_Parity_Even;
mbed_official 76:aeb1df146756 145 break;
mbed_official 76:aeb1df146756 146 default: // ParityNone
mbed_official 76:aeb1df146756 147 obj->parity = USART_Parity_No;
mbed_official 76:aeb1df146756 148 break;
mbed_official 76:aeb1df146756 149 }
mbed_official 76:aeb1df146756 150
mbed_official 76:aeb1df146756 151 if (stop_bits == 2) {
mbed_official 76:aeb1df146756 152 obj->stopbits = USART_StopBits_2;
mbed_official 76:aeb1df146756 153 }
mbed_official 76:aeb1df146756 154 else {
mbed_official 76:aeb1df146756 155 obj->stopbits = USART_StopBits_1;
mbed_official 76:aeb1df146756 156 }
mbed_official 76:aeb1df146756 157
mbed_official 76:aeb1df146756 158 init_usart(obj);
mbed_official 76:aeb1df146756 159 }
mbed_official 76:aeb1df146756 160
mbed_official 76:aeb1df146756 161 /******************************************************************************
mbed_official 76:aeb1df146756 162 * INTERRUPTS HANDLING
mbed_official 76:aeb1df146756 163 ******************************************************************************/
mbed_official 76:aeb1df146756 164
mbed_official 76:aeb1df146756 165 // not api
mbed_official 76:aeb1df146756 166 static void uart_irq(USART_TypeDef* usart, int id) {
mbed_official 76:aeb1df146756 167 if (serial_irq_ids[id] != 0) {
mbed_official 76:aeb1df146756 168 if (USART_GetITStatus(usart, USART_IT_TC) != RESET) {
mbed_official 76:aeb1df146756 169 irq_handler(serial_irq_ids[id], TxIrq);
mbed_official 76:aeb1df146756 170 USART_ClearITPendingBit(usart, USART_IT_TC);
mbed_official 76:aeb1df146756 171 }
mbed_official 76:aeb1df146756 172 if (USART_GetITStatus(usart, USART_IT_RXNE) != RESET) {
mbed_official 76:aeb1df146756 173 irq_handler(serial_irq_ids[id], RxIrq);
mbed_official 76:aeb1df146756 174 USART_ClearITPendingBit(usart, USART_IT_RXNE);
mbed_official 76:aeb1df146756 175 }
mbed_official 76:aeb1df146756 176 }
mbed_official 76:aeb1df146756 177 }
mbed_official 76:aeb1df146756 178
mbed_official 76:aeb1df146756 179 static void uart1_irq(void) {uart_irq((USART_TypeDef*)UART_1, 0);}
mbed_official 76:aeb1df146756 180 static void uart2_irq(void) {uart_irq((USART_TypeDef*)UART_2, 1);}
mbed_official 76:aeb1df146756 181
mbed_official 76:aeb1df146756 182 void serial_irq_handler(serial_t *obj, uart_irq_handler handler, uint32_t id) {
mbed_official 76:aeb1df146756 183 irq_handler = handler;
mbed_official 76:aeb1df146756 184 serial_irq_ids[obj->index] = id;
mbed_official 76:aeb1df146756 185 }
mbed_official 76:aeb1df146756 186
mbed_official 76:aeb1df146756 187 void serial_irq_set(serial_t *obj, SerialIrq irq, uint32_t enable) {
mbed_official 76:aeb1df146756 188 IRQn_Type irq_n = (IRQn_Type)0;
mbed_official 76:aeb1df146756 189 uint32_t vector = 0;
mbed_official 76:aeb1df146756 190 USART_TypeDef *usart = (USART_TypeDef *)(obj->uart);
mbed_official 76:aeb1df146756 191
mbed_official 76:aeb1df146756 192 if (obj->uart == UART_1) {
mbed_official 76:aeb1df146756 193 irq_n = USART1_IRQn;
mbed_official 76:aeb1df146756 194 vector = (uint32_t)&uart1_irq;
mbed_official 76:aeb1df146756 195 }
mbed_official 76:aeb1df146756 196
mbed_official 76:aeb1df146756 197 if (obj->uart == UART_2) {
mbed_official 76:aeb1df146756 198 irq_n = USART2_IRQn;
mbed_official 76:aeb1df146756 199 vector = (uint32_t)&uart2_irq;
mbed_official 76:aeb1df146756 200 }
mbed_official 76:aeb1df146756 201
mbed_official 76:aeb1df146756 202 if (enable) {
mbed_official 76:aeb1df146756 203
mbed_official 76:aeb1df146756 204 if (irq == RxIrq) {
mbed_official 76:aeb1df146756 205 USART_ITConfig(usart, USART_IT_RXNE, ENABLE);
mbed_official 76:aeb1df146756 206 }
mbed_official 76:aeb1df146756 207 else { // TxIrq
mbed_official 76:aeb1df146756 208 USART_ITConfig(usart, USART_IT_TC, ENABLE);
mbed_official 76:aeb1df146756 209 }
mbed_official 76:aeb1df146756 210
mbed_official 76:aeb1df146756 211 NVIC_SetVector(irq_n, vector);
mbed_official 76:aeb1df146756 212 NVIC_EnableIRQ(irq_n);
mbed_official 76:aeb1df146756 213
mbed_official 76:aeb1df146756 214 } else { // disable
mbed_official 76:aeb1df146756 215
mbed_official 76:aeb1df146756 216 int all_disabled = 0;
mbed_official 76:aeb1df146756 217
mbed_official 76:aeb1df146756 218 if (irq == RxIrq) {
mbed_official 76:aeb1df146756 219 USART_ITConfig(usart, USART_IT_RXNE, DISABLE);
mbed_official 76:aeb1df146756 220 // Check if TxIrq is disabled too
mbed_official 76:aeb1df146756 221 if ((usart->CR1 & USART_CR1_TXEIE) == 0) all_disabled = 1;
mbed_official 76:aeb1df146756 222 }
mbed_official 76:aeb1df146756 223 else { // TxIrq
mbed_official 76:aeb1df146756 224 USART_ITConfig(usart, USART_IT_TXE, DISABLE);
mbed_official 76:aeb1df146756 225 // Check if RxIrq is disabled too
mbed_official 76:aeb1df146756 226 if ((usart->CR1 & USART_CR1_RXNEIE) == 0) all_disabled = 1;
mbed_official 76:aeb1df146756 227 }
mbed_official 76:aeb1df146756 228
mbed_official 76:aeb1df146756 229 if (all_disabled) NVIC_DisableIRQ(irq_n);
mbed_official 76:aeb1df146756 230
mbed_official 76:aeb1df146756 231 }
mbed_official 76:aeb1df146756 232 }
mbed_official 76:aeb1df146756 233
mbed_official 76:aeb1df146756 234 /******************************************************************************
mbed_official 76:aeb1df146756 235 * READ/WRITE
mbed_official 76:aeb1df146756 236 ******************************************************************************/
mbed_official 76:aeb1df146756 237
mbed_official 76:aeb1df146756 238 int serial_getc(serial_t *obj) {
mbed_official 76:aeb1df146756 239 USART_TypeDef *usart = (USART_TypeDef *)(obj->uart);
mbed_official 76:aeb1df146756 240 while (!serial_readable(obj));
mbed_official 76:aeb1df146756 241 return (int)(USART_ReceiveData(usart));
mbed_official 76:aeb1df146756 242 }
mbed_official 76:aeb1df146756 243
mbed_official 76:aeb1df146756 244 void serial_putc(serial_t *obj, int c) {
mbed_official 76:aeb1df146756 245 USART_TypeDef *usart = (USART_TypeDef *)(obj->uart);
mbed_official 76:aeb1df146756 246 while (!serial_writable(obj));
mbed_official 76:aeb1df146756 247 USART_SendData(usart, (uint16_t)c);
mbed_official 76:aeb1df146756 248 }
mbed_official 76:aeb1df146756 249
mbed_official 76:aeb1df146756 250 int serial_readable(serial_t *obj) {
mbed_official 76:aeb1df146756 251 int status;
mbed_official 76:aeb1df146756 252 USART_TypeDef *usart = (USART_TypeDef *)(obj->uart);
mbed_official 76:aeb1df146756 253 // Check if data is received
mbed_official 76:aeb1df146756 254 status = ((USART_GetFlagStatus(usart, USART_FLAG_RXNE) != RESET) ? 1 : 0);
mbed_official 76:aeb1df146756 255 return status;
mbed_official 76:aeb1df146756 256 }
mbed_official 76:aeb1df146756 257
mbed_official 76:aeb1df146756 258 int serial_writable(serial_t *obj) {
mbed_official 76:aeb1df146756 259 int status;
mbed_official 76:aeb1df146756 260 USART_TypeDef *usart = (USART_TypeDef *)(obj->uart);
mbed_official 76:aeb1df146756 261 // Check if data is transmitted
mbed_official 76:aeb1df146756 262 status = ((USART_GetFlagStatus(usart, USART_FLAG_TXE) != RESET) ? 1 : 0);
mbed_official 76:aeb1df146756 263 return status;
mbed_official 76:aeb1df146756 264 }
mbed_official 76:aeb1df146756 265
mbed_official 76:aeb1df146756 266 void serial_clear(serial_t *obj) {
mbed_official 76:aeb1df146756 267 USART_TypeDef *usart = (USART_TypeDef *)(obj->uart);
mbed_official 76:aeb1df146756 268 USART_ClearFlag(usart, USART_FLAG_TXE);
mbed_official 76:aeb1df146756 269 USART_ClearFlag(usart, USART_FLAG_RXNE);
mbed_official 76:aeb1df146756 270 }
mbed_official 76:aeb1df146756 271
mbed_official 76:aeb1df146756 272 void serial_pinout_tx(PinName tx) {
mbed_official 76:aeb1df146756 273 pinmap_pinout(tx, PinMap_UART_TX);
mbed_official 76:aeb1df146756 274 }
mbed_official 76:aeb1df146756 275
mbed_official 76:aeb1df146756 276 void serial_break_set(serial_t *obj) {
mbed_official 76:aeb1df146756 277 }
mbed_official 76:aeb1df146756 278
mbed_official 76:aeb1df146756 279 void serial_break_clear(serial_t *obj) {
mbed_official 76:aeb1df146756 280 }