2 ******************************************************************************
3 * @file stm32l1xx_hal_tim_ex.c
4 * @author MCD Application Team
6 * @date 5-September-2014
7 * @brief TIM HAL module driver.
8 * This file provides firmware functions to manage the following
9 * functionalities of the Timer extension peripheral:
10 * + Time Master and Slave synchronization configuration
11 * + Timer remapping capabilities configuration
13 ==============================================================================
14 ##### TIMER Extended features #####
15 ==============================================================================
17 The Timer Extension features include:
18 (#) Synchronization circuit to control the timer with external signals and to
19 interconnect several timers together.
20 (#) Timer remapping capabilities configuration
23 ******************************************************************************
26 * <h2><center>© COPYRIGHT(c) 2014 STMicroelectronics</center></h2>
28 * Redistribution and use in source and binary forms, with or without modification,
29 * are permitted provided that the following conditions are met:
30 * 1. Redistributions of source code must retain the above copyright notice,
31 * this list of conditions and the following disclaimer.
32 * 2. Redistributions in binary form must reproduce the above copyright notice,
33 * this list of conditions and the following disclaimer in the documentation
34 * and/or other materials provided with the distribution.
35 * 3. Neither the name of STMicroelectronics nor the names of its contributors
36 * may be used to endorse or promote products derived from this software
37 * without specific prior written permission.
39 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
40 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
41 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
42 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
43 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
44 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
45 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
46 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
47 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
48 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
50 ******************************************************************************
53 /* Includes ------------------------------------------------------------------*/
54 #include "stm32l1xx_hal.h"
56 /** @addtogroup STM32L1xx_HAL_Driver
60 /** @defgroup TIMEx TIMEx
61 * @brief TIM HAL module driver
65 #ifdef HAL_TIM_MODULE_ENABLED
67 /* Private typedef -----------------------------------------------------------*/
68 /* Private define ------------------------------------------------------------*/
69 /* Private macro -------------------------------------------------------------*/
70 /* Private variables ---------------------------------------------------------*/
71 /* Private function prototypes -----------------------------------------------*/
72 /* Private functions ---------------------------------------------------------*/
74 /** @defgroup TIMEx_Exported_Functions TIMEx Exported Functions
78 /** @defgroup TIMEx_Exported_Functions_Group1 Peripheral Control functions
79 * @brief Peripheral Control functions
82 ==============================================================================
83 ##### Peripheral Control functions #####
84 ==============================================================================
86 This section provides functions allowing to:
87 (+) Configure the commutation event in case of use of the Hall sensor interface.
88 (+) Configure Complementary channels, break features and dead time.
89 (+) Configure Master synchronization.
90 (+) Configure timer remapping capabilities.
97 * @brief Configures the TIM in master mode.
98 * @param htim: TIM handle.
99 * @param sMasterConfig: pointer to a TIM_MasterConfigTypeDef structure that
100 * contains the selected trigger output (TRGO) and the Master/Slave
104 HAL_StatusTypeDef HAL_TIMEx_MasterConfigSynchronization(TIM_HandleTypeDef *htim, TIM_MasterConfigTypeDef * sMasterConfig)
106 /* Check the parameters */
107 assert_param(IS_TIM_MASTER_INSTANCE(htim->Instance));
108 assert_param(IS_TIM_TRGO_SOURCE(sMasterConfig->MasterOutputTrigger));
109 assert_param(IS_TIM_MSM_STATE(sMasterConfig->MasterSlaveMode));
113 htim->State = HAL_TIM_STATE_BUSY;
115 /* Reset the MMS Bits */
116 htim->Instance->CR2 &= ~TIM_CR2_MMS;
117 /* Select the TRGO source */
118 htim->Instance->CR2 |= sMasterConfig->MasterOutputTrigger;
120 /* Reset the MSM Bit */
121 htim->Instance->SMCR &= ~TIM_SMCR_MSM;
122 /* Set or Reset the MSM Bit */
123 htim->Instance->SMCR |= sMasterConfig->MasterSlaveMode;
125 htim->State = HAL_TIM_STATE_READY;
133 * @brief Configures the TIM2/TIM3/TIM9/TIM10/TIM11 Remapping input capabilities.
134 * @param htim: TIM handle.
135 * @param Remap: specifies the TIM remapping source.
136 * This parameter is a combination of the following values depending on TIM instance.
138 * For TIM2, the parameter can have the following values:
139 * @arg TIM_TIM2_ITR1_TIM10_OC: TIM2 ITR1 input is connected to TIM10 OC
140 * @arg TIM_TIM2_ITR1_TIM5_TGO: TIM2 ITR1 input is connected to TIM5 TGO
142 * For TIM3, the parameter can have the following values:
143 * @arg TIM_TIM3_ITR2_TIM11_OC: TIM3 ITR2 input is connected to TIM11 OC
144 * @arg TIM_TIM3_ITR2_TIM5_TGO: TIM3 ITR2 input is connected to TIM5 TGO
146 * For TIM9, the parameter is a combination of 2 fields (field1 | field2):
147 * field1 can have the following values:
148 * @arg TIM_TIM9_ITR1_TIM3_TGO: TIM9 ITR1 input is connected to TIM3 TGO
149 * @arg TIM_TIM9_ITR1_TS: TIM9 ITR1 input is connected to touch sensing I/O
150 * field2 can have the following values:
151 * @arg TIM_TIM9_GPIO: TIM9 Channel1 is connected to GPIO
152 * @arg TIM_TIM9_LSE: TIM9 Channel1 is connected to LSE internal clock
153 * @arg TIM_TIM9_GPIO1: TIM9 Channel1 is connected to GPIO
154 * @arg TIM_TIM9_GPIO2: TIM9 Channel1 is connected to GPIO
156 * For TIM10, the parameter is a combination of 3 fields (field1 | field2 | field3):
157 * field1 can have the following values:
158 * @arg TIM_TIM10_TI1RMP: TIM10 Channel 1 depends on TI1_RMP
159 * @arg TIM_TIM10_RI: TIM10 Channel 1 is connected to RI
160 * field2 can have the following values:
161 * @arg TIM_TIM10_ETR_LSE: TIM10 ETR input is connected to LSE clock
162 * @arg TIM_TIM10_ETR_TIM9_TGO: TIM10 ETR input is connected to TIM9 TGO
163 * field3 can have the following values:
164 * @arg TIM_TIM10_GPIO: TIM10 Channel1 is connected to GPIO
165 * @arg TIM_TIM10_LSI: TIM10 Channel1 is connected to LSI internal clock
166 * @arg TIM_TIM10_LSE: TIM10 Channel1 is connected to LSE internal clock
167 * @arg TIM_TIM10_RTC: TIM10 Channel1 is connected to RTC wakeup interrupt
169 * For TIM11, the parameter is a combination of 3 fields (field1 | field2 | field3):
170 * field1 can have the following values:
171 * @arg TIM_TIM11_TI1RMP: TIM11 Channel 1 depends on TI1_RMP
172 * @arg TIM_TIM11_RI: TIM11 Channel 1 is connected to RI
173 * field2 can have the following values:
174 * @arg TIM_TIM11_ETR_LSE: TIM11 ETR input is connected to LSE clock
175 * @arg TIM_TIM11_ETR_TIM9_TGO: TIM11 ETR input is connected to TIM9 TGO
176 * field3 can have the following values:
177 * @arg TIM_TIM11_GPIO: TIM11 Channel1 is connected to GPIO
178 * @arg TIM_TIM11_MSI: TIM11 Channel1 is connected to MSI internal clock
179 * @arg TIM_TIM11_HSE_RTC: TIM11 Channel1 is connected to HSE_RTC clock
180 * @arg TIM_TIM11_GPIO1: TIM11 Channel1 is connected to GPIO
184 HAL_StatusTypeDef HAL_TIMEx_RemapConfig(TIM_HandleTypeDef *htim, uint32_t Remap)
188 /* Check parameters */
189 assert_param(IS_TIM_REMAP_INSTANCE(htim->Instance));
190 assert_param(IS_TIM_REMAP(htim->Instance,Remap));
192 /* Set the Timer remapping configuration */
193 htim->Instance->OR = Remap;
195 htim->State = HAL_TIM_STATE_READY;
206 /** @defgroup TIMEx_Exported_Functions_Group2 Extension Callbacks functions
207 * @brief Extension Callbacks functions
210 ==============================================================================
211 ##### Extension Callbacks functions #####
212 ==============================================================================
214 This section provides Extension TIM callback functions:
215 (+) Timer Commutation callback
216 (+) Timer Break callback
227 /** @defgroup TIMEx_Exported_Functions_Group3 Extension Peripheral State functions
228 * @brief Extension Peripheral State functions
231 ==============================================================================
232 ##### Extension Peripheral State functions #####
233 ==============================================================================
235 This subsection permit to get in run-time the status of the peripheral
247 #endif /* HAL_TIM_MODULE_ENABLED */
260 /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/