use chrono::prelude::*; use itertools::Itertools; use std::{fs::File}; use std::collections::{BTreeMap, HashMap}; use ::function_name::named; use super::*; mod combinator_atoms; use combinator_atoms::*; mod types; use types::*; mod metadata; use metadata::*; #[named] fn parse_var<'a>( word_reader : &mut WordReader, parent_scope_idx : Scope_Idx, vcd : &'a mut VCD, signal_map : &mut HashMap ) -> Result<(), String> { let err = format!("reached end of file without parser leaving {}", function_name!()); let (word, cursor) = word_reader.next_word().ok_or(&err)?; let expected_types = "[integer, parameter, real, reg, string, wire]"; // $var parameter 3 a IDLE $end // ^^^^^^^^^ - var_type let var_type = match word { "integer" => {Ok(Sig_Type::Integer)} "parameter" => {Ok(Sig_Type::Parameter)} "real" => {Ok(Sig_Type::Real)} "reg" => {Ok(Sig_Type::Reg)} "string" => {Ok(Sig_Type::Str)} "wire" => {Ok(Sig_Type::Wire)} _ => { let err = format!("found keyword `{word}` but expected one of {expected_types} on {cursor:?}"); Err(err) } }?; let (word, cursor) = word_reader.next_word().ok_or(&err)?; let parse_err = format!("failed to parse as usize on {cursor:?}"); // $var parameter 3 a IDLE $end // ^ - no_bits let no_bits = match var_type { Sig_Type::Integer | Sig_Type::Parameter | Sig_Type::Real | Sig_Type::Reg | Sig_Type::Wire => { let no_bits = word.parse::().expect(parse_err.as_str()); Some(no_bits) } // for strings, we don't really care what the number of bits is _ => {None} }; // $var parameter 3 a IDLE $end // ^ - signal_alias let (word, cursor) = word_reader.next_word().ok_or(&err)?; let signal_alias = word.to_string(); // $var parameter 3 a IDLE $end // ^^^^ - full_signal_name(can extend until $end) let mut full_signal_name = Vec::::new(); loop { let (word, cursor) = word_reader.next_word().ok_or(&err)?; match word { "$end" => {break} _ => {full_signal_name.push(word.to_string())} } } let full_signal_name = full_signal_name.join(" "); // Is the current variable an alias to a signal already encountered? // if so, handle ref_signal_idx accordingly, if not, add signal to hash // map let (signal, signal_idx) = match signal_map.get(&signal_alias) { Some(ref_signal_idx) => { let signal_idx = Signal_Idx(vcd.all_signals.len()); let signal = Signal::Alias{ name: full_signal_name, signal_alias: *ref_signal_idx}; (signal, signal_idx) } None => { let signal_idx = Signal_Idx(vcd.all_signals.len()); signal_map.insert(signal_alias.to_string(), signal_idx); let signal = Signal::Data{ name: full_signal_name, sig_type: var_type, num_bits: no_bits, self_idx: signal_idx, timeline: BTreeMap::new(), scope_parent: parent_scope_idx }; (signal, signal_idx) } }; vcd.all_signals.push(signal); let Scope_Idx(parent_scope_idx_usize) = parent_scope_idx; let parent_scope = vcd.all_scopes.get_mut(parent_scope_idx_usize).unwrap(); parent_scope.child_signals.push(signal_idx); Ok(()) } #[named] fn parse_signal_tree<'a>( word_reader : &mut WordReader, parent_scope_idx : Option, vcd : &'a mut VCD, signal_map : &mut HashMap ) -> Result<(), String> { // $scope module reg_mag_i $end // ^^^^^^ - module keyword let err = format!("reached end of file without parser leaving {}", function_name!()); ident(word_reader, "module")?; // $scope module reg_mag_i $end // ^^^^^^^^^ - scope name let (scope_name, _) = word_reader.next_word().ok_or(err)?; let curr_scope_idx = Scope_Idx(vcd.all_scopes.len()); // register this scope as a child of the current parent scope // if there is a parent scope match parent_scope_idx { Some(Scope_Idx(parent_scope_idx)) => { let parent_scope = vcd.all_scopes.get_mut(parent_scope_idx).unwrap(); parent_scope.child_scopes.push(curr_scope_idx); } None => {} } // add this scope to list of existing scopes vcd.all_scopes.push( Scope { name: scope_name.to_string(), parent_idx: parent_scope_idx, self_idx: curr_scope_idx, child_signals: vec![], child_scopes: vec![] } ); // $scope module reg_mag_i $end // ^^^^ - end keyword ident(word_reader, "$end")?; let err = format!("reached end of file without parser leaving {}", function_name!()); loop { let (word, cursor) = word_reader.next_word().ok_or(&err)?; let ParseResult{matched, residual} = tag(word, "$"); match matched { // we hope that this word stars with a `$` "$" => { match residual { "scope" => { // recursive - parse inside of current scope tree parse_signal_tree(word_reader, Some(curr_scope_idx), vcd, signal_map); } "var" => { parse_var(word_reader, curr_scope_idx, vcd, signal_map)?; } "upscope" => { ident(word_reader, "$end")?; break } _ => { let err = format!("found keyword `{residual}` but expected `$scope`, `$var`, or `$upscope` on {cursor:?}"); return Err(err) } } } _ => { let err = format!("found keyword `{matched}` but expected `$` on {cursor:?}"); return Err(err) } } } // TODO : remove the following Ok(()) once we add loop above Ok(()) } // TODO : make this a generic traversal function that applies specified // functions upon encountering scopes and signals fn print_signal_tree( root_scope_idx : Scope_Idx, all_scopes : &Vec, all_signals : &Vec, depth : usize) { let indent = " ".repeat(depth * 4); let Scope_Idx(root_scope_idx) = root_scope_idx; let root_scope = &all_scopes[root_scope_idx]; let root_scope_name = &root_scope.name; println!("{indent}scope: {root_scope_name}"); for Signal_Idx(ref signal_idx) in &root_scope.child_signals { let child_signal = &all_signals[*signal_idx]; let name = match child_signal { Signal::Data{name, ..} => {name} Signal::Alias{name, ..} => {name} }; println!("{indent} - sig: {name}") } println!(); for scope_idx in &root_scope.child_scopes { // let Scope_Idx(ref scope_idx_usize) = scope_idx; // let child_scope = &all_scopes[*scope_idx_usize]; print_signal_tree(*scope_idx, all_scopes, all_signals, depth+1); } // let root = vcd.all_scopes; } pub fn parse_vcd(file : File) -> Result<(), String> { let mut word_gen = WordReader::new(file); let header = parse_metadata(&mut word_gen)?; dbg!(&header); // let (word, cursor) = word_gen.next_word().unwrap(); // cursor.error(word).unwrap(); let mut signal_map = std::collections::HashMap::new(); let mut vcd = VCD{ metadata : header, all_signals: vec![], all_scopes : vec![], scope_roots: vec![], }; parse_signal_tree(&mut word_gen, None, &mut vcd, &mut signal_map)?; println!("printing signal tree"); print_signal_tree(Scope_Idx(0), &vcd.all_scopes, &vcd.all_signals, 0); Ok(()) } #[cfg(test)] mod tests { use super::*; use crate::test; use std::fs::File; #[test] fn headers() { // TODO: eventually, once all dates pass, merge the following // two loops // testing dates for file in test::good_date_files { let metadata = parse_metadata( &mut WordReader::new( File::open(file) .unwrap() ) ); assert!(metadata.is_ok()); assert!(metadata.unwrap().date.is_some()); } for file in test::files { let metadata = parse_metadata( &mut WordReader::new( File::open(file) .unwrap() ) ); assert!(metadata.is_ok()); let (scalar, timescale) = metadata.unwrap().timescale; assert!(scalar.is_some()); } } }