ATK-MB012 电位器模块使用说明

        1，硬件连接

       这里以正点原子M48Z-M3最小系统板STM32F103版为例，给大家介绍一下模块和板卡的连接方法。其它板卡与模块的硬件连接方法，请大家在“ATK-MB012 电位器模块\3，程序源码\相应板卡例程文件夹\readme.txt”路径下查看。

       ATK-MB012电位器模块可通过杜邦线与正点原子M48Z-M3最小系统板STM32F103版进行连接，具体的连接关系，如下表所示：

表1.1 ATK-MB012电位器模块与M48Z-M3最小系统板STM32F103版连接关系

        2，实验功能

       2.1 ATK-MB012电位器模块测试实验

       2.1.1 功能说明

       在本实验中，串口会打印电位器模块AO端的ADC原始值和电压值。需要查看这部分实验信息的用户，可用杜邦线将最小系统板STM32F103的PA9引脚和GND连接至外部的USB转串口设备，这样就可以通过XCOM上位机查看串口打印的信息了。

       用户可以通过拨动开关设置AO的最大输出电压（可选3.3 V或1.8V），还可以通过旋转电位器的旋钮，调节AO的输出电压。

       开发板的LED0闪烁，提示程序运行。

       2.1.2 源码解读

       打开本实验的工程文件夹，能够在./Drivers/BSP目录下看到ATK_POTENTIOMETER文件夹和ADC文件夹，其中ATK_POTENTIOMETER文件夹中就包含了ATK-MB012电位器模块的驱动文件，ADC文件夹中就包含了ADC的驱动文件如下图所示：

图2.1.2.1 ATK-MB012电位器模块驱动代码

图2.1.2.2 ADC驱动代码

       2.1.2.1 ATK-MB012电位器模块驱动

       下面简要介绍atk_potentiometer.c中几个重要的API函数。

       1. 函数atk_potentiometer_init()

       该函数用于初始化ATK-MB012电位器模块，具体的代码，如下所示：

/**
 * @brief       电位器模块初始化函数
 * @param       无
 * @retval      无
 */
void atk_potentiometer_init(void)
{
    adc_init();     /* 初始化ADC */
}

       atk_potentiometer_init()函数非常简单，只是调用了adc_init()函数来初始化ADC采集通道，用于获取AO端电压转换值。

       2. 函数get_voltage_value()

       该函数用于获取AO端电压转换值，具体代码，如下所示：

/**
 * @brief       读取AO端电压转换值
 * @param       无
 * @retval      AO端电压转换值
 */
uint32_t get_voltage_value(void)
{
    return adc_get_result_average(ADC_ADCX_CHY, 10);
}

       该函数通过adc_get_result_average()函数得到ADC通道的电压转换值，并做了采集10次ADC取平均值的操作，这样数据会更稳定可靠。

       2.1.2.2 ADC驱动

       在图2.1.2.2中，adc.c和adc.h为ADC驱动文件，包含了ADC通道的初始化，并实现了多次采样取平均值等功能。我们就是使用其中的adc_get_result_average()函数来获取AO端电压转换值的。关于ADC的驱动介绍，请查看正点原子各个开发板对应的开发指南中ADC章节。

       2.1.2.3 实验测试代码

       实验的测试代码在demo.c文件中，该文件在工程根目录下的 User文件夹。测试代码的入口函数为demo_run()，具体的代码，如下所示：

/**
 * @brief       例程演示入口函数
 * @param       无
 * @retval      无
 */
void demo_run(void)
{
    atk_potentiometer_init();             /* 初始化电位器模块 */
    
    while (1)
    {
        printf("电位器模块 AO端ADC值为：%d\r\n", get_voltage_value());
        printf("电位器模块 AO端电压值为：%.2fV\r\n", 
(float)get_voltage_value() * (3.3 / 4096));
        
        printf("\r\n\r\n");
        
        LED0_TOGGLE();                      /* 闪烁LED,提示系统正在运行 */
        
        delay_ms(500);
    }
}

       从上面代码可以看出，整个测试代码的逻辑相对简单。初始化电位器模块后，在while循环中调用相关函数获取AO端的ADC和电压值，并通过串口打印，LED0闪烁表示程序正常运行。

       2.1.3 实验现象

       将ATK-MB012电位器模块按照第一节“硬件连接”中介绍的连接方式与开发板连接，并将实验代码编译烧录至开发板中。本实验使用串口输出调试信息，因此需将开发板的PA9连接至DAP虚拟串口（或USB转TTL模块）的RX引脚。完成连接后，可通过串口调试助手XCOM查看实验信息输出，如下图所示：

图2.1.3.1串口调试助手显示内容

       注：其它现象请看2.1.1功能说明。