1）实验平台：正点原子stm32f103战舰开发板V4
2）平台购买地址：https://detail.tmall.com/item.htm?id=609294757420
3）全套实验源码+手册+视频下载地址： http://www.openedv.com/thread-340252-1-1.html#
第三十章 PVD电压监控实验
本章介绍APM32F407电源电压监测器（PVD）的使用，PVD可以设置一个电压阈值，当监测到电源电压低于该阈值后，可以触发中断，以完成一些紧急处理。通过本章的学习，读者将学习到PVD的使用。
本章分为如下几个小节：
30.1 硬件设计
30.2 程序设计
30.3 下载验证
30.1 硬件设计
30.1.1 例程功能
- 当MCU电源电压低于2.7V时，LED1亮起，并且LCD显示相应的提示；当MCU电源电压恢复至高于2.7V时，LED1熄灭，并且LCD显示相应的提示
- LED0闪烁，指示程序正在运行
30.1.2 硬件资源 - LED
LED0 - PF9
LED1 - PF10 - 正点原子 2.8/3.5/4.3/7/10寸TFTLCD模块（仅限MCU屏，16位8080并口驱动）
- PVD
30.1.3 原理图
本章实验使用的PVD为APM32F407的片上资源，因此没有对应的连接原理图。
30.2 程序设计
30.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);
该函数的形参描述，如下表所示：
表30.2.1.1 函数PMU_ConfigPVDLevel()形参描述
该函数的返回值描述，如下表所示：
表30.2.1.2 函数PMU_ConfigPVDLevel()返回值描述
该函数的使用示例，如下所示：
#include "apm32f4xx.h"
#include "apm32f4xx_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);
该函数的形参描述，如下表所示：
形参 描述
无 无
表30.2.1.3 函数PMU_EnablePVD()形参描述
该函数的返回值描述，如下表所示：
返回值 描述
无 无
表30.2.1.4 函数PMU_EnablePVD()返回值描述
该函数的使用示例，如下所示：
#include "apm32f4xx.h"
#include "apm32f4xx_pmu.h"
void example_fun(void)
{
/* 使能PVD */
PMU_EnablePVD();
}
30.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时钟 */
PMU_ConfigPVDLevel((PMU_PVD_LEVEL_T)pls); /* 设置PVD电压阈值 */
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)
{
if (EINT_ReadIntFlag(EINT_LINE_16) == SET) /* 判断事件线16中断标志 */
{
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在监测到电源电压低于设定的电压阈值时，会有相应的操作，但是由于电压过低可能导致无法观察到部分操作的现象。
30.2.3 实验应用代码
本章实验的应用代码，如下所示：
int main(void)
{
uint8_t t = 0;
NVIC_ConfigPriorityGroup(NVIC_PRIORITY_GROUP_3); /* 设置中断优先级分组为组3 */
sys_apm32_clock_init(336, 8, 2, 7); /* 配置系统时钟 */
delay_init(168); /* 初始化延时功能 */
usart_init(115200); /* 初始化串口 */
led_init(); /* 初始化LED */
lcd_init(); /* 初始化LCD */
/* 初始化PVD电压阈值为2.7V */
pmu_pvd_init(PMU_PVD_LEVEL_2V7);
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。
30.3 下载验证
在完成编译和烧录操作后，若系统的供电正常，便可以在LCD上看到“PVD Voltage OK!”的提示，并且LED1也处于熄灭状态；若系统的供电低于设置的PVD电压阈值2.7V时，便可以在LCD上看到“PVD Low Voltage!”的提示，并且LED1也会亮起（系统供电过低时，可能出现跟多意想不到的结果，因此可能会看不到部分现象）。
正常情况下开发板的供电都是正常的，若读者强制影响开发板的供电，可能导致不可逆的硬件损坏。
