ADC

ADC ，即analog to digital converter（模数转换器）是一种非常常见的外设，用于将电压等模拟信号转换为数字形式，以便微控制器可以读取和处理。

ADC 在控制和监控应用中非常有用，因为大多数传感器（例如温度、压力、力）都会产生模拟输出电压。

注

每个 MCU 或模块都有不同数量的 ADC，以及不同数量的可用通道和引脚。有关详细信息，请参阅每个板的数据手册。

ADC 通用 API

analogRead

此函数用于获取给定引脚/ADC 通道的 ADC 原始值。

uint32_t analogRead(uint32_t pin);

• pin GPIO 引脚或 ADC 通道。
• • ADC的内部通道可以为ATEMP (内部温度传感器)、AVBAT (VBAT电压)、AREF (内部参考电压)。

该函数将返回模拟原始值。

读取内部通道时需要最小 ADC 采样时间，因此默认将其设置为最大可能值。它可以通过定义更精确地定义：

• ADC_SAMPLINGTIME_INTERNAL 到所需的 ADC 采样时间。

ADC_SAMPLINGTIME 和 ADC_CLOCK_DIV 也可以通过变体或使用 build_opt.h 重新定义。

analogReference

配置模拟输入所用的基准电压（即用作输入范围上限的值）。保留此功能只是为了与现有的基于 AVR 的 API 兼容。

void analogReference(eAnalogReference ulMode) ;

AirMCU 专用 API

analogReadResolution

此函数用于设置 ADC 读取的分辨率。默认为 10 位（范围为 0 至 1023）。

void analogReadResolution(uint8_t bits);

analogReadMillivolts

此函数用于获取给定引脚上的实际电压值（单位为毫伏）。

uint32_t analogReadMillivolts(uint32_t ulPin);

• ulPin GPIO 引脚

该函数将返回模拟电压值。

analogReadTempSensor

此函数用于获取内部温度传感器的实际温度值（单位为摄氏度）。

uint32_t analogReadTempSensor(void);

该函数将返回模拟温度值。

analogReadVref

此函数用于获取内部参考电压的实际电压值（单位为毫伏）。

uint32_t analogReadVref(void);

该函数将返回模拟电压值。