mdf4-rs 0.6.0

//! CAN bus integration for MDF4 files.
//!
//! This module provides utilities for logging and reading CAN bus data with MDF4 files.
//! It supports multiple modes:
//!
//! 1. **With DBC**: Use [`CanDbcLogger`] for full signal decoding with metadata
//! 2. **Without DBC**: Use [`RawCanLogger`] for raw frame capture
//! 3. **Post-processing**: Use [`DbcOverlayReader`] to decode raw captures with DBC
//!
//! # Features
//!
//! - Uses `Dbc::decode()` for full DBC support (multiplexing, value descriptions, etc.)
//! - Raw frame logging when no DBC is available
//! - Read-time DBC overlay for post-processing raw captures
//! - Batch processing for efficient logging
//! - Support for both Standard (11-bit) and Extended (29-bit) CAN IDs
//! - Full metadata preservation (units, conversions, limits)
//! - Raw value storage with conversion blocks for maximum precision
//! - **CAN FD support**: Up to 64 bytes per frame with BRS/ESI flags
//!
//! # Example with DBC
//!
//! ```ignore
//! use mdf4_rs::can::CanDbcLogger;
//!
//! // Parse DBC file
//! let dbc = dbc_rs::Dbc::parse(dbc_content)?;
//!
//! // Create logger with full metadata
//! let mut logger = CanDbcLogger::builder(&dbc)
//!     .store_raw_values(true)
//!     .build()?;
//!
//! // Log CAN frames
//! logger.log(0x100, timestamp_us, &frame_data);
//!
//! // Get MDF bytes
//! let mdf_bytes = logger.finalize()?;
//! ```
//!
//! # Example without DBC (Raw Logging)
//!
//! ```ignore
//! use mdf4_rs::can::RawCanLogger;
//!
//! // Create raw logger (no DBC needed)
//! let mut logger = RawCanLogger::new()?;
//!
//! // Log raw CAN frames
//! logger.log(0x100, timestamp_us, &frame_data);
//!
//! // Get MDF bytes
//! let mdf_bytes = logger.finalize()?;
//! ```

// CanDbcLogger uses FastDbc which requires std + dbc
#[cfg(all(feature = "std", feature = "dbc"))]
mod dbc_compat;
#[cfg(all(feature = "std", feature = "dbc"))]
mod dbc_logger;
#[cfg(all(feature = "std", feature = "dbc"))]
mod dbc_overlay;
pub mod fd;
mod raw_logger;
mod timestamped_frame;

#[cfg(all(feature = "std", feature = "dbc"))]
pub use dbc_logger::{CanDbcLogger, CanDbcLoggerBuilder, CanDbcLoggerConfig};
#[cfg(all(feature = "std", feature = "dbc"))]
pub use dbc_overlay::{DbcOverlayReader, DecodedFrame, OverlayStatistics, SignalValue};
// FD constants and flags are always available
pub use fd::{FdFlags, MAX_FD_DATA_LEN, dlc_to_len, len_to_dlc};
// FD frame trait and implementation require embedded_can
#[cfg(feature = "can")]
pub use fd::{FdFrame, SimpleFdFrame};
pub use raw_logger::RawCanLogger;
pub use timestamped_frame::TimestampedFrame;

// Re-export commonly used dbc-rs types (requires dbc feature)
#[cfg(feature = "dbc")]
pub use dbc_rs::{ByteOrder, Dbc, DecodedSignal, Message, Signal};