1 /* mbed Microcontroller Library
2 *******************************************************************************
3 * Copyright (c) 2014, STMicroelectronics
6 * Redistribution and use in source and binary forms, with or without
7 * modification, are permitted provided that the following conditions are met:
9 * 1. Redistributions of source code must retain the above copyright notice,
10 * this list of conditions and the following disclaimer.
11 * 2. Redistributions in binary form must reproduce the above copyright notice,
12 * this list of conditions and the following disclaimer in the documentation
13 * and/or other materials provided with the distribution.
14 * 3. Neither the name of STMicroelectronics nor the names of its contributors
15 * may be used to endorse or promote products derived from this software
16 * without specific prior written permission.
18 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
19 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
20 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
21 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
22 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
23 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
24 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
25 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
26 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
27 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
28 *******************************************************************************
30 #include "mbed_assert.h"
31 #include "serial_api.h"
38 #include "PeripheralPins.h"
40 #if defined (TARGET_STM32F091RC)
43 static uint32_t serial_irq_ids
[UART_NUM
] = {0, 0, 0, 0, 0, 0, 0, 0};
45 #elif defined (TARGET_STM32F030R8) || defined (TARGET_STM32F051R8)
48 static uint32_t serial_irq_ids
[UART_NUM
] = {0, 0};
53 static uint32_t serial_irq_ids
[UART_NUM
] = {0, 0, 0, 0};
57 static uart_irq_handler irq_handler
;
59 UART_HandleTypeDef UartHandle
;
61 int stdio_uart_inited
= 0;
64 static void init_uart(serial_t
*obj
)
66 UartHandle
.Instance
= (USART_TypeDef
*)(obj
->uart
);
68 UartHandle
.Init
.BaudRate
= obj
->baudrate
;
69 UartHandle
.Init
.WordLength
= obj
->databits
;
70 UartHandle
.Init
.StopBits
= obj
->stopbits
;
71 UartHandle
.Init
.Parity
= obj
->parity
;
72 UartHandle
.Init
.HwFlowCtl
= UART_HWCONTROL_NONE
;
74 if (obj
->pin_rx
== NC
) {
75 UartHandle
.Init
.Mode
= UART_MODE_TX
;
76 } else if (obj
->pin_tx
== NC
) {
77 UartHandle
.Init
.Mode
= UART_MODE_RX
;
79 UartHandle
.Init
.Mode
= UART_MODE_TX_RX
;
82 // Disable the reception overrun detection
83 UartHandle
.AdvancedInit
.AdvFeatureInit
= UART_ADVFEATURE_RXOVERRUNDISABLE_INIT
;
84 UartHandle
.AdvancedInit
.OverrunDisable
= UART_ADVFEATURE_OVERRUN_DISABLE
;
86 HAL_UART_Init(&UartHandle
);
89 void serial_init(serial_t
*obj
, PinName tx
, PinName rx
)
91 // Determine the UART to use (UART_1, UART_2, ...)
92 UARTName uart_tx
= (UARTName
)pinmap_peripheral(tx
, PinMap_UART_TX
);
93 UARTName uart_rx
= (UARTName
)pinmap_peripheral(rx
, PinMap_UART_RX
);
95 // Get the peripheral name (UART_1, UART_2, ...) from the pin and assign it to the object
96 obj
->uart
= (UARTName
)pinmap_merge(uart_tx
, uart_rx
);
97 MBED_ASSERT(obj
->uart
!= (UARTName
)NC
);
100 if (obj
->uart
== UART_1
) {
101 __USART1_CLK_ENABLE();
105 if (obj
->uart
== UART_2
) {
106 __USART2_CLK_ENABLE();
110 #if defined USART3_BASE
111 if (obj
->uart
== UART_3
) {
112 __USART3_CLK_ENABLE();
117 #if defined USART4_BASE
118 if (obj
->uart
== UART_4
) {
119 __USART4_CLK_ENABLE();
124 #if defined USART5_BASE
125 if (obj
->uart
== UART_5
) {
126 __USART5_CLK_ENABLE();
131 #if defined USART6_BASE
132 if (obj
->uart
== UART_6
) {
133 __USART6_CLK_ENABLE();
138 #if defined USART7_BASE
139 if (obj
->uart
== UART_7
) {
140 __USART7_CLK_ENABLE();
145 #if defined USART8_BASE
146 if (obj
->uart
== UART_8
) {
147 __USART8_CLK_ENABLE();
152 // Configure the UART pins
153 pinmap_pinout(tx
, PinMap_UART_TX
);
154 pinmap_pinout(rx
, PinMap_UART_RX
);
156 pin_mode(tx
, PullUp
);
159 pin_mode(rx
, PullUp
);
163 obj
->baudrate
= 9600;
164 obj
->databits
= UART_WORDLENGTH_8B
;
165 obj
->stopbits
= UART_STOPBITS_1
;
166 obj
->parity
= UART_PARITY_NONE
;
173 // For stdio management
174 if (obj
->uart
== STDIO_UART
) {
175 stdio_uart_inited
= 1;
176 memcpy(&stdio_uart
, obj
, sizeof(serial_t
));
180 void serial_free(serial_t
*obj
)
182 // Reset UART and disable clock
183 if (obj
->uart
== UART_1
) {
184 __USART1_FORCE_RESET();
185 __USART1_RELEASE_RESET();
186 __USART1_CLK_DISABLE();
189 if (obj
->uart
== UART_2
) {
190 __USART2_FORCE_RESET();
191 __USART2_RELEASE_RESET();
192 __USART2_CLK_DISABLE();
195 #if defined USART3_BASE
196 if (obj
->uart
== UART_3
) {
197 __USART3_FORCE_RESET();
198 __USART3_RELEASE_RESET();
199 __USART3_CLK_DISABLE();
203 #if defined USART4_BASE
204 if (obj
->uart
== UART_4
) {
205 __USART4_FORCE_RESET();
206 __USART4_RELEASE_RESET();
207 __USART4_CLK_DISABLE();
211 #if defined USART5_BASE
212 if (obj
->uart
== UART_5
) {
213 __USART5_FORCE_RESET();
214 __USART5_RELEASE_RESET();
215 __USART5_CLK_DISABLE();
219 #if defined USART6_BASE
220 if (obj
->uart
== UART_6
) {
221 __USART6_FORCE_RESET();
222 __USART6_RELEASE_RESET();
223 __USART6_CLK_DISABLE();
227 #if defined USART7_BASE
228 if (obj
->uart
== UART_7
) {
229 __USART7_FORCE_RESET();
230 __USART7_RELEASE_RESET();
231 __USART7_CLK_DISABLE();
235 #if defined USART8_BASE
236 if (obj
->uart
== UART_8
) {
237 __USART8_FORCE_RESET();
238 __USART8_RELEASE_RESET();
239 __USART8_CLK_DISABLE();
245 pin_function(obj
->pin_tx
, STM_PIN_DATA(STM_MODE_INPUT
, GPIO_NOPULL
, 0));
246 pin_function(obj
->pin_rx
, STM_PIN_DATA(STM_MODE_INPUT
, GPIO_NOPULL
, 0));
248 serial_irq_ids
[obj
->index
] = 0;
251 void serial_baud(serial_t
*obj
, int baudrate
)
253 obj
->baudrate
= baudrate
;
257 void serial_format(serial_t
*obj
, int data_bits
, SerialParity parity
, int stop_bits
)
259 if (data_bits
== 9) {
260 obj
->databits
= UART_WORDLENGTH_9B
;
262 obj
->databits
= UART_WORDLENGTH_8B
;
268 obj
->parity
= UART_PARITY_ODD
;
272 obj
->parity
= UART_PARITY_EVEN
;
274 default: // ParityNone
275 obj
->parity
= UART_PARITY_NONE
;
279 if (stop_bits
== 2) {
280 obj
->stopbits
= UART_STOPBITS_2
;
282 obj
->stopbits
= UART_STOPBITS_1
;
288 /******************************************************************************
289 * INTERRUPTS HANDLING
290 ******************************************************************************/
292 static void uart_irq(UARTName name
, int id
)
294 UartHandle
.Instance
= (USART_TypeDef
*)name
;
295 if (serial_irq_ids
[id
] != 0) {
296 if (__HAL_UART_GET_FLAG(&UartHandle
, UART_FLAG_TC
) != RESET
) {
297 irq_handler(serial_irq_ids
[id
], TxIrq
);
298 __HAL_UART_CLEAR_IT(&UartHandle
, UART_FLAG_TC
);
300 if (__HAL_UART_GET_FLAG(&UartHandle
, UART_FLAG_RXNE
) != RESET
) {
301 irq_handler(serial_irq_ids
[id
], RxIrq
);
302 volatile uint32_t tmpval
= UartHandle
.Instance
->RDR
; // Clear RXNE bit
307 static void uart1_irq(void)
312 static void uart2_irq(void)
317 #if defined USART3_BASE
318 static void uart3_irq(void)
324 #if defined USART4_BASE
325 static void uart4_irq(void)
331 #if defined USART5_BASE
332 static void uart5_irq(void)
338 #if defined USART6_BASE
339 static void uart6_irq(void)
345 #if defined USART7_BASE
346 static void uart7_irq(void)
352 #if defined USART8_BASE
353 static void uart8_irq(void)
359 void serial_irq_handler(serial_t
*obj
, uart_irq_handler handler
, uint32_t id
)
361 irq_handler
= handler
;
362 serial_irq_ids
[obj
->index
] = id
;
365 void serial_irq_set(serial_t
*obj
, SerialIrq irq
, uint32_t enable
)
367 IRQn_Type irq_n
= (IRQn_Type
)0;
370 UartHandle
.Instance
= (USART_TypeDef
*)(obj
->uart
);
372 if (obj
->uart
== UART_1
) {
374 vector
= (uint32_t)&uart1_irq
;
377 if (obj
->uart
== UART_2
) {
379 vector
= (uint32_t)&uart2_irq
;
382 #if defined (TARGET_STM32F091RC)
383 if (obj
->uart
== UART_3
) {
384 irq_n
= USART3_8_IRQn
;
385 vector
= (uint32_t)&uart3_irq
;
388 if (obj
->uart
== UART_4
) {
389 irq_n
= USART3_8_IRQn
;
390 vector
= (uint32_t)&uart4_irq
;
393 if (obj
->uart
== UART_5
) {
394 irq_n
= USART3_8_IRQn
;
395 vector
= (uint32_t)&uart5_irq
;
398 if (obj
->uart
== UART_6
) {
399 irq_n
= USART3_8_IRQn
;
400 vector
= (uint32_t)&uart6_irq
;
403 if (obj
->uart
== UART_7
) {
404 irq_n
= USART3_8_IRQn
;
405 vector
= (uint32_t)&uart7_irq
;
408 if (obj
->uart
== UART_8
) {
409 irq_n
= USART3_8_IRQn
;
410 vector
= (uint32_t)&uart8_irq
;
413 #elif defined (TARGET_STM32F030R8) || defined (TARGET_STM32F051R8)
416 if (obj
->uart
== UART_3
) {
417 irq_n
= USART3_4_IRQn
;
418 vector
= (uint32_t)&uart3_irq
;
421 if (obj
->uart
== UART_4
) {
422 irq_n
= USART3_4_IRQn
;
423 vector
= (uint32_t)&uart4_irq
;
430 __HAL_UART_ENABLE_IT(&UartHandle
, UART_IT_RXNE
);
432 __HAL_UART_ENABLE_IT(&UartHandle
, UART_IT_TC
);
435 NVIC_SetVector(irq_n
, vector
);
436 NVIC_EnableIRQ(irq_n
);
440 int all_disabled
= 0;
443 __HAL_UART_DISABLE_IT(&UartHandle
, UART_IT_RXNE
);
444 // Check if TxIrq is disabled too
445 if ((UartHandle
.Instance
->CR1
& USART_CR1_TCIE
) == 0) all_disabled
= 1;
447 __HAL_UART_DISABLE_IT(&UartHandle
, UART_IT_TC
);
448 // Check if RxIrq is disabled too
449 if ((UartHandle
.Instance
->CR1
& USART_CR1_RXNEIE
) == 0) all_disabled
= 1;
452 if (all_disabled
) NVIC_DisableIRQ(irq_n
);
457 /******************************************************************************
459 ******************************************************************************/
461 int serial_getc(serial_t
*obj
)
463 USART_TypeDef
*uart
= (USART_TypeDef
*)(obj
->uart
);
464 while (!serial_readable(obj
));
465 return (int)(uart
->RDR
& (uint16_t)0xFF);
468 void serial_putc(serial_t
*obj
, int c
)
470 USART_TypeDef
*uart
= (USART_TypeDef
*)(obj
->uart
);
471 while (!serial_writable(obj
));
472 uart
->TDR
= (uint32_t)(c
& (uint16_t)0xFF);
475 int serial_readable(serial_t
*obj
)
478 UartHandle
.Instance
= (USART_TypeDef
*)(obj
->uart
);
479 // Check if data is received
480 status
= ((__HAL_UART_GET_FLAG(&UartHandle
, UART_FLAG_RXNE
) != RESET
) ? 1 : 0);
484 int serial_writable(serial_t
*obj
)
487 UartHandle
.Instance
= (USART_TypeDef
*)(obj
->uart
);
488 // Check if data is transmitted
489 status
= ((__HAL_UART_GET_FLAG(&UartHandle
, UART_FLAG_TXE
) != RESET
) ? 1 : 0);
493 void serial_clear(serial_t
*obj
)
495 UartHandle
.Instance
= (USART_TypeDef
*)(obj
->uart
);
496 __HAL_UART_CLEAR_IT(&UartHandle
, UART_FLAG_TC
);
497 __HAL_UART_SEND_REQ(&UartHandle
, UART_RXDATA_FLUSH_REQUEST
);
500 void serial_pinout_tx(PinName tx
)
502 pinmap_pinout(tx
, PinMap_UART_TX
);
505 void serial_break_set(serial_t
*obj
)
510 void serial_break_clear(serial_t
*obj
)