14. Advanced-control timers (TIM1 and TIM8)

Low-density devices are STM32F101xx, STM32F102xx and STM32F103xx microcontrollers where the Flash memory density ranges between 16 and 32 Kbytes.

Medium-density devices are STM32F101xx, STM32F102xx and STM32F103xx microcontrollers where the Flash memory density ranges between 64 and 128 Kbytes.

High-density devices are STM32F101xx and STM32F103xx microcontrollers where the Flash memory density ranges between 256 and 512 Kbytes.

XL-density devices are STM32F101xx and STM32F103xx microcontrollers where the Flash memory density ranges between 768 Kbytes and 1 Mbyte.

Connectivity line devices are STM32F105xx and STM32F107xx microcontrollers.

Low- and medium-density STM32F103xx devices, and the STM32F105xx/STM32F107xx connectivity line devices, contain one advanced-control timer (TIM1) whereas high-density and XL-density STM32F103xx devices feature two advance-control timers (TIM1 and TIM8).

14.1 TIM1 and TIM8 introduction

The advanced-control timers (TIM1 and TIM8) consist of a 16-bit auto-reload counter driven by a programmable prescaler.

It may be used for a variety of purposes, including measuring the pulse lengths of input signals (input capture) or generating output waveforms (output compare, PWM, complementary PWM with dead-time insertion).

Pulse lengths and waveform periods can be modulated from a few microseconds to several milliseconds using the timer prescaler and the RCC clock controller prescalers.

The advanced-control (TIM1 and TIM8) and general-purpose (TIMx) timers are completely independent, and do not share any resources. They can be synchronized together as described in Section 14.3.20 .

14.2 TIM1 and TIM8 main features

TIM1 and TIM8 timer features include:

Figure 52. Advanced-control timer block diagram

Advanced-control timer block diagram showing internal architecture including Trigger controller, Slave mode controller, Encoder interface, PSC (prescaler), CNT (counter), Capture/Compare registers, DTG, and Output controls for four channels (CH1-CH4).

The diagram illustrates the internal architecture of an advanced-control timer (TIM1 or TIM8). At the top, the CK_TIM18 from RCC provides the Internal clock (CK_INT) to the Trigger controller , Slave mode controller , and Encoder interface . The ETR input passes through a Polarity selection, Edge detector and Prescaler block, which outputs ETRP and ETRF signals. ITR0 , ITR1 , ITR2 , and ITR3 inputs are combined and filtered by an Input filter to produce TRC . TIF_ED , TI1FP1 , and TI2FP2 signals are also fed into the Encoder interface . The Trigger controller generates the TRGO signal, which is sent to other timers, the DAC, and the ADC. The Slave mode controller receives TRGI and TGI signals and provides Reset , Enable , Up/Down , and Count signals to the CNT (counter) . The REP Register is connected to the REP Register block, which outputs UI and is controlled by a REP Register block. The AutoReload Register is connected to the CNT (counter) and the Repetition counter . The CK_PSC signal is divided by the PSC (prescaler) to produce the CK_CNT signal for the CNT (counter) . The CNT (counter) is connected to four Capture/Compare registers (1, 2, 3, and 4). Each register has associated CC and IC signals, which pass through Prescaler blocks. The DTG[7:0] registers are connected to the Capture/Compare registers and the Output control blocks. The Output control blocks generate the OC1 , OC1N , OC2 , OC2N , OC3 , OC3N , OC4 , and OC4N signals. The BRK input is connected to a Polarity selection block, which outputs BI . The Clock failure event from clock controller CSS (Clock Security System) is also connected to the BI signal. The BI signal is connected to the Output control blocks. The Legend indicates that a sawtooth symbol represents an Interrupt & DMA output and a double sawtooth symbol represents an Event .

Advanced-control timer block diagram showing internal architecture including Trigger controller, Slave mode controller, Encoder interface, PSC (prescaler), CNT (counter), Capture/Compare registers, DTG, and Output controls for four channels (CH1-CH4).

MS39906V3

14.3 TIM1 and TIM8 functional description

14.3.1 Time-base unit

The main block of the programmable advanced-control timer is a 16-bit counter with its related auto-reload register. The counter can count up, down or both up and down. The counter clock can be divided by a prescaler.

The counter, the auto-reload register and the prescaler register can be written or read by software. This is true even when the counter is running.

The time-base unit includes:

The auto-reload register is preloaded. Writing to or reading from the auto-reload register accesses the preload register. The content of the preload register are transferred into the shadow register permanently or at each update event (UEV), depending on the auto-reload preload enable bit (ARPE) in TIMx_CR1 register. The update event is sent when the counter reaches the overflow (or underflow when downcounting) and if the UDIS bit equals 0 in the TIMx_CR1 register. It can also be generated by software. The generation of the update event is described in detailed for each configuration.

The counter is clocked by the prescaler output CK_CNT, which is enabled only when the counter enable bit (CEN) in TIMx_CR1 register is set (refer also to the slave mode controller description to get more details on counter enabling).

Note that the counter starts counting 1 clock cycle after setting the CEN bit in the TIMx_CR1 register.

Prescaler description

The prescaler can divide the counter clock frequency by any factor between 1 and 65536. It is based on a 16-bit counter controlled through a 16-bit register (in the TIMx_PSC register). It can be changed on the fly as this control register is buffered. The new prescaler ratio is taken into account at the next update event.

Figure 53 and Figure 54 give some examples of the counter behavior when the prescaler ratio is changed on the fly:

Figure 53. Counter timing diagram with prescaler division change from 1 to 2

Timing diagram for Figure 53 showing signal transitions for CK_PSC, CEN, Timerclock, Counter register, Update event, Prescaler control register, Prescaler buffer, and Prescaler counter. The diagram illustrates a change in prescaler division from 1 to 2.

This timing diagram shows the relationship between several signals over time. The signals are:

Vertical dashed lines indicate key timing points: the start of counting, the write to the prescaler control register, and the update event that synchronizes the counter and buffer changes.

Timing diagram for Figure 53 showing signal transitions for CK_PSC, CEN, Timerclock, Counter register, Update event, Prescaler control register, Prescaler buffer, and Prescaler counter. The diagram illustrates a change in prescaler division from 1 to 2.

Figure 54. Counter timing diagram with prescaler division change from 1 to 4

Timing diagram for Figure 54 showing signal transitions for CK_PSC, CEN, Timerclock, Counter register, Update event, Prescaler control register, Prescaler buffer, and Prescaler counter. The diagram illustrates a change in prescaler division from 1 to 4.

This timing diagram is similar to Figure 53 but shows a prescaler division change from 1 to 4. The signals and their behavior are:

The timing points for starting counting, writing the new prescaler value, and the update event are consistent with the previous diagram.

Timing diagram for Figure 54 showing signal transitions for CK_PSC, CEN, Timerclock, Counter register, Update event, Prescaler control register, Prescaler buffer, and Prescaler counter. The diagram illustrates a change in prescaler division from 1 to 4.

14.3.2 Counter modes

Upcounting mode

In upcounting mode, the counter counts from 0 to the auto-reload value (content of the TIMx_ARR register), then restarts from 0 and generates a counter overflow event.

If the repetition counter is used, the update event (UEV) is generated after upcounting is repeated for the number of times programmed in the repetition counter register plus one (TIMx_RCR+1). Else the update event is generated at each counter overflow.

Setting the UG bit in the TIMx_EGR register (by software or by using the slave mode controller) also generates an update event.

The UEV event can be disabled by software by setting the UDIS bit in the TIMx_CR1 register. This is to avoid updating the shadow registers while writing new values in the preload registers. Then no update event occurs until the UDIS bit has been written to 0. However, the counter restarts from 0, as well as the counter of the prescaler (but the prescale rate does not change). In addition, if the URS bit (update request selection) in TIMx_CR1 register is set, setting the UG bit generates an update event UEV but without setting the UIF flag (thus no interrupt or DMA request is sent). This is to avoid generating both update and capture interrupts when clearing the counter on the capture event.

When an update event occurs, all the registers are updated and the update flag (UIF bit in TIMx_SR register) is set (depending on the URS bit):

The following figures show some examples of the counter behavior for different clock frequencies when TIMx_ARR=0x36.

Figure 55. Counter timing diagram, internal clock divided by 1

Timing diagram for upcounting mode. The diagram shows the relationship between the prescaler clock (CK_PSC), counter enable (CNT_EN), timer clock (CK_CNT), counter register values, counter overflow, update event (UEV), and update interrupt flag (UIF).

The timing diagram illustrates the counter's behavior in upcounting mode. The top signal, CK_PSC, is a periodic square wave. Below it, CNT_EN is a horizontal line that goes high to enable the counter. The third signal, Timerclock = CK_CNT, is a square wave that is active only when CNT_EN is high. The fourth signal, 'Counter register', shows a sequence of values: 31, 32, 33, 34, 35, 36, 00, 01, 02, 03, 04, 05, 06, 07. The values 32 through 36 are highlighted with a shaded background. The fifth signal, 'Counter overflow', is a pulse that goes high when the counter reaches 36 and returns low when it rolls over to 00. The sixth signal, 'Update event (UEV)', is a pulse that goes high at the same time as the counter overflow. The bottom signal, 'Update interrupt flag (UIF)', is a pulse that goes high at the same time as the counter overflow and returns low at the same time as the UEV pulse. Vertical dashed lines indicate the timing relationships between the signals. The diagram is labeled MS31078V3 in the bottom right corner.

Timing diagram for upcounting mode. The diagram shows the relationship between the prescaler clock (CK_PSC), counter enable (CNT_EN), timer clock (CK_CNT), counter register values, counter overflow, update event (UEV), and update interrupt flag (UIF).

Figure 56. Counter timing diagram, internal clock divided by 2

Timing diagram for internal clock divided by 2. It shows CK_PSC, CNT_EN, Timerclock = CK_CNT, Counter register values (0034, 0035, 0036, 0000, 0001, 0002, 0003), Counter overflow, Update event (UEV), and Update interrupt flag (UIF) over time. MS31079V3

This timing diagram illustrates the operation of a timer with the internal clock divided by 2. The top signal, CK_PSC, is a periodic square wave. Below it, CNT_EN is a horizontal line indicating the counter is enabled. The Timerclock = CK_CNT signal is a square wave with a frequency half that of CK_PSC. The Counter register shows a sequence of values: 0034, 0035, 0036, 0000, 0001, 0002, 0003. Vertical dashed lines mark the rising edges of the timer clock. At the transition from 0036 to 0000, the Counter overflow, Update event (UEV), and Update interrupt flag (UIF) signals all pulse high. The identifier MS31079V3 is in the bottom right corner.

Timing diagram for internal clock divided by 2. It shows CK_PSC, CNT_EN, Timerclock = CK_CNT, Counter register values (0034, 0035, 0036, 0000, 0001, 0002, 0003), Counter overflow, Update event (UEV), and Update interrupt flag (UIF) over time. MS31079V3

Figure 57. Counter timing diagram, internal clock divided by 4

Timing diagram for internal clock divided by 4. It shows CK_PSC, CNT_EN, Timerclock = CK_CNT, Counter register values (0035, 0036, 0000, 0001), Counter overflow, Update event (UEV), and Update interrupt flag (UIF) over time. MS31080V3

This timing diagram shows the timer operation with the internal clock divided by 4. CK_PSC is the base clock. CNT_EN is high. The Timerclock = CK_CNT signal has a frequency one-quarter that of CK_PSC. The Counter register displays values 0035, 0036, 0000, and 0001. Vertical dashed lines indicate the rising edges of the timer clock. At the rollover from 0036 to 0000, the Counter overflow, Update event (UEV), and Update interrupt flag (UIF) signals are asserted. The identifier MS31080V3 is in the bottom right corner.

Timing diagram for internal clock divided by 4. It shows CK_PSC, CNT_EN, Timerclock = CK_CNT, Counter register values (0035, 0036, 0000, 0001), Counter overflow, Update event (UEV), and Update interrupt flag (UIF) over time. MS31080V3

Figure 58. Counter timing diagram, internal clock divided by N

Timing diagram for internal clock divided by N. It shows CK_PSC, Timerclock = CK_CNT, Counter register values (1F, 20, 00), Counter overflow, Update event (UEV), and Update interrupt flag (UIF) over time. MS31081V3

This timing diagram depicts the timer operation with the internal clock divided by an arbitrary factor N. CK_PSC is the input clock, and Timerclock = CK_CNT is the divided clock. The Counter register shows values 1F, 20, and 00. Vertical dashed lines mark the rising edges of the timer clock. At the transition from 20 to 00, the Counter overflow, Update event (UEV), and Update interrupt flag (UIF) signals are triggered. The identifier MS31081V3 is in the bottom right corner.

Timing diagram for internal clock divided by N. It shows CK_PSC, Timerclock = CK_CNT, Counter register values (1F, 20, 00), Counter overflow, Update event (UEV), and Update interrupt flag (UIF) over time. MS31081V3

Figure 59. Counter timing diagram, update event when ARPE=0 (TIMx_ARR not preloaded)

Timing diagram for ARPE=0 showing counter overflow and update event when the auto-reload register is not preloaded.

This timing diagram illustrates the behavior of a timer when ARPE=0. The signals shown are:

MS31082V3

Timing diagram for ARPE=0 showing counter overflow and update event when the auto-reload register is not preloaded.

Figure 60. Counter timing diagram, update event when ARPE=1 (TIMx_ARR preloaded)

Timing diagram for ARPE=1 showing counter overflow and update event when the auto-reload register is preloaded.

This timing diagram illustrates the behavior of a timer when ARPE=1. The signals shown are:

MS31083V2

Timing diagram for ARPE=1 showing counter overflow and update event when the auto-reload register is preloaded.

Downcounting mode

In downcounting mode, the counter counts from the auto-reload value (content of the TIMx_ARR register) down to 0, then restarts from the auto-reload value and generates a counter underflow event.

If the repetition counter is used, the update event (UEV) is generated after downcounting is repeated for the number of times programmed in the repetition counter register plus one (TIMx_RCR+1). Else the update event is generated at each counter underflow.

Setting the UG bit in the TIMx_EGR register (by software or by using the slave mode controller) also generates an update event.

The UEV update event can be disabled by software by setting the UDIS bit in TIMx_CR1 register. This is to avoid updating the shadow registers while writing new values in the preload registers. Then no update event occurs until UDIS bit has been written to 0. However, the counter restarts from the current auto-reload value, whereas the counter of the prescaler restarts from 0 (but the prescale rate doesn't change).

In addition, if the URS bit (update request selection) in TIMx_CR1 register is set, setting the UG bit generates an update event UEV but without setting the UIF flag (thus no interrupt or DMA request is sent). This is to avoid generating both update and capture interrupts when clearing the counter on the capture event.

When an update event occurs, all the registers are updated and the update flag (UIF bit in TIMx_SR register) is set (depending on the URS bit):

The following figures show some examples of the counter behavior for different clock frequencies when TIMx_ARR=0x36.

Figure 61. Counter timing diagram, internal clock divided by 1

Timing diagram for internal clock divided by 1

Timing diagram showing the relationship between the prescaler clock (CK_PSC), counter enable (CNT_EN), timer clock (Timerclock = CK_CNT), counter register values, counter underflow (cnt_udf), update event (UEV), and update interrupt flag (UIF) when the internal clock is divided by 1.

The diagram illustrates the following signals and events:

MS31185V1

Timing diagram for internal clock divided by 1

Figure 62. Counter timing diagram, internal clock divided by 2

Timing diagram for internal clock divided by 2

Timing diagram showing the relationship between the prescaler clock (CK_PSC), counter enable (CNT_EN), timer clock (Timerclock = CK_CNT), counter register values, counter underflow (cnt_udf), update event (UEV), and update interrupt flag (UIF) when the internal clock is divided by 2.

The diagram illustrates the following signals and events:

MS31185V1

Timing diagram for internal clock divided by 2

Figure 63. Counter timing diagram, internal clock divided by 4

Timing diagram for internal clock divided by 4. It shows CK_PSC, CNT_EN, Timerclock = CK_CNT, Counter register values (0001, 0000, 0036, 0035), Counter underflow, Update event (UEV), and Update interrupt flag (UIF) over time. MS40510V1

This timing diagram illustrates the operation of a timer when the internal clock is divided by 4. The top signal, CK_PSC, is a periodic square wave. Below it, CNT_EN is shown as a high-level signal. The Timerclock = CK_CNT is derived from CK_PSC and is shown as a lower-frequency square wave. The Counter register is shown with four values: 0001, 0000, 0036, and 0035. The Counter underflow signal is shown as a pulse when the counter reaches 0000. The Update event (UEV) and Update interrupt flag (UIF) are also shown as pulses. The diagram is labeled MS40510V1.

Timing diagram for internal clock divided by 4. It shows CK_PSC, CNT_EN, Timerclock = CK_CNT, Counter register values (0001, 0000, 0036, 0035), Counter underflow, Update event (UEV), and Update interrupt flag (UIF) over time. MS40510V1

Figure 64. Counter timing diagram, internal clock divided by N

Timing diagram for internal clock divided by N. It shows CK_PSC, Timerclock = CK_CNT, Counter register values (20, 1F, 00, 36), Counter underflow, Update event (UEV), and Update interrupt flag (UIF) over time. MS31187V1

This timing diagram illustrates the operation of a timer when the internal clock is divided by N. The top signal, CK_PSC, is a periodic square wave. Below it, Timerclock = CK_CNT is shown as a lower-frequency square wave. The Counter register is shown with four values: 20, 1F, 00, and 36. The Counter underflow signal is shown as a pulse when the counter reaches 00. The Update event (UEV) and Update interrupt flag (UIF) are also shown as pulses. The diagram is labeled MS31187V1.

Timing diagram for internal clock divided by N. It shows CK_PSC, Timerclock = CK_CNT, Counter register values (20, 1F, 00, 36), Counter underflow, Update event (UEV), and Update interrupt flag (UIF) over time. MS31187V1

Figure 65. Counter timing diagram, update event when repetition counter is not used

Figure 65. Counter timing diagram, update event when repetition counter is not used. The diagram shows the relationship between the prescaler clock (CK_PSC), counter enable (CEN), timer clock (CK_CNT), counter register values, counter underflow, update event (UEV), update interrupt flag (UIF), and auto-reload preload register. The counter counts down from 05 to 00, then overflows to 36 and counts down to 2F. An update event is generated at the 00 count, setting the UIF flag. The auto-reload preload register is shown with a value of FF, which is updated to 36.

The diagram illustrates the timing of a counter. The top signal is CK_PSC (prescaler clock), a periodic square wave. Below it is CEN (counter enable), which is a high-level signal. The Timerclock = CK_CNT is derived from CK_PSC and is active when CEN is high. The Counter register shows a sequence of values: 05, 04, 03, 02, 01, 00, 36, 35, 34, 33, 32, 31, 30, 2F. This indicates a down-counting sequence from 05 to 00, followed by an overflow to 36 and further down-counting. The Counter underflow signal is a pulse that goes high when the counter reaches 00. The Update event (UEV) is a pulse that goes high at the 00 count. The Update interrupt flag (UIF) is a signal that goes high at the 00 count and remains high until software clears it. The Auto-reload preload register is shown with a value of FF, which is updated to 36. A note indicates that a new value can be written in the TIMx_ARR register.

Figure 65. Counter timing diagram, update event when repetition counter is not used. The diagram shows the relationship between the prescaler clock (CK_PSC), counter enable (CEN), timer clock (CK_CNT), counter register values, counter underflow, update event (UEV), update interrupt flag (UIF), and auto-reload preload register. The counter counts down from 05 to 00, then overflows to 36 and counts down to 2F. An update event is generated at the 00 count, setting the UIF flag. The auto-reload preload register is shown with a value of FF, which is updated to 36.

Center-aligned mode (up/down counting)

In center-aligned mode, the counter counts from 0 to the auto-reload value (content of the TIMx_ARR register) – 1, generates a counter overflow event, then counts from the auto-reload value down to 1 and generates a counter underflow event. Then it restarts counting from 0.

Center-aligned mode is active when the CMS bits in TIMx_CR1 register are not equal to '00'. The Output compare interrupt flag of channels configured in output is set when: the counter counts down (Center aligned mode 1, CMS = "01"), the counter counts up (Center aligned mode 2, CMS = "10") the counter counts up and down (Center aligned mode 3, CMS = "11").

In this mode, the DIR direction bit in the TIMx_CR1 register cannot be written. It is updated by hardware and gives the current direction of the counter.

The update event can be generated at each counter overflow and at each counter underflow or by setting the UG bit in the TIMx_EGR register (by software or by using the slave mode controller) also generates an update event. In this case, the counter restarts counting from 0, as well as the counter of the prescaler.

The UEV update event can be disabled by software by setting the UDIS bit in the TIMx_CR1 register. This is to avoid updating the shadow registers while writing new values in the preload registers. Then no update event occurs until UDIS bit has been written to 0. However, the counter continues counting up and down, based on the current auto-reload value.

In addition, if the URS bit (update request selection) in TIMx_CR1 register is set, setting the UG bit generates an UEV update event but without setting the UIF flag (thus no interrupt or DMA request is sent). This is to avoid generating both update and capture interrupts when clearing the counter on the capture event.

When an update event occurs, all the registers are updated and the update flag (UIF bit in TIMx_SR register) is set (depending on the URS bit):

The following figures show some examples of the counter behavior for different clock frequencies.

Figure 66. Counter timing diagram, internal clock divided by 1, TIMx_ARR = 0x6

Timing diagram for internal clock divided by 1. It shows CK_PSC, CEN, Timerclock = CK_CNT, Counter register values (04, 03, 02, 01, 00, 01, 02, 03, 04, 05, 06, 05, 04, 03), Counter underflow, Counter overflow, Update event (UEV), and Update interrupt flag (UIF).

The diagram shows the relationship between the prescaler clock (CK_PSC), counter enable (CEN), timer clock (Timerclock = CK_CNT), counter register values, counter underflow, counter overflow, update event (UEV), and update interrupt flag (UIF). The counter register values are shown in a sequence: 04, 03, 02, 01, 00, 01, 02, 03, 04, 05, 06, 05, 04, 03. The counter underflow occurs when the counter reaches 00, and the counter overflow occurs when the counter reaches 06. The update event (UEV) is generated when the counter reaches 00 or 06. The update interrupt flag (UIF) is set when the update event occurs.

Timing diagram for internal clock divided by 1. It shows CK_PSC, CEN, Timerclock = CK_CNT, Counter register values (04, 03, 02, 01, 00, 01, 02, 03, 04, 05, 06, 05, 04, 03), Counter underflow, Counter overflow, Update event (UEV), and Update interrupt flag (UIF).

1. Here, center-aligned mode 1 is used (for more details refer to Section 14.4: TIM1 and TIM8 registers ).

Figure 67. Counter timing diagram, internal clock divided by 2

Timing diagram for internal clock divided by 2. It shows CK_PSC, CNT_EN, Timerclock = CK_CNT, Counter register values (0003, 0002, 0001, 0000, 0001, 0002, 0003), Counter underflow, Update event (UEV), and Update interrupt flag (UIF).

The diagram shows the relationship between the prescaler clock (CK_PSC), counter enable (CNT_EN), timer clock (Timerclock = CK_CNT), counter register values, counter underflow, update event (UEV), and update interrupt flag (UIF). The counter register values are shown in a sequence: 0003, 0002, 0001, 0000, 0001, 0002, 0003. The counter underflow occurs when the counter reaches 0000. The update event (UEV) is generated when the counter reaches 0000. The update interrupt flag (UIF) is set when the update event occurs.

Timing diagram for internal clock divided by 2. It shows CK_PSC, CNT_EN, Timerclock = CK_CNT, Counter register values (0003, 0002, 0001, 0000, 0001, 0002, 0003), Counter underflow, Update event (UEV), and Update interrupt flag (UIF).

Figure 68. Counter timing diagram, internal clock divided by 4, TIMx_ARR=0x36

Timing diagram for Figure 68 showing CK_PSC, CNT_EN, Timerclock = CK_CNT, Counter register values (0034, 0035, 0036, 0035), Counter overflow, Update event (UEV), and Update interrupt flag (UIF).

This timing diagram illustrates the operation of a timer in center-aligned mode. The top signal, CK_PSC, is a periodic square wave. Below it, CNT_EN is a high-level signal that enables the counter. The Timerclock = CK_CNT signal is a square wave with a frequency that is one-fourth of the CK_PSC frequency. The Counter register shows a sequence of values: 0034, 0035, 0036, and 0035. A 'Counter overflow' pulse occurs when the counter reaches 0036 and rolls over to 0035. Simultaneously, an 'Update event (UEV)' and an 'Update interrupt flag (UIF)' are generated. The diagram is labeled MS31191V2 in the bottom right corner.

Timing diagram for Figure 68 showing CK_PSC, CNT_EN, Timerclock = CK_CNT, Counter register values (0034, 0035, 0036, 0035), Counter overflow, Update event (UEV), and Update interrupt flag (UIF).

Figure 69. Counter timing diagram, internal clock divided by N

Timing diagram for Figure 69 showing CK_PSC, Timerclock = CK_CNT, Counter register values (20, 1F, 01, 00), Counter underflow, Update event (UEV), and Update interrupt flag (UIF).

This timing diagram shows the counter's behavior during an underflow. The CK_PSC signal is a square wave. The Timerclock = CK_CNT signal is derived from CK_PSC and has a frequency divided by N. The Counter register displays values in hexadecimal: 20, 1F, 01, and 00. A 'Counter underflow' occurs as the counter transitions from 01 to 00. At this point, an 'Update event (UEV)' and an 'Update interrupt flag (UIF)' are asserted. The diagram is labeled MS31192V2 in the bottom right corner.

Timing diagram for Figure 69 showing CK_PSC, Timerclock = CK_CNT, Counter register values (20, 1F, 01, 00), Counter underflow, Update event (UEV), and Update interrupt flag (UIF).

Figure 70. Counter timing diagram, update event with ARPE=1 (counter underflow)

Timing diagram for counter underflow with ARPE=1. It shows the relationship between CK_PSC, CEN, Timer clock (CK_CNT), Counter register values (counting down from 06 to 00, then up to 07), Counter overflow, Update event (UEV), Update interrupt flag (UIF), Auto-reload preload register (initially FD, then 36), and Auto-reload active register (initially FD, then 36). An arrow indicates writing a new value in TIMx_ARR.

The diagram shows the following signals and register states over time:

MS31193V3

Timing diagram for counter underflow with ARPE=1. It shows the relationship between CK_PSC, CEN, Timer clock (CK_CNT), Counter register values (counting down from 06 to 00, then up to 07), Counter overflow, Update event (UEV), Update interrupt flag (UIF), Auto-reload preload register (initially FD, then 36), and Auto-reload active register (initially FD, then 36). An arrow indicates writing a new value in TIMx_ARR.

Figure 71. Counter timing diagram, Update event with ARPE=1 (counter overflow)

Timing diagram for counter overflow with ARPE=1. It shows the relationship between CK_PSC, CEN, Timer clock (CK_CNT), Counter register values (counting up from F7 to FC, then from 36 to 2F), Counter overflow, Update event (UEV), Update interrupt flag (UIF), Auto-reload preload register (initially FD, then 36), and Auto-reload active register (initially FD, then 36). An arrow indicates writing a new value in TIMx_ARR.

The diagram shows the following signals and register states over time:

MS31194V2

Timing diagram for counter overflow with ARPE=1. It shows the relationship between CK_PSC, CEN, Timer clock (CK_CNT), Counter register values (counting up from F7 to FC, then from 36 to 2F), Counter overflow, Update event (UEV), Update interrupt flag (UIF), Auto-reload preload register (initially FD, then 36), and Auto-reload active register (initially FD, then 36). An arrow indicates writing a new value in TIMx_ARR.

14.3.3 Repetition counter

Section 14.3.1: Time-base unit describes how the update event (UEV) is generated with respect to the counter overflows/underflows. It is actually generated only when the repetition counter has reached zero. This can be useful when generating PWM signals.

This means that data are transferred from the preload registers to the shadow registers (TIMx_ARR auto-reload register, TIMx_PSC prescaler register, but also TIMx_CCRx capture/compare registers in compare mode) every N+1 counter overflows or underflows, where N is the value in the TIMx_RCR repetition counter register.

The repetition counter is decremented:

    • • At each counter overflow in upcounting mode,
    • • At each counter underflow in downcounting mode,
    • • At each counter overflow and at each counter underflow in center-aligned mode.
  1. Although this limits the maximum number of repetition to 128 PWM cycles, it makes it possible to update the duty cycle twice per PWM period. When refreshing compare registers only once per PWM period in center-aligned mode, maximum resolution is \( 2 \times T_{ck} \) , due to the symmetry of the pattern.

The repetition counter is an auto-reload type; the repetition rate is maintained as defined by the TIMx_RCR register value (refer to Figure 72). When the update event is generated by software (by setting the UG bit in TIMx_EGR register) or by hardware through the slave mode controller, it occurs immediately whatever the value of the repetition counter is and the repetition counter is reloaded with the content of the TIMx_RCR register.

In center-aligned mode, for odd values of RCR, the update event occurs either on the overflow or on the underflow depending on when the RCR register was written and when the counter was started. If the RCR was written before starting the counter, the UEV occurs on the overflow. If the RCR was written after starting the counter, the UEV occurs on the underflow. For example for RCR = 3, the UEV is generated on each 4th overflow or underflow event depending on when RCR was written.

Figure 72. Update rate examples depending on mode and TIMx_RCR register settings

Figure 72: Update rate examples depending on mode and TIMx_RCR register settings. The figure shows waveforms for Counter-aligned and Edge-aligned (Upcounting and Downcounting) modes with various TIMx_RCR values (0, 1, 2, 3, and 3 with re-synchronization). Update events (UEV) are marked with arrows. In Counter-aligned mode with RCR=3 and re-synchronization, the UEV occurs on the underflow (by SW).

The figure illustrates the update rate for different timer modes and repetition counter (TIMx_RCR) settings. It is divided into two main columns: Counter-aligned mode and Edge-aligned mode (which includes Upcounting and Downcounting sub-columns). Rows represent different TIMx_RCR values: 0, 1, 2, 3, and 3 with re-synchronization. Waveforms show the counter (TIMx_CNT) and the resulting PWM signal. Update events (UEV) are indicated by arrows. In Counter-aligned mode with RCR=3 and re-synchronization, the UEV occurs on the underflow (by SW).

Legend:
UEV → Update event: Preload registers transferred to active registers and update interrupt generated
Update Event if the repetition counter underflow occurs when the counter is equal to the auto-reload value

MSv31195V1

Figure 72: Update rate examples depending on mode and TIMx_RCR register settings. The figure shows waveforms for Counter-aligned and Edge-aligned (Upcounting and Downcounting) modes with various TIMx_RCR values (0, 1, 2, 3, and 3 with re-synchronization). Update events (UEV) are marked with arrows. In Counter-aligned mode with RCR=3 and re-synchronization, the UEV occurs on the underflow (by SW).

14.3.4 Clock selection

The counter clock can be provided by the following clock sources:

Internal clock source (CK_INT)

If the slave mode controller is disabled (SMS=000), then the CEN, DIR (in the TIMx_CR1 register) and UG bits (in the TIMx_EGR register) are actual control bits and can be changed only by software (except UG which remains cleared automatically). As soon as the CEN bit is written to 1, the prescaler is clocked by the internal clock CK_INT.

Figure 73 shows the behavior of the control circuit and the upcounter in normal mode, without prescaler.

Figure 73. Control circuit in normal mode, internal clock divided by 1

Timing diagram showing Internal clock, CEN=CNT_EN, UG, CNT_INIT, Counter clock, and Counter register values over time.

The timing diagram illustrates the control circuit and upcounter behavior in normal mode with an internal clock divided by 1. The diagram consists of six horizontal signal lines. The top line, 'Internal clock', shows a continuous square wave. The second line, 'CEN=CNT_EN', is a signal that goes high at the first vertical dashed line. The third line, 'UG', is a signal that goes high at the second vertical dashed line. The fourth line, 'CNT_INIT', is a signal that goes high at the third vertical dashed line. The fifth line, 'Counter clock = CK_CNT = CK_PSC', shows a square wave that starts at the first vertical dashed line. The bottom line, 'Counter register', shows a sequence of values: 31, 32, 33, 34, 35, 36, 00, 01, 02, 03, 04, 05, 06, 07. The values 31 through 36 are shown in individual boxes, followed by a gap, and then 00 through 07 are shown in individual boxes. Vertical dashed lines indicate key timing points: the first line marks the start of counting (CEN goes high), the second line marks the generation of an update (UG goes high), and the third line marks the initialization (CNT_INIT goes high).

Timing diagram showing Internal clock, CEN=CNT_EN, UG, CNT_INIT, Counter clock, and Counter register values over time.

MS31085V2

External clock source mode 1

This mode is selected when SMS=111 in the TIMx_SMCR register. The counter can count at each rising or falling edge on a selected input.

Figure 74. TI2 external clock connection example

Figure 74. TI2 external clock connection example. This block diagram illustrates the internal logic for using the TI2 input as an external clock source. The TI2 input is first processed by a Filter block, which is controlled by the ICF[3:0] bits in the TIMx_CCMR1 register. The filtered signal then enters an Edge detector block, which outputs 'TI2F_Rising' and 'TI2F_Falling' signals. These signals are multiplexed by a 2-to-1 MUX controlled by the CC2P bit in the TIMx_CCER register. The selected signal is then fed into a 4-to-1 MUX that selects the trigger source (TRGI). This MUX is controlled by the TS[2:0] bits in the TIMx_SMCR register, with options for ITRx, TI1_ED, TI1FP1, TI2FP2, and ETRF. The TRGI signal is then passed through another 4-to-1 MUX that selects the clock source (CK_PSC). This MUX is controlled by the ECE and SMS[2:0] bits in the TIMx_SMCR register, with options for TI2F, TI1F, ETRF, and CK_INT (internal clock). The final output is the CK_PSC signal.
Figure 74. TI2 external clock connection example. This block diagram illustrates the internal logic for using the TI2 input as an external clock source. The TI2 input is first processed by a Filter block, which is controlled by the ICF[3:0] bits in the TIMx_CCMR1 register. The filtered signal then enters an Edge detector block, which outputs 'TI2F_Rising' and 'TI2F_Falling' signals. These signals are multiplexed by a 2-to-1 MUX controlled by the CC2P bit in the TIMx_CCER register. The selected signal is then fed into a 4-to-1 MUX that selects the trigger source (TRGI). This MUX is controlled by the TS[2:0] bits in the TIMx_SMCR register, with options for ITRx, TI1_ED, TI1FP1, TI2FP2, and ETRF. The TRGI signal is then passed through another 4-to-1 MUX that selects the clock source (CK_PSC). This MUX is controlled by the ECE and SMS[2:0] bits in the TIMx_SMCR register, with options for TI2F, TI1F, ETRF, and CK_INT (internal clock). The final output is the CK_PSC signal.

For example, to configure the upcounter to count in response to a rising edge on the TI2 input, use the following procedure:

  1. 1. Configure channel 2 to detect rising edges on the TI2 input by writing CC2S = '01' in the TIMx_CCMR1 register.
  2. 2. Configure the input filter duration by writing the IC2F[3:0] bits in the TIMx_CCMR1 register (if no filter is needed, keep IC2F=0000).
  3. 3. Select rising edge polarity by writing CC2P=0 in the TIMx_CCER register.
  4. 4. Configure the timer in external clock mode 1 by writing SMS=111 in the TIMx_SMCR register.
  5. 5. Select TI2 as the trigger input source by writing TS=110 in the TIMx_SMCR register.
  6. 6. Enable the counter by writing CEN=1 in the TIMx_CR1 register.

Note: The capture prescaler is not used for triggering, so the user does not need to configure it.

When a rising edge occurs on TI2, the counter counts once and the TIF flag is set.

The delay between the rising edge on TI2 and the actual clock of the counter is due to the resynchronization circuit on TI2 input.

Figure 75. Control circuit in external clock mode 1

Timing diagram for external clock mode 1 showing TI2, CNT_EN, Counter clock, Counter register, and TIF signals over time.

The diagram shows the relationship between several signals in external clock mode 1. The TI2 signal is a periodic square wave. The CNT_EN signal is a horizontal line indicating the counter is enabled. The Counter clock (CK_CNT = CK_PSC) is a square wave that toggles on the rising edges of TI2. The Counter register shows values 34, 35, and 36, with increments occurring at the rising edges of the counter clock. The TIF signal is shown as a pulse that goes high when the counter overflows (from 36 back to 34) and is cleared by writing TIF=0.

Timing diagram for external clock mode 1 showing TI2, CNT_EN, Counter clock, Counter register, and TIF signals over time.

External clock source mode 2

This mode is selected by writing ECE=1 in the TIMx_SMCR register.

The counter can count at each rising or falling edge on the external trigger input ETR.

Figure 76 gives an overview of the external trigger input block.

Figure 76. External trigger input block

Block diagram of the external trigger input block showing the ETR pin, ETR signal path, divider, filter, and clock selection multiplexer.

The diagram illustrates the external trigger input block. The ETR pin is connected to a buffer and a multiplexer. The multiplexer selects between the ETR pin signal (input 0) and an inverted ETR pin signal (input 1), controlled by the ETP bit in the TIMx_SMCR register. The selected signal passes through a divider (options: /1, /2, /4, /8) controlled by the ETPS[1:0] bits in the TIMx_SMCR register, producing the ETRP signal. This signal then passes through a filter downcounter controlled by the ETF[3:0] bits in the TIMx_SMCR register, producing the ETRF signal. The ETRF signal is one of the inputs to a multiplexer that selects the clock source (CK_PSC). Other inputs to this multiplexer include TI2F falling or rising edges, TI1F falling or rising edges, TRGI falling edges, and the internal clock (CK_INT). The multiplexer is controlled by the ECE and SMS[2:0] bits in the TIMx_SMCR register.

Block diagram of the external trigger input block showing the ETR pin, ETR signal path, divider, filter, and clock selection multiplexer.

For example, to configure the upcounter to count each 2 rising edges on ETR, use the following procedure:

  1. 1. As no filter is needed in this example, write ETF[3:0]=0000 in the TIMx_SMCR register.
  2. 2. Set the prescaler by writing ETPS[1:0]=01 in the TIMx_SMCR register
  3. 3. Select rising edge detection on the ETR pin by writing ETP=0 in the TIMx_SMCR register
  4. 4. Enable external clock mode 2 by writing ECE=1 in the TIMx_SMCR register.
  5. 5. Enable the counter by writing CEN=1 in the TIMx_CR1 register.

The counter counts once each 2 ETR rising edges.

The delay between the rising edge on ETR and the actual clock of the counter is due to the resynchronization circuit on the ETRP signal.

Figure 77. Control circuit in external clock mode 2

Timing diagram for Figure 77 showing control circuit in external clock mode 2. The diagram plots several signals over time: fCK_INT (internal clock), CNT_EN (counter enable), ETR (external trigger), ETRP (resynchronized trigger), ETRF (filtered trigger), Counter clock = CK_INT = CK_PSC (counter clock), and Counter register (showing values 34, 35, 36). The counter increments on every second rising edge of the ETR signal, which is captured by the ETRP signal after a delay. The counter clock is derived from the internal clock fCK_INT. The counter register values shown are 34, 35, and 36, with increments occurring at specific ETR rising edges. MS33111V2 is the reference code.

The timing diagram illustrates the relationship between several signals in external clock mode 2. The signals are plotted from top to bottom: \( f_{CK\_INT} \) (internal clock), CNT_EN (counter enable), ETR (external trigger), ETRP (resynchronized trigger), ETRF (filtered trigger), Counter clock = \( CK\_INT = CK\_PSC \) (counter clock), and Counter register (showing values 34, 35, 36). The counter increments on every second rising edge of the ETR signal, which is captured by the ETRP signal after a delay. The counter clock is derived from the internal clock \( f_{CK\_INT} \) . The counter register values shown are 34, 35, and 36, with increments occurring at specific ETR rising edges. The diagram is labeled MS33111V2 in the bottom right corner.

Timing diagram for Figure 77 showing control circuit in external clock mode 2. The diagram plots several signals over time: fCK_INT (internal clock), CNT_EN (counter enable), ETR (external trigger), ETRP (resynchronized trigger), ETRF (filtered trigger), Counter clock = CK_INT = CK_PSC (counter clock), and Counter register (showing values 34, 35, 36). The counter increments on every second rising edge of the ETR signal, which is captured by the ETRP signal after a delay. The counter clock is derived from the internal clock fCK_INT. The counter register values shown are 34, 35, and 36, with increments occurring at specific ETR rising edges. MS33111V2 is the reference code.

14.3.5 Capture/compare channels

Each Capture/Compare channel is built around a capture/compare register (including a shadow register), a input stage for capture (with digital filter, multiplexing and prescaler) and an output stage (with comparator and output control).

Figure 78 to Figure 81 give an overview of one Capture/Compare channel.

The input stage samples the corresponding TIx input to generate a filtered signal TIxF. Then, an edge detector with polarity selection generates a signal (TIxFPx) which can be used as trigger input by the slave mode controller or as the capture command. It is prescaled before the capture register (ICxPS).

Figure 78. Capture/compare channel (example: channel 1 input stage)

Figure 78: Capture/compare channel (example: channel 1 input stage) block diagram. The diagram shows the input stage for channel 1. TI1 is filtered by a 'Filter downcounter' with ICF[3:0] from TIMx_CCMR1 to produce TI1F. TI1F is then processed by an 'Edge detector' to produce TI1F_Rising and TI1F_Falling signals. These are multiplexed by TI1FP1. TI2F signals from channel 2 are also multiplexed by TI2FP1. TRC from the slave mode controller is multiplexed by IC1. IC1 is then divided by a 'Divider /1, /2, /4, /8' controlled by ICPS[1:0] from TIMx_CCMR1 and CC1E from TIMx_CCER to produce IC1PS. TI1F_ED is sent to the slave mode controller. MS33115V1
Figure 78: Capture/compare channel (example: channel 1 input stage) block diagram. The diagram shows the input stage for channel 1. TI1 is filtered by a 'Filter downcounter' with ICF[3:0] from TIMx_CCMR1 to produce TI1F. TI1F is then processed by an 'Edge detector' to produce TI1F_Rising and TI1F_Falling signals. These are multiplexed by TI1FP1. TI2F signals from channel 2 are also multiplexed by TI2FP1. TRC from the slave mode controller is multiplexed by IC1. IC1 is then divided by a 'Divider /1, /2, /4, /8' controlled by ICPS[1:0] from TIMx_CCMR1 and CC1E from TIMx_CCER to produce IC1PS. TI1F_ED is sent to the slave mode controller. MS33115V1

The output stage generates an intermediate waveform that is then used for reference: OCxRef (active high). The polarity acts at the end of the chain.

Figure 79. Capture/compare channel 1 main circuit

Figure 79: Capture/compare channel 1 main circuit block diagram. The diagram shows the main circuit for channel 1. It includes an APB Bus connected to an MCU-peripheral interface. The interface controls a 'Capture/compare preload register' and a 'Capture/compare shadow register'. The preload register is written via 'write CCR1H' and 'write CCR1L' signals from a write-in-progress logic. The shadow register is updated via 'capture_transfer' and 'compare_transfer' signals. The 'Counter' is compared with the shadow register values in a 'Comparator' to generate CNT>CCR1 and CNT=CCR1 signals. The 'Input mode' is determined by CC1S[1] and CC1S[0]. 'Capture' is triggered by IC1PS and CC1E. 'Output mode' is determined by CC1S[1] and CC1S[0] and OC1PE. OC1PE is generated by a UEV signal from the time base unit and TIMx_CCMR1. MS31089V3
Figure 79: Capture/compare channel 1 main circuit block diagram. The diagram shows the main circuit for channel 1. It includes an APB Bus connected to an MCU-peripheral interface. The interface controls a 'Capture/compare preload register' and a 'Capture/compare shadow register'. The preload register is written via 'write CCR1H' and 'write CCR1L' signals from a write-in-progress logic. The shadow register is updated via 'capture_transfer' and 'compare_transfer' signals. The 'Counter' is compared with the shadow register values in a 'Comparator' to generate CNT>CCR1 and CNT=CCR1 signals. The 'Input mode' is determined by CC1S[1] and CC1S[0]. 'Capture' is triggered by IC1PS and CC1E. 'Output mode' is determined by CC1S[1] and CC1S[0] and OC1PE. OC1PE is generated by a UEV signal from the time base unit and TIMx_CCMR1. MS31089V3

Figure 80. Output stage of capture/compare channel (channel 1 to 3)

Schematic diagram of the output stage for capture/compare channels 1 to 3. It shows the flow from ETRF and CNT registers through an output mode controller and selector to a dead-time generator, then through multiplexers and inverters to output enable circuits for OC1 and OC1N. Various control registers like TIM1_CCMR1, TIM1_BDTR, and TIM1_CCER are shown with their respective bits.

The diagram illustrates the internal logic for channels 1 to 3. Inputs include ETRF, CNT>CCR1, CNT=CCR1, and OCxREF/OC5REF. These pass through an 'Output mode controller' (controlled by OC1CE and OC1M[3:0] from TIM1_CCMR1) and an 'Output selector'. The selector feeds into a 'Dead-time generator' (controlled by DTG[7:0] from TIM1_BDTR), which outputs OC1_DT and OC1N_DT. These signals pass through multiplexers (inputs '0', '01', '11') and inverters. The multiplexers are controlled by CC1P, CC1NE, and CC1E from TIM1_CCER. The outputs then go to 'Output enable circuit' blocks for OC1 and OC1N. These circuits are controlled by CC1NE, CC1E, CC1NP, MOE, OSSI, and OSSR from TIM1_BDTR and TIM1_CCER. A signal 'OC1REFC' is sent to the master mode controller.

Schematic diagram of the output stage for capture/compare channels 1 to 3. It shows the flow from ETRF and CNT registers through an output mode controller and selector to a dead-time generator, then through multiplexers and inverters to output enable circuits for OC1 and OC1N. Various control registers like TIM1_CCMR1, TIM1_BDTR, and TIM1_CCER are shown with their respective bits.

Figure 81. Output stage of capture/compare channel (channel 4)

Schematic diagram of the output stage for capture/compare channel 4. It shows the flow from ETR and CNT registers through an output mode controller and selector to a multiplexer and inverter to an output enable circuit for OC4. Control registers like TIM1_CCMR2, TIM1_BDTR, and TIM1_CCER are shown with their respective bits.

The diagram illustrates the internal logic for channel 4. Inputs include ETR and CNT>CCR4. These pass through an 'Output mode controller' (controlled by OC1M[3:0] from TIM1_CCMR2) and an 'Output selector'. The selector feeds into a multiplexer (inputs '0', '1') and an inverter. The multiplexer is controlled by CC4P from TIM1_CCER. The output then goes to an 'Output enable circuit' for OC4. This circuit is controlled by CC4E from TIM1_CCER, MOE and OSSI from TIM1_BDTR, and OIS4 from TIM1_CR2. A signal 'OC4REF' is sent to the master mode controller.

Schematic diagram of the output stage for capture/compare channel 4. It shows the flow from ETR and CNT registers through an output mode controller and selector to a multiplexer and inverter to an output enable circuit for OC4. Control registers like TIM1_CCMR2, TIM1_BDTR, and TIM1_CCER are shown with their respective bits.

The capture/compare block is made of one preload register and one shadow register. Write and read always access the preload register.

In capture mode, captures are actually done in the shadow register, which is copied into the preload register.

In compare mode, the content of the preload register is copied into the shadow register which is compared to the counter.

14.3.6 Input capture mode

In Input capture mode, the Capture/Compare registers (TIMx_CCRx) are used to latch the value of the counter after a transition detected by the corresponding ICx signal. When a capture occurs, the corresponding CCxIF flag (TIMx_SR register) is set and an interrupt or a DMA request can be sent if they are enabled. If a capture occurs while the CCxIF flag was already high, then the over-capture flag CCxOF (TIMx_SR register) is set. CCxIF can be cleared by software by writing it to '0' or by reading the captured data stored in the TIMx_CCRx register. CCxOF is cleared when written to '0'.

The following example shows how to capture the counter value in TIMx_CCR1 when TI1 input rises. To do this, use the following procedure:

When an input capture occurs:

In order to handle the overcapture, it is recommended to read the data before the overcapture flag. This is to avoid missing an overcapture which could happen after reading the flag and before reading the data.

Note: IC interrupt and/or DMA requests can be generated by software by setting the corresponding CCxG bit in the TIMx_EGR register.

14.3.7 PWM input mode

This mode is a particular case of input capture mode. The procedure is the same except:

For example, user can measure the period (in TIMx_CCR1 register) and the duty cycle (in TIMx_CCR2 register) of the PWM applied on TI1 using the following procedure (depending on CK_INT frequency and prescaler value):

Figure 82. PWM input mode timing

Timing diagram for PWM input mode showing TI1, TIMx_CNT, TIMx_CCR1, and TIMx_CCR2 signals over time. The diagram illustrates the capture of rising and falling edges to measure period and duty cycle.

The timing diagram shows four horizontal lines representing signals over time. The top line is TI1, showing a PWM signal. The second line is TIMx_CNT, showing a counter that increments from 0000 to 0004, then resets to 0000 and increments again. The third line is TIMx_CCR1, which captures the value 0004 at the first rising edge after a reset. The fourth line is TIMx_CCR2, which captures the value 0002 at the first falling edge after a reset. Below the TIMx_CNT line, three annotations with arrows point to specific events: 'IC1 capture, IC2 capture, reset counter' points to the first rising edge; 'IC2 capture pulse width measurement' points to the first falling edge; and 'IC1 capture period measurement' points to the second rising edge. The identifier 'ai15413' is in the bottom right corner.

Timing diagram for PWM input mode showing TI1, TIMx_CNT, TIMx_CCR1, and TIMx_CCR2 signals over time. The diagram illustrates the capture of rising and falling edges to measure period and duty cycle.
  1. 1. The PWM input mode can be used only with the TIMx_CH1/TIMx_CH2 signals due to the fact that only TI1FP1 and TI2FP2 are connected to the slave mode controller.

14.3.8 Forced output mode

In output mode (CCxS bits = 00 in the TIMx_CCMRx register), each output compare signal (OCxREF and then OCx/OCxN) can be forced to active or inactive level directly by software, independently of any comparison between the output compare register and the counter.

To force an output compare signal (OCxREF/OCx) to its active level, the user just needs to write 101 in the OCxM bits in the corresponding TIMx_CCMRx register. Thus OCxREF is forced high (OCxREF is always active high) and OCx get opposite value to CCxP polarity bit.

For example: CCxP=0 (OCx active high) => OCx is forced to high level.

The OCxREF signal can be forced low by writing the OCxM bits to 100 in the TIMx_CCMRx register.

Anyway, the comparison between the TIMx_CCRx shadow register and the counter is still performed and allows the flag to be set. Interrupt and DMA requests can be sent accordingly. This is described in the output compare mode section below.

14.3.9 Output compare mode

This function is used to control an output waveform or indicating when a period of time has elapsed.

When a match is found between the capture/compare register and the counter, the output compare function:

The TIMx_CCRx registers can be programmed with or without preload registers using the OCxPE bit in the TIMx_CCMRx register.

In output compare mode, the update event UEV has no effect on OCxREF and OCx output. The timing resolution is one count of the counter. Output compare mode can also be used to output a single pulse (in One Pulse mode).

Procedure:

  1. 1. Select the counter clock (internal, external, prescaler).
  2. 2. Write the desired data in the TIMx_ARR and TIMx_CCRx registers.
  3. 3. Set the CCxIE bit if an interrupt request is to be generated.
  4. 4. Select the output mode. For example:
    • – Write OCxM = 011 to toggle OCx output pin when CNT matches CCRx
    • – Write OCxPE = 0 to disable preload register
    • – Write CCxP = 0 to select active high polarity
    • – Write CCxE = 1 to enable the output
  5. 5. Enable the counter by setting the CEN bit in the TIMx_CR1 register.

The TIMx_CCRx register can be updated at any time by software to control the output waveform, provided that the preload register is not enabled (OCxPE='0', else TIMx_CCRx shadow register is updated only at the next update event UEV). An example is given in Figure 83 .

Figure 83. Output compare mode, toggle on OC1.

Timing diagram for Output Compare mode on OC1. The diagram shows three horizontal timelines. The top timeline is TIM1_CNT, showing values 0039, 003A, 003B, followed by a dashed section, then B200, and B201. The middle timeline is TIM1_CCR1, showing values 003A and B201. An arrow points from the text 'Write B201h in the CC1R register' to the B201 value in TIM1_CCR1. The bottom timeline is OC1REF= OC1, showing a square wave. The first high-to-low transition occurs when TIM1_CNT reaches 003A. The second low-to-high transition occurs when TIM1_CNT reaches B201. Arrows from these transitions point to the text 'Match detected on CCR1 Interrupt generated if enabled'. The diagram is labeled MS31092V2 in the bottom right corner.
Timing diagram for Output Compare mode on OC1. The diagram shows three horizontal timelines. The top timeline is TIM1_CNT, showing values 0039, 003A, 003B, followed by a dashed section, then B200, and B201. The middle timeline is TIM1_CCR1, showing values 003A and B201. An arrow points from the text 'Write B201h in the CC1R register' to the B201 value in TIM1_CCR1. The bottom timeline is OC1REF= OC1, showing a square wave. The first high-to-low transition occurs when TIM1_CNT reaches 003A. The second low-to-high transition occurs when TIM1_CNT reaches B201. Arrows from these transitions point to the text 'Match detected on CCR1 Interrupt generated if enabled'. The diagram is labeled MS31092V2 in the bottom right corner.

14.3.10 PWM mode

Pulse Width Modulation mode allows generating a signal with a frequency determined by the value of the TIMx_ARR register and a duty cycle determined by the value of the TIMx_CCRx register.

The PWM mode can be selected independently on each channel (one PWM per OCx output) by writing '110' (PWM mode 1) or '111' (PWM mode 2) in the OCxM bits in the TIMx_CCMRx register. The corresponding preload register must be enabled by setting the OCxPE bit in the TIMx_CCMRx register, and eventually the auto-reload preload register (in upcounting or center-aligned modes) by setting the ARPE bit in the TIMx_CR1 register.

As the preload registers are transferred to the shadow registers only when an update event occurs, before starting the counter, the user must initialize all the registers by setting the UG bit in the TIMx_EGR register.

OCx polarity is software programmable using the CCxP bit in the TIMx_CCER register. It can be programmed as active high or active low. OCx output is enabled by a combination of the CCxE, CCxNE, MOE, OSSI and OSSR bits (TIMx_CCER and TIMx_BDTR registers). Refer to the TIMx_CCER register description for more details.

In PWM mode (1 or 2), TIMx_CNT and TIMx_CCRx are always compared to determine whether \( TIMx\_CCRx \leq TIMx\_CNT \) or \( TIMx\_CNT \leq TIMx\_CCRx \) (depending on the direction of the counter).

The timer is able to generate PWM in edge-aligned mode or center-aligned mode depending on the CMS bits in the TIMx_CR1 register.

PWM edge-aligned mode

Upcounting is active when the DIR bit in the TIMx_CR1 register is low. Refer to Upcounting mode .

In the following example, we consider PWM mode 1. The reference PWM signal OCxREF is high as long as \( TIMx\_CNT < TIMx\_CCRx \) else it becomes low. If the compare value in TIMx_CCRx is greater than the auto-reload value (in TIMx_ARR) then OCxREF is held at '1'. If the compare value is 0 then OCxRef is held at '0'.

Figure 84 shows some edge-aligned PWM waveforms in an example where TIMx_ARR=8.

Figure 84. Edge-aligned PWM waveforms (ARR=8)

Timing diagram showing edge-aligned PWM waveforms for different CCRx values (4, 8, >8, 0) relative to a counter register sequence (0-8, 0-1).

The diagram illustrates the relationship between the Counter register values and the resulting PWM signals (OCxREF and CCxIF) for different compare register (CCRx) values. The Counter register sequence is shown at the top: 0, 1, 2, 3, 4, 5, 6, 7, 8, 0, 1. Vertical dashed lines mark the transitions between counter values.

MS31093V1

Timing diagram showing edge-aligned PWM waveforms for different CCRx values (4, 8, >8, 0) relative to a counter register sequence (0-8, 0-1).

Downcounting is active when DIR bit in TIMx_CR1 register is high. Refer to

Downcounting mode

In PWM mode 1, the reference signal OCxRef is low as long as

TIMx_CNT > TIMx_CCRx else it becomes high. If the compare value in TIMx_CCRx is greater than the auto-reload value in TIMx_ARR, then OCxREF is held at '1'. 0% PWM is not possible in this mode.

PWM center-aligned mode

Center-aligned mode is active when the CMS bits in TIMx_CR1 register are different from '00' (all the remaining configurations having the same effect on the OCxRef/OCx signals). The compare flag is set when the counter counts up, when it counts down or both when it counts up and down depending on the CMS bits configuration. The direction bit (DIR) in the TIMx_CR1 register is updated by hardware and must not be changed by software. Refer to Center-aligned mode (up/down counting) .

Figure 85 shows some center-aligned PWM waveforms in an example where:

Figure 85. Center-aligned PWM waveforms (ARR=8)

Timing diagram showing center-aligned PWM waveforms for various CCRx values (4, 7, 8, >8, 0) with ARR=8. The diagram includes counter register values, OCxREF waveforms, and CCxIF flags for different CMS settings.

The figure illustrates the relationship between the counter register values and the resulting PWM waveforms for different capture/compare register (CCRx) values in center-aligned mode with an auto-reload register (ARR) of 8. The counter register values are shown at the top, cycling from 0 to 8 and back down to 0. The OCxREF waveforms show the output state for different CCRx values. The CCxIF flags indicate capture/compare events for different CMS (Capture/Compare Mode Selection) settings.

Timing diagram showing center-aligned PWM waveforms for various CCRx values (4, 7, 8, >8, 0) with ARR=8. The diagram includes counter register values, OCxREF waveforms, and CCxIF flags for different CMS settings.

Hints on using center-aligned mode:

14.3.11 Complementary outputs and dead-time insertion

The advanced-control timers (TIM1 and TIM8) can output two complementary signals and manage the switching-off and the switching-on instants of the outputs.

This time is generally known as dead-time and it has to be adjusted depending on the devices connected to the outputs and their characteristics (intrinsic delays of level-shifters, delays due to power switches...)

User can select the polarity of the outputs (main output OCx or complementary OCxN) independently for each output. This is done by writing to the CCxP and CCxNP bits in the TIMx_CCER register.

The complementary signals OCx and OCxN are activated by a combination of several control bits: the CCxE and CCxNE bits in the TIMx_CCER register and the MOE, OISx, OISxN, OSSI and OSSR bits in the TIMx_BDTR and TIMx_CR2 registers. Refer to Table 83 for more details. In particular, the dead-time is activated when switching to the IDLE state (MOE falling down to 0).

Dead-time insertion is enabled by setting both CCxE and CCxNE bits, and the MOE bit if the break circuit is present. DTG[7:0] bits of the TIMx_BDTR register are used to control the dead-time generation for all channels. From a reference waveform OCxREF, it generates 2 outputs OCx and OCxN. If OCx and OCxN are active high:

If the delay is greater than the width of the active output (OCx or OCxN) then the corresponding pulse is not generated.

The following figures show the relationships between the output signals of the dead-time generator and the reference signal OCxREF. (we suppose CCxP=0, CCxNP=0, MOE=1, CCxE=1 and CCxNE=1 in these examples)

Figure 86. Complementary output with dead-time insertion.

Figure 86: Timing diagram showing OCxREF, OCx, and OCxN waveforms. OCx follows OCxREF but with a delay on the rising edge. OCxN is the inverse of OCxREF but with a delay on its rising edge (which corresponds to the falling edge of OCxREF).

The diagram shows three signal lines: OCxREF, OCx, and OCxN.
1. OCxREF is a square wave that goes high and then low.
2. OCx stays low when OCxREF goes high, then goes high after a 'delay' period. It goes low exactly when OCxREF goes low.
3. OCxN is high while OCxREF is low. When OCxREF goes high, OCxN goes low immediately. When OCxREF goes low, OCxN stays low for a 'delay' period before going high.
Vertical dashed lines indicate the timing alignment, and horizontal double-headed arrows labeled 'delay' show the dead-time insertion. The label MS31095V1 is in the bottom right.

Figure 86: Timing diagram showing OCxREF, OCx, and OCxN waveforms. OCx follows OCxREF but with a delay on the rising edge. OCxN is the inverse of OCxREF but with a delay on its rising edge (which corresponds to the falling edge of OCxREF).

Figure 87. Dead-time waveforms with delay greater than the negative pulse.

Timing diagram for Figure 87 showing dead-time waveforms with delay greater than the negative pulse. The diagram shows three signals: OCxREF, OCx, and OCxN. OCxREF is a periodic signal. OCx is the output signal, which is the complement of OCxREF with a delay. OCxN is the complementary output signal, which is the complement of OCx. The delay is indicated by a horizontal arrow between the falling edge of OCxREF and the falling edge of OCxN. The diagram is labeled MS31096V1.
Timing diagram for Figure 87 showing dead-time waveforms with delay greater than the negative pulse. The diagram shows three signals: OCxREF, OCx, and OCxN. OCxREF is a periodic signal. OCx is the output signal, which is the complement of OCxREF with a delay. OCxN is the complementary output signal, which is the complement of OCx. The delay is indicated by a horizontal arrow between the falling edge of OCxREF and the falling edge of OCxN. The diagram is labeled MS31096V1.

Figure 88. Dead-time waveforms with delay greater than the positive pulse.

Timing diagram for Figure 88 showing dead-time waveforms with delay greater than the positive pulse. The diagram shows three signals: OCxREF, OCx, and OCxN. OCxREF is a periodic signal. OCx is the output signal, which is the complement of OCxREF with a delay. OCxN is the complementary output signal, which is the complement of OCx. The delay is indicated by a horizontal arrow between the rising edge of OCxREF and the rising edge of OCxN. The diagram is labeled MS31097V1.
Timing diagram for Figure 88 showing dead-time waveforms with delay greater than the positive pulse. The diagram shows three signals: OCxREF, OCx, and OCxN. OCxREF is a periodic signal. OCx is the output signal, which is the complement of OCxREF with a delay. OCxN is the complementary output signal, which is the complement of OCx. The delay is indicated by a horizontal arrow between the rising edge of OCxREF and the rising edge of OCxN. The diagram is labeled MS31097V1.

The dead-time delay is the same for each of the channels and is programmable with the DTG bits in the TIMx_BDTR register. Refer to Section 14.4.18: TIM1 and TIM8 break and dead-time register (TIMx_BDTR) for delay calculation.

Re-directing OCxREF to OCx or OCxN

In output mode (forced, output compare or PWM), OCxREF can be re-directed to the OCx output or to OCxN output by configuring the CCxE and CCxNE bits in the TIMx_CCER register.

This allows the user to send a specific waveform (such as PWM or static active level) on one output while the complementary remains at its inactive level. Other possibilities are to have both outputs at inactive level or both outputs active and complementary with dead-time.

Note: When only OCxN is enabled (CCxE=0, CCxNE=1), it is not complemented and becomes active as soon as OCxREF is high. For example, if CCxNP=0 then OCxN=OCxRef. On the other hand, when both OCx and OCxN are enabled (CCxE=CCxNE=1) OCx becomes active when OCxREF is high whereas OCxN is complemented and becomes active when OCxREF is low.

14.3.12 Using the break function

When using the break function, the output enable signals and inactive levels are modified according to additional control bits (MOE, OSSI and OSSR bits in the TIMx_BDTR register, OISx and OISxN bits in the TIMx_CR2 register). In any case, the OCx and OCxN outputs cannot be set both to active level at a given time. Refer to Table 83 for more details.

The break source can be either the break input pin or a clock failure event, generated by the Clock Security System (CSS), from the Reset Clock Controller. For further information on the Clock Security System, refer to Section 7.2.7: Clock security system (CSS) .

When exiting from reset, the break circuit is disabled and the MOE bit is low. User can enable the break function by setting the BKE bit in the TIMx_BDTR register. The break input polarity can be selected by configuring the BKP bit in the same register. BKE and BKP can be modified at the same time. When the BKE and BKP bits are written, a delay of 1 APB clock cycle is applied before the writing is effective. Consequently, it is necessary to wait 1 APB clock period to correctly read back the bit after the write operation.

Because MOE falling edge can be asynchronous, a resynchronization circuit has been inserted between the actual signal (acting on the outputs) and the synchronous control bit (accessed in the TIMx_BDTR register). It results in some delays between the asynchronous and the synchronous signals. In particular, if MOE is written to 1 whereas it was low, a delay (dummy instruction) must be inserted before reading it correctly. This is because the user writes an asynchronous signal, but reads a synchronous signal.

When a break occurs (selected level on the break input):

Note: The break inputs is acting on level. Thus, the MOE cannot be set while the break input is active (neither automatically nor by software). In the meantime, the status flag BIF cannot be cleared.

The break can be generated by the BRK input which has a programmable polarity and an enable bit BKE in the TIMx_BDTR register.

There are two solutions to generate a break:

In addition to the break input and the output management, a write protection has been implemented inside the break circuit to safeguard the application. It allows freezing the configuration of several parameters (dead-time duration, OCx/OCxN polarities and state when disabled, OCxM configurations, break enable and polarity). The user can choose from three levels of protection selected by the LOCK bits in the TIMx_BDTR register. Refer to Section 14.4.18: TIM1 and TIM8 break and dead-time register (TIMx_BDTR) . The LOCK bits can be written only once after an MCU reset.

Figure 89 shows an example of behavior of the outputs in response to a break.

Figure 89. Output behavior in response to a break.

Timing diagram showing output behavior (OCxREF, OCx, OCxN) in response to a break signal (BREAK (MOE ↓)). The diagram illustrates various output states and delays for different timer configurations.

The timing diagram illustrates the behavior of various output pins in response to a break signal (BREAK (MOE ↓)). The diagram is divided into several sections, each showing the state of a specific output pin over time. Vertical dashed lines indicate key time points, with the break signal occurring at the third dashed line.

Timing diagram showing output behavior (OCxREF, OCx, OCxN) in response to a break signal (BREAK (MOE ↓)). The diagram illustrates various output states and delays for different timer configurations.

MS31098V1

14.3.13 Clearing the OCxREF signal on an external event

The OCxREF signal for a given channel can be driven Low by applying a High level to the ETRF input (OCxCE enable bit of the corresponding TIMx_CCMRx register set to '1'). The OCxREF signal remains Low until the next update event, UEV, occurs.

This function can only be used in output compare and PWM modes, and does not work in forced mode.

For example, the ETR signal can be connected to the output of a comparator to be used for current handling. In this case, the ETR must be configured as follow:

  1. 1. The External Trigger Prescaler should be kept off: bits ETPS[1:0] of the TIMx_SMCR register set to '00'.
  2. 2. The external clock mode 2 must be disabled: bit ECE of the TIMx_SMCR register set to '0'.
  3. 3. The External Trigger Polarity (ETP) and the External Trigger Filter (ETF) can be configured according to the user needs.

Figure 90 shows the behavior of the OCxREF signal when the ETRF Input becomes High, for both values of the enable bit OCxCE. In this example, the timer TIMx is programmed in PWM mode.

Figure 90. Clearing TIMx OCxREF

Timing diagram showing the relationship between Counter (CNT), ETRF, and OCxREF signals. The Counter (CNT) is a sawtooth wave. The ETRF signal is a rectangular pulse. The OCxREF signal is shown for two cases: OCxCE = '0' and OCxCE = '1'. When ETRF becomes high, the OCxREF signal (OCxCE = '1') goes low and stays low until the next update event (UEV). The OCxREF signal (OCxCE = '0') remains high. The diagram is labeled with 'ETR becomes high' and 'ETR still high'.

The figure is a timing diagram illustrating the behavior of the OCxREF signal. It contains four horizontal signal lines. The top line, labeled 'Counter (CNT)', shows a sawtooth waveform representing the timer's counter value. The second line, labeled 'ETRF', shows an external trigger signal that goes high at a certain point. The third line, labeled 'OCxREF (OCxCE = '0')', shows the output reference signal when the OCxCE bit is 0; it remains high throughout. The bottom line, labeled 'OCxREF (OCxCE = '1')', shows the output reference signal when the OCxCE bit is 1; it goes low when ETRF becomes high and returns to high at the next update event (UEV), which corresponds to the counter resetting. Two arrows point to the ETRF signal: one at the rising edge labeled 'ETR becomes high' and another later in the high pulse labeled 'ETR still high'. The diagram is identified by the code MSv35889V1 in the bottom right corner.

Timing diagram showing the relationship between Counter (CNT), ETRF, and OCxREF signals. The Counter (CNT) is a sawtooth wave. The ETRF signal is a rectangular pulse. The OCxREF signal is shown for two cases: OCxCE = '0' and OCxCE = '1'. When ETRF becomes high, the OCxREF signal (OCxCE = '1') goes low and stays low until the next update event (UEV). The OCxREF signal (OCxCE = '0') remains high. The diagram is labeled with 'ETR becomes high' and 'ETR still high'.

14.3.14 6-step PWM generation

When complementary outputs are used on a channel, preload bits are available on the OCxM, CCxE and CCxNE bits. The preload bits are transferred to the shadow bits at the COM commutation event. The user can thus program in advance the configuration for the next step and change the configuration of all the channels at the same time. COM can be generated by software by setting the COM bit in the TIMx_EGR register or by hardware (on TRGI rising edge).

A flag is set when the COM event occurs (COMIF bit in the TIMx_SR register), which can generate an interrupt (if the COMIE bit is set in the TIMx_DIER register) or a DMA request (if the COMDE bit is set in the TIMx_DIER register).

Figure 91 describes the behavior of the OCx and OCxN outputs when a COM event occurs, in 3 different examples of programmed configurations.

Figure 91. 6-step generation, COM example (OSSR=1)

Timing diagram showing counter (CNT), OCxREF, COM event, and three examples of OCx and OCxN output behaviors over time. The diagram illustrates how software writes to configuration registers (OCxM, CCxNE) before a COM event to change output states.

The timing diagram shows the relationship between the timer counter (CNT), the OCxREF signal, a COM event, and three examples of OCx and OCxN output behaviors.

ai14910

Timing diagram showing counter (CNT), OCxREF, COM event, and three examples of OCx and OCxN output behaviors over time. The diagram illustrates how software writes to configuration registers (OCxM, CCxNE) before a COM event to change output states.

14.3.15 One-pulse mode

One-pulse mode (OPM) is a particular case of the previous modes. It allows the counter to be started in response to a stimulus and to generate a pulse with a programmable length after a programmable delay.

Starting the counter can be controlled through the slave mode controller. Generating the waveform can be done in output compare mode or PWM mode. Select One-pulse mode by setting the OPM bit in the TIMx_CR1 register. This makes the counter stop automatically at the next update event UEV.

A pulse can be correctly generated only if the compare value is different from the counter initial value. Before starting (when the timer is waiting for the trigger), the configuration must be:

Figure 92. Example of one pulse mode.

Timing diagram for one-pulse mode. The diagram shows four waveforms over time (t). 1. TI2: A positive edge-trigger signal. 2. OC1REF: The reference output signal, which is high before the pulse and low after. 3. OC1: The output signal, which goes high at t_DELAY and low at t_DELAY + t_PULSE. 4. Counter: A sawtooth-like waveform starting at 0, increasing linearly to TIM1_ARR, then jumping back to TIM1_CCR1 and continuing to increase. The time from the TI2 rising edge to the start of the counter ramp is t_DELAY. The time from the start of the counter ramp to the end of the OC1 pulse is t_PULSE. The diagram is labeled MS31099V2.
Timing diagram for one-pulse mode. The diagram shows four waveforms over time (t). 1. TI2: A positive edge-trigger signal. 2. OC1REF: The reference output signal, which is high before the pulse and low after. 3. OC1: The output signal, which goes high at t_DELAY and low at t_DELAY + t_PULSE. 4. Counter: A sawtooth-like waveform starting at 0, increasing linearly to TIM1_ARR, then jumping back to TIM1_CCR1 and continuing to increase. The time from the TI2 rising edge to the start of the counter ramp is t_DELAY. The time from the start of the counter ramp to the end of the OC1 pulse is t_PULSE. The diagram is labeled MS31099V2.

For example the user may want to generate a positive pulse on OC1 with a length of \( t_{PULSE} \) and after a delay of \( t_{DELAY} \) as soon as a positive edge is detected on the TI2 input pin.

Let's use TI2FP2 as trigger 1:

The OPM waveform is defined by writing the compare registers (taking into account the clock frequency and the counter prescaler).

auto-reload value. To do this, enable PWM mode 2 by writing OC1M=111 in the TIMx_CCMR1 register. The user can optionally enable the preload registers by writing OC1PE='1' in the TIMx_CCMR1 register and ARPE in the TIMx_CR1 register. In this case the compare value must be written in the TIMx_CCR1 register, the auto-reload value in the TIMx_ARR register, generate an update by setting the UG bit and wait for external trigger event on TI2. CC1P is written to '0' in this example.

In our example, the DIR and CMS bits in the TIMx_CR1 register should be low.

The user only wants one pulse (Single mode), so '1' must be written in the OPM bit in the TIMx_CR1 register to stop the counter at the next update event (when the counter rolls over from the auto-reload value back to 0). When OPM bit in the TIMx_CR1 register is set to '0', so the Repetitive Mode is selected.

Particular case: OCx fast enable:

In One-pulse mode, the edge detection on TIx input set the CEN bit which enables the counter. Then the comparison between the counter and the compare value makes the output toggle. But several clock cycles are needed for these operations and it limits the minimum delay \( t_{DELAY\ min} \) we can get.

If the user wants to output a waveform with the minimum delay, the OCxFE bit in the TIMx_CCMRx register must be set. Then OCxRef (and OCx) are forced in response to the stimulus, without taking in account the comparison. Its new level is the same as if a compare match had occurred. OCxFE acts only if the channel is configured in PWM1 or PWM2 mode.

14.3.16 Encoder interface mode

To select Encoder Interface mode write SMS='001' in the TIMx_SMCR register if the counter is counting on TI2 edges only, SMS='010' if it is counting on TI1 edges only and SMS='011' if it is counting on both TI1 and TI2 edges.

Select the TI1 and TI2 polarity by programming the CC1P and CC2P bits in the TIMx_CCER register. When needed, the user can program the input filter as well.

The two inputs TI1 and TI2 are used to interface to an incremental encoder. Refer to Table 81 . The counter is clocked by each valid transition on TI1FP1 or TI2FP2 (TI1 and TI2 after input filter and polarity selection, TI1FP1=TI1 if not filtered and not inverted, TI2FP2=TI2 if not filtered and not inverted) assuming that it is enabled (CEN bit in TIMx_CR1 register written to '1'). The sequence of transitions of the two inputs is evaluated and generates count pulses as well as the direction signal. Depending on the sequence the counter counts up or down, the DIR bit in the TIMx_CR1 register is modified by hardware accordingly. The DIR bit is calculated at each transition on any input (TI1 or TI2), whatever the counter is counting on TI1 only, TI2 only or both TI1 and TI2.

Encoder interface mode acts simply as an external clock with direction selection. This means that the counter just counts continuously between 0 and the auto-reload value in the TIMx_ARR register (0 to ARR or ARR down to 0 depending on the direction). So user must configure TIMx_ARR before starting. In the same way, the capture, compare, prescaler, repetition counter, trigger output features continue to work as normal. Encoder mode and External clock mode 2 are not compatible and must not be selected together.

In this mode, the counter is modified automatically following the speed and the direction of the incremental encoder and its content, therefore, always represents the encoder's position. The count direction correspond to the rotation direction of the connected sensor.

Table 81 summarizes the possible combinations, assuming TI1 and TI2 do not switch at the same time.

Table 81. Counting direction versus encoder signals

Active edgeLevel on opposite signal
(TI1FP1 for TI2, TI2FP2 for TI1)
TI1FP1 signalTI2FP2 signal
RisingFallingRisingFalling
Counting on
TI1 only
HighDownUpNo CountNo Count
LowUpDownNo CountNo Count
Counting on
TI2 only
HighNo CountNo CountUpDown
LowNo CountNo CountDownUp
Counting on
TI1 and TI2
HighDownUpUpDown
LowUpDownDownUp

An external incremental encoder can be connected directly to the MCU without external interface logic. However, comparators are normally used to convert the encoder's differential outputs to digital signals. This greatly increases noise immunity. The third encoder output which indicate the mechanical zero position, may be connected to an external interrupt input and trigger a counter reset.

Figure 93 gives an example of counter operation, showing count signal generation and direction control. It also shows how input jitter is compensated where both edges are selected. This might occur if the sensor is positioned near to one of the switching points. For this example we assume that the configuration is the following:

Figure 93. Example of counter operation in encoder interface mode.

Timing diagram for Figure 93 showing counter operation in encoder interface mode. The diagram displays three waveforms over time: TI1, TI2, and Counter. The TI1 and TI2 signals are square waves representing encoder outputs. The Counter waveform is a staircase-like signal that increases ('up') during the 'forward' phase, decreases ('down') during the 'backward' phase, and remains constant during 'jitter' phases. The phases are labeled at the top: forward, jitter, backward, jitter, forward. The counter value is shown as a series of steps. The diagram is labeled MS33107V1 in the bottom right corner.
Timing diagram for Figure 93 showing counter operation in encoder interface mode. The diagram displays three waveforms over time: TI1, TI2, and Counter. The TI1 and TI2 signals are square waves representing encoder outputs. The Counter waveform is a staircase-like signal that increases ('up') during the 'forward' phase, decreases ('down') during the 'backward' phase, and remains constant during 'jitter' phases. The phases are labeled at the top: forward, jitter, backward, jitter, forward. The counter value is shown as a series of steps. The diagram is labeled MS33107V1 in the bottom right corner.

Figure 94 gives an example of counter behavior when TI1FP1 polarity is inverted (same configuration as above except CC1P=‘1’).

Figure 94. Example of encoder interface mode with TI1FP1 polarity inverted.

Timing diagram for Figure 94 showing encoder interface mode with TI1FP1 polarity inverted. The diagram displays three waveforms over time: TI1, TI2, and Counter. The TI1 and TI2 signals are square waves. The Counter waveform is a staircase-like signal that decreases ('down') during the 'forward' phase, increases ('up') during the 'backward' phase, and remains constant during 'jitter' phases. The phases are labeled at the top: forward, jitter, backward, jitter, forward. The counter value is shown as a series of steps. The diagram is labeled MS33108V1 in the bottom right corner.
Timing diagram for Figure 94 showing encoder interface mode with TI1FP1 polarity inverted. The diagram displays three waveforms over time: TI1, TI2, and Counter. The TI1 and TI2 signals are square waves. The Counter waveform is a staircase-like signal that decreases ('down') during the 'forward' phase, increases ('up') during the 'backward' phase, and remains constant during 'jitter' phases. The phases are labeled at the top: forward, jitter, backward, jitter, forward. The counter value is shown as a series of steps. The diagram is labeled MS33108V1 in the bottom right corner.

The timer, when configured in Encoder Interface mode provides information on the sensor’s current position. The user can obtain dynamic information (speed, acceleration, deceleration) by measuring the period between two encoder events using a second timer configured in capture mode. The output of the encoder which indicates the mechanical zero can be used for this purpose. Depending on the time between two events, the counter can also be read at regular times. This can be done by latching the counter value into a third input capture register if available (then the capture signal must be periodic and can be generated by another timer). When available, it is also possible to read its value through a DMA request generated by a real-time clock.

14.3.17 Timer input XOR function

The TI1S bit in the TIMx_CR2 register, allows the input filter of channel 1 to be connected to the output of a XOR gate, combining the three input pins TIMx_CH1, TIMx_CH2 and TIMx_CH3.

The XOR output can be used with all the timer input functions such as trigger or input capture. An example of this feature used to interface Hall sensors is given in Section 14.3.18 .

14.3.18 Interfacing with Hall sensors

This is done using the advanced-control timers (TIM1 or TIM8) to generate PWM signals to drive the motor and another timer TIMx (TIM2, TIM3, TIM4 or TIM5) referred to as “interfacing timer” in Figure 95 . The “interfacing timer” captures the 3 timer input pins (TIMx_CH1, TIMx_CH2, and TIMx_CH3) connected through a XOR to the TI1 input channel (selected by setting the TI1S bit in the TIMx_CR2 register).

The slave mode controller is configured in reset mode; the slave input is TI1F_ED. Thus, each time one of the 3 inputs toggles, the counter restarts counting from 0. This creates a time base triggered by any change on the Hall inputs.

On the “interfacing timer”, capture/compare channel 1 is configured in capture mode, capture signal is TRC (see Figure 78 ). The captured value, which corresponds to the time elapsed between 2 changes on the inputs, gives information about motor speed.

The “interfacing timer” can be used in output mode to generate a pulse which changes the configuration of the channels of the advanced-control timer (TIM1 or TIM8) (by triggering a COM event). The TIM1 timer is used to generate PWM signals to drive the motor. To do this, the interfacing timer channel must be programmed so that a positive pulse is generated after a programmed delay (in output compare or PWM mode). This pulse is sent to the advanced-control timer (TIM1 or TIM8) through the TRGO output.

Example: the user wants to change the PWM configuration of the advanced-control timer TIM1 after a programmed delay each time a change occurs on the Hall inputs connected to one of the TIMx timers.

In the advanced-control timer TIM1, the right ITR input must be selected as trigger input, the timer is programmed to generate PWM signals, the capture/compare control signals are preloaded (CCPC=1 in the TIMx_CR2 register) and the COM event is controlled by the trigger input (CCUS=1 in the TIMx_CR2 register). The PWM control bits (CCxE, OCxM) are written after a COM event for the next step (this can be done in an interrupt subroutine generated by the rising edge of OC2REF).

Figure 95 describes this example.

Figure 95. Example of Hall sensor interface

Timing diagram for Hall sensor interface showing signals TIH1, TIH2, TIH3, Counter (CNT), CCR1, TRGO=OC2REF, COM, OC1, OC1N, OC2, OC2N, OC3, and OC3N over time. The diagram illustrates the relationship between Hall sensor inputs, the counter, and output compare signals for motor control.

The timing diagram illustrates the operation of a Hall sensor interface using advanced-control timers. The signals are categorized into two groups:

At the bottom of the diagram, eight arrows point to specific time intervals following each Hall sensor transition with the text: "Write CCxE, CCxNE and OCxM for next step". These indicate the software update window for the next commutation step.

ai17335b

Timing diagram for Hall sensor interface showing signals TIH1, TIH2, TIH3, Counter (CNT), CCR1, TRGO=OC2REF, COM, OC1, OC1N, OC2, OC2N, OC3, and OC3N over time. The diagram illustrates the relationship between Hall sensor inputs, the counter, and output compare signals for motor control.

14.3.19 TIMx and external trigger synchronization

The TIMx timer can be synchronized with an external trigger in several modes: Reset mode, Gated mode and Trigger mode.

Slave mode: Reset mode

The counter and its prescaler can be reinitialized in response to an event on a trigger input. Moreover, if the URS bit from the TIMx_CR1 register is low, an update event UEV is generated. Then all the preloaded registers (TIMx_ARR, TIMx_CCRx) are updated.

In the following example, the upcounter is cleared in response to a rising edge on TI1 input:

The counter starts counting on the internal clock, then behaves normally until TI1 rising edge. When TI1 rises, the counter is cleared and restarts from 0. In the meantime, the trigger flag is set (TIF bit in the TIMx_SR register) and an interrupt request, or a DMA request can be sent if enabled (depending on the TIE and TDE bits in TIMx_DIER register).

The following figure shows this behavior when the auto-reload register TIMx_ARR=0x36. The delay between the rising edge on TI1 and the actual reset of the counter is due to the resynchronization circuit on TI1 input.

Figure 96. Control circuit in reset mode

Timing diagram for Figure 96. Control circuit in reset mode. The diagram shows five waveforms over time. 1. TI1: A digital signal that goes high, then low, then high again. 2. UG: A pulse that goes high when TI1 rises. 3. Counter clock = CK_CNT = CK_PSC: A periodic square wave. 4. Counter register: A sequence of values starting at 30, increasing by 1 each clock cycle to 36, then jumping to 00, 01, 02, 03. 5. TIF: A pulse that goes high when the counter resets to 00. Vertical dashed lines indicate the timing relationship between the TI1 rising edge, the UG pulse, the counter reset, and the TIF pulse. The text MS31401V3 is in the bottom right corner.
Timing diagram for Figure 96. Control circuit in reset mode. The diagram shows five waveforms over time. 1. TI1: A digital signal that goes high, then low, then high again. 2. UG: A pulse that goes high when TI1 rises. 3. Counter clock = CK_CNT = CK_PSC: A periodic square wave. 4. Counter register: A sequence of values starting at 30, increasing by 1 each clock cycle to 36, then jumping to 00, 01, 02, 03. 5. TIF: A pulse that goes high when the counter resets to 00. Vertical dashed lines indicate the timing relationship between the TI1 rising edge, the UG pulse, the counter reset, and the TIF pulse. The text MS31401V3 is in the bottom right corner.

Slave mode: Gated mode

The counter can be enabled depending on the level of a selected input.

In the following example, the upcounter counts only when TI1 input is low:

The counter starts counting on the internal clock as long as TI1 is low and stops as soon as TI1 becomes high. The TIF flag in the TIMx_SR register is set both when the counter starts or stops.

The delay between the rising edge on TI1 and the actual stop of the counter is due to the resynchronization circuit on TI1 input.

Figure 97. Control circuit in gated mode

Timing diagram for Figure 97. Control circuit in gated mode. The diagram shows five waveforms over time. 1. TI1: A signal that starts high, goes low, then high again, then low, and finally high. 2. CNT_EN: Counter enable signal, which is high when TI1 is low. 3. Counter clock = ck_cnt = ck_psc: A periodic square wave that is active only when CNT_EN is high. 4. Counter register: Shows the count values. It starts at 30 when TI1 goes low, increments to 31, 32, 33, and then 34. When TI1 goes high, the count stops at 34. When TI1 goes low again, it resumes at 35, 36, 37, 38. 5. TIF: Interrupt flag, which is set (pulses high) at the falling edge of TI1 (when counter starts) and at the rising edge of TI1 (when counter stops). Arrows labeled 'Write TIF=0' point to the rising edges of the TIF signal.

Timing diagram showing the control circuit in gated mode. The diagram illustrates the relationship between the TI1 input, the counter enable (CNT_EN), the counter clock (ck_cnt = ck_psc), the counter register values, and the TIF flag. The counter starts counting when TI1 is low and stops when TI1 is high. The TIF flag is set when the counter starts or stops. The counter register values shown are 30, 31, 32, 33, 34, 35, 36, 37, 38. The counter clock is active only when CNT_EN is high. The TIF flag is set when the counter starts or stops. The counter register values are shown in a sequence: 30, 31, 32, 33, 34, 35, 36, 37, 38. The counter starts at 30 when TI1 goes low, increments to 31, 32, 33, and then 34. When TI1 goes high, the count stops at 34. When TI1 goes low again, it resumes at 35, 36, 37, 38. The TIF flag is set at the falling edge of TI1 (when counter starts) and at the rising edge of TI1 (when counter stops). Arrows labeled 'Write TIF=0' point to the rising edges of the TIF signal.

Timing diagram for Figure 97. Control circuit in gated mode. The diagram shows five waveforms over time. 1. TI1: A signal that starts high, goes low, then high again, then low, and finally high. 2. CNT_EN: Counter enable signal, which is high when TI1 is low. 3. Counter clock = ck_cnt = ck_psc: A periodic square wave that is active only when CNT_EN is high. 4. Counter register: Shows the count values. It starts at 30 when TI1 goes low, increments to 31, 32, 33, and then 34. When TI1 goes high, the count stops at 34. When TI1 goes low again, it resumes at 35, 36, 37, 38. 5. TIF: Interrupt flag, which is set (pulses high) at the falling edge of TI1 (when counter starts) and at the rising edge of TI1 (when counter stops). Arrows labeled 'Write TIF=0' point to the rising edges of the TIF signal.

Slave mode: Trigger mode

The counter can start in response to an event on a selected input.

In the following example, the upcounter starts in response to a rising edge on TI2 input:

When a rising edge occurs on TI2, the counter starts counting on the internal clock and the TIF flag is set.

The delay between the rising edge on TI2 and the actual start of the counter is due to the resynchronization circuit on TI2 input.

Figure 98. Control circuit in trigger mode

Timing diagram for Figure 98. Control circuit in trigger mode. The diagram shows five signals over time: TI2, CNT_EN, Counter clock (ck_cnt = ck_psc), Counter register, and TIF. TI2 shows a rising edge. CNT_EN goes high at the rising edge of TI2. Counter clock is a periodic square wave. Counter register shows values 34, 35, 36, 37, 38. TIF goes high at the rising edge of TI2 and returns low after a short delay. The diagram is labeled MS31403V2.
Timing diagram for Figure 98. Control circuit in trigger mode. The diagram shows five signals over time: TI2, CNT_EN, Counter clock (ck_cnt = ck_psc), Counter register, and TIF. TI2 shows a rising edge. CNT_EN goes high at the rising edge of TI2. Counter clock is a periodic square wave. Counter register shows values 34, 35, 36, 37, 38. TIF goes high at the rising edge of TI2 and returns low after a short delay. The diagram is labeled MS31403V2.

Slave mode: external clock mode 2 + trigger mode

The external clock mode 2 can be used in addition to another slave mode (except external clock mode 1 and encoder mode). In this case, the ETR signal is used as external clock input, and another input can be selected as trigger input (in reset mode, gated mode or trigger mode). It is recommended not to select ETR as TRGI through the TS bits of TIMx_SMCR register.

In the following example, the upcounter is incremented at each rising edge of the ETR signal as soon as a rising edge of TI1 occurs:

  1. Configure the external trigger input circuit by programming the TIMx_SMCR register as follows:
    • – ETF = 0000: no filter
    • – ETPS = 00: prescaler disabled
    • – ETP = 0: detection of rising edges on ETR and ECE=1 to enable the external clock mode 2.
  2. Configure the channel 1 as follows, to detect rising edges on TI1:
    • – IC1F=0000: no filter.
    • – The capture prescaler is not used for triggering and does not need to be configured.
    • – CC1S=01 in TIMx_CCMR1 register to select only the input capture source
    • – CC1P=0 in TIMx_CCER register to validate the polarity (and detect rising edge only).
    1. Configure the timer in trigger mode by writing SMS=110 in TIMx_SMCR register. Select TI1 as the input source by writing TS=101 in TIMx_SMCR register.

A rising edge on TI1 enables the counter and sets the TIF flag. The counter then counts on ETR rising edges.

The delay between the rising edge of the ETR signal and the actual reset of the counter is due to the resynchronization circuit on ETRP input.

Figure 99. Control circuit in external clock mode 2 + trigger mode

Timing diagram for Figure 99 showing the relationship between TI1, CEN/CNT_EN, ETR, Counter clock, Counter register, and TIF signals. The diagram shows that a rising edge on TI1 enables the counter (CEN/CNT_EN goes high) and sets the TIF flag. The counter then counts on ETR rising edges. The counter register values shown are 34, 35, and 36. The counter clock is CK_CNT = CK_PSC. The diagram is labeled MS33110V1.

The timing diagram illustrates the control circuit in external clock mode 2 + trigger mode. It shows the following signals over time:

The diagram is labeled MS33110V1.

Timing diagram for Figure 99 showing the relationship between TI1, CEN/CNT_EN, ETR, Counter clock, Counter register, and TIF signals. The diagram shows that a rising edge on TI1 enables the counter (CEN/CNT_EN goes high) and sets the TIF flag. The counter then counts on ETR rising edges. The counter register values shown are 34, 35, and 36. The counter clock is CK_CNT = CK_PSC. The diagram is labeled MS33110V1.

14.3.20 Timer synchronization

The TIM timers are linked together internally for timer synchronization or chaining. Refer to Section 15.3.15: Timer synchronization for details.

Note: The clock of the slave timer must be enabled prior to receive events from the master timer, and must not be changed on-the-fly while triggers are received from the master timer.

14.3.21 Debug mode

When the microcontroller enters debug mode (Cortex ® -M3 core halted), the TIMx counter either continues to work normally or stops, depending on DBG_TIMx_STOP configuration bit in DBG module. For more details, refer to Section 31.16.2: Debug support for timers, watchdog, bxCAN and I 2 C .

For safety purposes, when the counter is stopped (DBG_TIMx_STOP = 1 in DBGMCU_APBx_FZ register), the outputs are disabled (as if the MOE bit was reset). The outputs can either be forced to an inactive state (OSSI bit = 1), or have their control taken over by the GPIO controller (OSSI bit = 0) to force them to Hi-Z.

14.4 TIM1 and TIM8 registers

Refer to Section 2.2 for a list of abbreviations used in register descriptions.

The peripheral registers can be accessed by half-words (16-bit) or words (32-bit).

14.4.1 TIM1 and TIM8 control register 1 (TIMx_CR1)

Address offset: 0x00

Reset value: 0x0000

1514131211109876543210
ReservedCKD[1:0]ARPECMS[1:0]DIROPMURSUDIS
rwrwrwrwrwrwrwrwCEN

Bits 15:10 Reserved, must be kept at reset value.

Bits 9:8 CKD[1:0] : Clock division

This bit-field indicates the division ratio between the timer clock (CK_INT) frequency and the dead-time and sampling clock ( \( t_{DTS} \) ) used by the dead-time generators and the digital filters (ETR, TIx),

00: \( t_{DTS}=t_{CK\_INT} \)

01: \( t_{DTS}=2*t_{CK\_INT} \)

10: \( t_{DTS}=4*t_{CK\_INT} \)

11: Reserved, do not program this value

Bit 7 ARPE : Auto-reload preload enable

0: TIMx_ARR register is not buffered

1: TIMx_ARR register is buffered

Bits 6:5 CMS[1:0] : Center-aligned mode selection

00: Edge-aligned mode. The counter counts up or down depending on the direction bit (DIR).

01: Center-aligned mode 1. The counter counts up and down alternatively. Output compare interrupt flags of channels configured in output (CCxS=00 in TIMx_CCMRx register) are set only when the counter is counting down.

10: Center-aligned mode 2. The counter counts up and down alternatively. Output compare interrupt flags of channels configured in output (CCxS=00 in TIMx_CCMRx register) are set only when the counter is counting up.

11: Center-aligned mode 3. The counter counts up and down alternatively. Output compare interrupt flags of channels configured in output (CCxS=00 in TIMx_CCMRx register) are set both when the counter is counting up or down.

Note: It is not allowed to switch from edge-aligned mode to center-aligned mode as long as the counter is enabled (CEN=1)

Bit 4 DIR : Direction

0: Counter used as upcounter

1: Counter used as downcounter

Note: This bit is read only when the timer is configured in Center-aligned mode or Encoder mode.

Bit 3 OPM : One pulse mode

0: Counter is not stopped at update event

1: Counter stops counting at the next update event (clearing the bit CEN)

Bit 2 URS : Update request source

This bit is set and cleared by software to select the UEV event sources.

0: Any of the following events generate an update interrupt or DMA request if enabled.

These events can be:

1: Only counter overflow/underflow generates an update interrupt or DMA request if enabled.

Bit 1 UDIS : Update disable

This bit is set and cleared by software to enable/disable UEV event generation.

0: UEV enabled. The Update (UEV) event is generated by one of the following events:

Buffered registers are then loaded with their preload values.

1: UEV disabled. The Update event is not generated, shadow registers keep their value (ARR, PSC, CCRx). However the counter and the prescaler are reinitialized if the UG bit is set or if a hardware reset is received from the slave mode controller.

Bit 0 CEN : Counter enable

0: Counter disabled

1: Counter enabled

Note: External clock, gated mode and encoder mode can work only if the CEN bit has been previously set by software. However trigger mode can set the CEN bit automatically by hardware.

14.4.2 TIM1 and TIM8 control register 2 (TIMx_CR2)

Address offset: 0x04

Reset value: 0x0000

1514131211109876543210
Res.OIS4OIS3NOIS3OIS2NOIS2OIS1NOIS1TI1SMMS[2:0]CCDSCCUSRes.CCPC
rwrwrwrwrwrwrwrwrwrwrwrwrwrw

Bit 15 Reserved, must be kept at reset value.

Bit 14 OIS4 : Output Idle state 4 (OC4 output)
refer to OIS1 bit

Bit 13 OIS3N : Output Idle state 3 (OC3N output)
refer to OIS1N bit

Bit 12 OIS3 : Output Idle state 3 (OC3 output)
refer to OIS1 bit

Bit 11 OIS2N : Output Idle state 2 (OC2N output)
refer to OIS1N bit

Bit 10 OIS2 : Output Idle state 2 (OC2 output)
refer to OIS1 bit

Bit 9 OIS1N : Output Idle state 1 (OC1N output)

0: OC1N=0 after a dead-time when MOE=0

1: OC1N=1 after a dead-time when MOE=0

Note: This bit can not be modified as long as LOCK level 1, 2 or 3 has been programmed (LOCK bits in TIMx_BDTR register).

Bit 8 OIS1 : Output Idle state 1 (OC1 output)

0: OC1=0 (after a dead-time if OC1N is implemented) when MOE=0

1: OC1=1 (after a dead-time if OC1N is implemented) when MOE=0

Note: This bit can not be modified as long as LOCK level 1, 2 or 3 has been programmed (LOCK bits in TIMx_BDTR register).

Bit 7 TI1S : TI1 selection

0: The TIMx_CH1 pin is connected to TI1 input

1: The TIMx_CH1, CH2 and CH3 pins are connected to the TI1 input (XOR combination)

Bits 6:4 MMS[2:0] : Master mode selection

These bits allow to select the information to be sent in master mode to slave timers for synchronization (TRGO). The combination is as follows:

000: Reset - the UG bit from the TIMx_EGR register is used as trigger output (TRGO). If the reset is generated by the trigger input (slave mode controller configured in reset mode) then the signal on TRGO is delayed compared to the actual reset.

001: Enable - the Counter Enable signal CNT_EN is used as trigger output (TRGO). It is useful to start several timers at the same time or to control a window in which a slave timer is enable. The Counter Enable signal is generated by a logic OR between CEN control bit and the trigger input when configured in gated mode. When the Counter Enable signal is controlled by the trigger input, there is a delay on TRGO, except if the master/slave mode is selected (see the MSM bit description in TIMx_SMCR register).

010: Update - The update event is selected as trigger output (TRGO). For instance a master timer can then be used as a prescaler for a slave timer.

011: Compare Pulse - The trigger output send a positive pulse when the CC1IF flag is to be set (even if it was already high), as soon as a capture or a compare match occurred. (TRGO).

100: Compare - OC1REF signal is used as trigger output (TRGO)

101: Compare - OC2REF signal is used as trigger output (TRGO)

110: Compare - OC3REF signal is used as trigger output (TRGO)

111: Compare - OC4REF signal is used as trigger output (TRGO)

Note: The clock of the slave timer and ADC must be enabled prior to receiving events from the master timer, and must not be changed on-the-fly while triggers are received from the master timer.

Bit 3 CCDS : Capture/compare DMA selection

0: CCx DMA request sent when CCx event occurs

1: CCx DMA requests sent when update event occurs

Bit 2 CCUS : Capture/compare control update selection

0: When capture/compare control bits are preloaded (CCPC=1), they are updated by setting the COMG bit only

1: When capture/compare control bits are preloaded (CCPC=1), they are updated by setting the COMG bit or when an rising edge occurs on TRGI

Note: This bit acts only on channels that have a complementary output.

Bit 1 Reserved, must be kept at reset value.

Bit 0 CCPC : Capture/compare preloaded control

0: CCxE, CCxNE and OCxM bits are not preloaded

1: CCxE, CCxNE and OCxM bits are preloaded, after having been written, they are updated only when a commutation event (COM) occurs (COMG bit set or rising edge detected on TRGI, depending on the CCUS bit).

Note: This bit acts only on channels that have a complementary output.

14.4.3 TIM1 and TIM8 slave mode control register (TIMx_SMCR)

Address offset: 0x08

Reset value: 0x0000

1514131211109876543210
ETPECEETPS[1:0]ETF[3:0]MSMTS[2:0]Res.SMS[2:0]
rwrwrwrwrwrwrwrwrwrwrwrwRes.rwrwrw

Bit 15 ETP : External trigger polarity

This bit selects whether ETR or E TR is used for trigger operations

0: ETR is non-inverted, active at high level or rising edge.

1: ETR is inverted, active at low level or falling edge.

Bit 14 ECE : External clock enable

This bit enables External clock mode 2.

0: External clock mode 2 disabled

1: External clock mode 2 enabled. The counter is clocked by any active edge on the ETRF signal.

Note: 1: Setting the ECE bit has the same effect as selecting external clock mode 1 with TRGI connected to ETRF (SMS=111 and TS=111).

2: It is possible to simultaneously use external clock mode 2 with the following slave modes: reset mode, gated mode and trigger mode. Nevertheless, TRGI must not be connected to ETRF in this case (TS bits must not be 111).

3: If external clock mode 1 and external clock mode 2 are enabled at the same time, the external clock input is ETRF.

Bits 13:12 ETPS[1:0] : External trigger prescaler

External trigger signal ETRP frequency must be at most 1/4 of TIMxCLK frequency. A prescaler can be enabled to reduce ETRP frequency. It is useful when inputting fast external clocks.

00: Prescaler OFF

01: ETRP frequency divided by 2

10: ETRP frequency divided by 4

11: ETRP frequency divided by 8

Bits 11:8 ETF[3:0] : External trigger filter

This bit-field then defines the frequency used to sample ETRP signal and the length of the digital filter applied to ETRP. The digital filter is made of an event counter in which N consecutive events are needed to validate a transition on the output:

0000: No filter, sampling is done at \( f_{DTS} \)

0001: \( f_{SAMPLING}=f_{CK\_INT} \) , N=2

0010: \( f_{SAMPLING}=f_{CK\_INT} \) , N=4

0011: \( f_{SAMPLING}=f_{CK\_INT} \) , N=8

0100: \( f_{SAMPLING}=f_{DTS}/2 \) , N=6

0101: \( f_{SAMPLING}=f_{DTS}/2 \) , N=8

0110: \( f_{SAMPLING}=f_{DTS}/4 \) , N=6

0111: \( f_{SAMPLING}=f_{DTS}/4 \) , N=8

1000: \( f_{SAMPLING}=f_{DTS}/8 \) , N=6

1001: \( f_{SAMPLING}=f_{DTS}/8 \) , N=8

1010: \( f_{SAMPLING}=f_{DTS}/16 \) , N=5

1011: \( f_{SAMPLING}=f_{DTS}/16 \) , N=6

1100: \( f_{SAMPLING}=f_{DTS}/16 \) , N=8

1101: \( f_{SAMPLING}=f_{DTS}/32 \) , N=5

1110: \( f_{SAMPLING}=f_{DTS}/32 \) , N=6

1111: \( f_{SAMPLING}=f_{DTS}/32 \) , N=8

Bit 7 MSM : Master/slave mode

0: No action

1: The effect of an event on the trigger input (TRGI) is delayed to allow a perfect synchronization between the current timer and its slaves (through TRGO). It is useful if we want to synchronize several timers on a single external event.

Bits 6:4 TS[2:0] : Trigger selection

This bit-field selects the trigger input to be used to synchronize the counter.

000: Internal Trigger 0 (ITR0)

001: Internal Trigger 1 (ITR1)

010: Internal Trigger 2 (ITR2)

011: Internal Trigger 3 (ITR3)

100: TI1 Edge Detector (TI1F_ED)

101: Filtered Timer Input 1 (TI1FP1)

110: Filtered Timer Input 2 (TI2FP2)

111: External Trigger input (ETRF)

See Table 82 for more details on ITRx meaning for each Timer.

Note: These bits must be changed only when they are not used (e.g. when SMS=000) to avoid wrong edge detections at the transition.

Bit 3 Reserved, must be kept at reset value.

Bits 2:0 SMS : Slave mode selection

When external signals are selected the active edge of the trigger signal (TRGI) is linked to the polarity selected on the external input (see Input Control register and Control register description.

000: Slave mode disabled - if CEN = '1' then the prescaler is clocked directly by the internal clock.

001: Encoder mode 1 - Counter counts up/down on TI2FP1 edge depending on TI1FP2 level.

010: Encoder mode 2 - Counter counts up/down on TI1FP2 edge depending on TI2FP1 level.

011: Encoder mode 3 - Counter counts up/down on both TI1FP1 and TI2FP2 edges depending on the level of the other input.

100: Reset Mode - Rising edge of the selected trigger input (TRGI) reinitializes the counter and generates an update of the registers.

101: Gated Mode - The counter clock is enabled when the trigger input (TRGI) is high. The counter stops (but is not reset) as soon as the trigger becomes low. Both start and stop of the counter are controlled.

110: Trigger Mode - The counter starts at a rising edge of the trigger TRGI (but it is not reset). Only the start of the counter is controlled.

111: External Clock Mode 1 - Rising edges of the selected trigger (TRGI) clock the counter.

Note: The gated mode must not be used if TI1F_ED is selected as the trigger input (TS='100'). Indeed, TI1F_ED outputs 1 pulse for each transition on TI1F, whereas the gated mode checks the level of the trigger signal.

The clock of the slave timer must be enabled prior to receiving events from the master timer, and must not be changed on-the-fly while triggers are received from the master timer.

Table 82. TIMx Internal trigger connection (1)

Slave TIMITR0 (TS = 000)ITR1 (TS = 001)ITR2 (TS = 010)ITR3 (TS = 011)
TIM1TIM5_TRGOTIM2_TRGOTIM3_TRGOTIM4_TRGO
TIM8TIM1_TRGOTIM2_TRGOTIM4_TRGOTIM5_TRGO

1. When a timer is not present in the product, the corresponding trigger ITRx is not available.

14.4.4 TIM1 and TIM8 DMA/interrupt enable register (TIMx_DIER)

Address offset: 0x0C

Reset value: 0x0000

1514131211109876543210
Res.TDECOMDECC4DECC3DECC2DECC1DEUDEBIETIECOMIECC4IECC3IECC2IECC1IEUIE
rwrwrwrwrwrwrwrwrwrwrwrwrwrwrw

Bit 15 Reserved, must be kept at reset value.

Bit 14 TDE : Trigger DMA request enable

0: Trigger DMA request disabled

1: Trigger DMA request enabled

Bit 13 COMDE : COM DMA request enable

0: COM DMA request disabled

1: COM DMA request enabled

  1. Bit 12 CC4DE : Capture/Compare 4 DMA request enable
    0: CC4 DMA request disabled
    1: CC4 DMA request enabled
  2. Bit 11 CC3DE : Capture/Compare 3 DMA request enable
    0: CC3 DMA request disabled
    1: CC3 DMA request enabled
  3. Bit 10 CC2DE : Capture/Compare 2 DMA request enable
    0: CC2 DMA request disabled
    1: CC2 DMA request enabled
  4. Bit 9 CC1DE : Capture/Compare 1 DMA request enable
    0: CC1 DMA request disabled
    1: CC1 DMA request enabled
  5. Bit 8 UDE : Update DMA request enable
    0: Update DMA request disabled
    1: Update DMA request enabled
  6. Bit 7 BIE : Break interrupt enable
    0: Break interrupt disabled
    1: Break interrupt enabled
  7. Bit 6 TIE : Trigger interrupt enable
    0: Trigger interrupt disabled
    1: Trigger interrupt enabled
  8. Bit 5 COMIE : COM interrupt enable
    0: COM interrupt disabled
    1: COM interrupt enabled
  9. Bit 4 CC4IE : Capture/Compare 4 interrupt enable
    0: CC4 interrupt disabled
    1: CC4 interrupt enabled
  10. Bit 3 CC3IE : Capture/Compare 3 interrupt enable
    0: CC3 interrupt disabled
    1: CC3 interrupt enabled
  11. Bit 2 CC2IE : Capture/Compare 2 interrupt enable
    0: CC2 interrupt disabled
    1: CC2 interrupt enabled
  12. Bit 1 CC1IE : Capture/Compare 1 interrupt enable
    0: CC1 interrupt disabled
    1: CC1 interrupt enabled
  13. Bit 0 UIE : Update interrupt enable
    0: Update interrupt disabled
    1: Update interrupt enabled

14.4.5 TIM1 and TIM8 status register (TIMx_SR)

Address offset: 0x10

Reset value: 0x0000

1514131211109876543210
ReservedCC4OFCC3OFCC2OFCC1OFRes.BIFTIFCOMIFCC4IFCC3IFCC2IFCC1IFUIF
rc_w0rc_w0rc_w0rc_w0Res.rc_w0rc_w0rc_w0rc_w0rc_w0rc_w0rc_w0rc_w0rc_w0

Bits 15:13 Reserved, must be kept at reset value.

Bit 12 CC4OF : Capture/Compare 4 overcapture flag
refer to CC1OF description

Bit 11 CC3OF : Capture/Compare 3 overcapture flag
refer to CC1OF description

Bit 10 CC2OF : Capture/Compare 2 overcapture flag
refer to CC1OF description

Bit 9 CC1OF : Capture/Compare 1 overcapture flag

This flag is set by hardware only when the corresponding channel is configured in input capture mode. It is cleared by software by writing it to '0'.

0: No overcapture has been detected.

1: The counter value has been captured in TIMx_CCR1 register while CC1IF flag was already set

Bit 8 Reserved, must be kept at reset value.

Bit 7 BIF : Break interrupt flag

This flag is set by hardware as soon as the break input goes active. It can be cleared by software if the break input is not active.

0: No break event occurred.

1: An active level has been detected on the break input.

Bit 6 TIF : Trigger interrupt flag

This flag is set by hardware on trigger event (active edge detected on TRGI input when the slave mode controller is enabled in all modes but gated mode, both edges in case gated mode is selected). It is cleared by software.

0: No trigger event occurred.

1: Trigger interrupt pending.

Bit 5 COMIF : COM interrupt flag

This flag is set by hardware on COM event (when Capture/compare Control bits - CCxE, CCxNE, OCxM - have been updated). It is cleared by software.

0: No COM event occurred.

1: COM interrupt pending.

Bit 4 CC4IF : Capture/Compare 4 interrupt flag
refer to CC1IF description

Bit 3 CC3IF : Capture/Compare 3 interrupt flag
refer to CC1IF description

Bit 2 CC2IF : Capture/Compare 2 interrupt flag

refer to CC1IF description

Bit 1 CC1IF : Capture/Compare 1 interrupt flag

If channel CC1 is configured as output:

This flag is set by hardware when the counter matches the compare value, with some exception in center-aligned mode (refer to the CMS bits in the TIMx_CR1 register description). It is cleared by software.

0: No match.

1: The content of the counter TIMx_CNT matches the content of the TIMx_CCR1 register. When the contents of TIMx_CCR1 are greater than the contents of TIMx_ARR, the CC1IF bit goes high on the counter overflow (in upcounting and up/down-counting modes) or underflow (in downcounting mode)

If channel CC1 is configured as input:

This bit is set by hardware on a capture. It is cleared by software or by reading the TIMx_CCR1 register.

0: No input capture occurred

1: The counter value has been captured in TIMx_CCR1 register (An edge has been detected on IC1 which matches the selected polarity)

Bit 0 UIF : Update interrupt flag

This bit is set by hardware on an update event. It is cleared by software.

0: No update occurred.

1: Update interrupt pending. This bit is set by hardware when the registers are updated:

14.4.6 TIM1 and TIM8 event generation register (TIMx_EGR)

Address offset: 0x14

Reset value: 0x0000

1514131211109876543210
ReservedBGTGCOMGCC4GCC3GCC2GCC1GUG
wwwwwwww

Bits 15:8 Reserved, must be kept at reset value.

Bit 7 BG : Break generation

This bit is set by software in order to generate an event, it is automatically cleared by hardware.

0: No action

1: A break event is generated. MOE bit is cleared and BIF flag is set. Related interrupt or DMA transfer can occur if enabled.

Bit 6 TG : Trigger generation

This bit is set by software in order to generate an event, it is automatically cleared by hardware.

0: No action

1: The TIF flag is set in TIMx_SR register. Related interrupt or DMA transfer can occur if enabled.

Bit 5 COMG : Capture/Compare control update generation

This bit can be set by software, it is automatically cleared by hardware

0: No action

1: When CCPC bit is set, it allows to update CCxE, CCxNE and OCxM bits

Note: This bit acts only on channels having a complementary output.

Bit 4 CC4G : Capture/Compare 4 generation

refer to CC1G description

Bit 3 CC3G : Capture/Compare 3 generation

refer to CC1G description

Bit 2 CC2G : Capture/Compare 2 generation

refer to CC1G description

Bit 1 CC1G : Capture/Compare 1 generation

This bit is set by software in order to generate an event, it is automatically cleared by hardware.

0: No action

1: A capture/compare event is generated on channel 1:

If channel CC1 is configured as output:

CC1IF flag is set, Corresponding interrupt or DMA request is sent if enabled.

If channel CC1 is configured as input:

The current value of the counter is captured in TIMx_CCR1 register. The CC1IF flag is set, the corresponding interrupt or DMA request is sent if enabled. The CC1OF flag is set if the CC1IF flag was already high.

Bit 0 UG : Update generation

This bit can be set by software, it is automatically cleared by hardware.

0: No action

1: Reinitialize the counter and generates an update of the registers. Note that the prescaler counter is cleared too (anyway the prescaler ratio is not affected). The counter is cleared if the center-aligned mode is selected or if DIR=0 (upcounting), else it takes the auto-reload value (TIMx_ARR) if DIR=1 (downcounting).

14.4.7 TIM1 and TIM8 capture/compare mode register 1 (TIMx_CCMR1)

Address offset: 0x18

Reset value: 0x0000

The channels can be used in input (capture mode) or in output (compare mode). The direction of a channel is defined by configuring the corresponding CCxS bits. All the other bits of this register have a different function in input and in output mode. For a given bit, OCxx describes its function when the channel is configured in output, ICxx describes its function when the channel is configured in input. So the user must take care that the same bit can have a different meaning for the input stage and for the output stage.

1514131211109876543210
OC2
CE
OC2M[2:0]OC2
PE
OC2
FE
CC2S[1:0]OC1
CE
OC1M[2:0]OC1
PE
OC1
FE
CC1S[1:0]IC2F[3:0]IC2PSC[1:0]
IC2F[3:0]IC2PSC[1:0]IC1F[3:0]
rwrwrwrwrwrwrwrwrwrwrwrwrwrwrwrw

Output compare mode:

Bit 15 OC2CE : Output compare 2 clear enable

Bits 14:12 OC2M[2:0] : Output compare 2 mode

Bit 11 OC2PE : Output compare 2 preload enable

Bit 10 OC2FE : Output compare 2 fast enable

Bits 9:8 CC2S[1:0] : Capture/Compare 2 selection

This bit-field defines the direction of the channel (input/output) as well as the used input.

00: CC2 channel is configured as output

01: CC2 channel is configured as input, IC2 is mapped on TI2

10: CC2 channel is configured as input, IC2 is mapped on TI1

11: CC2 channel is configured as input, IC2 is mapped on TRC. This mode is working only if an internal trigger input is selected through the TS bit (TIMx_SMCR register)

Note: CC2S bits are writable only when the channel is OFF (CC2E = '0' in TIMx_CCER).

Bit 7 OC1CE : Output compare 1 clear enable

OC1CE: Output compare 1 Clear Enable

0: OC1Ref is not affected by the ETRF Input

1: OC1Ref is cleared as soon as a High level is detected on ETRF input

Bits 6:4 OC1M : Output compare 1 mode

These bits define the behavior of the output reference signal OC1REF from which OC1 and OC1N are derived. OC1REF is active high whereas OC1 and OC1N active level depends on CC1P and CC1NP bits.

000: Frozen - The comparison between the output compare register TIMx_CCR1 and the counter TIMx_CNT has no effect on the outputs. (this mode is used to generate a timing base).

001: Set channel 1 to active level on match. OC1REF signal is forced high when the counter TIMx_CNT matches the capture/compare register 1 (TIMx_CCR1).

010: Set channel 1 to inactive level on match. OC1REF signal is forced low when the counter TIMx_CNT matches the capture/compare register 1 (TIMx_CCR1).

011: Toggle - OC1REF toggles when TIMx_CNT=TIMx_CCR1.

100: Force inactive level - OC1REF is forced low.

101: Force active level - OC1REF is forced high.

110: PWM mode 1 - In upcounting, channel 1 is active as long as TIMx_CNT<TIMx_CCR1 else inactive. In downcounting, channel 1 is inactive (OC1REF='0') as long as TIMx_CNT>TIMx_CCR1 else active (OC1REF='1').

111: PWM mode 2 - In upcounting, channel 1 is inactive as long as TIMx_CNT<TIMx_CCR1 else active. In downcounting, channel 1 is active as long as TIMx_CNT>TIMx_CCR1 else inactive.

Note: 1: These bits can not be modified as long as LOCK level 3 has been programmed (LOCK bits in TIMx_BDTR register) and CC1S='00' (the channel is configured in output).

2: In PWM mode 1 or 2, the OCREF level changes only when the result of the comparison changes or when the output compare mode switches from "frozen" mode to "PWM" mode.

Bit 3 OC1PE : Output compare 1 preload enable

0: Preload register on TIMx_CCR1 disabled. TIMx_CCR1 can be written at anytime, the new value is taken in account immediately.

1: Preload register on TIMx_CCR1 enabled. Read/Write operations access the preload register. TIMx_CCR1 preload value is loaded in the active register at each update event.

Note: 1: These bits can not be modified as long as LOCK level 3 has been programmed (LOCK bits in TIMx_BDTR register) and CC1S='00' (the channel is configured in output).

2: The PWM mode can be used without validating the preload register only in one pulse mode (OPM bit set in TIMx_CR1 register). Else the behavior is not guaranteed.

Bit 2 OC1FE : Output compare 1 fast enable

This bit is used to accelerate the effect of an event on the trigger in input on the CC output. 0: CC1 behaves normally depending on counter and CCR1 values even when the trigger is ON. The minimum delay to activate CC1 output when an edge occurs on the trigger input is 5 clock cycles.

1: An active edge on the trigger input acts like a compare match on CC1 output. Then, OC is set to the compare level independently from the result of the comparison. Delay to sample the trigger input and to activate CC1 output is reduced to 3 clock cycles. OCFE acts only if the channel is configured in PWM1 or PWM2 mode.

Bits 1:0 CC1S : Capture/Compare 1 selection

This bit-field defines the direction of the channel (input/output) as well as the used input.

00: CC1 channel is configured as output

01: CC1 channel is configured as input, IC1 is mapped on TI1

10: CC1 channel is configured as input, IC1 is mapped on TI2

11: CC1 channel is configured as input, IC1 is mapped on TRC. This mode is working only if an internal trigger input is selected through TS bit (TIMx_SMCR register)

Note: CC1S bits are writable only when the channel is OFF (CC1E = '0' in TIMx_CCER).

Input capture mode

Bits 15:12 IC2F : Input capture 2 filter

Bits 11:10 IC2PSC[1:0] : Input capture 2 prescaler

Bits 9:8 CC2S : Capture/Compare 2 selection

This bit-field defines the direction of the channel (input/output) as well as the used input.

00: CC2 channel is configured as output

01: CC2 channel is configured as input, IC2 is mapped on TI2

10: CC2 channel is configured as input, IC2 is mapped on TI1

11: CC2 channel is configured as input, IC2 is mapped on TRC. This mode is working only if an internal trigger input is selected through TS bit (TIMx_SMCR register)

Note: CC2S bits are writable only when the channel is OFF (CC2E = '0' in TIMx_CCER).

Bits 7:4 IC1F[3:0] : Input capture 1 filter

This bit-field defines the frequency used to sample TI1 input and the length of the digital filter applied to TI1. The digital filter is made of an event counter in which N consecutive events are needed to validate a transition on the output:

0000: No filter, sampling is done at \( f_{DTS} \)

0001: \( f_{SAMPLING}=f_{CK\_INT} \) , N=2

0010: \( f_{SAMPLING}=f_{CK\_INT} \) , N=4

0011: \( f_{SAMPLING}=f_{CK\_INT} \) , N=8

0100: \( f_{SAMPLING}=f_{DTS}/2 \) , N=6

0101: \( f_{SAMPLING}=f_{DTS}/2 \) , N=8

0110: \( f_{SAMPLING}=f_{DTS}/4 \) , N=6

0111: \( f_{SAMPLING}=f_{DTS}/4 \) , N=8

1000: \( f_{SAMPLING}=f_{DTS}/8 \) , N=6

1001: \( f_{SAMPLING}=f_{DTS}/8 \) , N=8

1010: \( f_{SAMPLING}=f_{DTS}/16 \) , N=5

1011: \( f_{SAMPLING}=f_{DTS}/16 \) , N=6

1100: \( f_{SAMPLING}=f_{DTS}/16 \) , N=8

1101: \( f_{SAMPLING}=f_{DTS}/32 \) , N=5

1110: \( f_{SAMPLING}=f_{DTS}/32 \) , N=6

1111: \( f_{SAMPLING}=f_{DTS}/32 \) , N=8

Bits 3:2 IC1PSC : Input capture 1 prescaler

This bit-field defines the ratio of the prescaler acting on CC1 input (IC1).

The prescaler is reset as soon as CC1E='0' (TIMx_CCER register).

00: no prescaler, capture is done each time an edge is detected on the capture input

01: capture is done once every 2 events

10: capture is done once every 4 events

11: capture is done once every 8 events

Bits 1:0 CC1S : Capture/Compare 1 Selection

This bit-field defines the direction of the channel (input/output) as well as the used input.

00: CC1 channel is configured as output

01: CC1 channel is configured as input, IC1 is mapped on TI1

10: CC1 channel is configured as input, IC1 is mapped on TI2

11: CC1 channel is configured as input, IC1 is mapped on TRC. This mode is working only if an internal trigger input is selected through TS bit (TIMx_SMCR register)

Note: CC1S bits are writable only when the channel is OFF (CC1E = '0' in TIMx_CCER).

14.4.8 TIM1 and TIM8 capture/compare mode register 2 (TIMx_CCMR2)

Address offset: 0x1C

Reset value: 0x0000

Refer to the above CCMR1 register description.

1514131211109876543210
OC4CEOC4M[2:0]OC4PEOC4FECC4S[1:0]OC3CEOC3M[2:0]OC3PEOC3FECC3S[1:0]
IC4F[3:0]IC4PSC[1:0]IC3F[3:0]IC3PSC[1:0]
rwrwrwrwrwrwrwrwrwrwrwrwrwrwrwrw

Output compare mode

Bit 15 OC4CE : Output compare 4 clear enable

Bits 14:12 OC4M : Output compare 4 mode

Bit 11 OC4PE : Output compare 4 preload enable

Bit 10 OC4FE : Output compare 4 fast enable

Bits 9:8 CC4S : Capture/Compare 4 selection

This bit-field defines the direction of the channel (input/output) as well as the used input.

00: CC4 channel is configured as output

01: CC4 channel is configured as input, IC4 is mapped on TI4

10: CC4 channel is configured as input, IC4 is mapped on TI3

11: CC4 channel is configured as input, IC4 is mapped on TRC. This mode is working only if an internal trigger input is selected through TS bit (TIMx_SMCR register)

Note: CC4S bits are writable only when the channel is OFF (OC4E = '0' in TIMx_CCER).

Bit 7 OC3CE : Output compare 3 clear enable

Bits 6:4 OC3M : Output compare 3 mode

Bit 3 OC3PE : Output compare 3 preload enable

Bit 2 OC3FE : Output compare 3 fast enable

Bits 1:0 CC3S : Capture/Compare 3 selection

This bit-field defines the direction of the channel (input/output) as well as the used input.

00: CC3 channel is configured as output

01: CC3 channel is configured as input, IC3 is mapped on TI3

10: CC3 channel is configured as input, IC3 is mapped on TI4

11: CC3 channel is configured as input, IC3 is mapped on TRC. This mode is working only if an internal trigger input is selected through TS bit (TIMx_SMCR register)

Note: CC3S bits are writable only when the channel is OFF (OC3E = '0' in TIMx_CCER).

Input capture mode

Bits 15:12 IC4F : Input capture 4 filter

Bits 11:10 IC4PSC : Input capture 4 prescaler

Bits 9:8 CC4S : Capture/Compare 4 selection

This bit-field defines the direction of the channel (input/output) as well as the used input.

00: CC4 channel is configured as output

01: CC4 channel is configured as input, IC4 is mapped on TI4

10: CC4 channel is configured as input, IC4 is mapped on TI3

11: CC4 channel is configured as input, IC4 is mapped on TRC. This mode is working only if an internal trigger input is selected through TS bit (TIMx_SMCR register)

Note: CC4S bits are writable only when the channel is OFF (CC4E = '0' in TIMx_CCER).

Bits 7:4 IC3F : Input capture 3 filter

Bits 3:2 IC3PSC : Input capture 3 prescaler

Bits 1:0 CC3S : Capture/compare 3 selection

This bit-field defines the direction of the channel (input/output) as well as the used input.

00: CC3 channel is configured as output

01: CC3 channel is configured as input, IC3 is mapped on TI3

10: CC3 channel is configured as input, IC3 is mapped on TI4

11: CC3 channel is configured as input, IC3 is mapped on TRC. This mode is working only if an internal trigger input is selected through TS bit (TIMx_SMCR register)

Note: CC3S bits are writable only when the channel is OFF (CC3E = '0' in TIMx_CCER).

14.4.9 TIM1 and TIM8 capture/compare enable register (TIMx_CCER)

Address offset: 0x20

Reset value: 0x0000

1514131211109876543210
CC4NPRes.CC4PCC4ECC3NPCC3NECC3PCC3ECC2NPCC2NECC2PCC2ECC1NPCC1NECC1PCC1E
rwrwrwrwrwrwrwrwrwrwrwrwrwrwrw

Bit 15 CC4NP : Capture/Compare 4 complementary output polarity
refer to CC1NP description

Bit 14 Reserved, must be kept at reset value.

Bit 13 CC4P : Capture/Compare 4 output polarity
refer to CC1P description

Bit 12 CC4E : Capture/Compare 4 output enable
refer to CC1E description

Bit 11 CC3NP : Capture/Compare 3 complementary output polarity
refer to CC1NP description

Bit 10 CC3NE : Capture/Compare 3 complementary output enable
refer to CC1NE description

Bit 9 CC3P : Capture/Compare 3 output polarity
refer to CC1P description

Bit 8 CC3E : Capture/Compare 3 output enable
refer to CC1E description

Bit 7 CC2NP : Capture/Compare 2 complementary output polarity
refer to CC1NP description

Bit 6 CC2NE : Capture/Compare 2 complementary output enable
refer to CC1NE description

Bit 5 CC2P : Capture/Compare 2 output polarity
refer to CC1P description

Bit 4 CC2E : Capture/Compare 2 output enable
refer to CC1E description

Bit 3 CC1NP : Capture/Compare 1 complementary output polarity
0: OC1N active high.
1: OC1N active low.

Note: This bit is not writable as soon as LOCK level 2 or 3 has been programmed (LOCK bits in TIMx_BDTR register) and CC1S="00" (the channel is configured in output).

Bit 2 CC1NE : Capture/Compare 1 complementary output enable
0: Off - OC1N is not active. OC1N level is then function of MOE, OSSI, OSSR, OIS1, OIS1N and CC1E bits.
1: On - OC1N signal is output on the corresponding output pin depending on MOE, OSSI, OSSR, OIS1, OIS1N and CC1E bits.

Bit 1 CC1P : Capture/Compare 1 output polarity

CC1 channel configured as output:

0: OC1 active high
1: OC1 active low

CC1 channel configured as input:

This bit selects whether IC1 or IC1 is used for trigger or capture operations.

0: non-inverted: capture is done on a rising edge of IC1. When used as external trigger, IC1 is non-inverted.

1: inverted: capture is done on a falling edge of IC1. When used as external trigger, IC1 is inverted.

Note: This bit is not writable as soon as LOCK level 2 or 3 has been programmed (LOCK bits in TIMx_BDTR register).

Bit 0 CC1E : Capture/Compare 1 output enable

CC1 channel configured as output:

0: Off - OC1 is not active. OC1 level is then function of MOE, OSSI, OSSR, OIS1, OIS1N and CC1NE bits.

1: On - OC1 signal is output on the corresponding output pin depending on MOE, OSSI, OSSR, OIS1, OIS1N and CC1NE bits.

CC1 channel configured as input:

This bit determines if a capture of the counter value can actually be done into the input capture/compare register 1 (TIMx_CCR1) or not.

0: Capture disabled.

1: Capture enabled.

Table 83. Output control bits for complementary OCx and OCxN channels with break feature

Control bitsOutput states (1)
MOE bitOSSI bitOSSR bitCCxE bitCCxNE bitOCx output stateOCxN output state
1X000Output Disabled (not driven by the timer), OCx=0, OCx_EN=0Output Disabled (not driven by the timer), OCxN=0, OCxN_EN=0
001Output Disabled (not driven by the timer), OCx=0, OCx_EN=0OCxREF + Polarity OCxN=OCxREF xor CCxNP, OCxN_EN=1
010OCxREF + Polarity OCx=OCxREF xor CCxP, OCx_EN=1Output Disabled (not driven by the timer) OCxN=0, OCxN_EN=0
011OCREF + Polarity + dead-time OCx_EN=1Complementary to OCREF (not OCREF) + Polarity + dead-time OCxN_EN=1
100Output Disabled (not driven by the timer) OCx=CCxP, OCx_EN=0Output Disabled (not driven by the timer) OCxN=CCxNP, OCxN_EN=0
101Off-State (output enabled with inactive state) OCx=CCxP, OCx_EN=1OCxREF + Polarity OCxN=OCxREF xor CCxNP, OCxN_EN=1
110OCxREF + Polarity OCx=OCxREF xor CCxP, OCx_EN=1Off-State (output enabled with inactive state) OCxN=CCxNP, OCxN_EN=1
111OCREF + Polarity + dead-time OCx_EN=1Complementary to OCREF (not OCREF) + Polarity + dead-time OCxN_EN=1
0X000Output Disabled (not driven by the timer)
Asynchronously: OCx=CCxP, OCx_EN=0, OCxN=CCxNP, OCxN_EN=0
Then if the clock is present: OCx=OISx and OCxN=OISxN after a dead-time, assuming that OISx and OISxN do not correspond to OCx and OCxN both in active state.
001
010
011
100Off-State (output enabled with inactive state)
Asynchronously: OCx=CCxP, OCx_EN=1, OCxN=CCxNP, OCxN_EN=1
Then if the clock is present: OCx=OISx and OCxN=OISxN after a dead-time, assuming that OISx and OISxN do not correspond to OCx and OCxN both in active state.
101
110
111

1. When both outputs of a channel are not used (CCxE = CCxNE = 0), the OISx, OISxN, CCxP and CCxNP bits must be kept cleared.

Note: The state of the external I/O pins connected to the complementary OCx and OCxN channels depends on the OCx and OCxN channel state and the GPIO and AFIO registers.

14.4.10 TIM1 and TIM8 counter (TIMx_CNT)

Address offset: 0x24

Reset value: 0x0000

1514131211109876543210
CNT[15:0]
rwrwrwrwrwrwrwrwrwrwrwrwrwrwrwrw

Bits 15:0 CNT[15:0] : Counter value

14.4.11 TIM1 and TIM8 prescaler (TIMx_PSC)

Address offset: 0x28

Reset value: 0x0000

1514131211109876543210
PSC[15:0]
rwrwrwrwrwrwrwrwrwrwrwrwrwrwrwrw

Bits 15:0 PSC[15:0] : Prescaler value

The counter clock frequency (CK_CNT) is equal to \( f_{CK\_PSC} / (PSC[15:0] + 1) \) .

PSC contains the value to be loaded in the active prescaler register at each update event (including when the counter is cleared through UG bit of TIMx_EGR register or through trigger controller when configured in “reset mode”).

14.4.12 TIM1 and TIM8 auto-reload register (TIMx_ARR)

Address offset: 0x2C

Reset value: 0xFFFF

1514131211109876543210
ARR[15:0]
rwrwrwrwrwrwrwrwrwrwrwrwrwrwrwrw

Bits 15:0 ARR[15:0] : Auto-reload value

ARR is the value to be loaded in the actual auto-reload register.

Refer to Section 14.3.1: Time-base unit for more details about ARR update and behavior.

The counter is blocked while the auto-reload value is null.

14.4.13 TIM1 and TIM8 repetition counter register (TIMx_RCR)

Address offset: 0x30

Reset value: 0x0000

1514131211109876543210
ReservedREP[7:0]
rwrwrwrwrwrwrwrw

Bits 15:8 Reserved, must be kept at reset value.

Bits 7:0 REP[7:0] : Repetition counter value

These bits allow the user to set-up the update rate of the compare registers (i.e. periodic transfers from preload to active registers) when preload registers are enable, as well as the update interrupt generation rate, if this interrupt is enable.

Each time the REP_CNT related downcounter reaches zero, an update event is generated and it restarts counting from REP value. As REP_CNT is reloaded with REP value only at the repetition update event U_RC, any write to the TIMx_RCR register is not taken in account until the next repetition update event.

It means in PWM mode (REP+1) corresponds to:

14.4.14 TIM1 and TIM8 capture/compare register 1 (TIMx_CCR1)

Address offset: 0x34

Reset value: 0x0000

1514131211109876543210
CCR1[15:0]
rw/rorw/rorw/rorw/rorw/rorw/rorw/rorw/rorw/rorw/rorw/rorw/rorw/rorw/rorw/rorw/ro

Bits 15:0 CCR1[15:0] : Capture/Compare 1 value

If channel CC1 is configured as output:

CCR1 is the value to be loaded in the actual capture/compare 1 register (preload value).

It is loaded permanently if the preload feature is not selected in the TIMx_CCMR1 register (bit OC1PE). Else the preload value is copied in the active capture/compare 1 register when an update event occurs.

The active capture/compare register contains the value to be compared to the counter TIMx_CNT and signaled on OC1 output.

If channel CC1 is configured as input:

CCR1 is the counter value transferred by the last input capture 1 event (IC1). The TIMx_CCR1 register is read-only and cannot be programmed.

14.4.15 TIM1 and TIM8 capture/compare register 2 (TIMx_CCR2)

Address offset: 0x38

Reset value: 0x0000

1514131211109876543210
CCR2[15:0]
rw/rorw/rorw/rorw/rorw/rorw/rorw/rorw/rorw/rorw/rorw/rorw/rorw/rorw/rorw/rorw/ro

Bits 15:0 CCR2[15:0] : Capture/Compare 2 value

If channel CC2 is configured as output:

CCR2 is the value to be loaded in the actual capture/compare 2 register (preload value). It is loaded permanently if the preload feature is not selected in the TIMx_CCMR2 register (bit OC2PE). Else the preload value is copied in the active capture/compare 2 register when an update event occurs.

The active capture/compare register contains the value to be compared to the counter TIMx_CNT and signalled on OC2 output.

If channel CC2 is configured as input:

CCR2 is the counter value transferred by the last input capture 2 event (IC2). The TIMx_CCR2 register is read-only and cannot be programmed.

14.4.16 TIM1 and TIM8 capture/compare register 3 (TIMx_CCR3)

Address offset: 0x3C

Reset value: 0x0000

1514131211109876543210
CCR3[15:0]
rw/rorw/rorw/rorw/rorw/rorw/rorw/rorw/rorw/rorw/rorw/rorw/rorw/rorw/rorw/rorw/ro

Bits 15:0 CCR3[15:0] : Capture/Compare value

If channel CC3 is configured as output:

CCR3 is the value to be loaded in the actual capture/compare 3 register (preload value). It is loaded permanently if the preload feature is not selected in the TIMx_CCMR3 register (bit OC3PE). Else the preload value is copied in the active capture/compare 3 register when an update event occurs.

The active capture/compare register contains the value to be compared to the counter TIMx_CNT and signalled on OC3 output.

If channel CC3 is configured as input:

CCR3 is the counter value transferred by the last input capture 3 event (IC3). The TIMx_CCR3 register is read-only and cannot be programmed.

14.4.17 TIM1 and TIM8 capture/compare register 4 (TIMx_CCR4)

Address offset: 0x40

Reset value: 0x0000

1514131211109876543210
CCR4[15:0]
rw/rorw/rorw/rorw/rorw/rorw/rorw/rorw/rorw/rorw/rorw/rorw/rorw/rorw/rorw/rorw/ro

Bits 15:0 CCR4[15:0] : Capture/Compare value

If channel CC4 is configured as output:

CCR4 is the value to be loaded in the actual capture/compare 4 register (preload value).

It is loaded permanently if the preload feature is not selected in the TIMx_CCMR4 register (bit OC4PE). Else the preload value is copied in the active capture/compare 4 register when an update event occurs.

The active capture/compare register contains the value to be compared to the counter TIMx_CNT and signalled on OC4 output.

If channel CC4 is configured as input:

CCR4 is the counter value transferred by the last input capture 4 event (IC4). The TIMx_CCR3 register is read-only and cannot be programmed.

14.4.18 TIM1 and TIM8 break and dead-time register (TIMx_BDTR)

Address offset: 0x44

Reset value: 0x0000

1514131211109876543210
MOEAOEBKPBKEOSSROSSILOCK[1:0]DTG[7:0]
rwrwrwrwrwrwrwrwrwrwrwrwrwrwrwrw

Note: As the bits AOE, BKP, BKE, OSSI, OSSR and DTG[7:0] can be write-locked depending on the LOCK configuration, it can be necessary to configure all of them during the first write access to the TIMx_BDTR register.

Bit 15 MOE : Main output enable

This bit is cleared asynchronously by hardware as soon as the break input is active. It is set by software or automatically depending on the AOE bit. It is acting only on the channels which are configured in output.

0: OC and OCN outputs are disabled or forced to idle state.

1: OC and OCN outputs are enabled if their respective enable bits are set (CCxE, CCxNE in TIMx_CCER register).

See OC/OCN enable description for more details ( Section 14.4.9: TIM1 and TIM8 capture/compare enable register (TIMx_CCER) ).

Bit 14 AOE : Automatic output enable

0: MOE can be set only by software

1: MOE can be set by software or automatically at the next update event (if the break input is not active)

Note: This bit can not be modified as long as LOCK level 1 has been programmed (LOCK bits in TIMx_BDTR register).

Bit 13 BKP : Break polarity

Note: This bit can not be modified as long as LOCK level 1 has been programmed (LOCK bits in TIMx_BDTR register).

Note: Any write operation to this bit takes a delay of 1 APB clock cycle to become effective.

Bit 12 BKE : Break enable

Note: This bit cannot be modified when LOCK level 1 has been programmed (LOCK bits in TIMx_BDTR register).

Note: Any write operation to this bit takes a delay of 1 APB clock cycle to become effective.

Bit 11 OSSR : Off-state selection for Run mode

This bit is used when MOE=1 on channels having a complementary output which are configured as outputs. OSSR is not implemented if no complementary output is implemented in the timer.

See OC/OCN enable description for more details ( Section 14.4.9: TIM1 and TIM8 capture/compare enable register (TIMx_CCER) ).

Note: This bit can not be modified as soon as the LOCK level 2 has been programmed (LOCK bits in TIMx_BDTR register).

Bit 10 OSSI : Off-state selection for Idle mode

This bit is used when MOE=0 on channels configured as outputs.

See OC/OCN enable description for more details ( Section 14.4.9: TIM1 and TIM8 capture/compare enable register (TIMx_CCER) ).

Note: This bit can not be modified as soon as the LOCK level 2 has been programmed (LOCK bits in TIMx_BDTR register).

Bits 9:8 LOCK[1:0] : Lock configuration

These bits offer a write protection against software errors.

Note: The LOCK bits can be written only once after the reset. Once the TIMx_BDTR register has been written, their content is frozen until the next reset.

Bits 7:0 DTG[7:0] : Dead-time generator setup

This bit-field defines the duration of the dead-time inserted between the complementary outputs. DT correspond to this duration.
DTG[7:5]=0xx => DT=DTG[7:0] \( \times t_{dtg} \) with \( t_{dtg}=t_{DTS} \) .
DTG[7:5]=10x => DT=(64+DTG[5:0]) \( \times t_{dtg} \) with \( T_{dtg}=2 \times t_{DTS} \) .
DTG[7:5]=110 => DT=(32+DTG[4:0]) \( \times t_{dtg} \) with \( T_{dtg}=8 \times t_{DTS} \) .
DTG[7:5]=111 => DT=(32+DTG[4:0]) \( \times t_{dtg} \) with \( T_{dtg}=16 \times t_{DTS} \) .
Example if \( T_{DTS}=125\text{ns} \) (8MHz), dead-time possible values are:
0 to 15875 ns by 125 ns steps,
16 us to 31750 ns by 250 ns steps,
32 us to 63us by 1 us steps,
64 us to 126 us by 2 us steps

Note: This bit-field can not be modified as long as LOCK level 1, 2 or 3 has been programmed (LOCK bits in TIMx_BDTR register).

14.4.19 TIM1 and TIM8 DMA control register (TIMx_DCR)

Address offset: 0x48

Reset value: 0x0000

1514131211109876543210
ReservedDBL[4:0]ReservedDBA[4:0]
rwrwrwrwrwrwrwrwrwrw

Bits 15:13 Reserved, must be kept at reset value.

Bits 12:8 DBL[4:0] : DMA burst length

This 5-bit vector defines the number of DMA transfers (the timer detects a burst transfer when a read or a write access to the TIMx_DMAR register address is performed).

the TIMx_DMAR address)

00000: 1 transfer

00001: 2 transfers

00010: 3 transfers

...

10001: 18 transfers

Bits 7:5 Reserved, must be kept at reset value.

Bits 4:0 DBA[4:0] : DMA base address

This 5-bits vector defines the base-address for DMA transfers (when read/write access are done through the TIMx_DMAR address). DBA is defined as an offset starting from the address of the TIMx_CR1 register.

Example:

00000: TIMx_CR1,

00001: TIMx_CR2,

00010: TIMx_SMCR,

...

Example: Let us consider the following transfer: DBL = 7 transfers and DBA = TIMx_CR1. In this case the transfer is done to/from 7 registers starting from the TIMx_CR1 address.

14.4.20 TIM1 and TIM8 DMA address for full transfer (TIMx_DMAR)

Address offset: 0x4C

Reset value: 0x0000 0000

31302928272625242322212019181716
DMAB[31:16]
rwrwrwrwrwrwrwrwrwrwrwrwrwrwrwrw
1514131211109876543210
DMAB[15:0]
rwrwrwrwrwrwrwrwrwrwrwrwrwrwrwrw

Bits 31:0 DMAB[31:0] : DMA register for burst accesses

A read or write operation to the DMAR register accesses the register located at the address
\( (\text{TIMx\_CR1 address}) + (\text{DBA} + \text{DMA index}) \times 4 \)
where TIMx_CR1 address is the address of the control register 1, DBA is the DMA base address configured in TIMx_DCR register, DMA index is automatically controlled by the DMA transfer, and ranges from 0 to DBL (DBL configured in TIMx_DCR).

Example of how to use the DMA burst feature

In this example the timer DMA burst feature is used to update the contents of the CCRx registers (x = 2, 3, 4) with the DMA transferring half words into the CCRx registers.

This is done in the following steps:

  1. Configure the corresponding DMA channel as follows:
    • – DMA channel peripheral address is the DMAR register address
    • – DMA channel memory address is the address of the buffer in the RAM containing the data to be transferred by DMA into CCRx registers.
    • – Number of data to transfer = 3 (See note below).
    • – Circular mode disabled.
  2. Configure the DCR register by configuring the DBA and DBL bit fields as follows:
    DBL = 3 transfers, DBA = 0xE.
  3. Enable the TIMx update DMA request (set the UDE bit in the DIER register).
  4. Enable TIMx
  5. Enable the DMA channel

Note: This example is for the case where every CCRx register to be updated once. If every CCRx register is to be updated twice for example, the number of data to transfer should be 6. Let's take the example of a buffer in the RAM containing data1, data2, data3, data4, data5 and data6. The data is transferred to the CCRx registers as follows: on the first update DMA request, data1 is transferred to CCR2, data2 is transferred to CCR3, data3 is transferred to CCR4 and on the second update DMA request, data4 is transferred to CCR2, data5 is transferred to CCR3 and data6 is transferred to CCR4.

14.4.21 TIM1 and TIM8 register map

TIM1 and TIM8 registers are mapped as 16-bit addressable registers as described in the table below:

Table 84. TIM1 and TIM8 register map and reset values

OffsetRegister313029282726252423222120191817161514131211109876543210
0x00TIMx_CR1ReservedCKD
[1:0]
ARPECMS
[1:0]
DIROPMURSUDISCEN
Reset value00000000
0x04TIMx_CR2ReservedOIS4OIS3NOIS3OIS2NOIS2OIS1NOIS1T1ISMMS[2:0]CODSCCUSReservedCCPC
Reset value0000000000000
0x08TIMx_SMCRReservedETPECEETPS
[1:0]
ETF[3:0]MSMTS[2:0]ReservedSMS[2:0]
Reset value00000000000
0x0CTIMx_DIERReservedTDECOMDECC4DECC3DECC2DECC1DEUDEBIETIECOMIECC4IECC3IECC2IECC1IEUIE
Reset value0000000000000
0x10TIMx_SRReservedCC4OFCC3OFCC2OFCC1OFReservedBIFTIFCOMIFCC4IFCC3IFCC2IFCC1IFUIF
Reset value00000000000
0x14TIMx_EGRReservedBGTGCOMGCC4GCC3GCC2GCC1GUG
Reset value00000000
0x18TIMx_CCMR1
Output compare mode
ReservedOC2CEOC2M
[2:0]
OC2PEOC2FECC2S
[1:0]
OC1CEOC1M
[2:0]
OC1PEOC1FECC1S
[1:0]
Reset value0000000000000
TIMx_CCMR1
Input capture mode
ReservedIC2F[3:0]IC2PSC
[1:0]
CC2S
[1:0]
IC1F[3:0]IC1PSC
[1:0]
CC1S
[1:0]
Reset value0000000000000
0x1CTIMx_CCMR2
Output compare mode
ReservedOC4CEOC4M
[2:0]
OC4PEOC4FECC4S
[1:0]
OC3CEOC3M
[2:0]
OC3PEOC3FECC3S
[1:0]
Reset value0000000000000
TIMx_CCMR2
Input capture mode
ReservedIC4F[3:0]IC4PSC
[1:0]
CC4S
[1:0]
IC3F[3:0]IC3PSC
[1:0]
CC3S
[1:0]
Reset value0000000000000
0x20TIMx_CCERReservedCC4NPCC4PCC4ECC3NPCC3NECC3PCC3ECC2NPCC2NECC2PCC2ECC1NPCC1NECC1PCC1E
Reset value00000000000000
0x24TIMx_CNTReserved
Reset value
0x28TIMx_PSCReserved
Reset value

Table 84. TIM1 and TIM8 register map and reset values (continued)

OffsetRegister313029282726252423222120191817161514131211109876543210
0x2CTIMx_ARRReservedARR[15:0]
Reset value1111111111111111
0x30TIMx_RCRReservedREP[7:0]
Reset value0
0x34TIMx_CCR1ReservedCCR1[15:0]
Reset value000000000000000
0x38TIMx_CCR2ReservedCCR2[15:0]
Reset value000000000000000
0x3CTIMx_CCR3ReservedCCR3[15:0]
Reset value000000000000000
0x40TIMx_CCR4ReservedCCR4[15:0]
Reset value000000000000000
0x44TIMx_BDTRReservedMOEAOEBKPBKEOSSROSSILOCK
[1:0]
DT[7:0]
Reset value000000000000000
0x48TIMx_DCRReservedDBL[4:0]
Reset value0
0x4CTIMx_DMARDMAB[31:0]
Reset value0000000000000000000000000000000

Refer to Section 3.3: Memory map for the register boundary addresses.