Struct stm32_hal2::adc::Adc

pub struct Adc<R> {
    pub regs: R,
    pub cfg: AdcConfig,
    // some fields omitted
}

Represents an Analog to Digital Converter (ADC) peripheral.

Fields

regs: R

ADC Register

cfg: AdcConfig

Implementations

impl Adc<ADC1>

pub fn new_adc1(
    regs: ADC1,
    device: AdcDevice,
    cfg: AdcConfig,
    clock_cfg: &Clocks
) -> Self

Initialize an ADC peripheral, including configuration register writes, and enabling and resetting its RCC peripheral clock.

pub fn setup_oneshot(&mut self)

Sets up adc in one shot mode for a single channel

pub fn set_sequence_len(&mut self, len: u8)

Set the ADC conversion sequence length, between 1 and 16.

pub fn set_align(&self, align: Align)

Set the alignment mode.

pub fn stop_conversions(&mut self)

If any conversions are in progress, stop them. This is a step listed in the RMs for disable, and calibration procedures. See L4 RM: 16.4.17. When the ADSTP bit is set by software, any ongoing regular conversion is aborted with partial result discarded (ADC_DR register is not updated with the current conversion). When the JADSTP bit is set by software, any ongoing injected conversion is aborted with partial result discarded (ADC_JDRy register is not updated with the current conversion). The scan sequence is also aborted and reset (meaning that relaunching the ADC would restart a new sequence).

pub fn is_enabled(&self) -> bool

Check if the ADC is enabled.

pub fn is_advregen_enabled(&self) -> bool

Check if the ADC voltage regulator is enabled.

pub fn advregen_enable(&mut self, clocks: &Clocks)

Enable the ADC voltage regulator, and exit deep sleep mode (some MCUs)

pub fn advregen_disable(&mut self)

Disable power, eg to save power in low power modes. Inferred from RM, we should run this before entering STOP mode, in conjunction with with disabling the ADC.

pub fn calibrate(&mut self, input_type: InputType, clocks: &Clocks)

Calibrate. See L4 RM, 16.5.8, or F404 RM, section 15.3.8. Stores calibration values, which can be re-inserted later, eg after entering ADC deep sleep mode, or MCU STANDBY or VBAT.

pub fn inject_calibration(&mut self)

Insert a previously-saved calibration value into the ADC. Se L4 RM, 16.4.8.

pub fn set_input_type(&mut self, channel: u8, input_type: InputType)

Select single-ended, or differential conversions for a given channel.

pub fn set_sequence(&mut self, chan: u8, position: u8)

Select a sequence to sample, by inputting a single channel and position.

pub fn set_sample_time(&mut self, chan: u8, smp: SampleTime)

Select the sample time for a given channel.

pub fn reading_to_voltage(&self, reading: u16) -> f32

Convert a raw measurement into a voltage in Volts, using the calibrated VDDA. See RM0394, section 16.4.34

pub fn start_conversion(&mut self, sequence: &[u8], mode: OperationMode)

Start a conversion: Either a single measurement, or continuous conversions. See L4 RM 16.4.15 for details.

pub fn read_result(&mut self) -> u16

Read data from a conversion. In OneShot mode, this will generally be run right after start_conversion.

pub fn read(&mut self, channel: u8) -> u16

Take a single reading, in OneShot mode

pub unsafe fn read_dma<D>(
    &mut self,
    buf: &mut [u16],
    adc_channel: u8,
    dma_channel: DmaChannel,
    channel_cfg: ChannelCfg,
    dma: &mut Dma<D>
) where
    D: Deref<Target = RegisterBlock>, 

Take a one shot reading, using DMA. See L44 RM, 16.4.27: “DMA one shot mode”. Note that the channel argument is only used on F3 and L4.

pub fn enable_interrupt(&mut self, interrupt: AdcInterrupt)

Enable a specific type of ADC interrupt.

pub fn clear_interrupt(&mut self, interrupt: AdcInterrupt)

Clear an interrupt flag of the specified type. Consider running this in the corresponding ISR.

Trait Implementations

impl<WORD, PIN> OneShot<ADC1, WORD, PIN> for Adc<ADC1> where
    WORD: From<u16>,
    PIN: Channel<ADC1, ID = u8>, 

type Error = ()

Error type returned by ADC methods

fn read(&mut self, _pin: &mut PIN) -> Result<WORD, Self::Error>

Request that the ADC begin a conversion on the specified pin