Subversion Repositories EngineBay2

Rev

Details | Last modification | View Log | RSS feed

Rev Author Line No. Line
2 mjames 1 
/**
2 
  ******************************************************************************
3 
  * @file    stm32l1xx_hal_tim_ex.c
4 
  * @author  MCD Application Team
5 
  * @brief   TIM HAL module driver.
6 
  *          This file provides firmware functions to manage the following
28 mjames 7 
  *          functionalities of the Timer Extended peripheral:
2 mjames 8 
  *           + Time Master and Slave synchronization configuration
28 mjames 9 
  *           + Time OCRef clear configuration
2 mjames 10 
  *           + Timer remapping capabilities configuration
11 
  @verbatim
12 
  ==============================================================================
13 
                      ##### TIMER Extended features #####
14 
  ==============================================================================
15 
  [..]
28 mjames 16 
    The Timer Extended features include:
2 mjames 17 
    (#) Synchronization circuit to control the timer with external signals and to
18 
        interconnect several timers together.
19 
 
20 
  @endverbatim
21 
  ******************************************************************************
22 
  * @attention
23 
  *
28 mjames 24 
  * <h2><center>&copy; Copyright (c) 2016 STMicroelectronics.
25 
  * All rights reserved.</center></h2>
2 mjames 26 
  *
28 mjames 27 
  * This software component is licensed by ST under BSD 3-Clause license,
28 
  * the "License"; You may not use this file except in compliance with the
29 
  * License. You may obtain a copy of the License at:
30 
  *                        opensource.org/licenses/BSD-3-Clause
2 mjames 31 
  *
32 
  ******************************************************************************
28 mjames 33 
  */
2 mjames 34 
 
35 
/* Includes ------------------------------------------------------------------*/
36 
#include "stm32l1xx_hal.h"
37 
 
38 
/** @addtogroup STM32L1xx_HAL_Driver
39 
  * @{
40 
  */
41 
 
42 
/** @defgroup TIMEx TIMEx
43 
  * @brief TIM Extended HAL module driver
44 
  * @{
45 
  */
46 
 
47 
#ifdef HAL_TIM_MODULE_ENABLED
48 
 
49 
/* Private typedef -----------------------------------------------------------*/
50 
/* Private define ------------------------------------------------------------*/
28 mjames 51 
/* Private macros ------------------------------------------------------------*/
2 mjames 52 
/* Private variables ---------------------------------------------------------*/
53 
/* Private function prototypes -----------------------------------------------*/
54 
 
28 mjames 55 
/* Exported functions --------------------------------------------------------*/
56 
/** @defgroup TIMEx_Exported_Functions TIM Extended Exported Functions
2 mjames 57 
  * @{
58 
  */
28 mjames 59 
/** @defgroup TIMEx_Exported_Functions_Group5 Extended Peripheral Control functions
60 
  * @brief    Peripheral Control functions
61 
  *
2 mjames 62 
@verbatim
63 
  ==============================================================================
64 
                    ##### Peripheral Control functions #####
65 
  ==============================================================================
66 
  [..]
67 
    This section provides functions allowing to:
28 mjames 68 
      (+) Configure Master synchronization.
69 
      (+) Configure timer remapping capabilities.
2 mjames 70 
 
71 
@endverbatim
72 
  * @{
73 
  */
74 
 
75 
/**
76 
  * @brief  Configures the TIM in master mode.
28 mjames 77 
  * @param  htim TIM handle.
78 
  * @param  sMasterConfig pointer to a TIM_MasterConfigTypeDef structure that
2 mjames 79 
  *         contains the selected trigger output (TRGO) and the Master/Slave
80 
  *         mode.
81 
  * @retval HAL status
82 
  */
28 mjames 83 
HAL_StatusTypeDef HAL_TIMEx_MasterConfigSynchronization(TIM_HandleTypeDef *htim,
84 
                                                        TIM_MasterConfigTypeDef *sMasterConfig)
2 mjames 85 
{
28 mjames 86 
  uint32_t tmpcr2;
87 
  uint32_t tmpsmcr;
88 
 
2 mjames 89 
  /* Check the parameters */
90 
  assert_param(IS_TIM_MASTER_INSTANCE(htim->Instance));
91 
  assert_param(IS_TIM_TRGO_SOURCE(sMasterConfig->MasterOutputTrigger));
92 
  assert_param(IS_TIM_MSM_STATE(sMasterConfig->MasterSlaveMode));
93 
 
28 mjames 94 
  /* Check input state */
2 mjames 95 
  __HAL_LOCK(htim);
96 
 
28 mjames 97 
  /* Change the handler state */
2 mjames 98 
  htim->State = HAL_TIM_STATE_BUSY;
99 
 
28 mjames 100 
  /* Get the TIMx CR2 register value */
101 
  tmpcr2 = htim->Instance->CR2;
102 
 
103 
  /* Get the TIMx SMCR register value */
104 
  tmpsmcr = htim->Instance->SMCR;
105 
 
2 mjames 106 
  /* Reset the MMS Bits */
28 mjames 107 
  tmpcr2 &= ~TIM_CR2_MMS;
2 mjames 108 
  /* Select the TRGO source */
28 mjames 109 
  tmpcr2 |=  sMasterConfig->MasterOutputTrigger;
2 mjames 110 
 
28 mjames 111 
  /* Update TIMx CR2 */
112 
  htim->Instance->CR2 = tmpcr2;
2 mjames 113 
 
28 mjames 114 
  if (IS_TIM_SLAVE_INSTANCE(htim->Instance))
115 
  {
116 
    /* Reset the MSM Bit */
117 
    tmpsmcr &= ~TIM_SMCR_MSM;
118 
    /* Set master mode */
119 
    tmpsmcr |= sMasterConfig->MasterSlaveMode;
120 
 
121 
    /* Update TIMx SMCR */
122 
    htim->Instance->SMCR = tmpsmcr;
123 
  }
124 
 
125 
  /* Change the htim state */
2 mjames 126 
  htim->State = HAL_TIM_STATE_READY;
127 
 
128 
  __HAL_UNLOCK(htim);
129 
 
130 
  return HAL_OK;
131 
}
132 
 
133 
/**
28 mjames 134 
  * @brief  Configures the TIMx Remapping input capabilities.
135 
  * @param  htim TIM handle.
136 
  * @param  Remap specifies the TIM remapping source.
2 mjames 137 
  *
28 mjames 138 
  *         For TIM2, the parameter can have the following values:(see note)
2 mjames 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
141 
  *
28 mjames 142 
  *         For TIM3, the parameter can have the following values:(see note)
2 mjames 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
145 
  *
28 mjames 146 
  *         For TIM9, the parameter is a combination of 2 fields (field1 | field2):
147 
  *
148 
  *                   field1 can have the following values:(see note)
2 mjames 149 
  *            @arg TIM_TIM9_ITR1_TIM3_TGO:      TIM9 ITR1 input is connected to TIM3 TGO
150 
  *            @arg TIM_TIM9_ITR1_TS:            TIM9 ITR1 input is connected to touch sensing I/O
28 mjames 151 
  *
152 
  *                   field2 can have the following values:
2 mjames 153 
  *            @arg TIM_TIM9_GPIO:               TIM9 Channel1 is connected to GPIO
154 
  *            @arg TIM_TIM9_LSE:                TIM9 Channel1 is connected to LSE internal clock
155 
  *            @arg TIM_TIM9_GPIO1:              TIM9 Channel1 is connected to GPIO
156 
  *            @arg TIM_TIM9_GPIO2:              TIM9 Channel1 is connected to GPIO
157 
  *
28 mjames 158 
  *         For TIM10, the parameter is a combination of 3 fields (field1 | field2 | field3):
159 
  *
160 
  *                   field1 can have the following values:(see note)
2 mjames 161 
  *            @arg TIM_TIM10_TI1RMP:            TIM10 Channel 1 depends on TI1_RMP
162 
  *            @arg TIM_TIM10_RI:                TIM10 Channel 1 is connected to RI
28 mjames 163 
  *
164 
  *                   field2 can have the following values:(see note)
2 mjames 165 
  *            @arg TIM_TIM10_ETR_LSE:           TIM10 ETR input is connected to LSE clock
166 
  *            @arg TIM_TIM10_ETR_TIM9_TGO:      TIM10 ETR input is connected to TIM9 TGO
28 mjames 167 
  *
168 
  *                   field3 can have the following values:
2 mjames 169 
  *            @arg TIM_TIM10_GPIO:              TIM10 Channel1 is connected to GPIO
170 
  *            @arg TIM_TIM10_LSI:               TIM10 Channel1 is connected to LSI internal clock
171 
  *            @arg TIM_TIM10_LSE:               TIM10 Channel1 is connected to LSE internal clock
172 
  *            @arg TIM_TIM10_RTC:               TIM10 Channel1 is connected to RTC wakeup interrupt
173 
  *
28 mjames 174 
  *         For TIM11, the parameter is a combination of 3 fields (field1 | field2 | field3):
175 
  *
176 
  *                   field1 can have the following values:(see note)
2 mjames 177 
  *            @arg TIM_TIM11_TI1RMP:            TIM11 Channel 1 depends on TI1_RMP
178 
  *            @arg TIM_TIM11_RI:                TIM11 Channel 1 is connected to RI
28 mjames 179 
  *
180 
  *                   field2 can have the following values:(see note)
2 mjames 181 
  *            @arg TIM_TIM11_ETR_LSE:           TIM11 ETR input is connected to LSE clock
28 mjames 182 
  *            @arg TIM_TIM11_ETR_TIM9_TGO:      TIM11 ETR input is connected to TIM9 TGO
183 
  *
184 
  *                   field3 can have the following values:
185 
  *            @arg TIM_TIM11_GPIO:     TIM11 Channel1 is connected to GPIO
2 mjames 186 
  *            @arg TIM_TIM11_MSI:      TIM11 Channel1 is connected to MSI internal clock
187 
  *            @arg TIM_TIM11_HSE_RTC:  TIM11 Channel1 is connected to HSE_RTC clock
188 
  *            @arg TIM_TIM11_GPIO1:    TIM11 Channel1 is connected to GPIO
189 
  *
28 mjames 190 
  * @note   Available only in Cat.3, Cat.4,Cat.5 and Cat.6 devices.
191 
  *
192 
  * @retval HAL status
2 mjames 193 
  */
194 
HAL_StatusTypeDef HAL_TIMEx_RemapConfig(TIM_HandleTypeDef *htim, uint32_t Remap)
195 
{
196 
  __HAL_LOCK(htim);
197 
 
198 
  /* Check parameters */
28 mjames 199 
  assert_param(IS_TIM_REMAP(htim->Instance, Remap));
2 mjames 200 
 
201 
  /* Set the Timer remapping configuration */
28 mjames 202 
  WRITE_REG(htim->Instance->OR, Remap);
2 mjames 203 
 
204 
  __HAL_UNLOCK(htim);
205 
 
206 
  return HAL_OK;
207 
}
208 
 
209 
/**
210 
  * @}
211 
  */
212 
 
213 
/**
214 
  * @}
215 
  */
216 
 
28 mjames 217 
 
218 
#endif /* HAL_TIM_MODULE_ENABLED */
2 mjames 219 
/**
220 
  * @}
221 
  */
222 
 
223 
/**
224 
  * @}
225 
  */
226 
 
227 
/************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/