预装载功能探究一：比较/捕获寄存器预装载使能的意义

以沁恒CH32V307VCT6芯片测试为基准，测试开发板：CH32V307V-R1-1V0

以下内容均为解析调用此句代码的意义

TIM_OC1PreloadConfig ( TIM1, TIM_OCPreload_Enable );

第一层：解析底层代码结构

void TIM_OC1PreloadConfig(TIM_TypeDef *TIMx, uint16_t TIM_OCPreload)

{

    uint16_t tmpccmr1 = 0;

    tmpccmr1 = TIMx->CHCTLR1;

    tmpccmr1 &= (uint16_t) ~((uint16_t)TIM_OC1PE);

    tmpccmr1 |= TIM_OCPreload;

    TIMx->CHCTLR1 = tmpccmr1;

}

#define  TIM_OC1PE        ((uint16_t)0x0008)    /* Output Compare 1 Preload enable */

解析：从代码中可以看出底层代码是对“输出比较寄存器1（TIMx_CHCTLR1）”的

bit3位进行置位和初始化；

第二层：解析手册中关于此位的描述

手册中输出比较寄存器1（TIMx_CHCTLR1）

“Bit3：OC1PE-输出比较寄存器1预装载使能位”详细描述如下：

输出比较寄存器1预装载使能位

1：开启输出比较寄存器1（TIMx_CH1CVR）的预装载功能，读写操作仅对预装载寄存器操作，输出比较寄存器1的预装载值在更新事件到来时被加载至当前影子寄存器中；

0：禁止输出比较寄存器1的预装载功能，可随时写入输出比较寄存器1，并且新写入的数值立即起作用

首先我们所用的“输出比较寄存器1（TIMx_CH1CVR）”实际上均是由两个寄存器组成的:

Preload register(预装载寄存器)+ Shadow register(影子寄存器)

如果OC1PE=0，即不使能CH1CVR的预装载功能，则修改TIMx_CH1CVR寄存器的值就是操作影子寄存器，新的CH1CVR的值会立即生效。

如果OC1PE=1，即使能CH1CVR的预装载功能，则修改TIMx_CH1CVR 寄存器的值就是操作预装载寄存器，要等到发生更新事件后，TIMx_CH1CVR预装载寄存器的值才会拷贝到影子寄存器中,进而新的CH1CVR的值才会生效。

第三层：实验代码深度解析

实验代码：

设定系统时钟为SYSCLK_CLOCK=48MHz;

设定定时器1预分频系数PSC=48000-1,即定时器1ms记一个数；

设定定时器1自动重装载值ARR=100-1,即定时器计数到100更新一次，周期为100ms;

设定TIM1_CH1、TIM1_CH2、TIM1_CH3均为输出比较模式，且配置相同。

设定定时器1输出比较寄存器1、2、3的值为CH1CVR=CH2CVR=CH3CVR=CCP=30。

开启输出比较寄存器1（TIM1_CH1）的预装载功能

禁止输出比较寄存器2（TIM1_CH2）的预装载功能。

开启定时器1更新中断，设定进入5次中断后更改输出比较寄存器1和2的值

CH1CVR=CH2CVR=90;

三个通道波形如下所示：

波形图解析：

在输出5次正常的占空比30%的PWM波后，即定时器第5次进入定时器更新中断后

程序中将CH1CVR=CH2CVR=90，即将后续PWM输出的占空比更改为90%

        1.对于TIM1_CH1，开启输出比较寄存器1（TIM1_CH1）的预装载功能；

TIM1->CH1CVR=90;的操作相当于将值存入预装载寄存器，在等待发生更新事件（波形图B线处）后，会将值拷贝到影子寄存器，进而新的CH1CVR的值才会生效。

        2.对于TIM1_CH2，禁止输出比较寄存器2（TIM1_CH2）的预装载功能；

TIM1->CH2CVR=90;的操作相当于将值直接存入影子寄存器（波形图A线处），新的CH2CVR的值会立刻生效。

完整程序如下：

#include "debug.h"
void TIM1_UP_IRQHandler(void) __attribute__((interrupt("WCH-Interrupt-fast")));
u16 i=0;

void TIM1_OutCompare_Init( u16 arr, u16 psc, u16 ccp )
{
    GPIO_InitTypeDef GPIO_InitStructure={0};
    TIM_OCInitTypeDef TIM_OCInitStructure={0};
    TIM_TimeBaseInitTypeDef TIM_TimeBaseInitStructure={0};
    NVIC_InitTypeDef  NVIC_InitStructure = {0};

    RCC_APB2PeriphClockCmd( RCC_APB2Periph_GPIOA | RCC_APB2Periph_TIM1, ENABLE );

    GPIO_InitStructure.GPIO_Pin = GPIO_Pin_8;
    GPIO_InitStructure.GPIO_Mode = GPIO_Mode_AF_PP;
    GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz;
    GPIO_Init( GPIOA, &GPIO_InitStructure );
    GPIO_InitStructure.GPIO_Pin = GPIO_Pin_9;
    GPIO_InitStructure.GPIO_Mode = GPIO_Mode_AF_PP;
    GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz;
    GPIO_Init( GPIOA, &GPIO_InitStructure );
    GPIO_InitStructure.GPIO_Pin = GPIO_Pin_10;
    GPIO_InitStructure.GPIO_Mode = GPIO_Mode_AF_PP;
    GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz;
    GPIO_Init( GPIOA, &GPIO_InitStructure );

    TIM_TimeBaseInitStructure.TIM_Period = arr;
    TIM_TimeBaseInitStructure.TIM_Prescaler = psc;
    TIM_TimeBaseInitStructure.TIM_ClockDivision = TIM_CKD_DIV1;
    TIM_TimeBaseInitStructure.TIM_CounterMode = TIM_CounterMode_Up;
    TIM_TimeBaseInit( TIM1, &TIM_TimeBaseInitStructure);

    TIM_OCInitStructure.TIM_OCMode = TIM_OCMode_PWM1;
    TIM_OCInitStructure.TIM_OutputState = TIM_OutputState_Enable;
    TIM_OCInitStructure.TIM_Pulse = ccp;
    TIM_OCInitStructure.TIM_OCPolarity = TIM_OCPolarity_High;
    TIM_OC1Init( TIM1, &TIM_OCInitStructure );
    TIM_OC2Init( TIM1, &TIM_OCInitStructure );
    TIM_OC3Init( TIM1, &TIM_OCInitStructure );

    NVIC_InitStructure.NVIC_IRQChannel = TIM1_UP_IRQn;
    NVIC_InitStructure.NVIC_IRQChannelPreemptionPriority = 0;
    NVIC_InitStructure.NVIC_IRQChannelSubPriority = 0;
    NVIC_InitStructure.NVIC_IRQChannelCmd = ENABLE;
    NVIC_Init(&NVIC_InitStructure);

    TIM_CtrlPWMOutputs(TIM1, ENABLE );
    TIM_OC1PreloadConfig( TIM1, TIM_OCPreload_Enable );
    TIM_OC2PreloadConfig( TIM1, TIM_OCPreload_Disable );
    TIM_OC3PreloadConfig( TIM1, TIM_OCPreload_Disable );
    TIM_ARRPreloadConfig( TIM1, ENABLE );
    TIM_ClearITPendingBit(TIM1,TIM_IT_Update);
    TIM_ITConfig(TIM1,TIM_IT_Update,ENABLE);
    TIM_Cmd( TIM1, ENABLE );
}

void TIM1_UP_IRQHandler(void)
{

    if(TIM_GetITStatus(TIM1,TIM_IT_Update) == SET)
    {
        i++;
        if(i==5)
        {
            TIM1->CH1CVR=90;
            TIM1->CH2CVR=90;
        }
        TIM_ClearFlag(TIM1,TIM_IT_Update);
    }

}

int main(void)
{
    TIM1_OutCompare_Init( 100-1, 48000-1, 30 );//1ms记一个数
    while(1);
}