/* ChibiOS/RT - Copyright (C) 2006,2007,2008,2009,2010 Giovanni Di Sirio. This file is part of ChibiOS/RT. ChibiOS/RT is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3 of the License, or (at your option) any later version. ChibiOS/RT is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program. If not, see . */ /** * @file STM32/serial_lld.h * @brief STM32 low level serial driver header. * @addtogroup STM32_SERIAL * @{ */ #ifndef _SERIAL_LLD_H_ #define _SERIAL_LLD_H_ #if CH_HAL_USE_SERIAL || defined(__DOXYGEN__) /*===========================================================================*/ /* Driver constants. */ /*===========================================================================*/ /*===========================================================================*/ /* Driver pre-compile time settings. */ /*===========================================================================*/ /** * @brief USART1 driver enable switch. * @details If set to @p TRUE the support for USART1 is included. * @note The default is @p FALSE. */ #if !defined(USE_STM32_USART1) || defined(__DOXYGEN__) #define USE_STM32_USART1 TRUE #endif /** * @brief USART2 driver enable switch. * @details If set to @p TRUE the support for USART2 is included. * @note The default is @p TRUE. */ #if !defined(USE_STM32_USART2) || defined(__DOXYGEN__) #define USE_STM32_USART2 TRUE #endif /** * @brief USART3 driver enable switch. * @details If set to @p TRUE the support for USART3 is included. * @note The default is @p FALSE. */ #if !defined(USE_STM32_USART3) || defined(__DOXYGEN__) #define USE_STM32_USART3 TRUE #endif #if defined(STM32F10X_HD) || defined(STM32F10X_CL) || defined(__DOXYGEN__) /** * @brief UART4 driver enable switch. * @details If set to @p TRUE the support for UART4 is included. * @note The default is @p FALSE. */ #if !defined(USE_STM32_UART4) || defined(__DOXYGEN__) #define USE_STM32_UART4 TRUE #endif /** * @brief UART5 driver enable switch. * @details If set to @p TRUE the support for UART5 is included. * @note The default is @p FALSE. */ #if !defined(USE_STM32_USART3) || defined(__DOXYGEN__) #define USE_STM32_UART5 TRUE #endif #endif /** * @brief USART1 interrupt priority level setting. * @note @p CORTEX_BASEPRI_KERNEL >= @p STM32_USART1_PRIORITY > * @p CORTEX_PRIORITY_PENDSV. */ #if !defined(STM32_USART1_PRIORITY) || defined(__DOXYGEN__) #define STM32_USART1_PRIORITY CORTEX_PRIORITY(12) #endif /** * @brief USART2 interrupt priority level setting. * @note @p CORTEX_BASEPRI_KERNEL >= @p STM32_USART2_PRIORITY > * @p CORTEX_PRIORITY_PENDSV. */ #if !defined(STM32_USART2_PRIORITY) || defined(__DOXYGEN__) #define STM32_USART2_PRIORITY CORTEX_PRIORITY(12) #endif /** * @brief USART3 interrupt priority level setting. * @note @p CORTEX_BASEPRI_KERNEL >= @p STM32_USART3_PRIORITY > * @p CORTEX_PRIORITY_PENDSV. */ #if !defined(STM32_USART3_PRIORITY) || defined(__DOXYGEN__) #define STM32_USART3_PRIORITY CORTEX_PRIORITY(12) #endif #if defined(STM32F10X_HD) || defined(STM32F10X_CL) || defined(__DOXYGEN__) /** * @brief UART4 interrupt priority level setting. * @note @p CORTEX_BASEPRI_KERNEL >= @p STM32_USART2_PRIORITY > * @p CORTEX_PRIORITY_PENDSV. */ #if !defined(STM32_UART4_PRIORITY) || defined(__DOXYGEN__) #define STM32_UART4_PRIORITY CORTEX_PRIORITY(12) #endif /** * @brief UART5 interrupt priority level setting. * @note @p CORTEX_BASEPRI_KERNEL >= @p STM32_USART2_PRIORITY > * @p CORTEX_PRIORITY_PENDSV. */ #if !defined(STM32_UART5_PRIORITY) || defined(__DOXYGEN__) #define STM32_UART5_PRIORITY CORTEX_PRIORITY(12) #endif #endif /*===========================================================================*/ /* Derived constants and error checks. */ /*===========================================================================*/ /*===========================================================================*/ /* Driver data structures and types. */ /*===========================================================================*/ /** * @brief Serial Driver condition flags type. */ typedef uint32_t sdflags_t; /** * @brief STM32 Serial Driver configuration structure. * @details An instance of this structure must be passed to @p sdStart() * in order to configure and start a serial driver operations. * * @note This structure content is architecture dependent, each driver * implementation defines its own version and the custom static * initializers. */ typedef struct { /** * @brief Bit rate. */ uint32_t sc_speed; /** * @brief Initialization value for the CR1 register. */ uint16_t sc_cr1; /** * @brief Initialization value for the CR2 register. */ uint16_t sc_cr2; /** * @brief Initialization value for the CR3 register. */ uint16_t sc_cr3; } SerialConfig; /** * @brief @p SerialDriver specific data. */ #define _serial_driver_data \ _base_asynchronous_channel_data \ /* Driver state.*/ \ sdstate_t state; \ /* Current configuration data.*/ \ const SerialConfig *config; \ /* Input queue.*/ \ InputQueue iqueue; \ /* Output queue.*/ \ OutputQueue oqueue; \ /* Status Change @p EventSource.*/ \ EventSource sevent; \ /* I/O driver status flags.*/ \ sdflags_t flags; \ /* Input circular buffer.*/ \ uint8_t ib[SERIAL_BUFFERS_SIZE]; \ /* Output circular buffer.*/ \ uint8_t ob[SERIAL_BUFFERS_SIZE]; \ /* End of the mandatory fields.*/ \ /* Pointer to the USART registers block.*/ \ USART_TypeDef *usart; /*===========================================================================*/ /* Driver macros. */ /*===========================================================================*/ /* * Extra USARTs definitions here (missing from the ST header file). */ #define USART_CR2_STOP1_BITS (0 << 12) /**< @brief CR2 1 stop bit value.*/ #define USART_CR2_STOP0P5_BITS (1 << 12) /**< @brief CR2 0.5 stop bit value.*/ #define USART_CR2_STOP2_BITS (2 << 12) /**< @brief CR2 2 stop bit value.*/ #define USART_CR2_STOP1P5_BITS (3 << 12) /**< @brief CR2 1.5 stop bit value.*/ /*===========================================================================*/ /* External declarations. */ /*===========================================================================*/ #if USE_STM32_USART1 && !defined(__DOXYGEN__) extern SerialDriver SD1; #endif #if USE_STM32_USART2 && !defined(__DOXYGEN__) extern SerialDriver SD2; #endif #if USE_STM32_USART3 && !defined(__DOXYGEN__) extern SerialDriver SD3; #endif #if defined(STM32F10X_HD) || defined(STM32F10X_CL) #if USE_STM32_UART4 && !defined(__DOXYGEN__) extern SerialDriver SD4; #endif #if USE_STM32_UART5 && !defined(__DOXYGEN__) extern SerialDriver SD5; #endif #endif #ifdef __cplusplus extern "C" { #endif void sd_lld_init(void); void sd_lld_start(SerialDriver *sdp); void sd_lld_stop(SerialDriver *sdp); #ifdef __cplusplus } #endif #endif /* CH_HAL_USE_SERIAL */ #endif /* _SERIAL_LLD_H_ */ /** @} */