STM32 AD单通道函数设计

    RCC_APB2PeriphClockCmd(RCC_APB2Periph_ADC1,ENABLE);//开启ADC1的时钟
    RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOA,ENABLE);//还需要开启PA0口的时钟
    RCC_ADCCLKConfig(RCC_PCLK2_Div6);//配置ADCCLK

RCC_APB2PeriphClockCmd函数开启ADC1的时钟，ADC都是APB2上的设备，所以这里用APB2开启时钟的函数。

RCC_APB2PeriphClockCmd函数用于开启PA0口的时钟。

以上时钟就配置好了，还需要配置ADCCLK，用RCC_ADCCLKConfig/函数来配置，函数有四个参数分别是2、4、6、8分频：

RCC_PCLK2_Div2: ADC clock = PCLK2/2
RCC_PCLK2_Div4: ADC clock = PCLK2/4
RCC_PCLK2_Div6: ADC clock = PCLK2/6
RCC_PCLK2_Div8: ADC clock = PCLK2/8

函数参数配置好之后，ADC的CLOCK=PCLK2/2、PCLK2/4、PCLK2/6、PCLK2/8，参数的PCLK2就是APB2时钟的意思。

代码示例中选择6分频，分频之后，ADCCLK=72MHz/6=12MHz

2.2 配置GPIO

第二步：配置GPIO，把需要用到的GPIO配置成模拟输入的模式。

代码示例：

    GPIO_InitTypeDef GPIO_InitStruct;
    GPIO_InitStruct.GPIO_Mode= GPIO_Mode_AIN;//选择模拟输入
    GPIO_InitStruct.GPIO_Pin= GPIO_Pin_0;
    GPIO_InitStruct.GPIO_Speed= GPIO_Speed_50MHz;
    GPIO_Init(GPIOA,&GPIO_InitStruct);

代码示例中选择GPIO_Mode_AIN模拟输入这个模式，在GPIO_Mode_AIN模式下，GPIO是无效的，断开GPIO口，防止GPIO口的输入输出对模拟电压造成干扰。GPIO_Mode_AIN模式就是ADC的专属模式。

2.3 配置多路开关

第三步：配置多路开关，把通道接入到规则组列表里。

代码示例：

ADC_RegularChannelConfig(ADC1,ADC_Channel_0,1,ADC_SampleTime_55Cycles5);

用ADC_RegularChannelConfig函数可选择规则组的输入通道。

函数参数：

第1个参数：选择ADC。
第2个参数：指定通道，通道0~通道17.
第3个参数：Rank，规则组序列器里的次序，在1~16之间。若只有PA0一个通道，使用的是非扫描模式，那指定的通道就放在第一个序列1的位置。
第4个参数：指定通道的采样时间，采样时间参数根据需求调整，需要更快的转换，就选择小的参数；需要更稳定的转换，就选择大的参数。

代码示例的配置是：再ADC1中，在规则组菜单列表的第一个位置，写入通道0这个通道，指定通道的采样时间参数选择的采样时间为55.5个ADCCLK的周期。

如果想在序列2的位置写入其他通道，就可以复制一下这个代码，把序列数改成2，然后指定你想要的通道，若还需要继续填充序列，可以再复制这个函数，修改序列和通道，另外每个通道也可以设置不同的采样时间，在函数最后一个参数修改即可。

2.4 配置ADC转换器

第四步、用结构体初始化ADC。

代码示例：

    ADC_InitTypeDef ADC_InitStructure;
    ADC_InitStructure.ADC_Mode=ADC_Mode_Independent;//ADC的工作模式
    ADC_InitStructure.ADC_DataAlign=ADC_DataAlign_Right;//数据对齐
    ADC_InitStructure.ADC_ExternalTrigConv=ADC_ExternalTrigConv_None;//外部触发转换选择
    ADC_InitStructure.ADC_ContinuousConvMode=DISABLE;//连续/单次转换模式
    ADC_InitStructure.ADC_ScanConvMode=DISABLE;//扫描/非扫描转换模式
    ADC_InitStructure.ADC_NbrOfChannel=1;//通道数目

    ADC_Init(ADC1,&ADC_InitStructure);

ADC_Mode 是ADC的工作模式，这个参数是配置ADC是工作在独立模式还是双ADC模式，代码示例选择独立模式。

ADC_DataAlign 数据对齐，这里介绍是指定ADC数据是左对齐还是右对齐。

ADC_DataAlign_Right右对齐；
ADC_DataAlign_Left左对齐

ADC_ExternalTrigConv 外部触发转换选择，就是触发控制的触发源，定义用于启动规则组转换的外部触发源。参数对应结构框图中的外部触发源选择。代码示例选择 ADC_ExternalTrigConv_None 参数，就是不使用外部触发，也就是使用内部软件触发的意思。

ADC_ContinuousConvMode 连续/单次转换模式，这个参数可以选择是ENABLE连续转换模式还是DISABLE单次转换模式。

ADC_ScanConvMode 扫描/非扫描转换模式，这个参数可以选择是ENABLE扫描模式（多通道）还是DISABLE非扫描模式（单通道）。

ADC_NbrOfChannel 通道数目，这个是在指定扫描模式下，总共会有几个通道需要扫描，参数必须在1~16之间。这个参数仅在扫描模式下使用，因为非扫描模式整个列表就只有第一个序列有效，无论写多少数目，最终都只有序列1的位置有效。

后三个参数设置可以对应四种模式：

单次转换非扫描。
连续转换非扫描。
单次转换扫描。
连续转换扫描。

2.5 开启ADC电源

第五步、开关控制，调用一下ADC_Cmd函数，开启ADC.

代码示例：

ADC_Cmd(ADC1,ENABLE);

以上配置完后ADC准备就绪。

2.6 ADC进行校准

在开启ADC电源之后，根据手册的建议，还需要对ADC进行校准，校准分为以下四步。

复位校准
等待复位校准完成
开始校准
等待校准完成

2.6.1 复位校准

代码示例：

ADC_ResetCalibration(ADC1);//复位校准

2.6.2 等待复位校准完成

代码示例：

while(ADC_GetResetCalibrationStatus(ADC1)==SET);

ADC_GetResetCalibrationStatus函数是返回复位校准的状态，要等待复位完成的话，还需要加一个while循环，若没校准完成的话，就在这个while空循环里一直等待。

获取的标志位和是否校准完成的对应关系需参考函数定义和寄存器说明。

函数定义：

ADC_GetResetCalibrationStatus函数定义中返回值的说明是，ADC复位校准寄存器的状态，SET或RESET。

函数代码：

/**
  * @brief  Gets the selected ADC reset calibration registers status.
  * @param  ADCx: where x can be 1, 2 or 3 to select the ADC peripheral.
  * @retval The new state of ADC reset calibration registers (SET or RESET).
  */
FlagStatus ADC_GetResetCalibrationStatus(ADC_TypeDef* ADCx)
{
  FlagStatus bitstatus = RESET;
  /* Check the parameters */
  assert_param(IS_ADC_ALL_PERIPH(ADCx));
  /* Check the status of RSTCAL bit */
  if ((ADCx->CR2 & CR2_RSTCAL_Set) != (uint32_t)RESET)
  {
    /* RSTCAL bit is set */
    bitstatus = SET;
  }
  else
  {
    /* RSTCAL bit is reset */
    bitstatus = RESET;
  }
  /* Return the RSTCAL bit status */
  return  bitstatus;
}

在此函数代码中也可以看出来，它获取的就是CR2寄存器里的RSTCAL标志位。

寄存器说明：

在ADC的CR2寄存器里RSTCAL复位校准位的说明是该位由软件设置并由硬件清除，在校准寄存器被初始化后该位将被清除。

所以该标志位的用法就是软件置改位为1，那硬件就会开始复位校准，当复位校准完成后，该位就会由硬件自动清0.

因为校准的第一条代码ADC_ResetCalibration(ADC1);开始复位校准，就是将RSTCAL标志位置1，然后获取复位校准状态，就是读取RSTCAL标志位这一位，所以在读取这一位的时候：

如果它是1，那就需要一直空循环等待；
如果它变为0了，那就说明复位校准完成，可以跳出等待了。

所以校准第二条代码while(ADC_GetResetCalibrationStatus(ADC1)==SET);中while的条件就是，获取标志位函数 ADC_GetResetCalibrationStatus 的返回值是不是==SET，如果等于SET，while条件为真，就会一直空循环。一旦标志位被硬件清0了，这个空循环就会自动跳出来。这样就实现了等待复位校准完成的效果。这里==SET也是可以省略的，因为返回值SET直接作为条件和是不是==SET作为条件效果是一样的。

2.6.3 开始校准

代码示例：

ADC_StartCalibration(ADC1);

调用ADC_StartCalibration函数就开始校准了，之后内部电路就会自动进行校准。

2.6.4 等待校准完成

    while(ADC_GetCalibrationStatus(ADC1)==SET);//调用函数获取校准状态

调用ADC_GetCalibrationStatus函数获取校准状态，也需要将函数放于while循环内，和校准的第二步同理，循环条件是，校准标志位是不是==SET，这样就可以等待校准是否完成了。

三、启动AD转换函数设计

上文描述的代码设置使ADC已处于准备就绪的状态，以下设计启动转换，获取转换结果的函数块。

函数块里执行以下流程：

第一步、软件触发转换。
第二步、等待转换完成。
第三步、读取ADC数据寄存器。

3.1 软件触发转换

调用ADC_SoftwareStartConvCmd函数，实现软件触发。

代码示例：

ADC_SoftwareStartConvCmd(ADC1,ENABLE);

调用ADC_SoftwareStartConvCmd函数之后就可以触发，ADC就已经开始进行转换了。转换需要一段时间。

3.2 等待转换完成

等待转换完成，也就是等待EOC标志位置1.

代码示例：

    while(ADC_GetFlagStatus(ADC1,ADC_FLAG_EOC)==RESET);

ADC_GetFlagStatus是获取标志位状态的函数，函数的第二个参数可选择以下参数：

ADC_FLAG_AWD: 模拟看门狗标志位
ADC_FLAG_EOC: 规则组转换完成标志位
ADC_FLAG_JEOC:注入组转换完成标志位
ADC_FLAG_JSTRT: 注入组开始转换标志位
ADC_FLAG_STRT: 规则组开始转换标志位

这一步也需要套一个while空循环来实现一个等待的过程，返回标志位与转换是否完成的对应关系需参考函数定义和STM32手册的寄存器说明.

函数定义：

ADC_GetFlagStatus函数定义中返回值的说明是，ADC状态寄存器的状态，SET或RESET。

函数代码：

/**
  * @brief  Checks whether the specified ADC flag is set or not.
  * @param  ADCx: where x can be 1, 2 or 3 to select the ADC peripheral.
  * @param  ADC_FLAG: specifies the flag to check. 
  *   This parameter can be one of the following values:
  *     @arg ADC_FLAG_AWD: Analog watchdog flag
  *     @arg ADC_FLAG_EOC: End of conversion flag
  *     @arg ADC_FLAG_JEOC: End of injected group conversion flag
  *     @arg ADC_FLAG_JSTRT: Start of injected group conversion flag
  *     @arg ADC_FLAG_STRT: Start of regular group conversion flag
  * @retval The new state of ADC_FLAG (SET or RESET).
  */
FlagStatus ADC_GetFlagStatus(ADC_TypeDef* ADCx, uint8_t ADC_FLAG)
{
  FlagStatus bitstatus = RESET;
  /* Check the parameters */
  assert_param(IS_ADC_ALL_PERIPH(ADCx));
  assert_param(IS_ADC_GET_FLAG(ADC_FLAG));
  /* Check the status of the specified ADC flag */
  if ((ADCx->SR & ADC_FLAG) != (uint8_t)RESET)
  {
    /* ADC_FLAG is set */
    bitstatus = SET;
  }
  else
  {
    /* ADC_FLAG is reset */
    bitstatus = RESET;
  }
  /* Return the ADC_FLAG status */
  return  bitstatus;
}

寄存器说明：

在ADC状态寄存器里有EOC转换结束标志位，这里获取的就是EOC标志位，EOC标志位由硬件在（规则或注入）通道组转换结束时设置。

意思是EOC标志位在规则组或注入组完成时都会置1，这一位由软件清除或由读取ADC_DR时清除。

ADC_DR是数据寄存器，一般EOC标志位置1，程序就会来读取数据，所以EOC标志位就多设计了一个功能，这一位可以在读取数据寄存器之后自动清除，无需手动清除，可以省一条代码。

当EOC标志位为0时，表示转换未完成；
当EOC标志位为1时，表示转换完成。

所以在代码中，当ADC_GetFlagStatus函数的返回值，也就是EOC标志位==RESET时，转换未完成，while条件为真，执行空循环。转换完成后，EOC由硬件自动置1，while循环自动跳出。这样等待转换完成的代码就OK了。

具体等待的时间：ADC配置时，通道的采样周期是55.5，转换周期是固定的12.5，加在一起就是68个周期。ADCS时钟配置的ADCCLK是72MHz的6分频，就是12MHz，12MHz进行68个周期，转换才能完成。最终的时间1/12M再×68，结果大概是5.6us，可参考之前博文算转换时间的内容：STM32 ADC数模转换器-CSDN博客

3.3 读取ADC数据寄存器

等待完成之后就可以取结果了，调用ADC_GetConversionValue函数可取得结果。

代码示例：

    return ADC_GetConversionValue(ADC1);

ADC_GetConversionValue函数，也就是ADC获取转换值函数的返回值就是AD转换的结果。函数直接读取ADC的DR数据寄存器，因为读取DR寄存器会自动清除EOC标志位，所以在函数之后就不需要手动清除标志位了。

3.4 启动AD转换函数块总结

代码示例：

uint16_t AD_GetValue(void)
{
	ADC_SoftwareStartConvCmd(ADC1,ENABLE);
	while(ADC_GetFlagStatus(ADC1,ADC_FLAG_EOC)==RESET);
	return ADC_GetConversionValue(ADC1);
}

调用一次这个函数块就相当于执行了一次图单次转换，非扫描模式的流程。