第022例：ADC-单通道采集(DMA)（光敏电阻）

【HAL库每天一例】系列例程从今天开始持续更新。
我们将坚持每天至少发布一个基于YS-F1Pro开发板的HAL库例程，
该系列例程将带领大家从零开始使用HAL库，后面会持续添加模块应用例程。
同样的，我们还程序发布基于HAL库的指导文档和视频教程，欢迎持续关注，并提出改进意见。
例程下载：
资料包括程序、相关说明资料以及软件使用截图
链接：http://pan.baidu.com/s/1i574oPv
密码：r3s3
（硬石YS-F1Pro开发板HAL库例程持续更新\1. 软件设计之基本裸机例程(HAL库版本)\YSF1_HAL-022. ADC-单通道采集(DMA)（光敏电阻））

/**
  ******************************************************************************
  *                           硬石YS-F1Pro开发板例程功能说明
  *
  *  例程名称: YSF1_HAL-022. ADC-单通道采集(DMA)（光敏电阻）
  *   
  ******************************************************************************
  * 说明：
  * 本例程配套硬石stm32开发板YS-F1Pro使用。
  *
  * 淘宝：
  * 论坛：www.ing10bbs.com
  * 版权归硬石嵌入式开发团队所有，请勿商用。
  ******************************************************************************
  */
【1】例程简介
  ADC：模拟量数字量转换器，可以将电压模拟量转换为数字量，STM32F103ZET6有3个12bit的ADC，
可实现0~3.3V电压转变对应0~4095数值。
  ADC1和ADC3拥有DMA功能，可以使用DMA传输转换结果。
  板载一个光敏电阻器，随着光照度不同电阻值也不同，通过电路设计，两端电压也随着变化。
  
【2】跳线帽情况
******* 为保证例程正常运行，必须插入以下跳线帽 **********
丝印编号     IO端口      目标功能引脚        出厂默认设置
  JP1        PA10        TXD(CH340G)          已接入
  JP2        PA9         RXD(CH340G)          已接入
  CN17       PC1           RP                 已接入
  
【3】操作及现象
    使用开发板配套的MINI USB线连接到开发板标示“调试串口”字样的MIMI USB接口，打开PC端
串口调试助手，设置参数为115200 8-NO-1。下载完程序之后，在串口调试助手窗口可看到光敏电阻
器引脚对应的ADC转换值和电压值，如果此时我们用黑布盖住光敏电阻可看到串口打印的值也有明显
变化。
/******************* (C) COPYRIGHT 2015-2020 硬石嵌入式开发团队 *****END OF FILE****/

bsp_adc.h文件内容：

1. #ifndef __ADC_H__
   
2. #define        __ADC_H__
   
3. 
   
4. /* 包含头文件 ----------------------------------------------------------------*/
   
5. #include "stm32f1xx_hal.h"
   
6. 
   
7. /* 类型定义 ------------------------------------------------------------------*/
   
8. /* 宏定义 --------------------------------------------------------------------*/
   
9. // 注意：用作ADC采集的IO必须没有复用，否则采集电压会有影响
   
10. /********************ADC输入通道（引脚）配置**************************/
    
11. //#define ADCx_RCC_CLK_ENABLE()            __HAL_RCC_ADC1_CLK_ENABLE()
    
12. //#define ADCx_RCC_CLK_DISABLE()           __HAL_RCC_ADC1_CLK_DISABLE()
    
13. //#define DMAx_RCC_CLK_ENABLE()            __HAL_RCC_DMA1_CLK_ENABLE()
    
14. //#define ADCx                             ADC1
    
15. //#define ADC_DMAx_CHANNELn                DMA1_Channel1
    
16. //#define ADC_DMAx_CHANNELn_IRQn           DMA1_Channel1_IRQn
    
17. //#define ADC_DMAx_CHANNELn_IRQHANDLER     DMA1_Channel1_IRQHandler
    
18. 
    
19. #define ADCx_RCC_CLK_ENABLE()            __HAL_RCC_ADC3_CLK_ENABLE()
    
20. #define ADCx_RCC_CLK_DISABLE()           __HAL_RCC_ADC3_CLK_DISABLE()
    
21. #define DMAx_RCC_CLK_ENABLE()            __HAL_RCC_DMA2_CLK_ENABLE()
    
22. #define ADCx                             ADC3
    
23. #define ADC_DMAx_CHANNELn                DMA2_Channel5
    
24. #define ADC_DMAx_CHANNELn_IRQn           DMA2_Channel4_5_IRQn
    
25. #define ADC_DMAx_CHANNELn_IRQHANDLER     DMA2_Channel4_5_IRQHandler
    
26. 
    
27. #define ADC_GPIO_ClK_ENABLE()            __HAL_RCC_GPIOC_CLK_ENABLE()
    
28. #define ADC_GPIO                         GPIOC
    
29. //#define ADC_GPIO_PIN                     GPIO_PIN_0        // 连接至板载精密可调电阻(需加跳帽)
    
30. //#define ADC_CHANNEL                      ADC_CHANNEL_10    // 连接至板载精密可调电阻(需加跳帽)
    
31. #define ADC_GPIO_PIN                     GPIO_PIN_1        // 连接至板载光敏电阻(需加跳帽)
    
32. #define ADC_CHANNEL                      ADC_CHANNEL_11    // 连接至板载光敏电阻(需加跳帽)
    
33.               
    
34. 
    
35. 
    
36. /* 扩展变量 ------------------------------------------------------------------*/
    
37. extern ADC_HandleTypeDef hadcx;
    
38. extern DMA_HandleTypeDef hdma_adcx;
    
39. /* 函数声明 ------------------------------------------------------------------*/
    
40. void MX_ADCx_Init(void);
    
41. 
    
42. #endif /* __ADC_H__ */
    
43. 
    
44. /******************* (C) COPYRIGHT 2015-2020 硬石嵌入式开发团队 *****END OF FILE****/
    

复制代码

bsp_adc.c文件内容：

1. /**
   
2.   ******************************************************************************
   
3.   * 文件名程: bsp_adc.c
   
4.   * 作    者: 硬石嵌入式开发团队
   
5.   * 版    本: V1.0
   
6.   * 编写日期: 2015-10-04
   
7.   * 功    能: 板载ADC电压采集底层驱动程序
   
8.   ******************************************************************************
   
9.   * 说明：
   
10.   * 本例程配套硬石stm32开发板YS-F1Pro使用。
    
11.   *
    
12.   * 淘宝：
    
13.   * 论坛：<a >www.ing10bbs.com</a>
    
14.   * 版权归硬石嵌入式开发团队所有，请勿商用。
    
15.   ******************************************************************************
    
16.   */
    
17. /* 包含头文件 ----------------------------------------------------------------*/
    
18. #include "adc/bsp_adc.h"
    
19. 
    
20. /* 私有类型定义 --------------------------------------------------------------*/
    
21. /* 私有宏定义 ----------------------------------------------------------------*/
    
22. /* 私有变量 ------------------------------------------------------------------*/
    
23. ADC_HandleTypeDef hadcx;
    
24. DMA_HandleTypeDef hdma_adcx;
    
25. /* 扩展变量 ------------------------------------------------------------------*/
    
26. /* 私有函数原形 --------------------------------------------------------------*/
    
27. /* 函数体 --------------------------------------------------------------------*/
    
28. /**
    
29.   * 函数功能: AD转换初始化
    
30.   * 输入参数: 无
    
31.   * 返 回 值: 无
    
32.   * 说    明：无
    
33.   */
    
34. void MX_ADCx_Init(void)
    
35. {
    
36.   ADC_ChannelConfTypeDef sConfig;
    
37. 
    
38.   // ADC功能配置
    
39.   hadcx.Instance = ADCx;
    
40.   hadcx.Init.ScanConvMode = ADC_SCAN_DISABLE;
    
41.   hadcx.Init.ContinuousConvMode = ENABLE;
    
42.   hadcx.Init.DiscontinuousConvMode = DISABLE;
    
43.   hadcx.Init.ExternalTrigConv = ADC_SOFTWARE_START;
    
44.   hadcx.Init.DataAlign = ADC_DATAALIGN_RIGHT;
    
45.   hadcx.Init.NbrOfConversion = 1;
    
46.   HAL_ADC_Init(&hadcx);
    
47. 
    
48.   // 配置采样通道
    
49.   sConfig.Channel = ADC_CHANNEL;
    
50.   sConfig.Rank = 1;
    
51.   sConfig.SamplingTime = ADC_SAMPLETIME_55CYCLES_5;
    
52.   HAL_ADC_ConfigChannel(&hadcx, &sConfig);
    
53. }
    
54. 
    
55. /**
    
56.   * 函数功能: ADC外设初始化配置
    
57.   * 输入参数: hadc：AD外设句柄类型指针
    
58.   * 返 回 值: 无
    
59.   * 说    明: 该函数被HAL库内部调用
    
60.   */
    
61. void HAL_ADC_MspInit(ADC_HandleTypeDef* hadc)
    
62. {
    
63.   GPIO_InitTypeDef GPIO_InitStruct;
    
64.   if(hadc->Instance==ADCx)
    
65.   {
    
66.     /* 外设时钟使能 */
    
67.     ADCx_RCC_CLK_ENABLE();
    
68.    
    
69.     /* AD转换通道引脚时钟使能 */
    
70.     ADC_GPIO_ClK_ENABLE();
    
71.    
    
72.     /* DMA时钟使能 */
    
73.     DMAx_RCC_CLK_ENABLE();
    
74.       
    
75.     /* AD转换通道引脚初始化 */
    
76.     GPIO_InitStruct.Pin = ADC_GPIO_PIN;
    
77.     GPIO_InitStruct.Mode = GPIO_MODE_ANALOG;
    
78.     HAL_GPIO_Init(ADC_GPIO, &GPIO_InitStruct);
    
79. 
    
80.     /* DMA外设初始化配置 */  
    
81.     hdma_adcx.Instance = ADC_DMAx_CHANNELn;
    
82.     hdma_adcx.Init.Direction = DMA_PERIPH_TO_MEMORY;
    
83.     hdma_adcx.Init.PeriphInc = DMA_PINC_DISABLE;
    
84.     hdma_adcx.Init.MemInc = DMA_MINC_ENABLE;
    
85.     hdma_adcx.Init.PeriphDataAlignment = DMA_PDATAALIGN_HALFWORD;
    
86.     hdma_adcx.Init.MemDataAlignment = DMA_MDATAALIGN_HALFWORD;
    
87.     hdma_adcx.Init.Mode = DMA_CIRCULAR;
    
88.     hdma_adcx.Init.Priority = DMA_PRIORITY_HIGH;
    
89.     HAL_DMA_Init(&hdma_adcx);
    
90.     /* 连接DMA */
    
91.     __HAL_LINKDMA(hadc,DMA_Handle,hdma_adcx);
    
92.    
    
93.     /* 外设中断优先级配置和使能中断 */
    
94.     HAL_NVIC_SetPriority(ADC_DMAx_CHANNELn_IRQn, 0, 0);
    
95.     HAL_NVIC_EnableIRQ(ADC_DMAx_CHANNELn_IRQn);
    
96.   }
    
97. }
    
98. 
    
99. /**
    
100.   * 函数功能: ADC外设反初始化配置
     
101.   * 输入参数: hadc：AD外设句柄类型指针
     
102.   * 返 回 值: 无
     
103.   * 说    明: 该函数被HAL库内部调用
     
104.   */
     
105. void HAL_ADC_MspDeInit(ADC_HandleTypeDef* hadc)
     
106. {
     
107.   if(hadc->Instance==ADCx)
     
108.   {
     
109.     /* 禁用ADC外设时钟 */
     
110.     ADCx_RCC_CLK_DISABLE();
     
111.   
     
112.     /* AD转换通道引脚反初始化 */
     
113.     HAL_GPIO_DeInit(ADC_GPIO, ADC_GPIO_PIN);
     
114. 
     
115.     /* DMA外设反初始化*/
     
116.     HAL_DMA_DeInit(hadc->DMA_Handle);
     
117.   }
     
118. }
     
119. 
     
120. /******************* (C) COPYRIGHT 2015-2020 硬石嵌入式开发团队 *****END OF FILE****/
     

复制代码

谢谢小编，感谢分享，赞一个