總覽
本節介紹了模數轉換器（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時鐘啓用失敗。