Struct DmaFrameBuffer

#[repr(C, align(4))]
pub struct DmaFrameBuffer<const ROWS: usize, const COLS: usize, const NROWS: usize, const BITS: u8, const FRAME_COUNT: usize> { /* private fields */ }

DMA-compatible framebuffer for HUB75 LED panels with external latch circuit support.

This implementation is optimized for memory usage and external latch circuit support:

• Uses 8-bit entries instead of 16-bit
• Separates address and data words
• Supports the external latch circuit for row selection
• Implements the embedded-graphics DrawTarget trait

Type Parameters

• ROWS: Total number of rows in the panel
• COLS: Number of columns in the panel
• NROWS: Number of rows per scan (typically half of ROWS)
• BITS: Color depth (1-8 bits)
• FRAME_COUNT: Number of frames used for Binary Code Modulation

Helper Functions

Use these functions to compute the correct values:

• esp_hub75::compute_frame_count(BITS): Computes the required number of frames
• esp_hub75::compute_rows(ROWS): Computes the number of rows per scan

Memory Layout

The buffer is aligned to ensure efficient DMA transfers and contains:

• An array of frames, each containing the full panel data
• Each frame contains NROWS rows
• Each row contains both data and address words

Implementations

impl<const ROWS: usize, const COLS: usize, const NROWS: usize, const BITS: u8, const FRAME_COUNT: usize> DmaFrameBuffer<ROWS, COLS, NROWS, BITS, FRAME_COUNT>

pub fn new() -> Self

Create a new framebuffer with the given number of frames. The framebuffer is automatically formatted and ready to use.

Example

use hub75_framebuffer::{latched::DmaFrameBuffer,compute_rows,compute_frame_count};

const ROWS: usize = 32;
const COLS: usize = 64;
const BITS: u8 = 3; // Color depth (8 brightness levels, 7 frames)
const NROWS: usize = compute_rows(ROWS); // Number of rows per scan
const FRAME_COUNT: usize = compute_frame_count(BITS); // Number of frames for BCM

let mut framebuffer = DmaFrameBuffer::<ROWS, COLS, NROWS, BITS, FRAME_COUNT>::new();
// Ready to use immediately

pub fn format(&mut self)

Format the framebuffer, setting up all control bits and clearing pixel data. This method does a full format of all control bits and clears all pixel data. Normally you don’t need to call this as new() automatically formats the framebuffer.

Example

use hub75_framebuffer::{Color,latched::DmaFrameBuffer,compute_rows,compute_frame_count};

const ROWS: usize = 32;
const COLS: usize = 64;
const BITS: u8 = 3; // Color depth (8 brightness levels, 7 frames)
const NROWS: usize = compute_rows(ROWS); // Number of rows per scan
const FRAME_COUNT: usize = compute_frame_count(BITS); // Number of frames for BCM

let mut framebuffer = DmaFrameBuffer::<ROWS, COLS, NROWS, BITS, FRAME_COUNT>::new();
// framebuffer.format(); // Not needed - new() already calls this

pub fn erase(&mut self)

Erase pixel colors while preserving control bits. This is much faster than format() and is the typical way to clear the display.

Example

use hub75_framebuffer::{Color,latched::DmaFrameBuffer,compute_rows,compute_frame_count};

const ROWS: usize = 32;
const COLS: usize = 64;
const BITS: u8 = 3; // Color depth (8 brightness levels, 7 frames)
const NROWS: usize = compute_rows(ROWS); // Number of rows per scan
const FRAME_COUNT: usize = compute_frame_count(BITS); // Number of frames for BCM

let mut framebuffer = DmaFrameBuffer::<ROWS, COLS, NROWS, BITS, FRAME_COUNT>::new();
// ... draw some pixels ...
framebuffer.erase();

pub fn set_pixel(&mut self, p: Point, color: Color)

Set a pixel in the framebuffer.

Example

use hub75_framebuffer::{Color,latched::DmaFrameBuffer,compute_rows,compute_frame_count};
use embedded_graphics::prelude::*;

const ROWS: usize = 32;
const COLS: usize = 64;
const BITS: u8 = 3; // Color depth (8 brightness levels, 7 frames)
const NROWS: usize = compute_rows(ROWS); // Number of rows per scan
const FRAME_COUNT: usize = compute_frame_count(BITS); // Number of frames for BCM

let mut framebuffer = DmaFrameBuffer::<ROWS, COLS, NROWS, BITS, FRAME_COUNT>::new();
framebuffer.set_pixel(Point::new(10, 10), Color::RED);

Trait Implementations

impl<const ROWS: usize, const COLS: usize, const NROWS: usize, const BITS: u8, const FRAME_COUNT: usize> Clone for DmaFrameBuffer<ROWS, COLS, NROWS, BITS, FRAME_COUNT>

fn clone(&self) -> DmaFrameBuffer<ROWS, COLS, NROWS, BITS, FRAME_COUNT>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<const ROWS: usize, const COLS: usize, const NROWS: usize, const BITS: u8, const FRAME_COUNT: usize> Debug for DmaFrameBuffer<ROWS, COLS, NROWS, BITS, FRAME_COUNT>

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

Formats the value using the given formatter.

impl<const ROWS: usize, const COLS: usize, const NROWS: usize, const BITS: u8, const FRAME_COUNT: usize> Default for DmaFrameBuffer<ROWS, COLS, NROWS, BITS, FRAME_COUNT>

fn default() -> Self

Returns the “default value” for a type.

impl<const ROWS: usize, const COLS: usize, const NROWS: usize, const BITS: u8, const FRAME_COUNT: usize> DrawTarget for DmaFrameBuffer<ROWS, COLS, NROWS, BITS, FRAME_COUNT>

type Color = Rgb888

The pixel color type the targetted display supports.

type Error = Infallible

Error type to return when a drawing operation fails.

fn draw_iter<I>(&mut self, pixels: I) -> Result<(), Self::Error>

where I: IntoIterator<Item = Pixel<Self::Color>>,

Draw individual pixels to the display without a defined order.

fn fill_contiguous<I>( &mut self, area: &Rectangle, colors: I, ) -> Result<(), Self::Error>

where I: IntoIterator<Item = Self::Color>,

Fill a given area with an iterator providing a contiguous stream of pixel colors.

fn fill_solid( &mut self, area: &Rectangle, color: Self::Color, ) -> Result<(), Self::Error>

Fill a given area with a solid color.

fn clear(&mut self, color: Self::Color) -> Result<(), Self::Error>

Fill the entire display with a solid color.

impl<const ROWS: usize, const COLS: usize, const NROWS: usize, const BITS: u8, const FRAME_COUNT: usize> FrameBuffer<ROWS, COLS, NROWS, BITS, FRAME_COUNT> for &mut DmaFrameBuffer<ROWS, COLS, NROWS, BITS, FRAME_COUNT>

fn get_word_size(&self) -> WordSize

Returns the word size configuration for this framebuffer

impl<const ROWS: usize, const COLS: usize, const NROWS: usize, const BITS: u8, const FRAME_COUNT: usize> FrameBuffer<ROWS, COLS, NROWS, BITS, FRAME_COUNT> for DmaFrameBuffer<ROWS, COLS, NROWS, BITS, FRAME_COUNT>

fn get_word_size(&self) -> WordSize

Returns the word size configuration for this framebuffer

impl<const ROWS: usize, const COLS: usize, const NROWS: usize, const BITS: u8, const FRAME_COUNT: usize> FrameBufferOperations<ROWS, COLS, NROWS, BITS, FRAME_COUNT> for DmaFrameBuffer<ROWS, COLS, NROWS, BITS, FRAME_COUNT>

fn erase(&mut self)

Erase pixel colors while preserving control bits. This is much faster than format() and is the typical way to clear the display.

fn set_pixel(&mut self, p: Point, color: Color)

Set a pixel in the framebuffer.

impl<const ROWS: usize, const COLS: usize, const NROWS: usize, const BITS: u8, const FRAME_COUNT: usize> OriginDimensions for &mut DmaFrameBuffer<ROWS, COLS, NROWS, BITS, FRAME_COUNT>

fn size(&self) -> Size

Returns the size of the bounding box.

impl<const ROWS: usize, const COLS: usize, const NROWS: usize, const BITS: u8, const FRAME_COUNT: usize> OriginDimensions for DmaFrameBuffer<ROWS, COLS, NROWS, BITS, FRAME_COUNT>

fn size(&self) -> Size

Returns the size of the bounding box.

impl<const ROWS: usize, const COLS: usize, const NROWS: usize, const BITS: u8, const FRAME_COUNT: usize> ReadBuffer for &mut DmaFrameBuffer<ROWS, COLS, NROWS, BITS, FRAME_COUNT>

type Word = u8

unsafe fn read_buffer(&self) -> (*const u8, usize)

Provide a buffer usable for DMA reads.

impl<const ROWS: usize, const COLS: usize, const NROWS: usize, const BITS: u8, const FRAME_COUNT: usize> ReadBuffer for DmaFrameBuffer<ROWS, COLS, NROWS, BITS, FRAME_COUNT>

type Word = u8

unsafe fn read_buffer(&self) -> (*const u8, usize)

Provide a buffer usable for DMA reads.

impl<const ROWS: usize, const COLS: usize, const NROWS: usize, const BITS: u8, const FRAME_COUNT: usize> Copy for DmaFrameBuffer<ROWS, COLS, NROWS, BITS, FRAME_COUNT>