Struct MemoryImage 

pub struct MemoryImage { /* private fields */ }

A parsed TH-D75 memory image providing typed access to all settings.

The image is exactly programming::TOTAL_SIZE bytes (500,480). Create one from a raw MCP dump, or from a .d75 file via from_d75_file.

Examples

use kenwood_thd75::memory::MemoryImage;

let image = MemoryImage::from_raw(raw)?;

// Read channel 0.
let channels = image.channels();
if channels.is_used(0) {
    if let Some(entry) = channels.get(0) {
        println!("Ch 0: {} — {} Hz", entry.name, entry.flash.rx_frequency.as_hz());
    }
}

// Get the raw bytes back for writing.
let bytes = image.into_raw();

Implementations

impl MemoryImage

pub fn from_raw(data: Vec<u8>) -> Result<Self, MemoryError>

Create from a raw memory dump (from read_memory_image or .d75 file body).

Errors

Returns MemoryError::InvalidSize if the data is not exactly 500,480 bytes.

pub fn into_raw(self) -> Vec<u8>

Get the raw bytes (for write_memory_image).

pub fn as_raw(&self) -> &[u8]

Borrow the raw bytes.

pub fn as_raw_mut(&mut self) -> &mut [u8]

Mutably borrow the raw bytes.

pub fn channels(&self) -> ChannelAccess<'_>

Access channel data (read-only).

pub fn channels_mut(&mut self) -> ChannelWriter<'_>

Access channel data (mutable, for writing channels).

pub fn settings(&self) -> SettingsAccess<'_>

Access system settings (read-only raw bytes for unmapped regions).

pub fn settings_mut(&mut self) -> SettingsWriter<'_>

Access system settings (mutable, for writing verified settings).

pub fn modify_setting<F>(&mut self, f: F) -> Option<(u16, u8)>

where F: FnOnce(&mut SettingsWriter<'_>),

Apply a settings mutation and return the changed byte’s MCP offset and new value.

The closure receives a SettingsWriter to modify exactly one setting. This method snapshots the settings page before the closure, runs it, then diffs to find the single changed byte. Returns Some((offset, value)) if a byte changed, or None if nothing changed.

Panics

Panics if more than one byte changed (the closure should modify exactly one setting).

pub fn aprs(&self) -> AprsAccess<'_>

Access the APRS configuration region (raw bytes).

pub fn dstar(&self) -> DstarAccess<'_>

Access the D-STAR configuration region (raw bytes).

pub fn gps(&self) -> GpsAccess<'_>

Access the GPS configuration region (raw bytes).

pub fn from_d75_file(data: &[u8]) -> Result<Self, MemoryError>

Create from a .d75 config file (strips the 256-byte header).

The .d75 file format is a 256-byte file header followed by the raw MCP memory image. This constructor validates the header and extracts the image body.

Errors

Returns MemoryError::D75Error if the file is too short or the header model string is not recognised. Returns MemoryError::InvalidSize if the body is not the expected size.

pub fn to_d75_file(&self, header: &ConfigHeader) -> Vec<u8>

Export as a .d75 config file (prepends header).

Uses the provided ConfigHeader to build the file. The header is preserved as-is (including model string and version bytes) for round-trip fidelity.

pub fn to_d75_bytes(&self) -> Vec<u8>

Export this image as a .d75 file ready to write to the SD card.

Uses a default TH-D75A header with the standard version bytes. For a specific model or custom header, use to_d75_file.

Panics

Panics if the built-in model string is rejected, which should never happen since the model is a known constant.

pub fn read_region(&self, offset: usize, len: usize) -> Option<&[u8]>

Read a byte range from the image.

Returns None if the range is out of bounds.

pub fn write_region( &mut self, offset: usize, data: &[u8], ) -> Result<(), MemoryError>

Write bytes into the image at the given offset.

Errors

Returns MemoryError::InvalidSize if the write extends past the end of the image.

Trait Implementations

impl Clone for MemoryImage

fn clone(&self) -> MemoryImage

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for MemoryImage

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

Formats the value using the given formatter.