machine.ADC

machine.ADC 类是 machine 模块下的一个硬件类,用于指定 ADC 设备的配置和控制,提供对 ADC 设备的操作方法。

  • ADC(Analog-to-Digital Converter,模数转换器),用于将连续变化的模拟信号转化为离散的数字信号。
  • ADC 设备两个重要参数:采样值、分辨率;
  • 采样值:当前时间由模拟信号转化的数值信号的数值;
  • 分辨率:以二进制(或十进制)数的位数来表示,一般有 8 位、10 位、12 位、16 位等,它说明模数转换器对输入信号的分辨能力,位数越多,表示分辨率越高,采样值会更精确。

构造函数

在 RT-Thread MicroPython 中 ADC 对象的构造函数如下:

class machine.ADC(id, channel)

  • id:使用的 ADC 设备编号,id = 1 表示编号为 1 的 ADC 设备,或者表示使用的 ADC 设备名,如 id = "adc" 表示设备名为 adc 的 ADC 设备;
  • channel:使用的 ADC 设备通道号,每个 ADC 设备对应多个通道;

例如:ADC(1,4) 表示当前使用编号为 1 的 ADC 设备的 4 通道。

方法

ADC.init(channel)

根据输入的层参数初始化 ADC 对象,入参为使用的 ADC 对象通道号;

ADC.deinit()

用于关闭 ADC 对象,ADC 对象 deinit 之后需要重新 init 才能使用。

ADC.read()

用于获取并返回当前 ADC 对象的采样值。例如当前采样值为 2048,对应设备的分辨率为 12位,当前设备参考电压为 3.3V ,则该 ADC 对象通道上实际电压值的计算公式为:采样值 * 参考电压 / (1 << 分辨率位数),即 vol = 2048 / 4096 * 3.3 V = 1.15V

示例

>>> from machine import ADC      # 从 machine 导入 ADC 类
>>> adc = ADC(1, 13)             # 创建 ADC 对象,当前使用编号为 1 的 ADC 设备的 13 通道
>>> adc.read()                   # 获取 ADC 对象采样值
4095
>>> adc.deinit()                 # 关闭 ADC 对象
>>> adc.init(13)                 # 开启并重新配置 ADC 对象

Question && Feedback