Struct Allocator 

pub struct Allocator {
    pub address: u32,
}

Allocator for 28-bit memory

This can be used to allocate memory in 28-bit address space.

Examples

The allocated 28-bit region is described by a fat Ptr28 pointer, which implements the From trait for common types such as Vec<u8> and String.

let mut bank = Allocator::new(0x40000);
let a = Vec::<u8>::from([7, 9, 13]);
let ptr = bank.write(a.as_slice()); // dma write
let b = Vec::<u8>::from(ptr); // dma read
assert_eq!(a, b);

Vec<Ptr28> can be traversed almost as if a vector of values:

let cnt = Vec::from([bank.push(b"first"), bank.push(b"second")])
     .iter()
     .copied()
     .map(String::from) // dma write
     .filter(|s| s.starts_with('s'))
     .count();
assert_eq!(cnt, 1);

Fields

address: u32

Current 28-bit address

Implementations

impl Allocator

pub const fn new(address: u32) -> Self

New allocator starting at address

pub fn write(&mut self, bytes: &[u8]) -> Ptr28

DMA copy bytes to next free 28-bit memory location.

Every call to write advances the address by bytes.len().