总览
本节介绍了模数转换器（ADC）HAL驱动器的编程接口。
术语和首字母缩写词
下面提供了ADC驱动器中常用术语的描述以及如何使用其各种功能。
| 条款 | 细节 |
|---|---|
| ADC | ADC是一个模数转换器，可将连续的物理量（通常是电压）转换为代表该量幅值的数字。 |
支持的功能
ADC是逐次逼近型ADC。支持的通道根据使用的实际MCU设备而有所不同。ADC的分辨率为12位。
- 检索 ADC 数据 用于 一个 信道。
调用hal_adc_get_data_polling（）函数以获取通道数据。一次仅检索一个样本数据。
如何使用此驱动程序
- 使用 ADC 驱动器 ，以 获取 样本 数据 的 一个 通道。
- 步骤1：调用hal_adc_init（）初始化ADC模块。将引脚用作ADC模式时，无需调用hal_pinmux_set_function（）。
- 步骤2：调用hal_adc_get_data_polling（）检索通道的样本数据。
- 步骤3：调用hal_adc_deinit（）使ADC模块返回其原始状态。
- 样例代码：
uint32_t adc_data;hal_adc_init（）; //初始化ADC模块。hal_adc_get_data_polling（HAL_ADC_CHANNEL_AIO_0，＆adc_data）; //检索通道0的ADC数据。hal_adc_deinit（）; //完成作业后，请初始化ADC模块。
模组 |
|
| 枚举 | |
功能 |
|
| hal_adc_status_t | hal_adc_init（无效） |
| ADC初始化功能。 更多... | |
| hal_adc_status_t | hal_adc_deinit（无效） |
| ADC反初始化功能。该功能将ADC外设寄存器重置为其默认值。 更多... | |
| hal_adc_status_t | hal_adc_get_data_polling（hal_adc_channel_t通道，uint32_t * data） |
| ADC接收通道的样本数据。 更多... | |
功能文件
◆ hal_adc_deinit（）
| hal_adc_status_t hal_adc_deinit | （ | 虚空 | ） |
◆ hal_adc_get_data_polling（）
| hal_adc_status_t hal_adc_get_data_polling | （ | hal_adc_channel_t | 通道， |
| uint32_t * | 数据 | ||
| ） |
ADC接收通道的样本数据。
参量
| [在] | 渠道 | 是将要采样的通道。此参数只能是hal_adc_channel_t类型的值。 |
| [出] | 数据 | 是通道的原始数据。 |
退货
HAL_ADC_STATUS_OK，ADC成功获取数据。
HAL_ADC_STATUS_ERROR_CHANNEL，通道号无效。
HAL_ADC_STATUS_INVALID_PARAMETER，数据为NULL。
例
示例代码，请参阅“使用ADC驱动程序”以获取有关如何使用此驱动程序的通道的示例数据
◆ hal_adc_init（）
| hal_adc_status_t hal_adc_init | （ | 虚空 | ） |
ADC初始化功能。
退货
HAL_ADC_STATUS_OK，ADC初始化成功。
HAL_ADC_STATUS_ERROR_BUSY，ADC忙。
HAL_ADC_STATUS_ERROR，ADC时钟启用失败。