AB153x API----ADC

 

总览

本节介绍了模数转换器（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

（

虚空

）

ADC反初始化功能。该功能将ADC外设寄存器重置为其默认值。

退货

HAL_ADC_STATUS_OK，ADC初始化成功。
HAL_ADC_STATUS_ERROR，ADC时钟禁用失败。

◆ 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时钟启用失败。

枚举

哈尔 » ADC

总览

枚举
枚举	hal_adc_status_t {   HAL_ADC_STATUS_INVALID_PARAMETER = -4， HAL_ADC_STATUS_ERROR_BUSY = -3， HAL_ADC_STATUS_ERROR_CHANNEL = -2， HAL_ADC_STATUS_ERROR = -1，   HAL_ADC_STATUS_OK = 0 }
	该枚举定义ADC API返回状态。 更多...
枚举	hal_adc_channel_t {   HAL_ADC_CHANNEL_AIO_0 = 0， HAL_ADC_CHANNEL_AIO_1 = 1， HAL_ADC_CHANNEL_AIO_2 = 2， HAL_ADC_CHANNEL_AIO_3 = 3，   HAL_ADC_CHANNEL_AIO_4 = 4， HAL_ADC_CHANNEL_AIO_5 = 5， HAL_ADC_CHANNEL_AIO_6 = 6， HAL_ADC_CHANNEL_AIO_7 = 7，   HAL_ADC_CHANNEL_AIO_8 = 8， HAL_ADC_CHANNEL_AIO_9 = 9， HAL_ADC_CHANNEL_AIO_10 = 10， HAL_ADC_CHANNEL_AIO_11 = 11，   HAL_ADC_CHANNEL_AIO_12 = 12， HAL_ADC_CHANNEL_AIO_13 = 13， HAL_ADC_CHANNEL_AIO_14= 14， HAL_ADC_CHANNEL_AIO_15 = 15，   HAL_ADC_CHANNEL_AIO_16 = 16， HAL_ADC_CHANNEL_AIO_17 = 17， HAL_ADC_VCCIO = 18， HAL_ADC_AVSS = 19，   HAL_ADC_CHANNEL_AIO_28 = 20， HAL_ADC_CHANNEL_AIO_29 = 21， HAL_ADC_CHANNEL_AIO_30 = 22， HAL_ADC_CHANNEL_AIO_31 = 23，   HAL_ADC_ANC_L_DCOC = 24， HAL_ADC_VCCDIG = 25， HAL_ADC_ANC_R_DCOC = 26 ， HAL_ADC_VBAT_SCALE_1DIV5 = 27，   HAL_ADC_VBAT_SCALE_2DIV5 = 28， HAL_ADC_AIOADC_PWR = 29， HAL_ADC_VCM= 30， HAL_ADC_V_TEMP = 31，   HAL_ADC_CHANNEL_MAX }
	交流通道 更多...

枚举类型文档

◆ hal_adc_channel_t

枚举hal_adc_channel_t

ADC通道

枚举器
HAL_ADC_CHANNEL_AIO_0	ADC通道0
HAL_ADC_CHANNEL_AIO_1	ADC通道1。
HAL_ADC_CHANNEL_AIO_2	ADC通道2。
HAL_ADC_CHANNEL_AIO_3	ADC通道3。
HAL_ADC_CHANNEL_AIO_4	ADC通道4。
HAL_ADC_CHANNEL_AIO_5	ADC通道5。
HAL_ADC_CHANNEL_AIO_6	ADC通道6。
HAL_ADC_CHANNEL_AIO_7	ADC通道7。
HAL_ADC_CHANNEL_AIO_8	ADC通道8。
HAL_ADC_CHANNEL_AIO_9	ADC通道9。
HAL_ADC_CHANNEL_AIO_10	ADC通道10。
HAL_ADC_CHANNEL_AIO_11	ADC通道11。
HAL_ADC_CHANNEL_AIO_12	ADC通道12。
HAL_ADC_CHANNEL_AIO_13	ADC通道13。
HAL_ADC_CHANNEL_AIO_14	ADC通道14。
HAL_ADC_CHANNEL_AIO_15	ADC通道15。
HAL_ADC_CHANNEL_AIO_16	ADC通道16。
HAL_ADC_CHANNEL_AIO_17	ADC通道17。
HAL_ADC_VCCIO	ADC通道18。
HAL_ADC_AVSS	ADC通道19。
HAL_ADC_CHANNEL_AIO_28	ADC通道20。
HAL_ADC_CHANNEL_AIO_29	ADC通道21。
HAL_ADC_CHANNEL_AIO_30	ADC通道22。
HAL_ADC_CHANNEL_AIO_31	ADC通道23。
HAL_ADC_ANC_L_DCOC	ADC通道24。
HAL_ADC_VCCDIG	ADC通道25。
HAL_ADC_ANC_R_DCOC	ADC通道26。
HAL_ADC_VBAT_SCALE_1DIV5	ADC通道27。
HAL_ADC_VBAT_SCALE_2DIV5	ADC通道28。
HAL_ADC_AIOADC_PWR	ADC通道29。
HAL_ADC_VCM	ADC通道30。
HAL_ADC_V_TEMP	ADC通道31。
HAL_ADC_CHANNEL_MAX	ADC通道总数（无效的ADC通道）。

◆ hal_adc_status_t

枚举hal_adc_status_t

该枚举定义ADC API返回状态。

枚举器
HAL_ADC_STATUS_INVALID_PARAMETER	无效的参数
HAL_ADC_STATUS_ERROR_BUSY	ADC忙
HAL_ADC_STATUS_ERROR_CHANNEL	ADC通道号错误
HAL_ADC_STATUS_ERROR	ADC错误
HAL_ADC_STATUS_OK	ADC确定

• 
  
   

•