烟台高新区建设局网站/怎么样推广自己的公司

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

第三十三章 单通道ADC采集实验

本章介绍使用APM32E103模数转换器（ADC）进行带通道的电压采集。通过本章的学习，读者将学习到单通道ADC的使用。
本章分为如下几个小节：
33.1 硬件设计
33.2 程序设计
33.3 下载验证

33.1 硬件设计
33.1.1 例程功能

1. ADC1采集通道1（PA1）上的电压，并在LCD上显示ADC转换后电压的数字量和换算后的模拟量
2. LED0闪烁，指示程序正在运行
   33.1.2 硬件资源
3. LED
   LED0 - PB5
4. 正点原子 2.8/3.5/4.3/7/10寸TFTLCD模块（仅限MCU屏，16位8080并口驱动）
5. ADC1
   通道1 - PA1
   33.1.3 原理图
   本章实验使用的ADC1为APM32E103的片上资源，因此没有对应的连接原理图。
   33.2 程序设计
   33.2.1 Geehy标准库的ADC驱动
   本章实验将使用ADC1的通道1（PA1引脚）采集外部输入电压的模拟量，并将其转换为数字量，其具体的步骤如下：
   ①：配置ADC
   ②：使能ADC
   ③：配置ADC规则通道
   ④：启动转换规则通道
   ⑤：等待规则通道转换结束
   ⑥：读取规则通道的转换结果
   在Geehy标准库中对应的驱动函数如下：
   ①：配置ADC
   该函数用于配置ADC的各项参数，其函数原型如下所示：
   void ADC_Config(ADC_T* adc, ADC_Config_T* adcConfig);
   该函数的形参描述，如下表所示：
   形参 描述
   adc 指向ADC外设结构体的指针
   例如：ADC1、ADC2等（在apm32e10x.h文件中有定义）
   adcConfig 指向ADC配置结构体的指针
   需自行定义，并根据ADC的配置参数填充结构体中的成员变量
   表33.2.1.1 函数ADC_Config()形参描述
   该函数的返回值描述，如下表所示：
   返回值 描述
   无 无
   表33.2.1.2函数ADC_Config()返回值描述
   该函数使用ADC_Config_T类型的结构体变量传入ADC外设的配置参数，该结构体的定义如下所示：

typedef enum
{
/* 独立模式 */
ADC_MODE_INDEPENDENT              = ((uint32_t)0x00000000), 
/* 组合的常规同时和注入同时模式 */ADC_MODE_REG_INJEC_SIMULT		   = ((uint32_t)0x00010000),
/* 组合的常规同时和交替触发模式 */
ADC_MODE_REG_SIMULT_ALTER_TRIG    = ((uint32_t)0x00020000),
/* 组合注入同时和快速交织模式 */
ADC_MODE_INJEC_SIMULT_FAST_TNTERL = ((uint32_t)0x00030000),
/* 组合注入同步和慢速交织模式 */
ADC_MODE_INJEC_SIMULT_SLOW_INTERL = ((uint32_t)0x00040000),
/* 注入同时模式 */
ADC_MODE_INJEC_SIMULT             = ((uint32_t)0x00050000),
/* 常规同时模式 */
ADC_MODE_REG_SIMULT               = ((uint32_t)0x00060000),
/* 快速交错模式 */
ADC_MODE_FAST_INTERL              = ((uint32_t)0x00070000),
/* 慢速交错模式 */
ADC_MODE_SLOW_INTERL              = ((uint32_t)0x00080000),
/* 备用触发模式 */ADC_MODE_ALTER_TRIG               = ((uint32_t)0x00090000) 
} ADC_MODE_T;typedef enum
{ADC_EXT_TRIG_CONV_TMR1_CC1  = ((uint32_t)0x00000000), /* 定时器1的CC1事件 */ADC_EXT_TRIG_CONV_TMR1_CC2  = ((uint32_t)0x00020000), /* 定时器1的CC2事件 */
ADC_EXT_TRIG_CONV_TMR2_CC2  = ((uint32_t)0x00060000), /* 定时器2的CC2事件 */
/* 定时器3的TRGO事件 */ADC_EXT_TRIG_CONV_TMR3_TRGO = ((uint32_t)0x00080000),
ADC_EXT_TRIG_CONV_TMR4_CC4  = ((uint32_t)0x000A0000), /* 定时器4的CC4事件 */
/* EINT线11的TRGO事件 */ADC_EXT_TRIG_CONV_EINT11_T8_TRGO  = ((uint32_t)0x000C0000),ADC_EXT_TRIG_CONV_TMR1_CC3  = ((uint32_t)0x00040000), /* 定时器1的CC3事件 */ADC_EXT_TRIG_CONV_None      = ((uint32_t)0x000E0000), /* 无事件 */ADC_EXT_TRIG_CONV_TMR3_CC1  = ((uint32_t)0x00000000), /* 定时器3的CC1事件 */
ADC_EXT_TRIG_CONV_TMR2_CC3  = ((uint32_t)0x00020000), /* 定时器2的CC3事件 */
ADC_EXT_TRIG_CONV_TMR8_CC1  = ((uint32_t)0x00060000), /* 定时器8的CC1事件 */
/* 定时器8的TRGO事件 */ADC_EXT_TRIG_CONV_TMR8_TRGO = ((uint32_t)0x00080000),ADC_EXT_TRIG_CONV_TMR5_CC1  = ((uint32_t)0x000A0000), /* 定时器5的CC1事件 */ADC_EXT_TRIG_CONV_TMR5_CC3  = ((uint32_t)0x000C0000)  /* 定时器5的CC3事件 */
} ADC_EXT_TRIG_CONV_T;typedef enum
{ADC_DATA_ALIGN_RIGHT = 0x00000000,                    /* 右对齐 */ADC_DATA_ALIGN_LEFT  = 0x00000800                     /* 左对齐 */
} ADC_DATA_ALIGN_T;typedef struct
{ADC_MODE_T          mode;uint8_t             scanConvMode;		/* 扫描模式 */uint8_t             continuosConvMode;	/* 连续转换模式 */ADC_EXT_TRIG_CONV_T externalTrigConv;	/* 启动规则组转换的外部事件 */ADC_DATA_ALIGN_T    dataAlign;			/* 数据对齐方式 */uint8_t             nbrOfChannel;		/* 规则通道序列长度 */
} ADC_Config_T;
该函数的使用示例，如下所示：
#include "apm32e10x.h"
#include "apm32e10x_adc.h"void example_fun(void)
{ADC_Config_T adc_init_struct;/* 配置ADC1 */adc_init_struct.mode = ADC_MODE_INDEPENDENT;adc_init_struct.scanConvMode = DISABLE;adc_init_struct.continuosConvMode = DISABLE;adc_init_struct.externalTrigConv = ADC_EXT_TRIG_CONV_None;adc_init_struct.dataAlign = ADC_DATA_ALIGN_RIGHT;adc_init_struct.nbrOfChannel = 1;ADC_Config(ADC_ADCX, &adc_init_struct);
}

②：使能ADC
该函数用于使能ADC，其函数原型如下所示：
void ADC_Enable(ADC_T* adc);
该函数的形参描述，如下表所示：
形参 描述
adc 指向ADC外设结构体的指针
例如：ADC1、ADC2等（在apm32e10x.h文件中有定义）
表33.2.1.3 函数ADC_Enable()形参描述
该函数的返回值描述如下表所示
返回值 描述
无 无
表33.2.1.4 函数ADC_Enable()返回值描述
该函数的使用示例，如下所示：

#include "apm32e10x.h"
#include "apm32e10x_adc.h"void example_fun(void)
{/* 使能ADC1 */ADC_Enable(ADC1);
}
③：配置ADC规则通道
该函数用于配置ADC规则通道，其函数原型如下所示：
void ADC_ConfigRegularChannel(	ADC_T* adc,uint8_t channel,uint8_t rank,uint8_t sampleTime);

该函数的形参描述，如下表所示：
形参 描述
adc 指向ADC外设结构体的指针
例如：ADC1、ADC2等（在apm32e10x.h文件中有定义）
channel ADC通道
例如：ADC_CHANNEL_0、ADC_CHANNEL_1等（在apm32e10x_adc.h文件中有定义）
rank 转换顺序
sampleTime ADC通道的采样周期
例如：ADC_SAMPLETIME_3CYCLES
ADC_SAMPLETIME_15CYCLES等（在apm32e10x_adc.h文件中有定义）
表33.2.1.5 函数ADC_ConfigRegularChannel()形参描述
该函数的返回值描述，如下表所示：
返回值 描述
无 无
表33.2.1.6 函数ADC_ConfigRegularChannel()返回值描述
该函数的使用示例，如下所示：

#include "apm32e10x.h"
#include "apm32e10x_adc.h"void example_fun(void)
{/* 使能ADC1通道1的规则通道 */ADC_ConfigRegularChannel(ADC1, ADC_CHANNEL_1, 1, ADC_SAMPLETIME_480CYCLES);
}

④：启动转换规则通道
该函数用于启动转换规则通道，其函数原型如下所示：
void ADC_EnableSoftwareStartConv(ADC_T* adc);
该函数的形参描述，如下表所示：
形参 描述
adc 指向ADC外设结构体的指针
例如：ADC1、ADC2等（在apm32e10x.h文件中有定义）
表33.2.1.7 函数ADC_EnableSoftwareStartConv ()形参描述
该函数的返回值描述，如下表所示：
返回值 描述
无 无
表33.2.1.8 函数ADC_EnableSoftwareStartConv ()返回值描述
该函数的使用示例，如下所示：

#include "apm32e10x.h"
#include "apm32e10x_adc.h"void example_fun(void)
{ADC_EnableSoftwareStartConv(ADC1); /* 使能ADC1转换规则通道 */
}

⑤：读取ADC状态标志
该函数用于读取ADC的状态标志，其函数原型如下所示：
uint8_t ADC_ReadStatusFlag(ADC_T* adc, ADC_FLAG_T flag);
该函数的形参描述，如下表所示：
形参 描述
adc 指向ADC外设结构体的指针
例如：ADC1、ADC2等（在apm32e10x.h文件中有定义）
flag 指定的ADC状态标志
例如：ADC_FLAG_AWD、ADC_FLAG_EOC等（在apm32e10x_adc.h文件中有定义）
表33.2.1.9 函数ADC_ReadStatusFlag()形参描述
该函数的返回值描述，如下表所示：
返回值 描述
SET 事件标志发生
RESET 事件标志为发生
表33.2.1.10 函数ADC_ReadStatusFlag()返回值描述
该函数的使用示例，如下所示：

#include "apm32e10x.h"
#include "apm32e10x_adc.h"void example_fun(void)
{uint8_t flag;/* 读取ADC1的转换结束标志 */flag = ADC_ReadStatusFlag(ADC1, ADC_FLAG_EOC)if (flag == SET){/* Do something. */}else{/* Do something. */}
}

⑥：读取规则通道转换结果
该函数用于读取规则通道的转换结果，其函数原型如下所示：
uint16_t ADC_ReadConversionValue(ADC_T* adc);
该函数的形参描述，如下表所示：
形参 描述
adc 指向ADC外设结构体的指针
表33.2.1.11 函数ADC_ReadConversionValue()形参描述
该函数的返回值描述，如下表所示：
返回值 描述
uint16_t类型数据 转换结果
表33.2.1.12 函数ADC_ReadConversionValue()返回值描述
该函数的使用示例，如下所示：

#include "apm32e10x.h"
#include "apm32e10x_adc.h"void example_fun(void)
{uint16_t data;/* 读取规则通道转换结果 */data = ADC_ReadConversionValue(ADC1);/* Do something. */
}

33.2.2 ADC驱动
本章实验的ADC驱动主要负责向应用层提供ADC的初始化和获取ADC转换结果的函数。本章实验中，ADC的驱动代码包括adc.c和adc.h两个文件。
ADC驱动中，对ADC、GPIO的相关宏定义，如下所示：

/* 单通道ADC采集定义 */
#define ADC_ADCX_CHY_GPIO_PORT          GPIOA
#define ADC_ADCX_CHY_GPIO_PIN           GPIO_PIN_1
#define ADC_ADCX_CHY_GPIO_CLK_ENABLE()  do{ RCM_EnableAPB2PeriphClock(RCM_APB2_PERIPH_GPIOA); }while(0)#define ADC_ADCX                        ADC1
#define ADC_ADCX_CHY                    ADC_CHANNEL_1
#define ADC_ADCX_CHY_CLK_ENABLE()       do{ RCM_EnableAPB2PeriphClock(RCM_APB2_PERIPH_ADC1); }while(0)
ADC驱动中，ADC的初始化函数，如下所示：
/*** @brief   初始化ADC* @note    公式：TCONV=采样时间+12.5个周期*          采样时间由 SMPCYCCFGx[2:0]位控制，最小采样周期为1.5个，当*          ADCCLK=14MHz，采样时间为1.5周期：TCONV=1.5l,周期+12.5,周期=14,周期=1us。* @param   无* @retval  无*/
void adc_init(void)
{ADC_Config_T adc_init_struct;GPIO_Config_T gpio_init_struct;/* 使能时钟 */
ADC_ADCX_CHY_CLK_ENABLE();                          /* 使能ADC时钟 */
/* 使能ADC输入引脚端口时钟 */
ADC_ADCX_CHY_GPIO_CLK_ENABLE();                  
/* 设置ADC分频因子6，120MHz/6=20MHz,即6分频得到的ADC输入时钟频率为20MHz */RCM_ConfigADCCLK(RCM_PCLK2_DIV_6);                         /* 配置ADC引脚 */gpio_init_struct.pin = ADC_ADCX_CHY_GPIO_PIN;       /* ADC输入引脚 */
gpio_init_struct.mode = GPIO_MODE_ANALOG;           /* 模拟输入 */
/* 配置ADC输入引脚 */GPIO_Config(ADC_ADCX_CHY_GPIO_PORT, &gpio_init_struct);ADC_Reset(ADC_ADCX);                                /* 复位ADC1 *//* 配置ADC */adc_init_struct.mode = ADC_MODE_INDEPENDENT;        /* ADC工作模式:独立模式 */adc_init_struct.scanConvMode = DISABLE;             /* 禁止扫描模式 */
adc_init_struct.continuosConvMode = DISABLE;        /* 单次转换模式 */
/* 禁止触发检测 */adc_init_struct.externalTrigConv = ADC_EXT_TRIG_CONV_None; adc_init_struct.dataAlign = ADC_DATA_ALIGN_RIGHT;   /* 配置数据对齐方式 */adc_init_struct.nbrOfChannel = 1;                   /* 规则通道序列长度 */ADC_Config(ADC_ADCX, &adc_init_struct);             /* 配置ADC */ADC_Enable(ADC_ADCX);                               /* 使能ADC */ADC_ResetCalibration(ADC_ADCX);                     /* 使能复位校准 */while(ADC_ReadResetCalibrationStatus(ADC_ADCX))     /* 等待复位校准结束 */{ADC_StartCalibration(ADC_ADCX);                 /* 开启AD校准 */}while(ADC_ReadCalibrationStartFlag(ADC_ADCX));      /* 等待校准结束 */
}
从上面的代码中可以看出，ADC的初始化函数中，不仅配置了ADC通用控制寄存器和ADC，该配置了ADC1通道1对应的GPIO引脚，同时也配置了该引脚为模拟模式。
ADC驱动中，获取ADC转换结果的函数，如下所示：
/*** @brief       获得ADC转换后的结果* @param       ch: ADC通道，范围：ADC_CHANNEL_0~ADC_CHANNEL_V_REFINT* @retval      无*/
uint16_t adc_get_result(uint8_t ch)
{
/* 配置指定ADC规则通道 */ADC_ConfigRegularChannel(ADC_ADCX, ch, 1, ADC_SAMPLETIME_239CYCLES5);ADC_EnableSoftwareStartConv(ADC_ADCX);             /* 开始转换规则通道 */while(!ADC_ReadStatusFlag(ADC_ADCX, ADC_FLAG_EOC));/* 等待规则通道转换结束 */return ADC_ReadConversionValue(ADC_ADCX);          /* 返回规则通道的转换结果 */
}/*** @brief       获取通道ch的转换值，取times次,然后平均* @param       ch   : ADC通道，范围：ADC_CHANNEL_0~ADC_CHANNEL_V_REFINT* @param       times: 获取次数* @retval      通道ch的times次转换结果平均值*/
uint16_t adc_get_result_average(uint8_t ch, uint8_t times)
{uint32_t temp_val = 0;uint8_t t;for (t = 0; t < times; t++){temp_val += adc_get_result(ch); /* 获取times次数据 */delay_ms(5);}return temp_val / times;            /* 返回平均值 */
}

以上两个函数都是用于获取ADC转换结果的函数，其中函数adc_get_result()会配置并开启ADC指定通道的规则通道转换，并等待其转换结束后，读取其转换的1次结果；而函数adc_get_result_averagr()则是多次调用啊含糊adc_get_result()获取多次ADC的转换结果，然后进行均值滤波。
33.2.3 实验应用代码
本章实验的应用代码，如下所示：

int main(void)
{uint16_t adcdata;uint16_t voltage;NVIC_ConfigPriorityGroup(NVIC_PRIORITY_GROUP_4);  /* 设置中断优先级分组为组4 */sys_apm32_clock_init(15);                         /* 配置系统时钟 */delay_init(120);                                  /* 初始化延时功能 */usart_init(115200);                               /* 初始化串口 */led_init();                                       /* 初始化LED */lcd_init();                                       /* 初始化LCD */adc_init();                                       /* 初始化ADC */lcd_show_string(30, 50, 200, 16, 16, "APM32", RED);lcd_show_string(30, 70, 200, 16, 16, "ADC TEST", RED);lcd_show_string(30, 90, 200, 16, 16, "ATOM@ALIENTEK", RED);lcd_show_string(30, 110, 200, 16, 16, "ADC1_CH1_VAL:", BLUE);lcd_show_string(30, 130, 200, 16, 16, "ADC1_CH1_VOL:0.000V", BLUE); while (1)
{
/* 获取ADC通道1转换且进行均值滤波后的结果 */adcdata = adc_get_result_average(ADC_ADCX_CHY, 10);lcd_show_xnum(134, 110, adcdata, 5, 16, 0, BLUE);/* 显示原始值 */
/* 计算实际电压值（扩大1000倍） */voltage = (adcdata * 3300) / 4095;
/* 显示电压值的整数部分 */lcd_show_xnum(134, 130, voltage / 1000, 1, 16, 0, BLUE);
/* 显示电压值的小数部分（保留三位小数） */lcd_show_xnum(150, 130, voltage % 1000, 3, 16, 0x80, BLUE);LED0_TOGGLE();delay_ms(100);}
}

从上面的代码中可以看出，在进行完包括ADC的所有初始化工作后，便不断地获取ADC1通道1进行5次转换后经过均值滤波后的结果，并将该原始值显示在LCD上，同时还通过该电压的原始值计算出了电压的模拟量，并在LCD上进行显示。
33.3 下载验证
在完成编译和烧录操作后，可以看到LCD上实时刷新显示着ADC1通道1（PA1引脚）采集到电压的数字量和模拟量，此时可以通过杜邦线给PA1引脚接入不同的电压值（注意共地，且输入电压不能超过3.3V，否则可能损坏开发板），可以看到LCD上显示的电压数字量和模拟量也随之改变。