/* ChibiOS/RT - Copyright (C) 2006,2007,2008,2009,2010, 2011,2012 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 . --- A special exception to the GPL can be applied should you wish to distribute a combined work that includes ChibiOS/RT, without being obliged to provide the source code for any proprietary components. See the file exception.txt for full details of how and when the exception can be applied. */ /** * @file STM32/icu_lld.h * @brief STM32 ICU subsystem low level driver header. * * @addtogroup ICU * @{ */ #ifndef _ICU_LLD_H_ #define _ICU_LLD_H_ #if HAL_USE_ICU || defined(__DOXYGEN__) /*===========================================================================*/ /* Driver constants. */ /*===========================================================================*/ /*===========================================================================*/ /* Driver pre-compile time settings. */ /*===========================================================================*/ /** * @name Configuration options * @{ */ /** * @brief ICUD1 driver enable switch. * @details If set to @p TRUE the support for ICUD1 is included. * @note The default is @p TRUE. */ #if !defined(STM32_ICU_USE_TIM1) || defined(__DOXYGEN__) #define STM32_ICU_USE_TIM1 TRUE #endif /** * @brief ICUD2 driver enable switch. * @details If set to @p TRUE the support for ICUD2 is included. * @note The default is @p TRUE. */ #if !defined(STM32_ICU_USE_TIM2) || defined(__DOXYGEN__) #define STM32_ICU_USE_TIM2 TRUE #endif /** * @brief ICUD3 driver enable switch. * @details If set to @p TRUE the support for ICUD3 is included. * @note The default is @p TRUE. */ #if !defined(STM32_ICU_USE_TIM3) || defined(__DOXYGEN__) #define STM32_ICU_USE_TIM3 TRUE #endif /** * @brief ICUD4 driver enable switch. * @details If set to @p TRUE the support for ICUD4 is included. * @note The default is @p TRUE. */ #if !defined(STM32_ICU_USE_TIM4) || defined(__DOXYGEN__) #define STM32_ICU_USE_TIM4 TRUE #endif /** * @brief ICUD5 driver enable switch. * @details If set to @p TRUE the support for ICUD5 is included. * @note The default is @p TRUE. */ #if !defined(STM32_ICU_USE_TIM5) || defined(__DOXYGEN__) #define STM32_ICU_USE_TIM5 TRUE #endif /** * @brief ICUD8 driver enable switch. * @details If set to @p TRUE the support for ICUD8 is included. * @note The default is @p TRUE. */ #if !defined(STM32_ICU_USE_TIM8) || defined(__DOXYGEN__) #define STM32_ICU_USE_TIM8 TRUE #endif /** * @brief ICUD1 interrupt priority level setting. */ #if !defined(STM32_ICU_TIM1_IRQ_PRIORITY) || defined(__DOXYGEN__) #define STM32_ICU_TIM1_IRQ_PRIORITY 7 #endif /** * @brief ICUD2 interrupt priority level setting. */ #if !defined(STM32_ICU_TIM2_IRQ_PRIORITY) || defined(__DOXYGEN__) #define STM32_ICU_TIM2_IRQ_PRIORITY 7 #endif /** * @brief ICUD3 interrupt priority level setting. */ #if !defined(STM32_ICU_TIM3_IRQ_PRIORITY) || defined(__DOXYGEN__) #define STM32_ICU_TIM3_IRQ_PRIORITY 7 #endif /** * @brief ICUD4 interrupt priority level setting. */ #if !defined(STM32_ICU_TIM4_IRQ_PRIORITY) || defined(__DOXYGEN__) #define STM32_ICU_TIM4_IRQ_PRIORITY 7 #endif /** * @brief ICUD5 interrupt priority level setting. */ #if !defined(STM32_ICU_TIM5_IRQ_PRIORITY) || defined(__DOXYGEN__) #define STM32_ICU_TIM5_IRQ_PRIORITY 7 #endif /** * @brief ICUD8 interrupt priority level setting. */ #if !defined(STM32_ICU_TIM8_IRQ_PRIORITY) || defined(__DOXYGEN__) #define STM32_ICU_TIM8_IRQ_PRIORITY 7 #endif /** @} */ /*===========================================================================*/ /* Derived constants and error checks. */ /*===========================================================================*/ #if STM32_ICU_USE_TIM1 && !STM32_HAS_TIM1 #error "TIM1 not present in the selected device" #endif #if STM32_ICU_USE_TIM2 && !STM32_HAS_TIM2 #error "TIM2 not present in the selected device" #endif #if STM32_ICU_USE_TIM3 && !STM32_HAS_TIM3 #error "TIM3 not present in the selected device" #endif #if STM32_ICU_USE_TIM4 && !STM32_HAS_TIM4 #error "TIM4 not present in the selected device" #endif #if STM32_ICU_USE_TIM5 && !STM32_HAS_TIM5 #error "TIM5 not present in the selected device" #endif #if STM32_ICU_USE_TIM8 && !STM32_HAS_TIM8 #error "TIM8 not present in the selected device" #endif #if !STM32_ICU_USE_TIM1 && !STM32_ICU_USE_TIM2 && \ !STM32_ICU_USE_TIM3 && !STM32_ICU_USE_TIM4 && \ !STM32_ICU_USE_TIM5 && !STM32_ICU_USE_TIM8 #error "ICU driver activated but no TIM peripheral assigned" #endif /*===========================================================================*/ /* Driver data structures and types. */ /*===========================================================================*/ /** * @brief ICU driver mode. */ typedef enum { ICU_INPUT_ACTIVE_HIGH = 0, /**< Trigger on rising edge. */ ICU_INPUT_ACTIVE_LOW = 1, /**< Trigger on falling edge. */ } icumode_t; /** * @brief ICU frequency type. */ typedef uint32_t icufreq_t; /** * @brief ICU counter type. */ typedef uint16_t icucnt_t; /** * @brief Driver configuration structure. * @note It could be empty on some architectures. */ typedef struct { /** * @brief Driver mode. */ icumode_t mode; /** * @brief Timer clock in Hz. * @note The low level can use assertions in order to catch invalid * frequency specifications. */ icufreq_t frequency; /** * @brief Callback for pulse width measurement. */ icucallback_t width_cb; /** * @brief Callback for cycle period measurement. */ icucallback_t period_cb; /* End of the mandatory fields.*/ } ICUConfig; /** * @brief Structure representing an ICU driver. */ struct ICUDriver { /** * @brief Driver state. */ icustate_t state; /** * @brief Current configuration data. */ const ICUConfig *config; #if defined(ICU_DRIVER_EXT_FIELDS) ICU_DRIVER_EXT_FIELDS #endif /* End of the mandatory fields.*/ /** * @brief Timer base clock. */ uint32_t clock; /** * @brief Pointer to the TIMx registers block. */ stm32_tim_t *tim; }; /*===========================================================================*/ /* Driver macros. */ /*===========================================================================*/ /** * @brief Returns the width of the latest pulse. * @details The pulse width is defined as number of ticks between the start * edge and the stop edge. * * @param[in] icup pointer to the @p ICUDriver object * @return The number of ticks. * * @notapi */ #define icu_lld_get_width(icup) ((icup)->tim->CCR[1] + 1) /** * @brief Returns the width of the latest cycle. * @details The cycle width is defined as number of ticks between a start * edge and the next start edge. * * @param[in] icup pointer to the @p ICUDriver object * @return The number of ticks. * * @notapi */ #define icu_lld_get_period(icup) ((icup)->tim->CCR[0] + 1) /*===========================================================================*/ /* External declarations. */ /*===========================================================================*/ #if STM32_ICU_USE_TIM1 && !defined(__DOXYGEN__) extern ICUDriver ICUD1; #endif #if STM32_ICU_USE_TIM2 && !defined(__DOXYGEN__) extern ICUDriver ICUD2; #endif #if STM32_ICU_USE_TIM3 && !defined(__DOXYGEN__) extern ICUDriver ICUD3; #endif #if STM32_ICU_USE_TIM4 && !defined(__DOXYGEN__) extern ICUDriver ICUD4; #endif #if STM32_ICU_USE_TIM5 && !defined(__DOXYGEN__) extern ICUDriver ICUD5; #endif #if STM32_ICU_USE_TIM8 && !defined(__DOXYGEN__) extern ICUDriver ICUD8; #endif #ifdef __cplusplus extern "C" { #endif void icu_lld_init(void); void icu_lld_start(ICUDriver *icup); void icu_lld_stop(ICUDriver *icup); void icu_lld_enable(ICUDriver *icup); void icu_lld_disable(ICUDriver *icup); #ifdef __cplusplus } #endif #endif /* HAL_USE_ICU */ #endif /* _ICU_LLD_H_ */ /** @} */