shao ziyang / mbed-src-kl05

mbed library sources

Dependents:   frdm_kl05z_gpio_test

Fork of mbed-src by mbed official

targets/hal/TARGET_STM/TARGET_NUCLEO_F030R8/serial_api.c@166:cb4253f91ada, 2014-04-22 (annotated)

Committer:
mbed_official
Date:
Tue Apr 22 16:00:06 2014 +0100
Revision:
166:cb4253f91ada
Parent:
164:90c6009cba07
Child:
216:577900467c9e
Synchronized with git revision a519f94f35c3993310499623be5c28f74b80485c



Full URL: https://github.com/mbedmicro/mbed/commit/a519f94f35c3993310499623be5c28f74b80485c/



[NUCLEO_F030R8] Many improvements added

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 166:cb4253f91ada 31
mbed_official 166:cb4253f91ada 32 #if DEVICE_SERIAL
mbed_official 166:cb4253f91ada 33
mbed_official 76:aeb1df146756 34 #include "cmsis.h"
mbed_official 76:aeb1df146756 35 #include "pinmap.h"
mbed_official 76:aeb1df146756 36 #include "error.h"
mbed_official 76:aeb1df146756 37 #include <string.h>
mbed_official 76:aeb1df146756 38
mbed_official 76:aeb1df146756 39 static const PinMap PinMap_UART_TX[] = {
mbed_official 164:90c6009cba07 40 {PA_2, UART_2, STM_PIN_DATA(GPIO_Mode_AF, GPIO_OType_PP, GPIO_PuPd_UP, GPIO_AF_1)},
mbed_official 76:aeb1df146756 41 {PA_9, UART_1, STM_PIN_DATA(GPIO_Mode_AF, GPIO_OType_PP, GPIO_PuPd_UP, GPIO_AF_1)},
mbed_official 164:90c6009cba07 42 {PB_6, UART_1, STM_PIN_DATA(GPIO_Mode_AF, GPIO_OType_PP, GPIO_PuPd_UP, GPIO_AF_0)},
mbed_official 76:aeb1df146756 43 {NC, NC, 0}
mbed_official 76:aeb1df146756 44 };
mbed_official 76:aeb1df146756 45
mbed_official 76:aeb1df146756 46 static const PinMap PinMap_UART_RX[] = {
mbed_official 164:90c6009cba07 47 {PA_3, UART_2, STM_PIN_DATA(GPIO_Mode_AF, GPIO_OType_PP, GPIO_PuPd_UP, GPIO_AF_1)},
mbed_official 76:aeb1df146756 48 {PA_10, UART_1, STM_PIN_DATA(GPIO_Mode_AF, GPIO_OType_PP, GPIO_PuPd_UP, GPIO_AF_1)},
mbed_official 164:90c6009cba07 49 {PA_15, UART_2, STM_PIN_DATA(GPIO_Mode_AF, GPIO_OType_PP, GPIO_PuPd_UP, GPIO_AF_1)},
mbed_official 164:90c6009cba07 50 {PB_7, UART_1, STM_PIN_DATA(GPIO_Mode_AF, GPIO_OType_PP, GPIO_PuPd_UP, GPIO_AF_0)},
mbed_official 76:aeb1df146756 51 {NC, NC, 0}
mbed_official 76:aeb1df146756 52 };
mbed_official 76:aeb1df146756 53
mbed_official 76:aeb1df146756 54 #define UART_NUM (2)
mbed_official 76:aeb1df146756 55
mbed_official 76:aeb1df146756 56 static uint32_t serial_irq_ids[UART_NUM] = {0};
mbed_official 76:aeb1df146756 57
mbed_official 76:aeb1df146756 58 static uart_irq_handler irq_handler;
mbed_official 76:aeb1df146756 59
mbed_official 76:aeb1df146756 60 int stdio_uart_inited = 0;
mbed_official 76:aeb1df146756 61 serial_t stdio_uart;
mbed_official 76:aeb1df146756 62
mbed_official 76:aeb1df146756 63 static void init_usart(serial_t *obj) {
mbed_official 76:aeb1df146756 64 USART_TypeDef *usart = (USART_TypeDef *)(obj->uart);
mbed_official 76:aeb1df146756 65 USART_InitTypeDef USART_InitStructure;
mbed_official 76:aeb1df146756 66
mbed_official 76:aeb1df146756 67 USART_Cmd(usart, DISABLE);
mbed_official 76:aeb1df146756 68
mbed_official 76:aeb1df146756 69 USART_InitStructure.USART_BaudRate = obj->baudrate;
mbed_official 76:aeb1df146756 70 USART_InitStructure.USART_WordLength = obj->databits;
mbed_official 76:aeb1df146756 71 USART_InitStructure.USART_StopBits = obj->stopbits;
mbed_official 76:aeb1df146756 72 USART_InitStructure.USART_Parity = obj->parity;
mbed_official 76:aeb1df146756 73 USART_InitStructure.USART_HardwareFlowControl = USART_HardwareFlowControl_None;
mbed_official 76:aeb1df146756 74 USART_InitStructure.USART_Mode = USART_Mode_Rx | USART_Mode_Tx;
mbed_official 76:aeb1df146756 75 USART_Init(usart, &USART_InitStructure);
mbed_official 76:aeb1df146756 76
mbed_official 76:aeb1df146756 77 USART_Cmd(usart, ENABLE);
mbed_official 76:aeb1df146756 78 }
mbed_official 76:aeb1df146756 79
mbed_official 76:aeb1df146756 80 void serial_init(serial_t *obj, PinName tx, PinName rx) {
mbed_official 76:aeb1df146756 81 // Determine the UART to use (UART_1, UART_2, ...)
mbed_official 76:aeb1df146756 82 UARTName uart_tx = (UARTName)pinmap_peripheral(tx, PinMap_UART_TX);
mbed_official 76:aeb1df146756 83 UARTName uart_rx = (UARTName)pinmap_peripheral(rx, PinMap_UART_RX);
mbed_official 76:aeb1df146756 84
mbed_official 76:aeb1df146756 85 // Get the peripheral name (UART_1, UART_2, ...) from the pin and assign it to the object
mbed_official 76:aeb1df146756 86 obj->uart = (UARTName)pinmap_merge(uart_tx, uart_rx);
mbed_official 76:aeb1df146756 87
mbed_official 76:aeb1df146756 88 if (obj->uart == (UARTName)NC) {
mbed_official 76:aeb1df146756 89 error("Serial pinout mapping failed");
mbed_official 76:aeb1df146756 90 }
mbed_official 76:aeb1df146756 91
mbed_official 76:aeb1df146756 92 // Enable USART clock
mbed_official 76:aeb1df146756 93 if (obj->uart == UART_1) {
mbed_official 76:aeb1df146756 94 RCC_APB2PeriphClockCmd(RCC_APB2Periph_USART1, ENABLE);
mbed_official 76:aeb1df146756 95 }
mbed_official 76:aeb1df146756 96 if (obj->uart == UART_2) {
mbed_official 76:aeb1df146756 97 RCC_APB1PeriphClockCmd(RCC_APB1Periph_USART2, ENABLE);
mbed_official 76:aeb1df146756 98 }
mbed_official 76:aeb1df146756 99
mbed_official 76:aeb1df146756 100 // Configure the UART pins
mbed_official 76:aeb1df146756 101 pinmap_pinout(tx, PinMap_UART_TX);
mbed_official 76:aeb1df146756 102 pinmap_pinout(rx, PinMap_UART_RX);
mbed_official 76:aeb1df146756 103 pin_mode(tx, PullUp);
mbed_official 76:aeb1df146756 104 pin_mode(rx, PullUp);
mbed_official 77:b5886236e6f0 105
mbed_official 76:aeb1df146756 106 // Configure UART
mbed_official 76:aeb1df146756 107 obj->baudrate = 9600;
mbed_official 76:aeb1df146756 108 obj->databits = USART_WordLength_8b;
mbed_official 76:aeb1df146756 109 obj->stopbits = USART_StopBits_1;
mbed_official 76:aeb1df146756 110 obj->parity = USART_Parity_No;
mbed_official 76:aeb1df146756 111
mbed_official 76:aeb1df146756 112 init_usart(obj);
mbed_official 76:aeb1df146756 113
mbed_official 76:aeb1df146756 114 // The index is used by irq
mbed_official 76:aeb1df146756 115 if (obj->uart == UART_1) obj->index = 0;
mbed_official 76:aeb1df146756 116 if (obj->uart == UART_2) obj->index = 1;
mbed_official 76:aeb1df146756 117
mbed_official 76:aeb1df146756 118 // For stdio management
mbed_official 76:aeb1df146756 119 if (obj->uart == STDIO_UART) {
mbed_official 76:aeb1df146756 120 stdio_uart_inited = 1;
mbed_official 76:aeb1df146756 121 memcpy(&stdio_uart, obj, sizeof(serial_t));
mbed_official 76:aeb1df146756 122 }
mbed_official 76:aeb1df146756 123
mbed_official 76:aeb1df146756 124 }
mbed_official 76:aeb1df146756 125
mbed_official 76:aeb1df146756 126 void serial_free(serial_t *obj) {
mbed_official 76:aeb1df146756 127 serial_irq_ids[obj->index] = 0;
mbed_official 76:aeb1df146756 128 }
mbed_official 76:aeb1df146756 129
mbed_official 76:aeb1df146756 130 void serial_baud(serial_t *obj, int baudrate) {
mbed_official 76:aeb1df146756 131 obj->baudrate = baudrate;
mbed_official 76:aeb1df146756 132 init_usart(obj);
mbed_official 76:aeb1df146756 133 }
mbed_official 76:aeb1df146756 134
mbed_official 76:aeb1df146756 135 void serial_format(serial_t *obj, int data_bits, SerialParity parity, int stop_bits) {
mbed_official 76:aeb1df146756 136 if (data_bits == 8) {
mbed_official 76:aeb1df146756 137 obj->databits = USART_WordLength_8b;
mbed_official 76:aeb1df146756 138 }
mbed_official 76:aeb1df146756 139 else {
mbed_official 76:aeb1df146756 140 obj->databits = USART_WordLength_9b;
mbed_official 76:aeb1df146756 141 }
mbed_official 76:aeb1df146756 142
mbed_official 76:aeb1df146756 143 switch (parity) {
mbed_official 76:aeb1df146756 144 case ParityOdd:
mbed_official 76:aeb1df146756 145 case ParityForced0:
mbed_official 76:aeb1df146756 146 obj->parity = USART_Parity_Odd;
mbed_official 76:aeb1df146756 147 break;
mbed_official 76:aeb1df146756 148 case ParityEven:
mbed_official 76:aeb1df146756 149 case ParityForced1:
mbed_official 76:aeb1df146756 150 obj->parity = USART_Parity_Even;
mbed_official 76:aeb1df146756 151 break;
mbed_official 76:aeb1df146756 152 default: // ParityNone
mbed_official 76:aeb1df146756 153 obj->parity = USART_Parity_No;
mbed_official 76:aeb1df146756 154 break;
mbed_official 76:aeb1df146756 155 }
mbed_official 76:aeb1df146756 156
mbed_official 76:aeb1df146756 157 if (stop_bits == 2) {
mbed_official 76:aeb1df146756 158 obj->stopbits = USART_StopBits_2;
mbed_official 76:aeb1df146756 159 }
mbed_official 76:aeb1df146756 160 else {
mbed_official 76:aeb1df146756 161 obj->stopbits = USART_StopBits_1;
mbed_official 76:aeb1df146756 162 }
mbed_official 76:aeb1df146756 163
mbed_official 76:aeb1df146756 164 init_usart(obj);
mbed_official 76:aeb1df146756 165 }
mbed_official 76:aeb1df146756 166
mbed_official 76:aeb1df146756 167 /******************************************************************************
mbed_official 76:aeb1df146756 168 * INTERRUPTS HANDLING
mbed_official 76:aeb1df146756 169 ******************************************************************************/
mbed_official 76:aeb1df146756 170
mbed_official 76:aeb1df146756 171 // not api
mbed_official 76:aeb1df146756 172 static void uart_irq(USART_TypeDef* usart, int id) {
mbed_official 76:aeb1df146756 173 if (serial_irq_ids[id] != 0) {
mbed_official 76:aeb1df146756 174 if (USART_GetITStatus(usart, USART_IT_TC) != RESET) {
mbed_official 76:aeb1df146756 175 irq_handler(serial_irq_ids[id], TxIrq);
mbed_official 76:aeb1df146756 176 USART_ClearITPendingBit(usart, USART_IT_TC);
mbed_official 76:aeb1df146756 177 }
mbed_official 76:aeb1df146756 178 if (USART_GetITStatus(usart, USART_IT_RXNE) != RESET) {
mbed_official 76:aeb1df146756 179 irq_handler(serial_irq_ids[id], RxIrq);
mbed_official 76:aeb1df146756 180 USART_ClearITPendingBit(usart, USART_IT_RXNE);
mbed_official 76:aeb1df146756 181 }
mbed_official 76:aeb1df146756 182 }
mbed_official 76:aeb1df146756 183 }
mbed_official 76:aeb1df146756 184
mbed_official 76:aeb1df146756 185 static void uart1_irq(void) {uart_irq((USART_TypeDef*)UART_1, 0);}
mbed_official 76:aeb1df146756 186 static void uart2_irq(void) {uart_irq((USART_TypeDef*)UART_2, 1);}
mbed_official 76:aeb1df146756 187
mbed_official 76:aeb1df146756 188 void serial_irq_handler(serial_t *obj, uart_irq_handler handler, uint32_t id) {
mbed_official 76:aeb1df146756 189 irq_handler = handler;
mbed_official 76:aeb1df146756 190 serial_irq_ids[obj->index] = id;
mbed_official 76:aeb1df146756 191 }
mbed_official 76:aeb1df146756 192
mbed_official 76:aeb1df146756 193 void serial_irq_set(serial_t *obj, SerialIrq irq, uint32_t enable) {
mbed_official 76:aeb1df146756 194 IRQn_Type irq_n = (IRQn_Type)0;
mbed_official 76:aeb1df146756 195 uint32_t vector = 0;
mbed_official 76:aeb1df146756 196 USART_TypeDef *usart = (USART_TypeDef *)(obj->uart);
mbed_official 76:aeb1df146756 197
mbed_official 76:aeb1df146756 198 if (obj->uart == UART_1) {
mbed_official 76:aeb1df146756 199 irq_n = USART1_IRQn;
mbed_official 76:aeb1df146756 200 vector = (uint32_t)&uart1_irq;
mbed_official 76:aeb1df146756 201 }
mbed_official 76:aeb1df146756 202
mbed_official 76:aeb1df146756 203 if (obj->uart == UART_2) {
mbed_official 76:aeb1df146756 204 irq_n = USART2_IRQn;
mbed_official 76:aeb1df146756 205 vector = (uint32_t)&uart2_irq;
mbed_official 76:aeb1df146756 206 }
mbed_official 76:aeb1df146756 207
mbed_official 76:aeb1df146756 208 if (enable) {
mbed_official 76:aeb1df146756 209
mbed_official 76:aeb1df146756 210 if (irq == RxIrq) {
mbed_official 76:aeb1df146756 211 USART_ITConfig(usart, USART_IT_RXNE, ENABLE);
mbed_official 76:aeb1df146756 212 }
mbed_official 76:aeb1df146756 213 else { // TxIrq
mbed_official 76:aeb1df146756 214 USART_ITConfig(usart, USART_IT_TC, ENABLE);
mbed_official 76:aeb1df146756 215 }
mbed_official 76:aeb1df146756 216
mbed_official 76:aeb1df146756 217 NVIC_SetVector(irq_n, vector);
mbed_official 76:aeb1df146756 218 NVIC_EnableIRQ(irq_n);
mbed_official 76:aeb1df146756 219
mbed_official 76:aeb1df146756 220 } else { // disable
mbed_official 76:aeb1df146756 221
mbed_official 76:aeb1df146756 222 int all_disabled = 0;
mbed_official 76:aeb1df146756 223
mbed_official 76:aeb1df146756 224 if (irq == RxIrq) {
mbed_official 76:aeb1df146756 225 USART_ITConfig(usart, USART_IT_RXNE, DISABLE);
mbed_official 76:aeb1df146756 226 // Check if TxIrq is disabled too
mbed_official 76:aeb1df146756 227 if ((usart->CR1 & USART_CR1_TXEIE) == 0) all_disabled = 1;
mbed_official 76:aeb1df146756 228 }
mbed_official 76:aeb1df146756 229 else { // TxIrq
mbed_official 76:aeb1df146756 230 USART_ITConfig(usart, USART_IT_TXE, DISABLE);
mbed_official 76:aeb1df146756 231 // Check if RxIrq is disabled too
mbed_official 76:aeb1df146756 232 if ((usart->CR1 & USART_CR1_RXNEIE) == 0) all_disabled = 1;
mbed_official 76:aeb1df146756 233 }
mbed_official 76:aeb1df146756 234
mbed_official 76:aeb1df146756 235 if (all_disabled) NVIC_DisableIRQ(irq_n);
mbed_official 76:aeb1df146756 236
mbed_official 76:aeb1df146756 237 }
mbed_official 76:aeb1df146756 238 }
mbed_official 76:aeb1df146756 239
mbed_official 76:aeb1df146756 240 /******************************************************************************
mbed_official 76:aeb1df146756 241 * READ/WRITE
mbed_official 76:aeb1df146756 242 ******************************************************************************/
mbed_official 76:aeb1df146756 243
mbed_official 76:aeb1df146756 244 int serial_getc(serial_t *obj) {
mbed_official 76:aeb1df146756 245 USART_TypeDef *usart = (USART_TypeDef *)(obj->uart);
mbed_official 76:aeb1df146756 246 while (!serial_readable(obj));
mbed_official 76:aeb1df146756 247 return (int)(USART_ReceiveData(usart));
mbed_official 76:aeb1df146756 248 }
mbed_official 76:aeb1df146756 249
mbed_official 76:aeb1df146756 250 void serial_putc(serial_t *obj, int c) {
mbed_official 76:aeb1df146756 251 USART_TypeDef *usart = (USART_TypeDef *)(obj->uart);
mbed_official 76:aeb1df146756 252 while (!serial_writable(obj));
mbed_official 76:aeb1df146756 253 USART_SendData(usart, (uint16_t)c);
mbed_official 76:aeb1df146756 254 }
mbed_official 76:aeb1df146756 255
mbed_official 76:aeb1df146756 256 int serial_readable(serial_t *obj) {
mbed_official 76:aeb1df146756 257 int status;
mbed_official 76:aeb1df146756 258 USART_TypeDef *usart = (USART_TypeDef *)(obj->uart);
mbed_official 76:aeb1df146756 259 // Check if data is received
mbed_official 76:aeb1df146756 260 status = ((USART_GetFlagStatus(usart, USART_FLAG_RXNE) != RESET) ? 1 : 0);
mbed_official 76:aeb1df146756 261 return status;
mbed_official 76:aeb1df146756 262 }
mbed_official 76:aeb1df146756 263
mbed_official 76:aeb1df146756 264 int serial_writable(serial_t *obj) {
mbed_official 76:aeb1df146756 265 int status;
mbed_official 76:aeb1df146756 266 USART_TypeDef *usart = (USART_TypeDef *)(obj->uart);
mbed_official 76:aeb1df146756 267 // Check if data is transmitted
mbed_official 76:aeb1df146756 268 status = ((USART_GetFlagStatus(usart, USART_FLAG_TXE) != RESET) ? 1 : 0);
mbed_official 76:aeb1df146756 269 return status;
mbed_official 76:aeb1df146756 270 }
mbed_official 76:aeb1df146756 271
mbed_official 76:aeb1df146756 272 void serial_clear(serial_t *obj) {
mbed_official 76:aeb1df146756 273 USART_TypeDef *usart = (USART_TypeDef *)(obj->uart);
mbed_official 76:aeb1df146756 274 USART_ClearFlag(usart, USART_FLAG_TXE);
mbed_official 76:aeb1df146756 275 USART_ClearFlag(usart, USART_FLAG_RXNE);
mbed_official 76:aeb1df146756 276 }
mbed_official 76:aeb1df146756 277
mbed_official 76:aeb1df146756 278 void serial_pinout_tx(PinName tx) {
mbed_official 76:aeb1df146756 279 pinmap_pinout(tx, PinMap_UART_TX);
mbed_official 76:aeb1df146756 280 }
mbed_official 76:aeb1df146756 281
mbed_official 76:aeb1df146756 282 void serial_break_set(serial_t *obj) {
mbed_official 76:aeb1df146756 283 }
mbed_official 76:aeb1df146756 284
mbed_official 76:aeb1df146756 285 void serial_break_clear(serial_t *obj) {
mbed_official 76:aeb1df146756 286 }
mbed_official 166:cb4253f91ada 287
mbed_official 166:cb4253f91ada 288 #endif