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_F103RB/serial_api.c@167:d5744491c362, 2014-04-23 (annotated)

Committer:
mbed_official
Date:
Wed Apr 23 11:00:08 2014 +0100
Revision:
167:d5744491c362
Parent:
70:c1fbde68b492
Child:
174:8bb9f3a33240
Synchronized with git revision 6cf73e2e267b625c71cbf586a1d74e7e4972a369



Full URL: https://github.com/mbedmicro/mbed/commit/6cf73e2e267b625c71cbf586a1d74e7e4972a369/



[NUCLEO_F030R8/F302R8] Move back SetSysClock() call in SystemInit()

Who changed what in which revision?

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