Abdessamad El Abbassi / mbed-src-temp

mbed library sources

Fork of mbed-src by mbed official

targets/hal/TARGET_STM/TARGET_DISCO_F051R8/serial_api.c@130:1dec54e4aec3, 2014-03-21 (annotated)

Committer:
mbed_official
Date:
Fri Mar 21 11:45:09 2014 +0000
Revision:
130:1dec54e4aec3
Synchronized with git revision e5c9ff6781a4e277a5a454e5a0b037f76e31739d



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



STM32F0-Discovery (STM32F051R8) initial port

Who changed what in which revision?

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