【正点原子STM32连载】 第二十八章 PVD电压监控实验摘自【正点原子】APM32E103最小系统板使用指南

1）实验平台：正点原子APM32E103最小系统板
2）平台购买地址：https://detail.tmall.com/item.htm?id=609294757420
3）全套实验源码+手册+视频下载地址： http://www.openedv.com/docs/boards/xiaoxitongban

第二十八章 PVD电压监控实验

本章介绍APM32E103电源电压监测器（PVD）的使用，PVD可以设置一个电压阈值，当监测到电源电压低于该阈值后，可以触发中断，以完成一些紧急处理。通过本章的学习，读者将学习到PVD的使用。
本章分为如下几个小节：
28.1 硬件设计
28.2 程序设计
28.3 下载验证

28.1 硬件设计
28.1.1 例程功能

1. 当MCU电源电压低于2.7V时，LED1亮起，并且LCD显示相应的提示；当MCU电源电压恢复至高于2.7V时，LED1熄灭，并且LCD显示相应的提示
2. LED0闪烁，指示程序正在运行
   28.1.2 硬件资源
3. LED
   LED0 - PB5
   LED1 - PE5
4. 正点原子 2.8/3.5/4.3/7/10寸TFTLCD模块（仅限MCU屏，16位8080并口驱动）
5. PVD
   28.1.3 原理图
   本章实验使用的PVD为APM32E103的片上资源，因此没有对应的连接原理图。
   28.2 程序设计
   28.2.1 Geehy标准库的PMU驱动
   本章实验使用的PVD为PMU的子模块，因此对PVD的操作函数都由Geehy标准库中的PMU驱动提供，使用PVD的具体步骤如下：
   ①：配置PVD电压阈值
   ②：配置PVD输出对应的EINT线
   ③：使能PVD中断，并配置其相关的中断优先级
   ④：使能PVD
   在Geehy标准库中对应的驱动函数如下：
   ①：配置PVD电压阈值
   该函数用于配置PVD的电压阈值，其函数原型如下所示：
   void PMU_ConfigPVDLevel(PMU_PVD_LEVEL_T level);
   该函数的形参描述，如下表所示：
   形参 描述
   level PVD电压阈值
   例如：PMU_PVD_LEVEL_2V0、PMU_PVD_LEVEL_2V1等（在apm32e10x_pmu.h文件中有定义）
   表28.2.1.1 函数PMU_ConfigPVDLevel()形参描述
   该函数的返回值描述，如下表所示：
   返回值 描述
   无 无
   表28.2.1.2 函数PMU_ConfigPVDLevel()返回值描述
   该函数的使用示例，如下所示：

#include "apm32e10x.h"
#include "apm32e10x_pmu.h"

void example_fun(void)
{
    /* 配置PVD的阈值电压的2.7V */
    PMU_ConfigLVDLevel(PMU_PVD_LEVEL_2V7);
}

②：配置EINT
PVD输出对应的外部中断与事件线为EINT16，其配置方式请见第12.2.3小节中配置EINT的相关内容。
③：使能PVD中断
请见第12.2.3小节中配置中断的相关内容。
④：使能PVD
该函数用于使能PVD，其函数原型如下所示：
void PMU_EnablePVD(void);
该函数的形参描述，如下表所示：
形参 描述
无 无
表28.2.1.3 函数PMU_EnablePVD()形参描述
该函数的返回值描述，如下表所示：
返回值 描述
无 无
表28.2.1.4 函数PMU_EnablePVD()返回值描述
该函数的使用示例，如下所示：

#include "apm32e10x.h"
#include "apm32e10x_pmu.h"

void example_fun(void)
{
    /* 使能PVD */
    PMU_EnablePVD();
}

28.2.2 PMU驱动
本章实验的PMU驱动主要负责向应用层提供PVD的初始化函数，并实现PVD的中断回调函数。本章实验中，PMU的驱动代码包括pmu.c和pmu.h两个文件。
PMU驱动中，初始化PVD的函数，如下所示：

/**
 *   @brief     初始化PVD
 *   @param     pls: PVD 电压阈值
 *   @arg       PMU_PVD_LEVEL_2V0: PVD电压阈值设置为2.0V
 *   @arg       PMU_PVD_LEVEL_2V1: PVD电压阈值设置为2.1V
 *   @arg       PMU_PVD_LEVEL_2V3: PVD电压阈值设置为2.3V
 *   @arg       PMU_PVD_LEVEL_2V5: PVD电压阈值设置为2.5V
 *   @arg       PMU_PVD_LEVEL_2V6: PVD电压阈值设置为2.6V
 *   @arg       PMU_PVD_LEVEL_2V7: PVD电压阈值设置为2.7V
 *   @arg       PMU_PVD_LEVEL_2V8: PVD电压阈值设置为2.8V
 *   @arg       PMU_PVD_LEVEL_2V9: PVD电压阈值设置为2.9V
 *   @retval    无
 */
void pmu_pvd_init(uint32_t pls)
{
    EINT_Config_T eint_pmu_init_struct;
    
RCM_EnableAPB1PeriphClock(RCM_APB1_PERIPH_PMU);            /* 使能PMU时钟 */
/* 设置PVD电压阈值 */
    PMU_ConfigPVDLevel((PMU_PVD_LEVEL_T)pls);
    
    eint_pmu_init_struct.line = EINT_LINE_16;                  /* 事件线16 */
    eint_pmu_init_struct.mode = EINT_MODE_INTERRUPT;           /* 中断模式 */
    eint_pmu_init_struct.trigger = EINT_TRIGGER_RISING_FALLING;/* 双边沿触发 */
    eint_pmu_init_struct.lineCmd = ENABLE;                     /* 使能事件线16 */
    EINT_Config(&eint_pmu_init_struct);                        /* 配置事件线16 */
    
    NVIC_EnableIRQRequest(PVD_IRQn, 3, 0);                     /* 使能PVD中断 */
    PMU_EnablePVD();                                           /* 使能PVD */
}

从上面的代码中可以看到，PVD的初始化函数中，根据函数传入的参数配置了PVD的电压阈值，并开启了PVD的相关中断和使能PVD。
PMU驱动中，PVD的中断回调函数，如下所示：

/**
 * @brief       PVD中断回调函数
 * @param       无
 * @retval      无
 */
void PVD_IRQHandler(void)
{   /* 判断事件线16中断标志 */
    if (EINT_ReadIntFlag(EINT_LINE_16) == SET)
    {
        if (PMU_ReadStatusFlag(PMU_FLAG_PVDO) == SET)
        {
/* LCD显示电压低 */
            lcd_show_string(30, 130, 200, 16, 16, "PVD Low Voltage!", RED);
            LED1(0);                      /* 点亮LED1 */
        }
        else
        {
/* LCD显示电压正常 */
            lcd_show_string(30, 130, 200, 16, 16, "PVD Voltage OK! ", BLUE);
            LED1(1);                      /* 熄灭LED1 */
        }
        
        EINT_ClearIntFlag(EINT_LINE_16);  /* 清除事件线16中断标志 */
    }
}

从PVD的中断回调函数中可以看到，当PVD监测到电源电压小于设定的电压阈值时，会在LCD上显示电压低的提示并点亮LED1，在PVD监测到电源电压恢复至设定的电压阈值时，会在LCD上显示电压正常的提示并熄灭LED1。
虽然PVD在监测到电源电压低于设定的电压阈值时，会有相应的操作，但是由于电压过低可能导致无法观察到部分操作的现象。
28.2.3 实验应用代码
本实验的应用代码，如下所示：

int main(void)
{
    uint8_t t = 0;
    
    NVIC_ConfigPriorityGroup(NVIC_PRIORITY_GROUP_4); /* 设置中断优先级分组为组4 */
    sys_apm32_clock_init(15);                        /* 配置系统时钟 */
    delay_init(120);                                /* 初始化延时功能 */
    usart_init(115200);                             /* 初始化串口 */
    led_init();                                     /* 初始化LED */
    lcd_init();                                     /* 初始化LCD */
    pmu_pvd_init(PMU_PVD_LEVEL_2V7);                /* 初始化PVD电压阈值为2.7V */
    
    lcd_show_string(30, 50, 200, 16, 16, "APM32", RED);
    lcd_show_string(30, 70, 200, 16, 16, "PVD TEST", RED);
lcd_show_string(30, 90, 200, 16, 16, "ATOM@ALIENTEK", RED);
/* LCD默认显示电压正常 */
    lcd_show_string(30, 110, 200, 16, 16, "PVD Voltage OK! ", BLUE);
    
    while (1)
    {
        if ((t % 20) == 0)
        {
            LED0_TOGGLE();
        }
        t++;
        delay_ms(10);
    }
}

本实验的应用代码很简单，主要就是配置了PVD的阈值电压为2.7V。
28.3 下载验证
在完成编译和烧录操作后，若系统的供电正常，便可以在LCD上看到“PVD Voltage OK!”的提示，并且LED1也处于熄灭状态；若系统的供电低于设置的PVD电压阈值2.7V时，便可以在LCD上看到“PVD Low Voltage!”的提示，并且LED1也会亮起（系统供电过低时，可能出现跟多意想不到的结果，因此可能会看不到部分现象）。
正常情况下开发板的供电都是正常的，若读者强制影响开发板的供电，可能导致不可逆的硬件损坏。