kelas ADC -- konversi analog ke digital#

Kelas ADC membungkus satu saluran konverter analog-ke-digital yang mengambil sampel tegangan pada pin (atau salah satu saluran analog on-chip) dan mengembalikan nilai yang telah didiskritisasi.

Contoh penggunaan:

from machine import ADC, Pin

adc = ADC(Pin("P6"))      # ADC channel on header pin P6 (PA5)
val = adc.read_u16()      # raw reading scaled to 0..65535

Konstruktor#

class machine.ADC(id: int | str | Pin) → ADC#

Buat objek ADC untuk sumber analog yang diidentifikasi oleh id. Bentuk yang diterima adalah:

  • nomor saluran integer (0 -- 18 pada STM32, spesifik port di tempat lain);

  • objek Pin, atau string pin board seperti "P6" -- pin harus mampu analog;

  • salah satu konstanta saluran internal (CORE_TEMP, CORE_VREF, CORE_VBAT, VREF atau CORE_VDD) untuk membaca sensor internal MCU. Hanya STM32.

Metode#

read_u16() → int#

Ambil sampel saluran analog sekali dan kembalikan hasilnya sebagai integer tak bertanda 16-bit (0 -- 65535). ADC resolusi lebih rendah disejajarkan ke kiri ke dalam rentang 16-bit sehingga resolusi mentah spesifik port disembunyikan.

read_uv() → int#

Ambil sampel saluran analog dan kembalikan hasilnya dalam mikrovolt. Pembacaan dikalibrasi terhadap referensi internal jika perangkat keras mendukungnya. Hanya port mimxrt.

Konstanta#

Konstanta di bawah ini hanya tersedia pada port STM32; berikan sebagai argumen id untuk membangun ADC yang membaca salah satu sensor analog on-chip. Hasil dari read_u16() adalah pembacaan 16-bit mentah saluran; untuk nilai yang dikalibrasi gunakan helper pada pyb.ADCAll.

VREF: int#

Saluran referensi tegangan eksternal.

CORE_VREF: int#

Saluran referensi tegangan internal 1,21 V (nominal) (VREFINT).

CORE_TEMP: int#

Saluran sensor suhu die internal.

CORE_VBAT: int#

Saluran tegangan baterai cadangan (VBAT).

CORE_VDD: int#

Saluran rail suplai MCU (VDDA).