TUKS MCU Introductory course / TUKS-COURSE-2-LED
Embed: (wiki syntax)

« Back to documentation index

Input channel configuration

Input channel configuration
[TIM Exported Functions]

Functions

__STATIC_INLINE void LL_TIM_IC_Config (TIM_TypeDef *TIMx, uint32_t Channel, uint32_t Configuration)
 Configure input channel.
__STATIC_INLINE void LL_TIM_IC_SetActiveInput (TIM_TypeDef *TIMx, uint32_t Channel, uint32_t ICActiveInput)
 Set the active input.
__STATIC_INLINE uint32_t LL_TIM_IC_GetActiveInput (TIM_TypeDef *TIMx, uint32_t Channel)
 Get the current active input.
__STATIC_INLINE void LL_TIM_IC_SetPrescaler (TIM_TypeDef *TIMx, uint32_t Channel, uint32_t ICPrescaler)
 Set the prescaler of input channel.
__STATIC_INLINE uint32_t LL_TIM_IC_GetPrescaler (TIM_TypeDef *TIMx, uint32_t Channel)
 Get the current prescaler value acting on an input channel.
__STATIC_INLINE void LL_TIM_IC_SetFilter (TIM_TypeDef *TIMx, uint32_t Channel, uint32_t ICFilter)
 Set the input filter duration.
__STATIC_INLINE uint32_t LL_TIM_IC_GetFilter (TIM_TypeDef *TIMx, uint32_t Channel)
 Get the input filter duration.
__STATIC_INLINE void LL_TIM_IC_SetPolarity (TIM_TypeDef *TIMx, uint32_t Channel, uint32_t ICPolarity)
 Set the input channel polarity.
__STATIC_INLINE uint32_t LL_TIM_IC_GetPolarity (TIM_TypeDef *TIMx, uint32_t Channel)
 Get the current input channel polarity.
__STATIC_INLINE void LL_TIM_IC_EnableXORCombination (TIM_TypeDef *TIMx)
 Connect the TIMx_CH1, CH2 and CH3 pins to the TI1 input (XOR combination).
__STATIC_INLINE void LL_TIM_IC_DisableXORCombination (TIM_TypeDef *TIMx)
 Disconnect the TIMx_CH1, CH2 and CH3 pins from the TI1 input.
__STATIC_INLINE uint32_t LL_TIM_IC_IsEnabledXORCombination (TIM_TypeDef *TIMx)
 Indicates whether the TIMx_CH1, CH2 and CH3 pins are connectected to the TI1 input.
__STATIC_INLINE uint32_t LL_TIM_IC_GetCaptureCH1 (TIM_TypeDef *TIMx)
 Get captured value for input channel 1.
__STATIC_INLINE uint32_t LL_TIM_IC_GetCaptureCH2 (TIM_TypeDef *TIMx)
 Get captured value for input channel 2.
__STATIC_INLINE uint32_t LL_TIM_IC_GetCaptureCH3 (TIM_TypeDef *TIMx)
 Get captured value for input channel 3.
__STATIC_INLINE uint32_t LL_TIM_IC_GetCaptureCH4 (TIM_TypeDef *TIMx)
 Get captured value for input channel 4.

Function Documentation

__STATIC_INLINE void LL_TIM_IC_Config ( TIM_TypeDef *  TIMx,
uint32_t  Channel,
uint32_t  Configuration 
)

Configure input channel.

CCMR1 CC1S LL_TIM_IC_Config
CCMR1 IC1PSC LL_TIM_IC_Config
CCMR1 IC1F LL_TIM_IC_Config
CCMR1 CC2S LL_TIM_IC_Config
CCMR1 IC2PSC LL_TIM_IC_Config
CCMR1 IC2F LL_TIM_IC_Config
CCMR2 CC3S LL_TIM_IC_Config
CCMR2 IC3PSC LL_TIM_IC_Config
CCMR2 IC3F LL_TIM_IC_Config
CCMR2 CC4S LL_TIM_IC_Config
CCMR2 IC4PSC LL_TIM_IC_Config
CCMR2 IC4F LL_TIM_IC_Config
CCER CC1P LL_TIM_IC_Config
CCER CC1NP LL_TIM_IC_Config
CCER CC2P LL_TIM_IC_Config
CCER CC2NP LL_TIM_IC_Config
CCER CC3P LL_TIM_IC_Config
CCER CC3NP LL_TIM_IC_Config
CCER CC4P LL_TIM_IC_Config
CCER CC4NP LL_TIM_IC_Config

Parameters:
TIMxTimer instance
ChannelThis parameter can be one of the following values:

  • LL_TIM_CHANNEL_CH1
  • LL_TIM_CHANNEL_CH2
  • LL_TIM_CHANNEL_CH3
  • LL_TIM_CHANNEL_CH4
ConfigurationThis parameter must be a combination of all the following values:

  • LL_TIM_ACTIVEINPUT_DIRECTTI or LL_TIM_ACTIVEINPUT_INDIRECTTI or LL_TIM_ACTIVEINPUT_TRC
  • LL_TIM_ICPSC_DIV1 or ... or LL_TIM_ICPSC_DIV8
  • LL_TIM_IC_FILTER_FDIV1 or ... or LL_TIM_IC_FILTER_FDIV32_N8
  • LL_TIM_IC_POLARITY_RISING or LL_TIM_IC_POLARITY_FALLING or LL_TIM_IC_POLARITY_BOTHEDGE
Return values:
None

Definition at line 2656 of file stm32l4xx_ll_tim.h.

__STATIC_INLINE void LL_TIM_IC_DisableXORCombination ( TIM_TypeDef *  TIMx )

Disconnect the TIMx_CH1, CH2 and CH3 pins from the TI1 input.

Note:
Macro IS_TIM_XOR_INSTANCE(TIMx) can be used to check whether or not a timer instance provides an XOR input. CR2 TI1S LL_TIM_IC_DisableXORCombination
Parameters:
TIMxTimer instance
Return values:
None

Definition at line 2915 of file stm32l4xx_ll_tim.h.

__STATIC_INLINE void LL_TIM_IC_EnableXORCombination ( TIM_TypeDef *  TIMx )

Connect the TIMx_CH1, CH2 and CH3 pins to the TI1 input (XOR combination).

Note:
Macro IS_TIM_XOR_INSTANCE(TIMx) can be used to check whether or not a timer instance provides an XOR input. CR2 TI1S LL_TIM_IC_EnableXORCombination
Parameters:
TIMxTimer instance
Return values:
None

Definition at line 2902 of file stm32l4xx_ll_tim.h.

__STATIC_INLINE uint32_t LL_TIM_IC_GetActiveInput ( TIM_TypeDef *  TIMx,
uint32_t  Channel 
)

Get the current active input.

CCMR1 CC1S LL_TIM_IC_GetActiveInput
CCMR1 CC2S LL_TIM_IC_GetActiveInput
CCMR2 CC3S LL_TIM_IC_GetActiveInput
CCMR2 CC4S LL_TIM_IC_GetActiveInput

Parameters:
TIMxTimer instance
ChannelThis parameter can be one of the following values:

  • LL_TIM_CHANNEL_CH1
  • LL_TIM_CHANNEL_CH2
  • LL_TIM_CHANNEL_CH3
  • LL_TIM_CHANNEL_CH4
Return values:
Returnedvalue can be one of the following values:

  • LL_TIM_ACTIVEINPUT_DIRECTTI
  • LL_TIM_ACTIVEINPUT_INDIRECTTI
  • LL_TIM_ACTIVEINPUT_TRC

Definition at line 2706 of file stm32l4xx_ll_tim.h.

__STATIC_INLINE uint32_t LL_TIM_IC_GetCaptureCH1 ( TIM_TypeDef *  TIMx )

Get captured value for input channel 1.

Note:
In 32-bit timer implementations returned captured value can be between 0x00000000 and 0xFFFFFFFF.
Macro IS_TIM_32B_COUNTER_INSTANCE(TIMx) can be used to check whether or not a timer instance supports a 32 bits counter.
Macro IS_TIM_CC1_INSTANCE(TIMx) can be used to check whether or not input channel 1 is supported by a timer instance. CCR1 CCR1 LL_TIM_IC_GetCaptureCH1
Parameters:
TIMxTimer instance
Return values:
CapturedValue(between Min_Data=0 and Max_Data=65535)

Definition at line 2944 of file stm32l4xx_ll_tim.h.

__STATIC_INLINE uint32_t LL_TIM_IC_GetCaptureCH2 ( TIM_TypeDef *  TIMx )

Get captured value for input channel 2.

Note:
In 32-bit timer implementations returned captured value can be between 0x00000000 and 0xFFFFFFFF.
Macro IS_TIM_32B_COUNTER_INSTANCE(TIMx) can be used to check whether or not a timer instance supports a 32 bits counter.
Macro IS_TIM_CC2_INSTANCE(TIMx) can be used to check whether or not input channel 2 is supported by a timer instance. CCR2 CCR2 LL_TIM_IC_GetCaptureCH2
Parameters:
TIMxTimer instance
Return values:
CapturedValue(between Min_Data=0 and Max_Data=65535)

Definition at line 2960 of file stm32l4xx_ll_tim.h.

__STATIC_INLINE uint32_t LL_TIM_IC_GetCaptureCH3 ( TIM_TypeDef *  TIMx )

Get captured value for input channel 3.

Note:
In 32-bit timer implementations returned captured value can be between 0x00000000 and 0xFFFFFFFF.
Macro IS_TIM_32B_COUNTER_INSTANCE(TIMx) can be used to check whether or not a timer instance supports a 32 bits counter.
Macro IS_TIM_CC3_INSTANCE(TIMx) can be used to check whether or not input channel 3 is supported by a timer instance. CCR3 CCR3 LL_TIM_IC_GetCaptureCH3
Parameters:
TIMxTimer instance
Return values:
CapturedValue(between Min_Data=0 and Max_Data=65535)

Definition at line 2976 of file stm32l4xx_ll_tim.h.

__STATIC_INLINE uint32_t LL_TIM_IC_GetCaptureCH4 ( TIM_TypeDef *  TIMx )

Get captured value for input channel 4.

Note:
In 32-bit timer implementations returned captured value can be between 0x00000000 and 0xFFFFFFFF.
Macro IS_TIM_32B_COUNTER_INSTANCE(TIMx) can be used to check whether or not a timer instance supports a 32 bits counter.
Macro IS_TIM_CC4_INSTANCE(TIMx) can be used to check whether or not input channel 4 is supported by a timer instance. CCR4 CCR4 LL_TIM_IC_GetCaptureCH4
Parameters:
TIMxTimer instance
Return values:
CapturedValue(between Min_Data=0 and Max_Data=65535)

Definition at line 2992 of file stm32l4xx_ll_tim.h.

__STATIC_INLINE uint32_t LL_TIM_IC_GetFilter ( TIM_TypeDef *  TIMx,
uint32_t  Channel 
)

Get the input filter duration.

CCMR1 IC1F LL_TIM_IC_GetFilter
CCMR1 IC2F LL_TIM_IC_GetFilter
CCMR2 IC3F LL_TIM_IC_GetFilter
CCMR2 IC4F LL_TIM_IC_GetFilter

Parameters:
TIMxTimer instance
ChannelThis parameter can be one of the following values:

  • LL_TIM_CHANNEL_CH1
  • LL_TIM_CHANNEL_CH2
  • LL_TIM_CHANNEL_CH3
  • LL_TIM_CHANNEL_CH4
Return values:
Returnedvalue can be one of the following values:

  • LL_TIM_IC_FILTER_FDIV1
  • LL_TIM_IC_FILTER_FDIV1_N2
  • LL_TIM_IC_FILTER_FDIV1_N4
  • LL_TIM_IC_FILTER_FDIV1_N8
  • LL_TIM_IC_FILTER_FDIV2_N6
  • LL_TIM_IC_FILTER_FDIV2_N8
  • LL_TIM_IC_FILTER_FDIV4_N6
  • LL_TIM_IC_FILTER_FDIV4_N8
  • LL_TIM_IC_FILTER_FDIV8_N6
  • LL_TIM_IC_FILTER_FDIV8_N8
  • LL_TIM_IC_FILTER_FDIV16_N5
  • LL_TIM_IC_FILTER_FDIV16_N6
  • LL_TIM_IC_FILTER_FDIV16_N8
  • LL_TIM_IC_FILTER_FDIV32_N5
  • LL_TIM_IC_FILTER_FDIV32_N6
  • LL_TIM_IC_FILTER_FDIV32_N8

Definition at line 2832 of file stm32l4xx_ll_tim.h.

__STATIC_INLINE uint32_t LL_TIM_IC_GetPolarity ( TIM_TypeDef *  TIMx,
uint32_t  Channel 
)

Get the current input channel polarity.

CCER CC1P LL_TIM_IC_GetPolarity
CCER CC1NP LL_TIM_IC_GetPolarity
CCER CC2P LL_TIM_IC_GetPolarity
CCER CC2NP LL_TIM_IC_GetPolarity
CCER CC3P LL_TIM_IC_GetPolarity
CCER CC3NP LL_TIM_IC_GetPolarity
CCER CC4P LL_TIM_IC_GetPolarity
CCER CC4NP LL_TIM_IC_GetPolarity

Parameters:
TIMxTimer instance
ChannelThis parameter can be one of the following values:

  • LL_TIM_CHANNEL_CH1
  • LL_TIM_CHANNEL_CH2
  • LL_TIM_CHANNEL_CH3
  • LL_TIM_CHANNEL_CH4
Return values:
Returnedvalue can be one of the following values:

  • LL_TIM_IC_POLARITY_RISING
  • LL_TIM_IC_POLARITY_FALLING
  • LL_TIM_IC_POLARITY_BOTHEDGE

Definition at line 2888 of file stm32l4xx_ll_tim.h.

__STATIC_INLINE uint32_t LL_TIM_IC_GetPrescaler ( TIM_TypeDef *  TIMx,
uint32_t  Channel 
)

Get the current prescaler value acting on an input channel.

CCMR1 IC1PSC LL_TIM_IC_GetPrescaler
CCMR1 IC2PSC LL_TIM_IC_GetPrescaler
CCMR2 IC3PSC LL_TIM_IC_GetPrescaler
CCMR2 IC4PSC LL_TIM_IC_GetPrescaler

Parameters:
TIMxTimer instance
ChannelThis parameter can be one of the following values:

  • LL_TIM_CHANNEL_CH1
  • LL_TIM_CHANNEL_CH2
  • LL_TIM_CHANNEL_CH3
  • LL_TIM_CHANNEL_CH4
Return values:
Returnedvalue can be one of the following values:

  • LL_TIM_ICPSC_DIV1
  • LL_TIM_ICPSC_DIV2
  • LL_TIM_ICPSC_DIV4
  • LL_TIM_ICPSC_DIV8

Definition at line 2757 of file stm32l4xx_ll_tim.h.

__STATIC_INLINE uint32_t LL_TIM_IC_IsEnabledXORCombination ( TIM_TypeDef *  TIMx )

Indicates whether the TIMx_CH1, CH2 and CH3 pins are connectected to the TI1 input.

Note:
Macro IS_TIM_XOR_INSTANCE(TIMx) can be used to check whether or not a timer instance provides an XOR input. CR2 TI1S LL_TIM_IC_IsEnabledXORCombination
Parameters:
TIMxTimer instance
Return values:
Stateof bit (1 or 0).

Definition at line 2928 of file stm32l4xx_ll_tim.h.

__STATIC_INLINE void LL_TIM_IC_SetActiveInput ( TIM_TypeDef *  TIMx,
uint32_t  Channel,
uint32_t  ICActiveInput 
)

Set the active input.

CCMR1 CC1S LL_TIM_IC_SetActiveInput
CCMR1 CC2S LL_TIM_IC_SetActiveInput
CCMR2 CC3S LL_TIM_IC_SetActiveInput
CCMR2 CC4S LL_TIM_IC_SetActiveInput

Parameters:
TIMxTimer instance
ChannelThis parameter can be one of the following values:

  • LL_TIM_CHANNEL_CH1
  • LL_TIM_CHANNEL_CH2
  • LL_TIM_CHANNEL_CH3
  • LL_TIM_CHANNEL_CH4
ICActiveInputThis parameter can be one of the following values:

  • LL_TIM_ACTIVEINPUT_DIRECTTI
  • LL_TIM_ACTIVEINPUT_INDIRECTTI
  • LL_TIM_ACTIVEINPUT_TRC
Return values:
None

Definition at line 2682 of file stm32l4xx_ll_tim.h.

__STATIC_INLINE void LL_TIM_IC_SetFilter ( TIM_TypeDef *  TIMx,
uint32_t  Channel,
uint32_t  ICFilter 
)

Set the input filter duration.

CCMR1 IC1F LL_TIM_IC_SetFilter
CCMR1 IC2F LL_TIM_IC_SetFilter
CCMR2 IC3F LL_TIM_IC_SetFilter
CCMR2 IC4F LL_TIM_IC_SetFilter

Parameters:
TIMxTimer instance
ChannelThis parameter can be one of the following values:

  • LL_TIM_CHANNEL_CH1
  • LL_TIM_CHANNEL_CH2
  • LL_TIM_CHANNEL_CH3
  • LL_TIM_CHANNEL_CH4
ICFilterThis parameter can be one of the following values:

  • LL_TIM_IC_FILTER_FDIV1
  • LL_TIM_IC_FILTER_FDIV1_N2
  • LL_TIM_IC_FILTER_FDIV1_N4
  • LL_TIM_IC_FILTER_FDIV1_N8
  • LL_TIM_IC_FILTER_FDIV2_N6
  • LL_TIM_IC_FILTER_FDIV2_N8
  • LL_TIM_IC_FILTER_FDIV4_N6
  • LL_TIM_IC_FILTER_FDIV4_N8
  • LL_TIM_IC_FILTER_FDIV8_N6
  • LL_TIM_IC_FILTER_FDIV8_N8
  • LL_TIM_IC_FILTER_FDIV16_N5
  • LL_TIM_IC_FILTER_FDIV16_N6
  • LL_TIM_IC_FILTER_FDIV16_N8
  • LL_TIM_IC_FILTER_FDIV32_N5
  • LL_TIM_IC_FILTER_FDIV32_N6
  • LL_TIM_IC_FILTER_FDIV32_N8
Return values:
None

Definition at line 2795 of file stm32l4xx_ll_tim.h.

__STATIC_INLINE void LL_TIM_IC_SetPolarity ( TIM_TypeDef *  TIMx,
uint32_t  Channel,
uint32_t  ICPolarity 
)

Set the input channel polarity.

CCER CC1P LL_TIM_IC_SetPolarity
CCER CC1NP LL_TIM_IC_SetPolarity
CCER CC2P LL_TIM_IC_SetPolarity
CCER CC2NP LL_TIM_IC_SetPolarity
CCER CC3P LL_TIM_IC_SetPolarity
CCER CC3NP LL_TIM_IC_SetPolarity
CCER CC4P LL_TIM_IC_SetPolarity
CCER CC4NP LL_TIM_IC_SetPolarity

Parameters:
TIMxTimer instance
ChannelThis parameter can be one of the following values:

  • LL_TIM_CHANNEL_CH1
  • LL_TIM_CHANNEL_CH2
  • LL_TIM_CHANNEL_CH3
  • LL_TIM_CHANNEL_CH4
ICPolarityThis parameter can be one of the following values:

  • LL_TIM_IC_POLARITY_RISING
  • LL_TIM_IC_POLARITY_FALLING
  • LL_TIM_IC_POLARITY_BOTHEDGE
Return values:
None

Definition at line 2861 of file stm32l4xx_ll_tim.h.

__STATIC_INLINE void LL_TIM_IC_SetPrescaler ( TIM_TypeDef *  TIMx,
uint32_t  Channel,
uint32_t  ICPrescaler 
)

Set the prescaler of input channel.

CCMR1 IC1PSC LL_TIM_IC_SetPrescaler
CCMR1 IC2PSC LL_TIM_IC_SetPrescaler
CCMR2 IC3PSC LL_TIM_IC_SetPrescaler
CCMR2 IC4PSC LL_TIM_IC_SetPrescaler

Parameters:
TIMxTimer instance
ChannelThis parameter can be one of the following values:

  • LL_TIM_CHANNEL_CH1
  • LL_TIM_CHANNEL_CH2
  • LL_TIM_CHANNEL_CH3
  • LL_TIM_CHANNEL_CH4
ICPrescalerThis parameter can be one of the following values:

  • LL_TIM_ICPSC_DIV1
  • LL_TIM_ICPSC_DIV2
  • LL_TIM_ICPSC_DIV4
  • LL_TIM_ICPSC_DIV8
Return values:
None

Definition at line 2732 of file stm32l4xx_ll_tim.h.