class ADCAll – accesso a tutti i canali ADC¶

ADCAll espone ogni canale ADC del MCU attraverso un singolo oggetto – sia i pin di ingresso analogico esterni sia i canali interni per la temperatura del die, il riferimento da 1.21 V e VBAT. È utile per monitorare la linea di alimentazione del MCU e i sensori on-chip senza istanziare un ADC per ogni pin.

Esempio:

import pyb

# 12-bit resolution, internal channels only (temp + VBAT + VREF).
adcall = pyb.ADCAll(12, 0x70000)
temp = adcall.read_core_temp()
vbat = adcall.read_core_vbat()
vref = adcall.read_core_vref()
vdda = adcall.read_vref()

Costruttori¶

class pyb.ADCAll(resolution: int, mask: int = 0xffffffff)¶

Fornisce l’accesso simultaneo a ogni canale ADC del MCU, inclusi i canali interni per la temperatura del die, il riferimento interno da 1.21 V e VBAT. La costruzione di questo oggetto commuta in modalità ingresso analogico tutti i pin ADC esterni mascherati.

resolution è la risoluzione di conversione dell’ADC in bit (tipicamente 8, 10 o 12).
mask è una bitmask a 32 bit che seleziona quali canali abilitare; il bit N abilita il canale N. Il valore predefinito è 0xffffffff (tutti i canali). I canali interni si trovano ai bit 16 (temperatura), 17 (VBAT) e 18 (VREF), quindi per abilitare solo i canali interni passa 0x70000.

Il sensore di temperatura on-chip è calibrato in fabbrica ed è accurato fino a circa ±1 °C, ma misura la temperatura del die – che è tipicamente decine di gradi superiore a quella ambiente quando il MCU è attivo. Le letture sono significative come stima della temperatura ambiente solo su una scheda appena risvegliata.

Avvertimento

Le tensioni di ingresso analogiche non devono mai superare la tensione di alimentazione effettiva.

Metodi¶

read_channel(channel: int) → int¶: Legge il canale ADC specificato. I canali esterni (0 – 15) restituiscono valori grezzi non scalati alla risoluzione configurata; i canali interni (16–18) restituiscono anch’essi valori grezzi, ma gli helper dedicati indicati di seguito li convertono in tensioni.

read_core_temp() → float¶: Restituisce la temperatura del die in gradi Celsius, calcolata dal canale di temperatura interno e dai valori di calibrazione di fabbrica memorizzati nel MCU.

read_core_vbat() → float¶: Restituisce la tensione della batteria di backup in volt. La lettura viene effettuata attraverso un partitore di tensione on-chip (in modo che il margine non limiti l’intervallo di ingresso dell’ADC) e riscalata alla tensione effettiva della batteria. Il partitore è attivo solo durante la conversione dell’ADC, quindi l’assorbimento in standby sulla batteria di backup è trascurabile.

read_core_vref() → float¶: Restituisce la tensione di riferimento interna da 1.21 V (nominale) in volt, misurata usando l’alimentazione del MCU come riferimento dell’ADC. Questo è il risultato grezzo della conversione.

read_vref() → float¶: Restituisce la tensione di alimentazione del MCU in volt. Calcolata misurando il riferimento di tensione interno e riscalando in base al suo valore di calibrazione di fabbrica. Con una linea da 3.3 V in buono stato la lettura sarà vicina a 3.3. Il MCU continua a funzionare – e le conversioni dell’ADC rimangono significative – con un’alimentazione fino a circa 2 V, purché vengano rispettate le impostazioni appropriate di clock del MCU, velocità di accesso alla flash e modalità di programmazione.