Skip to main content

Hub75Config

Struct Hub75Config 

Source
pub struct Hub75Config {
    pub frequency: Rate,
    pub interrupt_priority: Option<Priority>,
}
Expand description

Configuration for creating a Hub75 instance.

Passed to Hub75::new and Hub75::new_async instead of a bare frequency.

Hub75Config::new (and [Default]) start from a 10 MHz pixel clock and the peripheral’s default interrupt priority; override either with the with_frequency and with_interrupt_priority builders.

The theoretical refresh rate for a given framebuffer type and pixel clock can be computed at compile time with refresh_hz.

Fields§

§frequency: Rate

The HUB75 pixel-clock frequency.

§interrupt_priority: Option<Priority>

Interrupt priority for the HUB75 refresh ISR.

None (the default) leaves the ISR at esp-hal’s default interrupt priority (Priority::min()). Raising it lets the refresh ISR preempt lower-priority interrupt handlers, which is the main practical anti-flicker lever on multi-core chips:

  • ESP32: Wi-Fi and other long-running interrupt handlers run at low priority and can delay the refresh ISR by hundreds of microseconds, causing visible flicker. Set the priority to Priority::Priority3 (the maximum) and enable the iram feature to keep the ISR resident in instruction RAM.
  • ESP32-S3: same treatment, especially when Wi-Fi is active.
  • Single-core RISC-V chips (C5/C6): interrupt priority control is more fine-grained there; raising the priority mainly protects the refresh ISR against other same-core interrupt handlers.

Note that a higher ISR priority increases the latency of everything it preempts — including Wi-Fi bookkeeping — so use the lowest value that eliminates flicker.

Implementations§

Source§

impl Hub75Config

Source

pub const fn new() -> Self

Creates a new configuration with the default 10 MHz pixel clock.

Use with_frequency to override the pixel clock, and with_interrupt_priority to raise the refresh ISR priority.

Source

pub const fn with_frequency(self, frequency: Rate) -> Self

Sets the HUB75 pixel-clock frequency.

Source

pub const fn with_interrupt_priority(self, priority: Priority) -> Self

Sets the interrupt priority of the HUB75 refresh ISR.

See Hub75Config::interrupt_priority for guidance.

Trait Implementations§

Source§

impl Clone for Hub75Config

Source§

fn clone(&self) -> Hub75Config

Returns a duplicate of the value. Read more
1.0.0 (const: unstable)§

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

Performs copy-assignment from source. Read more
Source§

impl Copy for Hub75Config

Source§

impl Debug for Hub75Config

Source§

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

Formats the value using the given formatter. Read more
Source§

impl Default for Hub75Config

Source§

fn default() -> Self

Returns the default configuration: a 10 MHz pixel clock and the peripheral’s default interrupt priority.

Auto Trait Implementations§

§

impl Freeze for Hub75Config

§

impl RefUnwindSafe for Hub75Config

§

impl Send for Hub75Config

§

impl Sync for Hub75Config

§

impl Unpin for Hub75Config

§

impl UnsafeUnpin for Hub75Config

§

impl UnwindSafe for Hub75Config

Blanket Implementations§

§

impl<T> Any for T
where T: 'static + ?Sized,

§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Az for T

Source§

fn az<Dst>(self) -> Dst
where T: Cast<Dst>,

Casts the value.
§

impl<T> Borrow<T> for T
where T: ?Sized,

§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
§

impl<T> BorrowMut<T> for T
where T: ?Sized,

§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<Src, Dst> CastFrom<Src> for Dst
where Src: Cast<Dst>,

Source§

fn cast_from(src: Src) -> Dst

Casts the value.
Source§

impl<T> CheckedAs for T

Source§

fn checked_as<Dst>(self) -> Option<Dst>
where T: CheckedCast<Dst>,

Casts the value.
Source§

impl<Src, Dst> CheckedCastFrom<Src> for Dst
where Src: CheckedCast<Dst>,

Source§

fn checked_cast_from(src: Src) -> Option<Dst>

Casts the value.
§

impl<T> CloneToUninit for T
where T: Clone,

§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
§

impl<T> From<T> for T

§

fn from(t: T) -> T

Returns the argument unchanged.

§

impl<T, U> Into<U> for T
where U: From<T>,

§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of [From]<T> for U chooses to do.

Source§

impl<T> OverflowingAs for T

Source§

fn overflowing_as<Dst>(self) -> (Dst, bool)
where T: OverflowingCast<Dst>,

Casts the value.
Source§

impl<Src, Dst> OverflowingCastFrom<Src> for Dst
where Src: OverflowingCast<Dst>,

Source§

fn overflowing_cast_from(src: Src) -> (Dst, bool)

Casts the value.
Source§

impl<T> Same for T

Source§

type Output = T

Should always be Self
Source§

impl<T> SaturatingAs for T

Source§

fn saturating_as<Dst>(self) -> Dst
where T: SaturatingCast<Dst>,

Casts the value.
Source§

impl<Src, Dst> SaturatingCastFrom<Src> for Dst
where Src: SaturatingCast<Dst>,

Source§

fn saturating_cast_from(src: Src) -> Dst

Casts the value.
§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

§

type Error = !

The type returned in the event of a conversion error.
§

fn try_from(value: U) -> Result<T, !>

Performs the conversion.
§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Source§

impl<T> UnwrappedAs for T

Source§

fn unwrapped_as<Dst>(self) -> Dst
where T: UnwrappedCast<Dst>,

Casts the value.
Source§

impl<Src, Dst> UnwrappedCastFrom<Src> for Dst
where Src: UnwrappedCast<Dst>,

Source§

fn unwrapped_cast_from(src: Src) -> Dst

Casts the value.
Source§

impl<T> WrappingAs for T

Source§

fn wrapping_as<Dst>(self) -> Dst
where T: WrappingCast<Dst>,

Casts the value.
Source§

impl<Src, Dst> WrappingCastFrom<Src> for Dst
where Src: WrappingCast<Dst>,

Source§

fn wrapping_cast_from(src: Src) -> Dst

Casts the value.