Timer

概述

Ameba 系列产品提供很多定时器供用户使用：

RTL8721DxRTL8720ERTL8710ERTL8726ERTL8713ERTL8730ERTL8721FRTL8720FRTL8735C

RTL8721Dx:

• 10 个 Basic Timer，其中：

  • TIM0 ~ TIM7 为低频 Basic Timer，时钟源是 SDM32K

  • TIM10、TIM11 为高频 Basic Timer，时钟源是 XTAL40M

• 1 个 8 通道 PWM Timer：TIM8

• 1 个 1 通道 Capture Timer：TIM9

• 1 个 32 位 Debug Timer

• 2 组 PMC Timer

Basic Timer

功能特性

• 向上计数的 32 位计数器

• 可以产生溢出中断

• 自动重载寄存器的值可以预加载

• 可以在睡眠状态下继续工作，并且可以通过中断唤醒系统

应用示例

SDK 提供了两类功能示例，帮助开发者了解和使用 Basic Timer 功能：

• mbed 示例

  • 路径：{SDK}\example\peripheral\mbed\Timer\mbed_gtimer\{demo}

  • 展示如何在 mbed 环境中实现 Basic Timer 控制

• raw 示例

  • 路径：{SDK}\example\peripheral\raw\Timer\raw_gtimer\{demo}

  • 展示如何在无抽象层的情况下直接控制 Basic Timer

备注

要了解示例支持的芯片，请查看示例路径下的 README.md 文件。

Raw API

BASICTIMER Exported Types

struct RTIM_TimeBaseInitTypeDef

TIM Basic Init Structure Definition.

Public Members

u32 TIM_Prescaler

Specifies the prescaler value used to divide the TIM clock. This parameter can be a number between 0x0 and 0xFFFF, basic timer dont care.

u32 TIM_Period

Specifies the period value to be loaded into the active Auto-Reload Register at the next update event. This parameter is 16bits for PWM/Capture timers, and 32bits for basic timers. You can get it from SourceClock & TIM_Prescaler.

u32 TIM_UpdateEvent

Specifies whether or not to enable update event(UEV). This parameter can be ENABLE or DISABLE. ENABLE means UEV Enable, DISABLE means UEV Disable.

u32 TIM_UpdateSource

Specifies the update request source. This parameter can be TIM_UpdateSource_Overflow or TIM_UpdateSource_Global. TIM_UpdateSource_Overflow means counter overflow generates an update event(UEV). TIM_UpdateSource_Global means both counter overflow and setting the UG bit can generate UEV.

u32 TIM_ARRProtection

DISABLE or ENABLE, when ENABLE: period will update when cnt = 0(counter overflow, an UEV happens), or period will update immediatly.

u8 TIM_Idx

Specifies the timer index.

u32 TIM_SecureTimer

Specifies the secure attribute of this timer. This parameter is used in secure world of trustzone.

BASICTIMER Exported Constants

SEC Control Enable Definition

/* R/W 0x0 Secure timer enable * 0: non-security timer * 1: security timer */
#define TIM_BIT_SEC ((u32)0x00000001 << 0)

TIM Event Source

/* Event source: counter update event. */
#define TIM_EventSource_Update ((u32)0x00000001)

/* Check if LP timer event source value is valid. */
#define IS_LP_TIM_EVENT_SOURCE ((((SOURCE) & 0xFFFFFFFE) == 0x0000) && \
    (((SOURCE) & 0x1) != 0x0000))

RTL8721DxRTL8720ERTL8710ERTL8726ERTL8713ERTL8730ERTL8721FRTL8720F

RTL8721Dx:

/* Check if HP timer event source value is valid. */
#define IS_HP_TIM_EVENT_SOURCE ((((SOURCE) & 0xFFFFFE00) == 0x0000) && \
    (((SOURCE) & 0x1FF) != 0x0000))

TIM PSC Reload Mode

/* Prescaler reloaded at next update event. */
#define TIM_PSCReloadMode_Update ((u32)0x00000000)

/* Prescaler reloaded immediately. */
#define TIM_PSCReloadMode_Immediate ((u32)0x00000001)

/* Check if prescaler reload mode value is valid. */
#define IS_TIM_PRESCALER_RELOAD (((RELOAD) == TIM_PSCReloadMode_Update) || \
    ((RELOAD) == TIM_PSCReloadMode_Immediate))

TIM Prescaler

/* Check if prescaler value fits in 16 bits. */
#define IS_TIM_PSC (VAL <= 0xFFFF)

TIM Update Source

/* Source of update is the counter overflow or the setting of UG bit. */
#define TIM_UpdateSource_Global ((u32)0x00000000)

/* Source of update is counter overflow. */
#define TIM_UpdateSource_Overflow ((u32)0x00000004)

/* Check if update request source value is valid. */
#define IS_TIM_UPDATE_SOURCE (((SOURCE) == TIM_UpdateSource_Global) || \
    ((SOURCE) == TIM_UpdateSource_Overflow))

TIM Type

RTL8721DxRTL8720ERTL8710ERTL8726ERTL8713ERTL8730ERTL8721FRTL8720F

RTL8721Dx:

/* Check if peripheral is a valid timer. */
#define IS_TIM_ALL_TIM (((PERIPH) == TIM0) || \
    ((PERIPH) == TIM1) || \
    ((PERIPH) == TIM2) || \
    ((PERIPH) == TIM3) || \
    ((PERIPH) == TIM4) || \
    ((PERIPH) == TIM5) || \
    ((PERIPH) == TIM6) || \
    ((PERIPH) == TIM7) || \
    ((PERIPH) == TIM8) || \
    ((PERIPH) == TIM9) || \
    ((PERIPH) == TIM10) || \
    ((PERIPH) == TIM11) || \
    ((PERIPH) == TIM0_S) || \
    ((PERIPH) == TIM1_S) || \
    ((PERIPH) == TIM2_S) || \
    ((PERIPH) == TIM3_S) || \
    ((PERIPH) == TIM4_S) || \
    ((PERIPH) == TIM5_S) || \
    ((PERIPH) == TIM6_S) || \
    ((PERIPH) == TIM7_S) || \
    ((PERIPH) == TIM8_S) || \
    ((PERIPH) == TIM9_S) || \
    ((PERIPH) == TIM10_S) || \
    ((PERIPH) == TIM11_S))

/* Check if peripheral is a secure-world timer. */
#define IS_TIM_SEC_TIM (((PERIPH) == TIM0_S) || \
    ((PERIPH) == TIM1_S) || \
    ((PERIPH) == TIM2_S) || \
    ((PERIPH) == TIM3_S) || \
    ((PERIPH) == TIM4_S) || \
    ((PERIPH) == TIM5_S) || \
    ((PERIPH) == TIM6_S) || \
    ((PERIPH) == TIM7_S) || \
    ((PERIPH) == TIM8_S) || \
    ((PERIPH) == TIM9_S) || \
    ((PERIPH) == TIM10_S) || \
    ((PERIPH) == TIM11_S))

/* Check if peripheral is a basic timer. */
#define IS_TIM_BASIC_TIM (((PERIPH) == TIM0) || \
    ((PERIPH) == TIM1) || \
    ((PERIPH) == TIM2) || \
    ((PERIPH) == TIM3) || \
    ((PERIPH) == TIM4) || \
    ((PERIPH) == TIM5) || \
    ((PERIPH) == TIM6) || \
    ((PERIPH) == TIM7) || \
    ((PERIPH) == TIM10) || \
    ((PERIPH) == TIM11) || \
    ((PERIPH) == TIM0_S) || \
    ((PERIPH) == TIM1_S) || \
    ((PERIPH) == TIM2_S) || \
    ((PERIPH) == TIM3_S) || \
    ((PERIPH) == TIM4_S) || \
    ((PERIPH) == TIM5_S) || \
    ((PERIPH) == TIM6_S) || \
    ((PERIPH) == TIM7_S) || \
    ((PERIPH) == TIM10_S) || \
    ((PERIPH) == TIM11_S))

/* Check if peripheral is a 40 MHz timer. */
#define IS_TIM_40M_TIM (((PERIPH) == TIM8) || \
    ((PERIPH) == TIM9) || \
    ((PERIPH) == TIM10) || \
    ((PERIPH) == TIM11) || \
    ((PERIPH) == TIM8_S) || \
    ((PERIPH) == TIM9_S) || \
    ((PERIPH) == TIM10_S) || \
    ((PERIPH) == TIM11_S))

TIM Peripheral Count

RTL8721DxRTL8720ERTL8710ERTL8726ERTL8713ERTL8730ERTL8721FRTL8720F

RTL8721Dx:

/* Total number of TIM peripherals. */
#define TimerNum 12

BASICTIMER Exported Functions

TimeBase Management Functions

void RTIM_ARRPreloadConfig(RTIM_TypeDef *TIMx, u32 NewState)

Enable or disable TIMx peripheral Preload register on ARR.

参数:

• TIMx -- The TIM peripheral, where x can be 0 to (TimerNum - 1). See TIM Peripheral Count.

• NewState -- New state of the TIMx peripheral Preload register This parameter can be: ENABLE or DISABLE.

备注

• DISABLE: TIMx_ARR register is not buffered, and shadow register will update immediately

• ENABLE: TIMx_ARR register is buffered, and shadow register will update after overflow

void RTIM_ChangePeriod(RTIM_TypeDef *TIMx, u32 Autoreload)

Set the TIMx Autoreload Register(TIMx_ARR) value to change period with protection.

参数:

• TIMx -- The TIM peripheral, where x can be 0 to (TimerNum - 1). See TIM Peripheral Count.

• Autoreload --

  Specifies the Autoreload register new value. The valid range depends on the TIM type:

  • Basic timers (non-CCM): 0 ~ 0xFFFFFFFF

  • CCM timers (PWM/Capture): 0 ~ 0xFFFF

void RTIM_ChangePeriodImmediate(RTIM_TypeDef *TIMx, u32 Autoreload)

Set the TIMx Autoreload Register(TIMx_ARR) value to change period.

参数:

• TIMx -- The TIM peripheral, where x can be 0 to (TimerNum - 1). See TIM Peripheral Count.

• Autoreload --

  Specifies the Autoreload register new value. The valid range depends on the TIM type:

  • Basic timers (non-CCM): 0 ~ 0xFFFFFFFF

  • CCM timers (PWM/Capture): 0 ~ 0xFFFF

void RTIM_Cmd(RTIM_TypeDef *TIMx, u32 NewState)

Enable or disable the specified TIM peripheral.

参数:

• TIMx -- The TIM peripheral, where x can be 0 to (TimerNum - 1). See TIM Peripheral Count.

• NewState -- New state of the TIMx peripheral. This parameter can be: ENABLE or DISABLE.

void RTIM_DeInit(RTIM_TypeDef *TIMx)

DeInit the specified TIM peripheral, including disable TIM, close and clear interrupt.

参数:

• TIMx -- The TIM peripheral, where x can be 0 to (TimerNum - 1). See TIM Peripheral Count.

void RTIM_GenerateEvent(RTIM_TypeDef *TIMx, u32 TIM_EventSource)

Configure the TIMx event to be generated by software.

参数:

• TIMx -- The TIM peripheral, where x can be 0 to (TimerNum - 1). See TIM Peripheral Count.

• TIM_EventSource -- Specifies the event source. This parameter can be one or more of the following values TIM Event Source

u32 RTIM_GetCount(RTIM_TypeDef *TIMx)

Get the TIMx Counter value.

参数:

• TIMx -- The TIM peripheral, where x can be 0 to (TimerNum - 1). See TIM Peripheral Count.

返回:

Counter Register value.

void RTIM_PrescalerConfig(RTIM_TypeDef *TIMx, u32 Prescaler, u32 TIM_PSCReloadMode)

Configure the TIMx Prescaler.

参数:

• TIMx -- The TIM peripheral with CCM capability. See IS_TIM_CCM_TIM macro.

• Prescaler -- Specifies the Prescaler Register value, which can be a number in 0~0xFFFF range.

• TIM_PSCReloadMode --

  Specifies the TIM Prescaler Reload mode This parameter can be one of the following values:

  • TIM_PSCReloadMode_Update: The Prescaler is loaded at the update event.

  • TIM_PSCReloadMode_Immediate: The Prescaler is loaded immediately.

void RTIM_Reset(RTIM_TypeDef *TIMx)

Reset timer, counter will start from 0.

参数:

• TIMx -- The TIM peripheral, where x can be 0 to (TimerNum - 1). See TIM Peripheral Count.

void RTIM_TimeBaseInit(RTIM_TypeDef *TIMx, RTIM_TimeBaseInitTypeDef *TIM_InitStruct, IRQn_Type IrqNum, IRQ_FUN UserCB, u32 UserCBData)

Initialize the TIMx Time Base Unit peripheral according to the specified parameters in the TIM_InitStruct.

参数:

• TIMx -- The TIM peripheral, where x can be 0 to (TimerNum - 1). See TIM Peripheral Count.

• TIM_InitStruct -- Pointer to a RTIM_TimeBaseInitTypeDef structure that contains the configuration information for the specified TIM peripheral.

• IrqNum -- The IRQ number for TIMx, which can be TIMERx_IRQ where x is 0 to (TimerNum - 1). See TIM Peripheral Count.

• UserCB -- ISR callback function. This parameter uses the IRQ_FUN type, which takes a void pointer and returns u32.

• UserCBData -- Parameters of ISR function.

void RTIM_TimeBaseStructInit(RTIM_TimeBaseInitTypeDef *TIM_InitStruct)

Initialize the parameters in the TIM_InitStruct with its default value.

参数:

• TIM_InitStruct -- Pointer to a RTIM_TimeBaseInitTypeDef structure which will be initialized.

void RTIM_UpdateDisableConfig(RTIM_TypeDef *TIMx, u32 NewState)

Enable or Disable the TIMx Update event(UEV).

参数:

• TIMx -- The TIM peripheral, where x can be 0 to (TimerNum - 1). See TIM Peripheral Count.

• NewState -- New state of the TIMx UDIS bit This parameter can be:ENABLE or DISABLE

备注

• If NewState is ENABLE, Update Disable Bit is set, UEV disable and shadow registers keep their value.

• If NewState is DISABLE, Update Disable Bit is clear, UEV enable and buffered registers are loaded with their preload values when UEV happen.

void RTIM_UpdateRequestConfig(RTIM_TypeDef *TIMx, u32 TIM_UpdateSource)

Configure the TIMx Update Request Interrupt source.

参数:

• TIMx -- The TIM peripheral, where x can be 0 to (TimerNum - 1). See TIM Peripheral Count.

• TIM_UpdateSource --

  Specifies the Update source. This parameter can be one of the following values:

  • TIM_UpdateSource_Global: Source of update is the counter overflow or the setting of UG bit.

  • TIM_UpdateSource_Overflow: Source of update is counter overflow.

RTL8721DxRTL8720ERTL8710ERTL8726ERTL8713ERTL8730ERTL8721FRTL8720F

RTL8721Dx:

Not supported.

Interrupt Management Functions

u32 RTIM_GetINTStatus(RTIM_TypeDef *TIMx, u32 TIM_IT)

Check whether the TIM interrupt has occurred or not.

参数:

• TIMx -- The TIM peripheral, where x can be 0 to (TimerNum - 1). See TIM Peripheral Count.

• TIM_IT -- Specifies the TIM interrupt source to check. This parameter is one of the TIM interrupt sources. See TIM Interrupt Control for available values.

返回:

The new state of the TIM_IT:

• TRUE: The specified TIM interrupt has occurred.

• FALSE: The specified TIM interrupt has not occurred.

void RTIM_INTClear(RTIM_TypeDef *TIMx)

Clear the TIMx's all interrupt pending bits.

参数:

• TIMx -- The TIM peripheral, where x can be 0 to (TimerNum - 1). See TIM Peripheral Count.

void RTIM_INTClearPendingBit(RTIM_TypeDef *TIMx, u32 TIM_IT)

Clear the TIMx's interrupt pending bits.

参数:

• TIMx -- The TIM peripheral, where x can be 0 to (TimerNum - 1). See TIM Peripheral Count.

• TIM_IT -- Specifies the pending bit(s) to clear. This parameter is a combination of TIM interrupt bits. See TIM Interrupt Control for available values.

void RTIM_INTConfig(RTIM_TypeDef *TIMx, u32 TIM_IT, u32 NewState)

ENABLE/DISABLE the TIMx's interrupt bits.

参数:

• TIMx -- The TIM peripheral, where x can be 0 to (TimerNum - 1). See TIM Peripheral Count.

• TIM_IT -- Specifies the interrupt bit(s) to configure. This parameter is a combination of TIM interrupt bits. See TIM Interrupt Control for available values.

• NewState -- ENABLE or DISABLE.

Mbed API

MBED_TIMER Exported Types

Structure Type

typedef void (*gtimer_irq_handler)(uint32_t id)

Typedef of interrupt handler function pointer.

typedef struct gtimer_s gtimer_t

Typedef of struct gtimer_s as gtimer_t.

Enumeration Type

RTL8721DxRTL8720ERTL8710ERTL8726ERTL8713ERTL8730ERTL8721FRTL8720F

RTL8721Dx:

enum TIMER_ID

Enumeration of general timer IDs.

Values:

/* General timer 0. */
TIMER0 = 0

/* General timer 1. */
TIMER1 = 1

/* General timer 2. */
TIMER2 = 2

/* General timer 3. */
TIMER3 = 3

/* General timer 4. */
TIMER4 = 4

/* General timer 5. */
TIMER5 = 5

/* General timer 6. */
TIMER6 = 6

/* General timer 7. */
TIMER7 = 7

/* General timer 8. */
TIMER8 = 8

/* General timer 9. */
TIMER9 = 9

/* General timer 10. */
TIMER10 = 10

/* General timer 11. */
TIMER11 = 11

/* Total number of general timers. */
GTIMER_MAX = 12

MBED_TIMER Exported Functions

void gtimer_deinit(gtimer_t *obj)

Deinitialize the timer device, including interrupt and timer registers.

参数:

• obj -- Timer object defined in application software.

void gtimer_init(gtimer_t *obj, uint32_t tid)

Initialize the timer device, including timer registers and interrupt.

参数:

• obj -- Timer object defined in application software.

• tid -- General timer ID, which can be a value of TIMER_ID enumeration.

uint32_t gtimer_read_tick(gtimer_t *obj)

Get counter value of the specified timer.

参数:

• obj -- Timer object defined in application software.

返回:

Counter value.

uint64_t gtimer_read_us(gtimer_t *obj)

Read current timer tick in microsecond.

参数:

• obj -- Timer object defined in application software.

返回:

64b tick time in microsecond(us).

void gtimer_reload(gtimer_t *obj, uint32_t duration_us)

Change period of the specified timer.

参数:

• obj -- Timer object defined in application software.

• duration_us -- Period to be set in microseconds.

void gtimer_start(gtimer_t *obj)

Start the specified timer and enable update interrupt.

参数:

• obj -- Timer object defined in application software.

void gtimer_start_one_shout(gtimer_t *obj, uint32_t duration_us, void *handler, uint32_t hid)

Start the specified timer in one-shot mode with specified period and interrupt handler.

参数:

• obj -- Timer object defined in application software.

• duration_us -- Period to be set in microseconds.

• handler -- User-defined IRQ callback function.

• hid -- User-defined IRQ callback parameter.

备注

In one-shot mode, timer will stop counting the first time counter overflows.

void gtimer_start_periodical(gtimer_t *obj, uint32_t duration_us, void *handler, uint32_t hid)

Start the specified timer in periodical mode with specified period and interrupt handler.

参数:

• obj -- Timer object defined in application software.

• duration_us -- Period to be set in microseconds.

• handler -- User-defined IRQ callback function.

• hid -- User-defined IRQ callback parameter.

备注

In periodical mode, timer will restart from 0 each time the counter overflows.

void gtimer_stop(gtimer_t *obj)

Disable the specified timer peripheral.

参数:

• obj -- Timer object defined in application software.

PWM Timer

功能特性

• 向上计数的 16 位计数器

• 自动重载寄存器的值可以预加载

• 内部有 16 位的分频寄存器

• 每个通道可以独立产生 PWM 波形

• 可以产生的中断类型：

  • 计数器溢出中断

  • 软件更新事件中断

  • 通道的计数器溢出中断

  • 通道的捕获/比较中断

• 三种工作模式

  • PWM 模式：用于生成占空比和周期可配置的方波

  • 输入捕获功能：用于捕获输入引脚上升沿/下降沿时计数器的数值

  • 单脉冲模式：用于检测到输入引脚的上升沿/下降沿/边沿后，在可编程延迟后产生一个具有可编程的脉冲。

应用示例

SDK 提供了两类功能示例，帮助开发者了解和使用 PWM Timer 功能：

• mbed 示例

  • 路径：{SDK}\example\peripheral\mbed\Timer\mbed_pwm

  • 展示如何在 mbed 环境中实现 PWM Timer 控制

• raw 示例

  • 路径：{SDK}\example\peripheral\raw\Timer\{demo}

  • 展示如何在无抽象层的情况下直接控制 PWM Timer

以下是对 raw 示例功能的简要说明：

• raw_pwm 演示如何使用 PWM 模式。

• raw_tim_capture_pwm_32k 演示如何使用 PWM 输入捕获功能。

• raw_tim_pwm_one_pulse 演示如何使用 PWM 单脉冲模式。

备注

要了解示例支持的芯片，请查看示例路径下的 README.md 文件。

Raw API

PWMTIMER Exported Types

struct TIM_CCInitTypeDef

TIM Output Compare Init Structure Definition.

Public Members

u32 TIM_CCMode

Specifies the CC timer mode. This parameter can be a value of TIM_CCMode_PWM or TIM_CCMode_Inputcapture.

u32 TIM_CCPolarity

Specifies the polarity. This parameter can be TIM_CCPolarity_High/TIM_CCPolarity_Low. If CCx channel is configured as output: TIM_CCPolarity_High means OCx active high. TIM_CCPolarity_Low means OCx active low. If CCx channel is configured as input: TIM_CCPolarity_High means positive edge of TRGI is active for capture. TIM_CCPolarity_Low means negative edge of TRGI is active for capture.

u32 TIM_OCProtection

Output Compare value update protection. TIM_OCPreload_Enable/TIM_OCPreload_Disable. TIM_OCPreload_Enable means duty cycle will update when UEV happens if write to CCRx field in TIMx_CCRX. TIM_OCPreload_Disable means duty cycle will update immediately if write to CCRx field in TIMx_CCRX.

u32 TIM_OCPulse

Specifies the output pulse value to be loaded into the CCRx Register, which decides the duty cycle. This parameter can be a number between 0x0000 and 0xFFFF.

u32 TIM_ICPulseMode

Specifies the pulse mode of TIM with pulse capability. This parameter can be TIM_CCMode_PulseWidth or TIM_CCMode_PulseNumber.

RTL8721DxRTL8720ERTL8710ERTL8726ERTL8713ERTL8730ERTL8721FRTL8720F

RTL8721Dx:

Not supported.

PWMTIMER Exported Constants

TIM Capture Compare Control

/* Enable the Capture/Compare channel output. */
#define TIM_CCx_Enable ((u32)0x01000000)

/* Disable the Capture/Compare channel output. */
#define TIM_CCx_Disable ((u32)0x00000000)

/* Check if CCx enable/disable value is valid. */
#define IS_TIM_CCX (((CCX) == TIM_CCx_Enable) || ((CCX) == TIM_CCx_Disable))

/* Enable output compare preload register on CCRx. */
#define TIM_OCPreload_Enable ((u32)0x02000000)

/* Disable output compare preload register on CCRx. */
#define TIM_OCPreload_Disable ((u32)0x00000000)

/* Check if output compare preload state value is valid. */
#define IS_TIM_OCPRELOAD_STATE (((STATE) == TIM_OCPreload_Enable) || \
    ((STATE) == TIM_OCPreload_Disable))

/* if input is set : Positive edge of TRGI is active for capture */
#define TIM_CCPolarity_High ((u32)0x00000000)

/* if input is set : negative edge of TRGI is active for capture */
#define TIM_CCPolarity_Low ((u32)0x04000000)

/* Check if CC polarity value is valid. */
#define IS_TIM_CC_POLARITY (((POLARITY) == TIM_CCPolarity_High) || \
    ((POLARITY) == TIM_CCPolarity_Low))

/* CC channel configured as PWM output mode. */
#define TIM_CCMode_PWM ((u32)0x00000000)

/* CC channel configured as input capture mode. */
#define TIM_CCMode_Inputcapture ((u32)0x08000000)

/* Check if CC mode value is valid. */
#define IS_TIM_CC_MODE (((MODE) == TIM_CCMode_PWM) || \
    ((MODE) == TIM_CCMode_Inputcapture))

TIM CC Event Source

/* Event source: Capture/Compare channel 0 event. */
#define TIM_EventSource_CC0 ((u32)0x00000002)

/* Event source: Capture/Compare channel 1 event. */
#define TIM_EventSource_CC1 ((u32)0x00000004)

/* Event source: Capture/Compare channel 2 event. */
#define TIM_EventSource_CC2 ((u32)0x00000008)

/* Event source: Capture/Compare channel 3 event. */
#define TIM_EventSource_CC3 ((u32)0x00000010)

RTL8721DxRTL8720ERTL8710ERTL8726ERTL8713ERTL8730ERTL8721FRTL8720F

RTL8721Dx:

/* Event source: Capture/Compare channel 4 event. */
#define TIM_EventSource_CC4 ((u32)0x00000020)

/* Event source: Capture/Compare channel 5 event. */
#define TIM_EventSource_CC5 ((u32)0x00000040)

/* Event source: Capture/Compare channel 6 event. */
#define TIM_EventSource_CC6 ((u32)0x00000080)

/* Event source: Capture/Compare channel 7 event. */
#define TIM_EventSource_CC7 ((u32)0x00000100)

TIM Channel

/* Timer channel 0 index. */
#define TIM_Channel_0 ((u16)0x0000)

/* Timer channel 1 index. */
#define TIM_Channel_1 ((u16)0x0001)

/* Timer channel 2 index. */
#define TIM_Channel_2 ((u16)0x0002)

/* Timer channel 3 index. */
#define TIM_Channel_3 ((u16)0x0003)

RTL8721DxRTL8720ERTL8710ERTL8726ERTL8713ERTL8730ERTL8721FRTL8720F

RTL8721Dx:

/* Timer channel 4 index. */
#define TIM_Channel_4 ((u16)0x0004)

/* Timer channel 5 index. */
#define TIM_Channel_5 ((u16)0x0005)

/* Timer channel 6 index. */
#define TIM_Channel_6 ((u16)0x0006)

/* Timer channel 7 index. */
#define TIM_Channel_7 ((u16)0x0007)

/* Check if channel index is a valid timer channel. */
#define IS_TIM_CHANNEL (((CHANNEL) == TIM_Channel_0) || \
    ((CHANNEL) == TIM_Channel_1) || \
    ((CHANNEL) == TIM_Channel_2) || \
    ((CHANNEL) == TIM_Channel_3) || \
    ((CHANNEL) == TIM_Channel_4) || \
    ((CHANNEL) == TIM_Channel_5) || \
    ((CHANNEL) == TIM_Channel_6) || \
    ((CHANNEL) == TIM_Channel_7))

TIM Default Level

/* PWM one-pulse default output level: high. */
#define TIMPWM_DefaultLevel_High ((u32)0x00000000)

/* PWM one-pulse default output level: low. */
#define TIMPWM_DefaultLevel_Low ((u32)0x00000001)

/* Check if default level value is valid. */
#define IS_TIMPWM_DefaultLevel (((LEVEL) == TIMPWM_DefaultLevel_High) || ((LEVEL) == TIMPWM_DefaultLevel_Low))

TIM Interrupt Control

/* Timer counter update interrupt flag. */
#define TIM_IT_Update ((u32)0x00000001)

/* Capture/Compare channel 0 interrupt flag. */
#define TIM_IT_CC0 ((u32)0x00000002)

/* Capture/Compare channel 1 interrupt flag. */
#define TIM_IT_CC1 ((u32)0x00000004)

/* Capture/Compare channel 2 interrupt flag. */
#define TIM_IT_CC2 ((u32)0x00000008)

/* Capture/Compare channel 3 interrupt flag. */
#define TIM_IT_CC3 ((u32)0x00000010)

/* Channel 0 update interrupt enable flag. */
#define TIM_IT_UIE0 ((u32)0x00010000)

/* Channel 1 update interrupt enable flag. */
#define TIM_IT_UIE1 ((u32)0x00020000)

/* Channel 2 update interrupt enable flag. */
#define TIM_IT_UIE2 ((u32)0x00040000)

/* Channel 3 update interrupt enable flag. */
#define TIM_IT_UIE3 ((u32)0x00080000)

RTL8721DxRTL8720ERTL8710ERTL8726ERTL8713ERTL8730ERTL8721FRTL8720F

RTL8721Dx:

/* Capture/Compare channel 4 interrupt flag. */
#define TIM_IT_CC4 ((u32)0x00000020)

/* Capture/Compare channel 5 interrupt flag. */
#define TIM_IT_CC5 ((u32)0x00000040)

/* Capture/Compare channel 6 interrupt flag. */
#define TIM_IT_CC6 ((u32)0x00000080)

/* Capture/Compare channel 7 interrupt flag. */
#define TIM_IT_CC7 ((u32)0x00000100)

/* Channel 4 update interrupt enable flag. */
#define TIM_IT_UIE4 ((u32)0x00100000)

/* Channel 5 update interrupt enable flag. */
#define TIM_IT_UIE5 ((u32)0x00200000)

/* Channel 6 update interrupt enable flag. */
#define TIM_IT_UIE6 ((u32)0x00400000)

/* Channel 7 update interrupt enable flag. */
#define TIM_IT_UIE7 ((u32)0x00800000)

/* Check if interrupt source bitmask is valid. */
#define IS_TIM_IT ((((IT) & (u32)0xFF00FE00) == 0x0000) && (((IT) & (u32)0xFF01FF) != 0x0000))

/* Check if a single interrupt source value is valid. */
#define IS_TIM_GET_IT (((IT) == TIM_IT_Update) || \
    ((IT) == TIM_IT_CC0) || \
    ((IT) == TIM_IT_CC1) || \
    ((IT) == TIM_IT_CC2) || \
    ((IT) == TIM_IT_CC3) || \
    ((IT) == TIM_IT_CC4) || \
    ((IT) == TIM_IT_CC5) || \
    ((IT) == TIM_IT_CC6) || \
    ((IT) == TIM_IT_CC7) || \
    ((IT) == TIM_IT_UIE0) || \
    ((IT) == TIM_IT_UIE1) || \
    ((IT) == TIM_IT_UIE2) || \
    ((IT) == TIM_IT_UIE3) || \
    ((IT) == TIM_IT_UIE4) || \
    ((IT) == TIM_IT_UIE5) || \
    ((IT) == TIM_IT_UIE6) || \
    ((IT) == TIM_IT_UIE7))

TIM OPM Control

/* External trigger polarity: positive edge active. */
#define TIM_OPMode_ETP_positive ((u32)0x00000000)

/* External trigger polarity: negative edge active. */
#define TIM_OPMode_ETP_negative ((u32)0x00000100)

/* External trigger polarity: both edges active. */
#define TIM_OPMode_ETP_bothedge ((u32)0x00000200)

/* Check if external trigger polarity mode is valid. */
#define IS_TIM_OPM_ETP_MODE (((MODE) == TIM_OPMode_ETP_positive) || \
    ((MODE) == TIM_OPMode_ETP_negative) || \
    ((MODE) == TIM_OPMode_ETP_bothedge))

/* One-pulse mode: counter stops at next update event. */
#define TIM_OPMode_Single ((u32)0x00000008)

/* Repetitive (PWM) mode: counter does not stop at next update event. */
#define TIM_OPMode_Repetitive ((u32)0x00000000)

/* Check if one-pulse operation mode value is valid. */
#define IS_TIM_OPM_MODE (((MODE) == TIM_OPMode_Single) || \
    ((MODE) == TIM_OPMode_Repetitive))

TIM Phase Sync Control

/* Phase sync direction: channel delays behind reference counter. */
#define TIMPWM_PSync_Delay ((u32)0x00000000)

/* Phase sync direction: channel leads ahead of reference counter. */
#define TIMPWM_PSync_Ahead ((u32)0x00000001)

/* Check if phase sync direction value is valid. */
#define IS_TIMPWM_PSync_Dir (((DIR) == TIMPWM_PSync_Delay) || ((DIR) == TIMPWM_PSync_Ahead))

/* Enable phase sync parameter preload register. */
#define TIMPWM_PSyncPreload_Enable ((u32)0x00000000)

/* Disable phase sync parameter preload register. */
#define TIMPWM_PSyncPreload_Disable ((u32)0x00000001)

/* Check if phase sync preload state value is valid. */
#define IS_TIMPWM_PPRELOAD_STATE (((STATE) == TIMPWM_PSyncPreload_Enable) || \
    ((STATE) == TIMPWM_PSyncPreload_Disable))

TIM PWM Type

RTL8721DxRTL8720ERTL8710ERTL8726ERTL8713ERTL8730ERTL8721FRTL8720F

RTL8721Dx:

/* Check if peripheral is a one-pulse capable timer. */
#define IS_TIM_ONE_PULSE_TIM (((PERIPH) == TIM8) || \
    ((PERIPH) == TIM8_S))

/* Check if peripheral is a capture/compare mode timer. */
#define IS_TIM_CCM_TIM (((PERIPH) == TIM8) || \
    ((PERIPH) == TIM9) || \
    ((PERIPH) == TIM8_S) || \
    ((PERIPH) == TIM9_S))

/* Check if peripheral is a PWM output timer. */
#define IS_TIM_PWM_TIM (((PERIPH) == TIM8) || \
    ((PERIPH) == TIM8_S))

PWM AUD Channel

RTL8721DxRTL8720ERTL8710ERTL8726ERTL8713ERTL8730ERTL8721FRTL8720F

RTL8721Dx:

Not supported.

PWM Audio and Motor Control

RTL8721DxRTL8720ERTL8710ERTL8726ERTL8713ERTL8730ERTL8721FRTL8720F

RTL8721Dx:

Not supported.

PWM Audio and Motor Interrupt Control

RTL8721DxRTL8720ERTL8710ERTL8726ERTL8713ERTL8730ERTL8721FRTL8720F

RTL8721Dx:

Not supported.

PWMTIMER Exported Functions

Capture Compare Management Functions

void RTIM_CCRxMode(RTIM_TypeDef *TIMx, u16 TIM_Channel, u32 TIM_CCMode)

Initialize the TIMx Channel CCmode.

参数:

• TIMx -- The TIM peripheral with PWM output capability. See IS_TIM_PWM_TIM macro.

• TIM_Channel -- The channel need to be set mode, which can be one of the following parameters TIM Channel.

• TIM_CCMode --

  CCx working mode which can be one of the following parameters:

  • TIM_CCMode_PWM

  • TIM_CCMode_Inputcapture

void RTIM_CCRxSet(RTIM_TypeDef *TIMx, u32 Compare, u16 TIM_Channel)

Set the TIMx Capture Compare X register value.

参数:

• TIMx -- The TIM peripheral with PWM output capability. See IS_TIM_PWM_TIM macro.

• Compare -- The value specifies pulsewidth, which is in the 0x00~0xFFFF range. Duty cycle = Compare / (ARR+1).

• TIM_Channel -- The channel to be set, which can be one of the following parameters TIM Channel.

备注

• CCRx=0 will give 0% cycle pwm pulse.

• CCRx>=TIM_Period there will be 100% pwm pulse.

void RTIM_CCStructInit(TIM_CCInitTypeDef *TIM_CCInitStruct)

Fill each TIM_CCInitStruct member with its default value.

参数:

• TIM_CCInitStruct -- Pointer to a TIM_CCInitTypeDef structure which will be initialized.

void RTIM_CCxCmd(RTIM_TypeDef *TIMx, u16 TIM_Channel, u32 TIM_CCx)

Enable or disable the TIM Capture Compare Channel x.

参数:

• TIMx -- The TIM peripheral with CCM capability. See IS_TIM_CCM_TIM macro.

• TIM_Channel -- Specifies the TIM Channel This parameter can be one of the following values TIM Channel

• TIM_CCx --

  Specifies the TIM Channel CCxE bit new state. This parameter can be one of the following values:

  • TIM_CCx_Enable

  • TIM_CCx_Disable

void RTIM_CCxInit(RTIM_TypeDef *TIMx, TIM_CCInitTypeDef *TIM_CCInitStruct, u16 TIM_Channel)

Initialize the TIMx Channel according to the specified parameters in the TIM_CCInitStruct.

参数:

• TIMx -- The TIM peripheral with CCM capability. See IS_TIM_CCM_TIM macro.

• TIM_CCInitStruct -- Pointer to a TIM_CCInitTypeDef structure that contains the configuration information for the specified TIM peripheral.

• TIM_Channel -- The channel need to be initialized, which can be one of the following parameters TIM Channel

void RTIM_CCxPolarityConfig(RTIM_TypeDef *TIMx, u32 TIM_OCPolarity, u16 TIM_Channel)

Configure the TIMx channel x polarity.

参数:

• TIMx -- The TIM peripheral with CCM capability. See IS_TIM_CCM_TIM macro.

• TIM_OCPolarity --

  Specifies the OCx Polarity This parameter can be one of the following values:

  • TIM_CCPolarity_High: Output Compare active high

  • TIM_CCPolarity_Low: Output Compare active low

• TIM_Channel -- Specifies the TIM Channel This parameter can be one of the following values TIM Channel

void RTIM_OCxPreloadConfig(RTIM_TypeDef *TIMx, u32 TIM_OCProtection, u16 TIM_Channel)

Enable or disable the TIMx peripheral Preload register on CCRx.

参数:

• TIMx -- The TIM peripheral with PWM output capability. See IS_TIM_PWM_TIM macro.

• TIM_OCProtection --

  New state of the TIMx peripheral Preload register This parameter can be one of the following values:

  • TIM_OCPreload_Enable: value is loaded in the active register at each update event.

  • TIM_OCPreload_Disable: new value is taken in account immediately

• TIM_Channel -- The channel need to be set, which can be one of the following parameters TIM Channel

void RTIM_SetOnePulseDefaultLevel(RTIM_TypeDef *TIMx, u16 TIM_Channel, u32 DefaultLevel)

Set the TIMx's default level in one pulse mode.

参数:

• TIMx -- The TIM peripheral with PWM output capability. See IS_TIM_PWM_TIM macro.

• TIM_Channel -- The channel to be set, which can be one of the following parameters TIM Channel.

• DefaultLevel --

  Specifies the OPM Mode Default Level. This parameter can be one of the following values:

  • TIMPWM_DefaultLevel_High

  • TIMPWM_DefaultLevel_Low

备注

• Takes effect only in PWM output mode's One-Pulse-Mode.

• You must select TIM_OPMode_Single if you want to set One Pulse Mode, which makes the counter stop automatically at the next UEV.

void RTIM_SetOnePulseOutputMode(RTIM_TypeDef *TIMx, u32 TIM_OPMode, u32 TriggerPolarity)

Set the TIMx's One Pulse Mode (output one pulse PWM mode).

参数:

• TIMx -- The TIM peripheral with PWM output capability. See IS_TIM_PWM_TIM macro.

• TIM_OPMode --

  Specifies the OPM Mode to be used. This parameter can be one of the following values:

  • TIM_OPMode_Single

  • TIM_OPMode_Repetitive

• TriggerPolarity --

  Specifies the OPM Mode Trigger Polarity. This parameter can be one of the following values:

  • TIM_OPMode_ETP_positive

  • TIM_OPMode_ETP_negative

  • TIM_OPMode_ETP_bothedge

备注

You must select TIM_OPMode_Single if you want to set One Pulse Mode, which makes the counter stop automatically at the next UEV.

RTL8721DxRTL8720ERTL8710ERTL8726ERTL8713ERTL8730ERTL8721FRTL8720F

RTL8721Dx:

Not supported.

Phase Sync Functions

u32 RTIM_GetChannelCountx(RTIM_TypeDef *TIMx, u16 TIM_Channel)

Get the TIMx Channel Counter value.

参数:

• TIMx -- The TIM peripheral with PWM output capability. See IS_TIM_PWM_TIM macro.

• TIM_Channel -- Specifies the TIM Channel This parameter can be one of the following values TIM Channel

返回:

Counter Register value.

void RTIM_PSyncxCmd(RTIM_TypeDef *TIMx, u16 TIM_Channel, u8 NewState)

Enable or disable the TIMx Phase Sync function.

参数:

• TIMx -- The TIM peripheral with PWM output capability. See IS_TIM_PWM_TIM macro.

• TIM_Channel -- Specifies the TIM Channel This parameter can be one of the following values TIM Channel

• NewState -- ENABLE/DISABLE.

void RTIM_PSyncxDir(RTIM_TypeDef *TIMx, u16 TIM_Channel, u8 TIM_SyncDir)

Set the TIMx Phase Sync X direction.

参数:

• TIMx -- The TIM peripheral with PWM output capability. See IS_TIM_PWM_TIM macro.

• TIM_Channel -- The channel to be set, which can be one of the following parameters TIM Channel.

• TIM_SyncDir -- TIMPWM_PSync_Delay/TIMPWM_PSync_Ahead

u32 RTIM_PSyncxGet(RTIM_TypeDef *TIMx, u16 TIM_Channel)

Get the TIMx Phase Sync X value.

参数:

• TIMx -- The TIM peripheral with PWM output capability. See IS_TIM_PWM_TIM macro.

• TIM_Channel -- The channel to be read, which can be one of the following parameters TIM Channel.

返回:

TIMx Phase Sync X value.

void RTIM_PSyncxPreloadConfig(RTIM_TypeDef *TIMx, u16 TIM_Channel, u32 TIM_PSyncProtection)

Enable or disable the preload function of TIMx phase sync register.

参数:

• TIMx -- The TIM peripheral with PWM output capability. See IS_TIM_PWM_TIM macro.

• TIM_Channel -- The channel need to be set, which can be one of the following parameters TIM Channel

• TIM_PSyncProtection --

  TIMPWM_PSyncPreload_Enable/TIMPWM_PSyncPreload_Disable

  • TIMPWM_PSyncPreload_Enable: value is loaded in the active register at each update event.

  • TIMPWM_PSyncPreload_Disable: new value is taken in account immediately

void RTIM_PSyncxSet(RTIM_TypeDef *TIMx, u16 TIM_Channel, u32 TIM_SyncPhase)

Set the TIMx Phase Sync X value.

参数:

• TIMx -- The TIM peripheral with PWM output capability. See IS_TIM_PWM_TIM macro.

• TIM_Channel -- The channel to be set, which can be one of the following parameters TIM Channel.

• TIM_SyncPhase -- The phase sync value compared to CNT in TIM_CNT

备注

• TIM_SyncPhase should always smaller than ARR value

Audio and Motor Functions

RTL8721DxRTL8720ERTL8710ERTL8726ERTL8713ERTL8730ERTL8721FRTL8720F

RTL8721Dx:

Not supported.

Mbed API

MBED_PWM Exported Types

Structure Type

typedef struct pwmout_s pwmout_t

Typedef struct pwmout_s to pwmout_t.

MBED_PWM Exported Functions

void pwmout_free(pwmout_t *obj)

Deinitialize the PWM device of the specified channel.

参数:

• obj -- PWM object defined in application software.

备注

If all channels are released, PWMTIMER will also be disabled.

void pwmout_init(pwmout_t *obj, PinName pin)

Initialize PWM channel output according to the specified pin.

参数:

• obj -- PWM object defined in application software.

• pin -- Pin name of corresponding PWM channel to be set.

备注

• Default period: 1638us.

• Default pulse width: 102us.

• Default duty cycle: 6.227%.

void pwmout_period(pwmout_t *obj, float seconds)

Set the period of the specified channel in seconds.

参数:

• obj -- PWM object defined in application software.

• seconds -- The period value to be set in seconds(s).

void pwmout_period_ms(pwmout_t *obj, int ms)

Set the period of the specified channel in milliseconds.

参数:

• obj -- PWM object defined in application software.

• ms -- The period value to be set in milliseconds(ms).

void pwmout_period_us(pwmout_t *obj, int us)

Set the period of the specified channel in microseconds.

参数:

• obj -- PWM object defined in application software.

• us -- The period value to be set in microseconds(us).

void pwmout_pulsewidth(pwmout_t *obj, float seconds)

Set the pulse width of the specified channel in seconds.

参数:

• obj -- PWM object defined in application software.

• seconds -- The pulse width value to be set in seconds(s).

void pwmout_pulsewidth_ms(pwmout_t *obj, int ms)

Set the pulse width of the specified channel in milliseconds.

参数:

• obj -- PWM object defined in application software.

• ms -- The pulse width value to be set in milliseconds(ms).

void pwmout_pulsewidth_us(pwmout_t *obj, int us)

Set the pulse width of the specified channel in microseconds.

参数:

• obj -- PWM object defined in application software.

• us -- The pulse width value to be set in microseconds(us).

float pwmout_read(pwmout_t *obj)

Get the duty cycle of the specified channel.

参数:

• obj -- PWM object defined in application software.

返回:

Duty cycle of the specified channel, in the range [0.0, 1.0].

void pwmout_set_polarity(pwmout_t *obj, int polarity)

Set the polarity of the specified PWM channel.

参数:

• obj -- PWM object defined in application software.

• polarity --

  This parameter can be one of the following values:

  • 0: Output is LOW when timer count < set value.

  • 1: Output is HIGH when timer count < set value (default).

注意

Configure polarity after setting duty cycle or pulse width.

void pwmout_start(pwmout_t *obj)

Enable the specified channel to output PWM.

参数:

• obj -- PWM object defined in application software.

void pwmout_stop(pwmout_t *obj)

Disable the specified channel to output PWM.

参数:

• obj -- PWM object defined in application software.

void pwmout_write(pwmout_t *obj, float percent)

Set the duty cycle of the specified channel.

参数:

• obj -- PWM object defined in application software.

• percent -- The duty cycle value to be set.

Capture Timer

功能特性

• 向上计数的 16 位计数器

• 内部有 16 位的分频寄存器

• 自动重载寄存器的值可以预加载

• 两种工作模式：

  • 记录输入引脚的脉冲宽度

  • 记录输入引脚在可配置周期内脉冲的数量

应用示例

SDK 提供了 raw 示例，帮助开发者了解和使用 Capture Timer 功能：

• 路径：{SDK}\example\peripheral\raw\Timer\{demo}

• 展示如何在无抽象层的情况下直接控制 Capture Timer

以下是对 raw 示例功能的简要说明：

• raw_tim_pulse_width_32k 演示如何使用 Capture Timer 捕获脉冲宽度功能。

• raw_tim_pulse_num_32k 演示如何使用 Capture Timer 捕获脉冲数量。

备注

要了解示例支持的芯片，请查看示例路径下的 README.md 文件。

Raw API

CAPTIMER Exported Constants

TIM CC Pulse Mode

/* Input pulse mode: measure pulse width. */
#define TIM_CCMode_PulseWidth ((u32)0x00000000)

/* Input pulse mode: count pulse number. */
#define TIM_CCMode_PulseNumber ((u32)0x10000000)

/* Check if TIM pulse mode value is valid. */
#define IS_TIM_CC_PULSEMODE (((MODE) == TIM_CCMode_PulseWidth) || \
    ((MODE) == TIM_CCMode_PulseNumber))

/* Maximum CCR value mask (16-bit). */
#define TIM_CCMode_CCR ((u32)0x0000FFFF)

/* Check if pulse width compare value fits in CCR. */
#define IS_TIM_CC_PULSEWIDTH ((Compare) <= TIM_CCMode_CCR)

TIM Capture Type

RTL8721DxRTL8720ERTL8710ERTL8726ERTL8713ERTL8730ERTL8721FRTL8720F

RTL8721Dx:

/* Check if peripheral is an input pulse capture timer. */
#define IS_TIM_INPULSE_TIM (((PERIPH) == TIM9) || \
    ((PERIPH) == TIM9_S))

CAPTIMER Exported Functions

u32 RTIM_CCRxGet(RTIM_TypeDef *TIMx, u16 TIM_Channel)

Get the TIMx Capture Compare X register value.

参数:

• TIMx -- The TIM peripheral with CCM capability. See IS_TIM_CCM_TIM macro.

• TIM_Channel -- The channel to be read, which can be one of the following parameters TIM Channel.

返回:

Capture Compare x Register value.

备注

If you want to get pulse width of PWM, remember to plus 1 to the return value of this function.

Debug Timer

功能特性

• 两种时钟源可选：

  • XTAL40M：通过分频器得到 1M 的时钟源，每一拍计数时间是 1us

  • SDM32K：时钟频率为 32768 Hz，每一拍周期约为 30.5us；由于计数器不保存小数，每一拍计数值增加 31us（硬件固有的舍入误差）

• 可以在睡眠状态下继续计数

• 无锁计数器：支持多核环境下安全并发读写

Raw API

DEBUGTIMER Exported Constants

Debug Timer Clock Source

/* Select XTAL as clock source */
#define DTIM_CLK_XTAL 0

/* Select 32K as clock source */
#define DTIM_CLK_32K 1

DEBUGTIMER Exported Functions

u32 DTimer_AtomGet(void)

Get the Debug Timer atom counter value. Reading this register does not increment the atom counter.

返回:

Current atom counter value.

u32 DTimer_AtomIncGet(void)

Get the Debug Timer atom counter value and trigger auto-increment. Reading this register auto-increments the atom counter by 1.

返回:

Atom counter value after auto-increment.

void DTimer_AtomSet(u32 NewValue)

Set the Debug Timer atom counter value.

参数:

• NewValue -- New atom counter value.

void DTimer_Cmd(bool Newstatus)

Enable or disable the Debug Timer peripheral The debug timer is a free-running timer that works at 1 MHz.

参数:

• Newstatus -- New state of the Debug Timer peripheral. This parameter can be: ENABLE or DISABLE.

u32 DTimer_ScratchGet(void)

Get the Debug Timer scratch register value.

返回:

Current scratch register value.

void DTimer_ScratchSet(u32 NewValue)

Set the Debug Timer scratch register value.

参数:

• NewValue -- New scratch register value.

u32 DTimestamp_Get(void)

Get the Debug Timer u32 current counter.

返回:

Current u32 counter value.

RTL8721DxRTL8720ERTL8710ERTL8726ERTL8713ERTL8730ERTL8721FRTL8720F

RTL8721Dx:

void DTimestamp_Set(u32 NewValue)

Set the Debug Timer current counter.

参数:

• NewValue -- New counter value.

void DTimer_CLK(u8 DTim_speed)

Select clock for timestamp, which works at 1MHz by default.

参数:

• DTim_speed --

  Speed of debugtimer counter.

  • 0: OSC32KHz.

  • 1: 1MHz, which is divided from XTAL40MHz.

PMC Timer

功能特性

RTL8721DxRTL8720ERTL8710ERTL8726ERTL8713ERTL8730ERTL8721FRTL8720FRTL8735C

RTL8721Dx:

• 有两组 PMC Timer， 每组 PMC Timer 内有四个计数器

  • 休眠倒计时计数器

  • 深度休眠倒计时计数器

  • 唤醒计数器

  • 预留计数器

• 32 位宽向下计数，计数到 0 后自动停止

• 在计数到 0 之后可配置是否产生中断

• 以 SDM32K 作为时钟源

• 在计数器工作过程中可以重新设置定时器倒计时的值

Raw API

PMCTIMER Exported Constants

PMCTIMER Device Config

RTL8721DxRTL8720ERTL8710ERTL8726ERTL8713ERTL8730ERTL8721FRTL8720F

RTL8721Dx:

/* PMC timer device instance for CM4/KM4 core. */
#define PMC_TIMER_DEV PMCTIMER_DEV0

/* PMC timer device instance for CM0/KM0 core. */
#define PMC_TIMER_DEV PMCTIMER_DEV1

/* PMC timer IRQ number for CM4/KM4 core. */
#define PMC_TIMER_IRQ PMC_TIMER0_IRQ

/* PMC timer IRQ number for CM0/KM0 core. */
#define PMC_TIMER_IRQ PMC_TIMER1_IRQ

/* PMC timer interrupt priority. */
#define PMC_TIMER_INT_PRIO INT_PRI_LOWEST

PMCTIMER Index

RTL8721DxRTL8720ERTL8710ERTL8726ERTL8713ERTL8730ERTL8721FRTL8720F

RTL8721Dx:

/* PMC timer index for system active time during sleep. */
#define PMC_SLEEP_TIMER 0

/* PMC timer index for system active time during deep sleep. */
#define PMC_DSLP_TIMER 1

/* PMC timer index for setting wakeup time during sleep. */
#define PMC_WAKEUP_TIMER 2

/* Reserved PMC timer index. */
#define PMC_RSVD_TIMER 3

PMCTIMER Valid Check

RTL8721DxRTL8720ERTL8710ERTL8726ERTL8713ERTL8730ERTL8721FRTL8720F

RTL8721Dx:

/* Bit mask for timer x configuration valid status. */
#define PMCT_BIT_TIM_VALIDx ((u32)(0x00000001 << (8 + x)))

PMCTIMER Reset

RTL8721DxRTL8720ERTL8710ERTL8726ERTL8713ERTL8730ERTL8721FRTL8720F

RTL8721Dx:

/* Bit mask to pulse reset timer x. */
#define PMCTRESET_BIT_TIMERx ((u32)(0x00000001 << (28 + x)))

PMCTIMER Exported Functions

RTL8721DxRTL8720ERTL8710ERTL8726ERTL8713ERTL8730ERTL8721FRTL8720F

RTL8721Dx:

u32 PMCTimerCnt_Get(PMCTIMER_TpyeDef *PMC_TIMER, u32 Timer_Idx)

Get the pmc timer current Counter value.

参数:

• PMC_TIMER -- The pointer of PMC TIMER DEV.

• Timer_Idx -- Timer index in PMC TIMER DEV. This parameter can be: 0 ~ 3.

返回:

Current counter value.

void PMCTimerCnt_Reset(PMCTIMER_TpyeDef *PMC_TIMER, u32 Timer_Idx)

Reset the pmc timer count down value.

参数:

• PMC_TIMER -- The pointer of PMC TIMER DEV.

• Timer_Idx -- Timer index in PMC TIMER DEV. This parameter can be: 0 ~ 3.

void PMCTimerCnt_Set(PMCTIMER_TpyeDef *PMC_TIMER, u32 Timer_Idx, u32 NewValue)

Set the pmc timer count down value.

参数:

• PMC_TIMER -- The pointer of PMC TIMER DEV.

• Timer_Idx -- Timer index in PMC TIMER DEV. This parameter can be: 0 ~ 3.

• NewValue -- New counter.

void PMCTimer_Cmd(PMCTIMER_TpyeDef *PMC_TIMER, u32 Timer_Idx, bool NewState)

Enable or disable the pmc timer counter The pmc timer group contains 4 timers for each group, all runs at 32k.

参数:

• PMC_TIMER -- The pointer of PMC TIMER DEV.

• Timer_Idx -- Timer index in PMC TIMER DEV. This parameter can be: 0 ~ 3.

• NewState -- New state of the PMC timer counter. This parameter can be: ENABLE or DISABLE.

void PMCTimer_INTClear(PMCTIMER_TpyeDef *PMC_TIMER, u32 Timer_Idx)

Clear the pmc timer's interrupt bits.

参数:

• PMC_TIMER -- The pointer of PMC TIMER DEV.

• Timer_Idx -- Timer index in PMC TIMER DEV. This parameter can be: 0 ~ 3.

void PMCTimer_INTConfig(PMCTIMER_TpyeDef *PMC_TIMER, u32 Timer_Idx, u32 NewState)

ENABLE/DISABLE the pmc timer's interrupt bits.

参数:

• PMC_TIMER -- The pointer of PMC TIMER DEV.

• Timer_Idx -- Timer index in PMC TIMER DEV. This parameter can be: 0 ~ 3.

• NewState -- ENABLE or DISABLE.

u32 PMCTimer_Valid_Check(PMCTIMER_TpyeDef *PMC_TIMER, u32 Timer_Idx)

Check pmctimer current state.

参数:

• PMC_TIMER -- The pointer of PMC TIMER DEV.

• Timer_Idx -- Timer index in PMC TIMER DEV. This parameter can be: 0 ~ 3.

返回:

The validation result:

• TRUE: valid

• FALSE: not valid