andreika-git
/
ChibiOS
mirror of https://github.com/andreika-git/ChibiOS.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

UART driver improvements. 

git-svn-id: svn://svn.code.sf.net/p/chibios/svn/trunk@2131 35acf78f-673a-0410-8e92-d51de3d6d3f4
This commit is contained in:
gdisirio 2010-08-15 15:37:52 +00:00
parent c36b827d05
commit ae70bb24cc
6 changed files with 68 additions and 40 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

3
os/hal/include/uart.h
View File

@ -83,8 +83,7 @@ typedef enum {
typedef enum {
UART_RX_IDLE = 0, /**< @brief Not receiving. */
UART_RX_ACTIVE = 1, /**< @brief Receiving. */
UART_RX_ERROR = 2, /**< @brief Receive error. */
UART_RX_COMPLETE = 3 /**< @brief Buffer complete. */
UART_RX_COMPLETE = 2 /**< @brief Buffer complete. */
} uartrxstate_t;
#include "uart_lld.h"

31
os/hal/platforms/STM32/uart_lld.c
View File

@ -168,7 +168,7 @@ static void serve_rx_end_irq(UARTDriver *uartp) {
uartp->ud_rxstate = UART_RX_COMPLETE;
if (uartp->ud_config->uc_rxend != NULL)
uartp->ud_config->uc_rxend();
uartp->ud_config->uc_rxend(uartp);
/* If the callback didn't explicitly change state then the receiver
automatically returns to the idle state.*/
if (uartp->ud_rxstate == UART_RX_COMPLETE) {
@ -187,7 +187,7 @@ static void serve_tx_end_irq(UARTDriver *uartp) {
/* A callback is generated, if enabled, after a completed transfer.*/
uartp->ud_txstate = UART_TX_COMPLETE;
if (uartp->ud_config->uc_txend1 != NULL)
uartp->ud_config->uc_txend1();
uartp->ud_config->uc_txend1(uartp);
/* If the callback didn't explicitly change state then the transmitter
automatically returns to the idle state.*/
if (uartp->ud_txstate == UART_TX_COMPLETE)
@ -207,33 +207,14 @@ static void serve_usart_irq(UARTDriver *uartp) {
if (sr & (USART_SR_LBD | USART_SR_ORE | USART_SR_NE |
USART_SR_FE | USART_SR_PE)) {
u->SR = ~USART_SR_LBD;
if (uartp->ud_rxstate == UART_RX_IDLE) {
/* Receiver in idle state, a callback is generated, if enabled, for each
receive error and then the driver stays in the same state.*/
if (uartp->ud_config->uc_rxerr != NULL)
uartp->ud_config->uc_rxerr(translate_errors(sr));
}
else {
/* Receiver in active state, a callback is generated and the receive
operation aborts.*/
dmaDisableChannel(uartp->ud_dmap, uartp->ud_dmarx);
dmaClearChannel(uartp->ud_dmap, uartp->ud_dmarx);
uartp->ud_rxstate = UART_RX_ERROR;
if (uartp->ud_config->uc_rxerr != NULL)
uartp->ud_config->uc_rxerr(translate_errors(sr));
/* If the callback didn't explicitly change state then the receiver
automatically returns to the idle state.*/
if (uartp->ud_rxstate == UART_RX_ERROR) {
uartp->ud_rxstate = UART_RX_IDLE;
set_rx_idle_loop(uartp);
}
}
if (uartp->ud_config->uc_rxerr != NULL)
uartp->ud_config->uc_rxerr(uartp, translate_errors(sr));
}
if (sr & USART_SR_TC) {
u->SR = ~USART_SR_TC;
/* End of transmission, a callback is generated.*/
if (uartp->ud_config->uc_txend2 != NULL)
uartp->ud_config->uc_txend2();
uartp->ud_config->uc_txend2(uartp);
}
}
@ -322,7 +303,7 @@ CH_IRQ_HANDLER(DMA1_Ch6_IRQHandler) {
/* Receiver in idle state, a callback is generated, if enabled, for each
received character and then the driver stays in the same state.*/
if (uartp->ud_config->uc_rxchar != NULL)
uartp->ud_config->uc_rxchar(uartp->ud_rxbuf);
uartp->ud_config->uc_rxchar(uartp, uartp->ud_rxbuf);
}
else {
/* Receiver in active state, a callback is generated, if enabled, after

21
os/hal/platforms/STM32/uart_lld.h
View File

@ -166,23 +166,32 @@
typedef uint32_t uartflags_t;
/**
* @brief Generic UART notification callback type.
* @brief Structure representing an UART driver.
*/
typedef void (*uartcb_t)(void);
typedef struct _UARTDriver UARTDriver;
/**
* @brief Generic UART notification callback type.
*
* @param[in] uartp pointer to the @p UARTDriver object
*/
typedef void (*uartcb_t)(UARTDriver *uartp);
/**
* @brief Character received UART notification callback type.
*
* @param[in] uartp pointer to the @p UARTDriver object
* @param[in] c received character
*/
typedef void (*uartccb_t)(uint16_t c);
typedef void (*uartccb_t)(UARTDriver *uartp, uint16_t c);
/**
* @brief Receive error UART notification callback type.
*
* @param[in] uartp pointer to the @p UARTDriver object
* @param[in] e receive error mask
*/
typedef void (*uartecb_t)(uartflags_t e);
typedef void (*uartecb_t)(UARTDriver *uartp, uartflags_t e);
/**
* @brief Driver configuration structure.
@ -213,7 +222,7 @@ typedef struct {
/**
* @brief Structure representing an UART driver.
*/
typedef struct {
struct _UARTDriver {
/** @brief Driver state.*/
uartstate_t ud_state;
/** @brief Current configuration data.*/
@ -237,7 +246,7 @@ typedef struct {
uint8_t ud_dmatx;
/** @brief Default receive buffer while into @p UART_RX_IDLE state.*/
volatile uint16_t ud_rxbuf;
} UARTDriver;
};
/*===========================================================================*/
/* Driver macros. */

32
os/hal/templates/uart_lld.h
View File

@ -51,6 +51,34 @@
*/
typedef uint32_t uartflags_t;
/**
* @brief Structure representing an UART driver.
*/
typedef struct _UARTDriver UARTDriver;
/**
* @brief Generic UART notification callback type.
*
* @param[in] uartp pointer to the @p UARTDriver object
*/
typedef void (*uartcb_t)(UARTDriver *uartp);
/**
* @brief Character received UART notification callback type.
*
* @param[in] uartp pointer to the @p UARTDriver object
* @param[in] c received character
*/
typedef void (*uartccb_t)(UARTDriver *uartp, uint16_t c);
/**
* @brief Receive error UART notification callback type.
*
* @param[in] uartp pointer to the @p UARTDriver object
* @param[in] e receive error mask
*/
typedef void (*uartecb_t)(UARTDriver *uartp, uartflags_t e);
/**
* @brief Driver configuration structure.
* @note It could be empty on some architectures.
@ -72,7 +100,7 @@ typedef struct {
/**
* @brief Structure representing an UART driver.
*/
typedef struct {
struct _UARTDriver {
/**
* @brief Driver state.
*/
@ -90,7 +118,7 @@ typedef struct {
*/
const UARTConfig *ud_config;
/* End of the mandatory fields.*/
} UARTDriver;
};
/*===========================================================================*/
/* Driver macros. */

6
readme.txt
View File

@ -87,6 +87,12 @@
change).
- OPT: Speed optimizations of the STM32 SPI driver, improved latency.
- OPT: Speed optimizations of the STM32 ADC driver.
- CHANGE: Added a parameter to the UART driver callbacks, the pointer to the
driver itself.
- CHANGE: In the UART driver now an error does not automatically brings the
receiver in UART_RX_IDLE state, the receive operation continues unless
explicitly stopped in the error callback handler. This considerably
simplifies the low level driver code.
- CHANGE: Modified the STM32 ADC driver to use the new DMA infrastructure.
- CHANGE: Modified the STM32 SPI driver to use the new DMA infrastructure.
- CHANGE: Added DMA cleanup code to the STM32 dmaInit() function.

15
testhal/STM32/UART/main.c
View File

@ -40,16 +40,18 @@ static void ledoff(void *p) {
* This callback is invoked when a transmission buffer has been completely
* read by the driver.
*/
static void txend1(void) {
static void txend1(UARTDriver *uartp) {
(void)uartp;
palClearPad(IOPORT3, GPIOC_LED);
}
/*
* This callback is invoked when a transmission has phisically completed.
*/
static void txend2(void) {
static void txend2(UARTDriver *uartp) {
(void)uartp;
palSetPad(IOPORT3, GPIOC_LED);
chSysLockFromIsr();
if (chVTIsArmedI(&vt1))
@ -62,8 +64,9 @@ static void txend2(void) {
* This callback is invoked on a receive error, the errors mask is passed
* as parameter.
*/
static void rxerr(uartflags_t e) {
static void rxerr(UARTDriver *uartp, uartflags_t e) {
(void)uartp;
(void)e;
}
@ -71,8 +74,9 @@ static void rxerr(uartflags_t e) {
* This callback is invoked when a character is received but the application
* was not ready to receive it, the character is passed as parameter.
*/
static void rxchar(uint16_t c) {
static void rxchar(UARTDriver *uartp, uint16_t c) {
(void)uartp;
(void)c;
/* Flashing the LED each time a character is received.*/
palClearPad(IOPORT3, GPIOC_LED);
@ -86,8 +90,9 @@ static void rxchar(uint16_t c) {
/*
* This callback is invoked when a receive buffer has been completely written.
*/
static void rxend(void) {
static void rxend(UARTDriver *uartp) {
(void)uartp;
}
/*