use chrono::{DateTime, Local, Timelike, Utc}; use regex::Captures; use std::collections::VecDeque; #[derive(Clone, Debug)] pub struct LtcFrame { pub status: String, pub hours: u32, pub minutes: u32, pub seconds: u32, pub frames: u32, pub frame_rate: f64, pub timestamp: DateTime, // arrival stamp } impl LtcFrame { pub fn from_regex(caps: &Captures, timestamp: DateTime) -> Option { Some(Self { status: caps[1].to_string(), hours: caps[2].parse().ok()?, minutes: caps[3].parse().ok()?, seconds: caps[4].parse().ok()?, frames: caps[5].parse().ok()?, frame_rate: caps[6].parse().ok()?, timestamp, }) } /// Compare just HH:MM:SS against local time. pub fn matches_system_time(&self) -> bool { let local = Local::now(); local.hour() == self.hours && local.minute() == self.minutes && local.second() == self.seconds } } pub struct LtcState { pub latest: Option, pub lock_count: u32, pub free_count: u32, /// Stores the last up-to-20 raw offset measurements in ms. pub offset_history: VecDeque, /// Stores the last up-to-20 timecode Δ measurements in ms. pub clock_delta_history: VecDeque, pub last_match_status: String, pub last_match_check: i64, } impl LtcState { pub fn new() -> Self { Self { latest: None, lock_count: 0, free_count: 0, offset_history: VecDeque::with_capacity(20), clock_delta_history: VecDeque::with_capacity(20), last_match_status: "UNKNOWN".into(), last_match_check: 0, } } /// Record one measured jitter offset in ms. pub fn record_offset(&mut self, offset_ms: i64) { if self.offset_history.len() == 20 { self.offset_history.pop_front(); } self.offset_history.push_back(offset_ms); } /// Record one timecode Δ in ms. pub fn record_clock_delta(&mut self, delta_ms: i64) { if self.clock_delta_history.len() == 20 { self.clock_delta_history.pop_front(); } self.clock_delta_history.push_back(delta_ms); } /// Clear all stored jitter measurements. pub fn clear_offsets(&mut self) { self.offset_history.clear(); } /// Clear all stored timecode Δ measurements. pub fn clear_clock_deltas(&mut self) { self.clock_delta_history.clear(); } /// Update LOCK/FREE counts and timecode-match status every 5 s. pub fn update(&mut self, frame: LtcFrame) { match frame.status.as_str() { "LOCK" => { self.lock_count += 1; } "FREE" => { self.free_count += 1; self.clear_offsets(); self.clear_clock_deltas(); self.last_match_status = "UNKNOWN".into(); } _ => {} } // Recompute timecode-match every 5 seconds let now_secs = Utc::now().timestamp(); if now_secs - self.last_match_check >= 5 { self.last_match_status = if let Some(frame) = &self.latest { if frame.matches_system_time() { "IN SYNC" } else { "OUT OF SYNC" } } else { "UNKNOWN" } .into(); self.last_match_check = now_secs; } self.latest = Some(frame); } /// Average jitter over stored history, in ms. pub fn average_jitter(&self) -> i64 { if self.offset_history.is_empty() { 0 } else { let sum: i64 = self.offset_history.iter().sum(); sum / self.offset_history.len() as i64 } } /// Convert average jitter into frames (rounded). pub fn average_frames(&self) -> i64 { if let Some(frame) = &self.latest { let ms_per_frame = 1000.0 / frame.frame_rate; (self.average_jitter() as f64 / ms_per_frame).round() as i64 } else { 0 } } /// Average timecode Δ over stored history, in ms. pub fn average_clock_delta(&self) -> i64 { if self.clock_delta_history.is_empty() { 0 } else { let sum: i64 = self.clock_delta_history.iter().sum(); sum / self.clock_delta_history.len() as i64 } } /// Percentage of samples seen in LOCK state versus total. pub fn lock_ratio(&self) -> f64 { let total = self.lock_count + self.free_count; if total == 0 { 0.0 } else { self.lock_count as f64 / total as f64 * 100.0 } } /// Get timecode-match status. pub fn timecode_match(&self) -> &str { &self.last_match_status } }