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_DISCO_F100RB/serial_api.c@165:46e3636d4af7, 2014-04-22 (annotated)

Committer:
mbed_official
Date:
Tue Apr 22 15:00:07 2014 +0100
Revision:
165:46e3636d4af7
Parent:
126:549ba18ddd81
Child:
227:7bd0639b8911
Synchronized with git revision 14ad8773c432d34f478954f00a97bfef2aa40439



Full URL: https://github.com/mbedmicro/mbed/commit/14ad8773c432d34f478954f00a97bfef2aa40439/



Update serial_api.c

Who changed what in which revision?

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