Struct RingOscillator 

pub struct RingOscillator<S>
where
    S: State,
{ /* private fields */ }

A Ring Oscillator.

Implementations

impl<S> RingOscillator<S>

where S: State,

pub fn free(self) -> ROSC

Releases the underlying device.

impl RingOscillator<Disabled>

pub fn new(dev: ROSC) -> RingOscillator<Disabled>

Creates a new RingOscillator from the underlying device.

pub fn initialize(self) -> RingOscillator<Enabled>

Initializes the ROSC : frequency range is set, startup delay is calculated and set.

pub fn initialize_with_freq( self, known_freq: Rate<u32, 1, 1>, ) -> RingOscillator<Enabled>

Initializes the ROSC with a known frequency.

See Sections 8.3.4 “Modifying the frequency”, and 8.3.8 “Using the frequency counter” in the RP2350 datasheet for guidance on how to do this before initialising the ROSC. Also see rosc_as_system_clock example for usage.

impl RingOscillator<Enabled>

pub fn operating_frequency(&self) -> Rate<u32, 1, 1>

Approx operating frequency of the ROSC in hertz

pub fn disable(self) -> RingOscillator<Disabled>

Disables the ROSC

pub fn get_random_bit(&self) -> bool

Generate random bit based on the Ring oscillator This is not suited for security purposes

pub unsafe fn dormant(&self)

Put the ROSC in DORMANT state. The method returns after the processor awakens.

After waking up from the DORMANT state, ROSC restarts in approximately 1µs.

Safety

This method is marked unsafe because prior to switch the ROSC into DORMANT state, PLLs must be stopped and IRQs have to be properly configured. This method does not do any of that, it merely switches the ROSC to DORMANT state. It should only be called if this oscillator is the clock source for the system clock.

See Section 6.5.3 of the RP2350 datasheet.

Trait Implementations

impl ClockSource for RingOscillator<Enabled>

fn get_freq(&self) -> Rate<u32, 1, 1>

Get the operating frequency for this source

impl RngCore for RingOscillator<Enabled>

fn next_u32(&mut self) -> u32

Return the next random u32.

fn next_u64(&mut self) -> u64

Return the next random u64.

fn fill_bytes(&mut self, dest: &mut [u8])

Fill dest with random data.

fn try_fill_bytes(&mut self, dest: &mut [u8]) -> Result<(), Error>

Fill dest entirely with random data.

impl ValidSrc<AdcClock> for RingOscillator<Enabled>

fn is_aux(&self) -> bool

Is this a ClockSource for src or aux?

fn variant(&self) -> ClkAdcSrcType

Get register value for this ClockSource

impl ValidSrc<GpioOutput0Clock> for RingOscillator<Enabled>

fn is_aux(&self) -> bool

Is this a ClockSource for src or aux?

fn variant(&self) -> ClkGpout0SrcType

Get register value for this ClockSource

impl ValidSrc<GpioOutput1Clock> for RingOscillator<Enabled>

fn is_aux(&self) -> bool

Is this a ClockSource for src or aux?

fn variant(&self) -> ClkGpout1SrcType

Get register value for this ClockSource

impl ValidSrc<GpioOutput2Clock> for RingOscillator<Enabled>

fn is_aux(&self) -> bool

Is this a ClockSource for src or aux?

fn variant(&self) -> ClkGpout2SrcType

Get register value for this ClockSource

impl ValidSrc<GpioOutput3Clock> for RingOscillator<Enabled>

fn is_aux(&self) -> bool

Is this a ClockSource for src or aux?

fn variant(&self) -> ClkGpout3SrcType

Get register value for this ClockSource

impl ValidSrc<PeripheralClock> for RingOscillator<Enabled>

fn is_aux(&self) -> bool

Is this a ClockSource for src or aux?

fn variant(&self) -> ClkPeriSrcType

Get register value for this ClockSource

impl ValidSrc<ReferenceClock> for RingOscillator<Enabled>

fn is_aux(&self) -> bool

Is this a ClockSource for src or aux?

fn variant(&self) -> ClkRefSrcType

Get register value for this ClockSource

impl ValidSrc<SystemClock> for RingOscillator<Enabled>

fn is_aux(&self) -> bool

Is this a ClockSource for src or aux?

fn variant(&self) -> ClkSysSrcType

Get register value for this ClockSource

impl ValidSrc<UsbClock> for RingOscillator<Enabled>

fn is_aux(&self) -> bool

Is this a ClockSource for src or aux?

fn variant(&self) -> ClkUsbSrcType

Get register value for this ClockSource