mdf4-rs 0.6.0

mdf4-rs is a Rust library for working with Measurement Data Format (ASAM MDF4) files.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94

// src/blocks/mod.rs

// ============================================================================
// Block Size Constants (internal use only)
// ============================================================================
// Fixed sizes for MDF 4.x block structures. Variable-length blocks (TX, MD, DT,
// SD, DL) don't have fixed sizes and are determined by their header.length.

/// Identification block size (64 bytes) - file format identifier at offset 0.
pub(crate) const ID_BLOCK_SIZE: usize = 64;

/// Header block size (104 bytes) - file-level metadata after identification.
pub(crate) const HD_BLOCK_SIZE: usize = 104;

/// Data group block size (64 bytes) - groups channel groups sharing data.
pub(crate) const DG_BLOCK_SIZE: usize = 64;

/// Channel group block size (104 bytes) - groups channels with common time base.
pub(crate) const CG_BLOCK_SIZE: usize = 104;

/// Channel block size (160 bytes) - defines a single measurement channel.
pub(crate) const CN_BLOCK_SIZE: usize = 160;

/// Source block size (56 bytes) - describes data acquisition source.
pub(crate) const SI_BLOCK_SIZE: usize = 56;

/// File history block size (56 bytes) - records modification history.
pub(crate) const FH_BLOCK_SIZE: usize = 56;

/// Event block minimum size (96 bytes) - timestamped markers.
/// Actual size varies based on scope_count and attachment_count.
/// Base: 24 (header) + 40 (5 fixed links) + 32 (data) = 96 bytes.
pub(crate) const EV_BLOCK_SIZE: usize = 96;

/// Attachment block minimum size (96 bytes) - embedded/external files.
/// Actual size varies based on embedded data size.
/// Base: 24 (header) + 32 (4 links) + 40 (fixed data) = 96 bytes.
pub(crate) const AT_BLOCK_SIZE: usize = 96;

// ============================================================================
// Submodules
// ============================================================================

mod attachment_block;
mod channel_block;
mod channel_group_block;
mod common;
mod conversion;
mod data_block;
mod data_group_block;
mod data_list_block;
#[cfg(feature = "compression")]
mod dz_block;
mod event_block;
mod file_history_block;
mod header_block;
pub(crate) mod hl_block;
mod identification_block;
mod metadata_block;
mod signal_data_block;
mod source_block;
mod text_block;

// Re-export common types
pub use common::{BlockHeader, BlockParse, DataType};
// Internal-only exports (std only - used by MdfFile parsing)
#[cfg(feature = "std")]
pub(crate) use common::read_string_block;
#[cfg(feature = "std")]
pub(crate) use common::{u64_to_usize, validate_buffer_size};

// Re-export block types
pub use attachment_block::{AT_HEADER_SIZE, AttachmentBlock, AttachmentFlags};
pub use channel_block::ChannelBlock;
pub use channel_group_block::ChannelGroupBlock;
pub use data_block::DataBlock;
pub use data_group_block::DataGroupBlock;
pub use data_list_block::DataListBlock;
#[cfg(feature = "compression")]
pub use dz_block::{DZ_HEADER_SIZE, DzBlock, DzCompressionType};
pub use event_block::{EventBlock, EventCause, EventRangeType, EventSyncType, EventType};
pub use file_history_block::FileHistoryBlock;
pub use header_block::HeaderBlock;
pub use hl_block::HlBlock;
pub use identification_block::IdentificationBlock;
pub use metadata_block::MetadataBlock;
pub use signal_data_block::SignalDataBlock;
#[cfg(feature = "std")]
pub(crate) use source_block::read_source_block;
pub use source_block::{BusType, SourceBlock, SourceType};
pub use text_block::TextBlock;

// Re-export conversion types
pub use conversion::{ConversionBlock, ConversionType};