mbed SDK library sources
Fork of mbed-src by
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.
targets/hal/TARGET_STM/TARGET_NUCLEO_F103RB/serial_api.c@56:99eb381a3269, 2013-12-12 (annotated)
- Committer:
- mbed_official
- Date:
- Thu Dec 12 10:45:05 2013 +0000
- Revision:
- 56:99eb381a3269
- Parent:
- 55:3b765ca737a5
- Child:
- 70:c1fbde68b492
Synchronized with git revision bd51e4eb73a1706f1d5379ec5cebcbd6d978cb4f
Full URL: https://github.com/mbedmicro/mbed/commit/bd51e4eb73a1706f1d5379ec5cebcbd6d978cb4f/
[NUCLEO_F103RB] Add I2C master, code cleanup, ...
Who changed what in which revision?
User | Revision | Line number | New contents of line |
---|---|---|---|
mbed_official | 52:a51c77007319 | 1 | /* mbed Microcontroller Library |
mbed_official | 52:a51c77007319 | 2 | * Copyright (c) 2006-2013 ARM Limited |
mbed_official | 52:a51c77007319 | 3 | * |
mbed_official | 52:a51c77007319 | 4 | * Licensed under the Apache License, Version 2.0 (the "License"); |
mbed_official | 52:a51c77007319 | 5 | * you may not use this file except in compliance with the License. |
mbed_official | 52:a51c77007319 | 6 | * You may obtain a copy of the License at |
mbed_official | 52:a51c77007319 | 7 | * |
mbed_official | 52:a51c77007319 | 8 | * http://www.apache.org/licenses/LICENSE-2.0 |
mbed_official | 52:a51c77007319 | 9 | * |
mbed_official | 52:a51c77007319 | 10 | * Unless required by applicable law or agreed to in writing, software |
mbed_official | 52:a51c77007319 | 11 | * distributed under the License is distributed on an "AS IS" BASIS, |
mbed_official | 52:a51c77007319 | 12 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
mbed_official | 52:a51c77007319 | 13 | * See the License for the specific language governing permissions and |
mbed_official | 52:a51c77007319 | 14 | * limitations under the License. |
mbed_official | 52:a51c77007319 | 15 | */ |
mbed_official | 52:a51c77007319 | 16 | #include "serial_api.h" |
mbed_official | 52:a51c77007319 | 17 | #include "cmsis.h" |
mbed_official | 52:a51c77007319 | 18 | #include "pinmap.h" |
mbed_official | 52:a51c77007319 | 19 | #include "error.h" |
mbed_official | 52:a51c77007319 | 20 | #include <string.h> |
mbed_official | 52:a51c77007319 | 21 | |
mbed_official | 52:a51c77007319 | 22 | static const PinMap PinMap_UART_TX[] = { |
mbed_official | 52:a51c77007319 | 23 | {PA_9, UART_1, STM_PIN_DATA(GPIO_Mode_AF_PP, 0)}, |
mbed_official | 52:a51c77007319 | 24 | {PA_2, UART_2, STM_PIN_DATA(GPIO_Mode_AF_PP, 0)}, |
mbed_official | 52:a51c77007319 | 25 | {NC, NC, 0} |
mbed_official | 52:a51c77007319 | 26 | }; |
mbed_official | 52:a51c77007319 | 27 | |
mbed_official | 52:a51c77007319 | 28 | static const PinMap PinMap_UART_RX[] = { |
mbed_official | 52:a51c77007319 | 29 | {PA_10, UART_1, STM_PIN_DATA(GPIO_Mode_IN_FLOATING, 0)}, |
mbed_official | 52:a51c77007319 | 30 | {PA_3, UART_2, STM_PIN_DATA(GPIO_Mode_IN_FLOATING, 0)}, |
mbed_official | 52:a51c77007319 | 31 | {NC, NC, 0} |
mbed_official | 52:a51c77007319 | 32 | }; |
mbed_official | 52:a51c77007319 | 33 | |
mbed_official | 52:a51c77007319 | 34 | #define UART_NUM (2) |
mbed_official | 52:a51c77007319 | 35 | |
mbed_official | 52:a51c77007319 | 36 | static uint32_t serial_irq_ids[UART_NUM] = {0}; |
mbed_official | 52:a51c77007319 | 37 | |
mbed_official | 52:a51c77007319 | 38 | static uart_irq_handler irq_handler; |
mbed_official | 52:a51c77007319 | 39 | |
mbed_official | 52:a51c77007319 | 40 | int stdio_uart_inited = 0; |
mbed_official | 52:a51c77007319 | 41 | serial_t stdio_uart; |
mbed_official | 52:a51c77007319 | 42 | |
mbed_official | 56:99eb381a3269 | 43 | static void init_usart(serial_t *obj) { |
mbed_official | 56:99eb381a3269 | 44 | USART_TypeDef *usart = (USART_TypeDef *)(obj->uart); |
mbed_official | 52:a51c77007319 | 45 | USART_InitTypeDef USART_InitStructure; |
mbed_official | 52:a51c77007319 | 46 | |
mbed_official | 56:99eb381a3269 | 47 | USART_Cmd(usart, DISABLE); |
mbed_official | 56:99eb381a3269 | 48 | |
mbed_official | 56:99eb381a3269 | 49 | USART_InitStructure.USART_BaudRate = obj->baudrate; |
mbed_official | 56:99eb381a3269 | 50 | USART_InitStructure.USART_WordLength = obj->databits; |
mbed_official | 56:99eb381a3269 | 51 | USART_InitStructure.USART_StopBits = obj->stopbits; |
mbed_official | 56:99eb381a3269 | 52 | USART_InitStructure.USART_Parity = obj->parity; |
mbed_official | 56:99eb381a3269 | 53 | USART_InitStructure.USART_HardwareFlowControl = USART_HardwareFlowControl_None; |
mbed_official | 56:99eb381a3269 | 54 | USART_InitStructure.USART_Mode = USART_Mode_Rx | USART_Mode_Tx; |
mbed_official | 56:99eb381a3269 | 55 | USART_Init(usart, &USART_InitStructure); |
mbed_official | 56:99eb381a3269 | 56 | |
mbed_official | 56:99eb381a3269 | 57 | USART_Cmd(usart, ENABLE); |
mbed_official | 56:99eb381a3269 | 58 | } |
mbed_official | 56:99eb381a3269 | 59 | |
mbed_official | 56:99eb381a3269 | 60 | void serial_init(serial_t *obj, PinName tx, PinName rx) { |
mbed_official | 52:a51c77007319 | 61 | // Determine the UART to use (UART_1, UART_2, ...) |
mbed_official | 52:a51c77007319 | 62 | UARTName uart_tx = (UARTName)pinmap_peripheral(tx, PinMap_UART_TX); |
mbed_official | 52:a51c77007319 | 63 | UARTName uart_rx = (UARTName)pinmap_peripheral(rx, PinMap_UART_RX); |
mbed_official | 52:a51c77007319 | 64 | |
mbed_official | 52:a51c77007319 | 65 | // Get the peripheral name (UART_1, UART_2, ...) from the pin and assign it to the object |
mbed_official | 52:a51c77007319 | 66 | obj->uart = (UARTName)pinmap_merge(uart_tx, uart_rx); |
mbed_official | 52:a51c77007319 | 67 | |
mbed_official | 52:a51c77007319 | 68 | if (obj->uart == (UARTName)NC) { |
mbed_official | 52:a51c77007319 | 69 | error("Serial pinout mapping failed"); |
mbed_official | 52:a51c77007319 | 70 | } |
mbed_official | 56:99eb381a3269 | 71 | |
mbed_official | 52:a51c77007319 | 72 | // Enable USART clock |
mbed_official | 52:a51c77007319 | 73 | if (obj->uart == UART_1) { |
mbed_official | 52:a51c77007319 | 74 | RCC_APB2PeriphClockCmd(RCC_APB2Periph_USART1, ENABLE); |
mbed_official | 52:a51c77007319 | 75 | } |
mbed_official | 52:a51c77007319 | 76 | if (obj->uart == UART_2) { |
mbed_official | 52:a51c77007319 | 77 | RCC_APB1PeriphClockCmd(RCC_APB1Periph_USART2, ENABLE); |
mbed_official | 52:a51c77007319 | 78 | } |
mbed_official | 52:a51c77007319 | 79 | |
mbed_official | 52:a51c77007319 | 80 | // Configure the UART pins |
mbed_official | 52:a51c77007319 | 81 | pinmap_pinout(tx, PinMap_UART_TX); |
mbed_official | 52:a51c77007319 | 82 | pinmap_pinout(rx, PinMap_UART_RX); |
mbed_official | 52:a51c77007319 | 83 | |
mbed_official | 52:a51c77007319 | 84 | // Configure UART |
mbed_official | 52:a51c77007319 | 85 | obj->baudrate = 9600; |
mbed_official | 52:a51c77007319 | 86 | obj->databits = USART_WordLength_8b; |
mbed_official | 52:a51c77007319 | 87 | obj->stopbits = USART_StopBits_1; |
mbed_official | 52:a51c77007319 | 88 | obj->parity = USART_Parity_No; |
mbed_official | 52:a51c77007319 | 89 | |
mbed_official | 56:99eb381a3269 | 90 | init_usart(obj); |
mbed_official | 52:a51c77007319 | 91 | |
mbed_official | 52:a51c77007319 | 92 | // The index is used by irq |
mbed_official | 52:a51c77007319 | 93 | if (obj->uart == UART_1) obj->index = 0; |
mbed_official | 52:a51c77007319 | 94 | if (obj->uart == UART_2) obj->index = 1; |
mbed_official | 52:a51c77007319 | 95 | |
mbed_official | 52:a51c77007319 | 96 | // For stdio management |
mbed_official | 52:a51c77007319 | 97 | if (obj->uart == STDIO_UART) { |
mbed_official | 52:a51c77007319 | 98 | stdio_uart_inited = 1; |
mbed_official | 52:a51c77007319 | 99 | memcpy(&stdio_uart, obj, sizeof(serial_t)); |
mbed_official | 52:a51c77007319 | 100 | } |
mbed_official | 52:a51c77007319 | 101 | |
mbed_official | 52:a51c77007319 | 102 | } |
mbed_official | 52:a51c77007319 | 103 | |
mbed_official | 52:a51c77007319 | 104 | void serial_free(serial_t *obj) { |
mbed_official | 52:a51c77007319 | 105 | serial_irq_ids[obj->index] = 0; |
mbed_official | 52:a51c77007319 | 106 | } |
mbed_official | 52:a51c77007319 | 107 | |
mbed_official | 52:a51c77007319 | 108 | void serial_baud(serial_t *obj, int baudrate) { |
mbed_official | 52:a51c77007319 | 109 | obj->baudrate = baudrate; |
mbed_official | 56:99eb381a3269 | 110 | init_usart(obj); |
mbed_official | 52:a51c77007319 | 111 | } |
mbed_official | 52:a51c77007319 | 112 | |
mbed_official | 52:a51c77007319 | 113 | void serial_format(serial_t *obj, int data_bits, SerialParity parity, int stop_bits) { |
mbed_official | 52:a51c77007319 | 114 | if (data_bits == 8) { |
mbed_official | 52:a51c77007319 | 115 | obj->databits = USART_WordLength_8b; |
mbed_official | 52:a51c77007319 | 116 | } |
mbed_official | 52:a51c77007319 | 117 | else { |
mbed_official | 52:a51c77007319 | 118 | obj->databits = USART_WordLength_9b; |
mbed_official | 52:a51c77007319 | 119 | } |
mbed_official | 52:a51c77007319 | 120 | |
mbed_official | 52:a51c77007319 | 121 | switch (parity) { |
mbed_official | 52:a51c77007319 | 122 | case ParityOdd: |
mbed_official | 52:a51c77007319 | 123 | case ParityForced0: |
mbed_official | 52:a51c77007319 | 124 | obj->parity = USART_Parity_Odd; |
mbed_official | 52:a51c77007319 | 125 | break; |
mbed_official | 52:a51c77007319 | 126 | case ParityEven: |
mbed_official | 52:a51c77007319 | 127 | case ParityForced1: |
mbed_official | 52:a51c77007319 | 128 | obj->parity = USART_Parity_Even; |
mbed_official | 52:a51c77007319 | 129 | break; |
mbed_official | 52:a51c77007319 | 130 | default: // ParityNone |
mbed_official | 52:a51c77007319 | 131 | obj->parity = USART_Parity_No; |
mbed_official | 52:a51c77007319 | 132 | break; |
mbed_official | 52:a51c77007319 | 133 | } |
mbed_official | 52:a51c77007319 | 134 | |
mbed_official | 52:a51c77007319 | 135 | if (stop_bits == 2) { |
mbed_official | 52:a51c77007319 | 136 | obj->stopbits = USART_StopBits_2; |
mbed_official | 52:a51c77007319 | 137 | } |
mbed_official | 52:a51c77007319 | 138 | else { |
mbed_official | 52:a51c77007319 | 139 | obj->stopbits = USART_StopBits_1; |
mbed_official | 52:a51c77007319 | 140 | } |
mbed_official | 52:a51c77007319 | 141 | |
mbed_official | 56:99eb381a3269 | 142 | init_usart(obj); |
mbed_official | 52:a51c77007319 | 143 | } |
mbed_official | 52:a51c77007319 | 144 | |
mbed_official | 52:a51c77007319 | 145 | /****************************************************************************** |
mbed_official | 52:a51c77007319 | 146 | * INTERRUPTS HANDLING |
mbed_official | 52:a51c77007319 | 147 | ******************************************************************************/ |
mbed_official | 52:a51c77007319 | 148 | |
mbed_official | 52:a51c77007319 | 149 | // not api |
mbed_official | 55:3b765ca737a5 | 150 | static void uart_irq(USART_TypeDef* usart, int id) { |
mbed_official | 55:3b765ca737a5 | 151 | if (serial_irq_ids[id] != 0) { |
mbed_official | 55:3b765ca737a5 | 152 | if (USART_GetITStatus(usart, USART_IT_TC) != RESET) { |
mbed_official | 55:3b765ca737a5 | 153 | irq_handler(serial_irq_ids[id], TxIrq); |
mbed_official | 55:3b765ca737a5 | 154 | USART_ClearITPendingBit(usart, USART_IT_TC); |
mbed_official | 52:a51c77007319 | 155 | } |
mbed_official | 52:a51c77007319 | 156 | if (USART_GetITStatus(usart, USART_IT_RXNE) != RESET) { |
mbed_official | 55:3b765ca737a5 | 157 | irq_handler(serial_irq_ids[id], RxIrq); |
mbed_official | 55:3b765ca737a5 | 158 | USART_ClearITPendingBit(usart, USART_IT_RXNE); |
mbed_official | 52:a51c77007319 | 159 | } |
mbed_official | 52:a51c77007319 | 160 | } |
mbed_official | 52:a51c77007319 | 161 | } |
mbed_official | 52:a51c77007319 | 162 | |
mbed_official | 55:3b765ca737a5 | 163 | static void uart1_irq(void) {uart_irq((USART_TypeDef*)UART_1, 0);} |
mbed_official | 55:3b765ca737a5 | 164 | static void uart2_irq(void) {uart_irq((USART_TypeDef*)UART_2, 1);} |
mbed_official | 52:a51c77007319 | 165 | |
mbed_official | 52:a51c77007319 | 166 | void serial_irq_handler(serial_t *obj, uart_irq_handler handler, uint32_t id) { |
mbed_official | 52:a51c77007319 | 167 | irq_handler = handler; |
mbed_official | 52:a51c77007319 | 168 | serial_irq_ids[obj->index] = id; |
mbed_official | 52:a51c77007319 | 169 | } |
mbed_official | 52:a51c77007319 | 170 | |
mbed_official | 52:a51c77007319 | 171 | void serial_irq_set(serial_t *obj, SerialIrq irq, uint32_t enable) { |
mbed_official | 52:a51c77007319 | 172 | IRQn_Type irq_n = (IRQn_Type)0; |
mbed_official | 52:a51c77007319 | 173 | uint32_t vector = 0; |
mbed_official | 52:a51c77007319 | 174 | USART_TypeDef *usart = (USART_TypeDef *)(obj->uart); |
mbed_official | 52:a51c77007319 | 175 | |
mbed_official | 52:a51c77007319 | 176 | if (obj->uart == UART_1) { |
mbed_official | 52:a51c77007319 | 177 | irq_n = USART1_IRQn; |
mbed_official | 52:a51c77007319 | 178 | vector = (uint32_t)&uart1_irq; |
mbed_official | 52:a51c77007319 | 179 | } |
mbed_official | 52:a51c77007319 | 180 | |
mbed_official | 52:a51c77007319 | 181 | if (obj->uart == UART_2) { |
mbed_official | 52:a51c77007319 | 182 | irq_n = USART2_IRQn; |
mbed_official | 52:a51c77007319 | 183 | vector = (uint32_t)&uart2_irq; |
mbed_official | 52:a51c77007319 | 184 | } |
mbed_official | 52:a51c77007319 | 185 | |
mbed_official | 52:a51c77007319 | 186 | if (enable) { |
mbed_official | 52:a51c77007319 | 187 | |
mbed_official | 52:a51c77007319 | 188 | if (irq == RxIrq) { |
mbed_official | 52:a51c77007319 | 189 | USART_ITConfig(usart, USART_IT_RXNE, ENABLE); |
mbed_official | 52:a51c77007319 | 190 | } |
mbed_official | 52:a51c77007319 | 191 | else { // TxIrq |
mbed_official | 55:3b765ca737a5 | 192 | USART_ITConfig(usart, USART_IT_TC, ENABLE); |
mbed_official | 52:a51c77007319 | 193 | } |
mbed_official | 52:a51c77007319 | 194 | |
mbed_official | 52:a51c77007319 | 195 | NVIC_SetVector(irq_n, vector); |
mbed_official | 52:a51c77007319 | 196 | NVIC_EnableIRQ(irq_n); |
mbed_official | 52:a51c77007319 | 197 | |
mbed_official | 52:a51c77007319 | 198 | } else { // disable |
mbed_official | 52:a51c77007319 | 199 | |
mbed_official | 52:a51c77007319 | 200 | int all_disabled = 0; |
mbed_official | 52:a51c77007319 | 201 | |
mbed_official | 52:a51c77007319 | 202 | if (irq == RxIrq) { |
mbed_official | 52:a51c77007319 | 203 | USART_ITConfig(usart, USART_IT_RXNE, DISABLE); |
mbed_official | 52:a51c77007319 | 204 | // Check if TxIrq is disabled too |
mbed_official | 52:a51c77007319 | 205 | if ((usart->CR1 & USART_CR1_TXEIE) == 0) all_disabled = 1; |
mbed_official | 52:a51c77007319 | 206 | } |
mbed_official | 52:a51c77007319 | 207 | else { // TxIrq |
mbed_official | 52:a51c77007319 | 208 | USART_ITConfig(usart, USART_IT_TXE, DISABLE); |
mbed_official | 52:a51c77007319 | 209 | // Check if RxIrq is disabled too |
mbed_official | 52:a51c77007319 | 210 | if ((usart->CR1 & USART_CR1_RXNEIE) == 0) all_disabled = 1; |
mbed_official | 52:a51c77007319 | 211 | } |
mbed_official | 52:a51c77007319 | 212 | |
mbed_official | 52:a51c77007319 | 213 | if (all_disabled) NVIC_DisableIRQ(irq_n); |
mbed_official | 52:a51c77007319 | 214 | |
mbed_official | 52:a51c77007319 | 215 | } |
mbed_official | 52:a51c77007319 | 216 | } |
mbed_official | 52:a51c77007319 | 217 | |
mbed_official | 52:a51c77007319 | 218 | /****************************************************************************** |
mbed_official | 52:a51c77007319 | 219 | * READ/WRITE |
mbed_official | 52:a51c77007319 | 220 | ******************************************************************************/ |
mbed_official | 52:a51c77007319 | 221 | |
mbed_official | 52:a51c77007319 | 222 | int serial_getc(serial_t *obj) { |
mbed_official | 52:a51c77007319 | 223 | USART_TypeDef *usart = (USART_TypeDef *)(obj->uart); |
mbed_official | 52:a51c77007319 | 224 | while (!serial_readable(obj)); |
mbed_official | 52:a51c77007319 | 225 | return (int)(USART_ReceiveData(usart)); |
mbed_official | 52:a51c77007319 | 226 | } |
mbed_official | 52:a51c77007319 | 227 | |
mbed_official | 52:a51c77007319 | 228 | void serial_putc(serial_t *obj, int c) { |
mbed_official | 52:a51c77007319 | 229 | USART_TypeDef *usart = (USART_TypeDef *)(obj->uart); |
mbed_official | 52:a51c77007319 | 230 | while (!serial_writable(obj)); |
mbed_official | 52:a51c77007319 | 231 | USART_SendData(usart, (uint16_t)c); |
mbed_official | 52:a51c77007319 | 232 | } |
mbed_official | 52:a51c77007319 | 233 | |
mbed_official | 52:a51c77007319 | 234 | int serial_readable(serial_t *obj) { |
mbed_official | 52:a51c77007319 | 235 | int status; |
mbed_official | 52:a51c77007319 | 236 | USART_TypeDef *usart = (USART_TypeDef *)(obj->uart); |
mbed_official | 52:a51c77007319 | 237 | // Check if data is received |
mbed_official | 52:a51c77007319 | 238 | status = ((USART_GetFlagStatus(usart, USART_FLAG_RXNE) != RESET) ? 1 : 0); |
mbed_official | 52:a51c77007319 | 239 | return status; |
mbed_official | 52:a51c77007319 | 240 | } |
mbed_official | 52:a51c77007319 | 241 | |
mbed_official | 52:a51c77007319 | 242 | int serial_writable(serial_t *obj) { |
mbed_official | 52:a51c77007319 | 243 | int status; |
mbed_official | 52:a51c77007319 | 244 | USART_TypeDef *usart = (USART_TypeDef *)(obj->uart); |
mbed_official | 52:a51c77007319 | 245 | // Check if data is transmitted |
mbed_official | 52:a51c77007319 | 246 | status = ((USART_GetFlagStatus(usart, USART_FLAG_TXE) != RESET) ? 1 : 0); |
mbed_official | 52:a51c77007319 | 247 | return status; |
mbed_official | 52:a51c77007319 | 248 | } |
mbed_official | 52:a51c77007319 | 249 | |
mbed_official | 52:a51c77007319 | 250 | void serial_clear(serial_t *obj) { |
mbed_official | 52:a51c77007319 | 251 | USART_TypeDef *usart = (USART_TypeDef *)(obj->uart); |
mbed_official | 52:a51c77007319 | 252 | USART_ClearFlag(usart, USART_FLAG_TXE); |
mbed_official | 52:a51c77007319 | 253 | USART_ClearFlag(usart, USART_FLAG_RXNE); |
mbed_official | 52:a51c77007319 | 254 | } |
mbed_official | 52:a51c77007319 | 255 | |
mbed_official | 52:a51c77007319 | 256 | void serial_pinout_tx(PinName tx) { |
mbed_official | 52:a51c77007319 | 257 | pinmap_pinout(tx, PinMap_UART_TX); |
mbed_official | 52:a51c77007319 | 258 | } |
mbed_official | 52:a51c77007319 | 259 | |
mbed_official | 52:a51c77007319 | 260 | void serial_break_set(serial_t *obj) { |
mbed_official | 52:a51c77007319 | 261 | USART_TypeDef *usart = (USART_TypeDef *)(obj->uart); |
mbed_official | 52:a51c77007319 | 262 | USART_SendBreak(usart); |
mbed_official | 52:a51c77007319 | 263 | } |
mbed_official | 52:a51c77007319 | 264 | |
mbed_official | 52:a51c77007319 | 265 | void serial_break_clear(serial_t *obj) { |
mbed_official | 52:a51c77007319 | 266 | } |