Enum ConversionMode

#[non_exhaustive]
pub enum ConversionMode {
    Single,
    Continuous,
    Discontinuous(u8),
}

The conversion mode the ADC peripheral is operating in.

The Adc can be configured through Adc::set_conversion_mode and obtained via Adc::conversion_mode.

A conversion is either started by Adc::start_conversion, or by an external trigger (ExternalTrigger).

TLDR

• ConversionMode::Single once triggered goes through the whole sequence then stops.
• ConversionMode::Continuous once triggered goes through the whole sequence and repeats that process until activly stopped (e.g. by calling [Adc::start_conversion.] ConversionMode::Single)
• ConversionMode::Discontinuous once triggered goes through part of the sequence in the specified step width n + 1 and has to be activly triggered to continue.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Single

In Single conversion mode, the ADC performs once all the conversions of the channels.

Start Conditions

Inside the regular sequence, after each conversion is complete:

• The converted data are stored into the 16-bit data register
• The Event::EndOfConversion event is set.
• An interrupt is generated if an interrupt is enabled for Event::EndOfConversion. (Adc::enable_interrupt)

After the regular sequence is complete:

• The Event::EndOfSequence event is set.
• An interrupt is generated if an interrupt is enabled for Event::EndOfSequence. (Adc::enable_interrupt)

Continuous

In continuous conversion mode, when a software or hardware regular trigger event occurs, the ADC performs once all the regular conversions of the channels and then automatically re-starts and continuously converts each conversions of the sequence.

Note

This mode applies to regular channls only.

Start conditions

Inside the regular sequence, after each conversion is complete:

• The converted data are stored into the 16-bit data register
• The Event::EndOfConversion event is set.
• An interrupt is generated if an interrupt is enabled for Event::EndOfConversion. (Adc::enable_interrupt)

After the sequence of conversions is complete:

• The Event::EndOfSequence event is set.
• An interrupt is generated if an interrupt is enabled for Event::EndOfSequence. (Adc::enable_interrupt)

Discontinuous(u8)

It is used to convert a short sequence (sub-group) of n + 1 conversions (n ≤ 8) that is part of the sequence of conversions selected via Adc::set_channel_sequence. The value is specified by the associated enum value Discontinuous(n).

When an ExternalTrigger occurs, it starts the next n + 1 conversions selected with Adc::set_channel_sequence registers until all the conversions in the sequence are done. The total sequence length is defined by Adc::set_sequence_length

Example

Discontinuous(2)

Channels to be converted = 1, 2, 3, 6, 7, 8, 9, 10, 11

• 1st trigger:
  • channels converted are 1, 2, 3 (an Event::EndOfConversion is generated at each conversion).
• 2nd trigger:
  • channels converted are 6, 7, 8 (an Event::EndOfConversion is generated at each conversion).
• 3rd trigger:
  • channels converted are 9, 10, 11 (an Event::EndOfConversion is generated at each conversion) and an Event::EndOfSequence event is generated after the conversion of channel 11.
• 4th trigger:
  • channels converted are 1, 2, 3 (an Event::EndOfConversion is generated at each conversion).
• …

Continuous

Channels to be converted = 1, 2, 3, 6, 7, 8, 9, 10,11

• 1st trigger:
  • The complete sequence is converted: channel 1, then 2, 3, 6, 7, 9, 10 and 11. Each conversion generates an Event::EndOfConversion event and the last one also generates an Event::EndOfSequence event. – All the next trigger events will relaunch the complete sequence

Note

When a regular group is converted in ConversionMode::Discontinuous, no rollover occurs (the last subgroup of the sequence can have less than n conversions). When all subgroups are converted, the next trigger starts the conversion of the first subgroup. In the example above, the 4th trigger reconverts the channels 1, 2 and 3 in the 1st subgroup.

Trait Implementations

impl Clone for ConversionMode

fn clone(&self) -> ConversionMode

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ConversionMode

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for ConversionMode

fn default() -> Self

Returns the “default value” for a type.

impl From<CONT_A> for ConversionMode

fn from(mode: CONT_A) -> Self

Converts to this type from the input type.

impl From<ConversionMode> for CONT_A

fn from(mode: ConversionMode) -> Self

Converts to this type from the input type.

impl From<ConversionMode> for DISCEN_A

fn from(mode: ConversionMode) -> Self

Converts to this type from the input type.

impl PartialEq for ConversionMode

fn eq(&self, other: &ConversionMode) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Copy for ConversionMode

impl Eq for ConversionMode

impl StructuralPartialEq for ConversionMode