Subversion Repositories s1_core

S1 Core - Tracan (Trace Analyzer)
=================================

This small tool has been written to convert the waveforms of the
original OpenSPARC T1 simulation environment into a format similar
to the one used in the "sim.log" file generated by the S1 simulations.

To have it working you have to:
- have a working OpenSPARC T1 simulation environment;
- modify the top-level testbench cmpt_top.v to add the
  following lines:

    initial begin
      $dumpfile("trace.vcd");
      $dumpvars(2);
    end

- run the T1 simulations you want (give to the sims script
  the argument to not delete the results);
- open the resulting trace.vcd file with a text editor and
  look for lines similar to these ones:

    $var wire 124 " spc_pcx_data_pa [123:0] $end
    $var wire 145 $ cpx_spc_data_cx2 [144:0] $end

- if the chars after the numbers are different from the double
  quote and the dollar sign shown above, then you have to change
  the string used by the egrep command into the 'tracan' script;
  for instance if the two chars are 'A' and 'B' the line will
  become:

    egrep ' A$| B$' $1 | egrep -v x | ./tracan.bin

- then you can finally run the program: if the binary file
  tracan.bin does not exists it will be compiled with GCC;
- if everything goes right you will be able to use the command:

    tracan.sh PATH_TO_YOUR_TRACE_VCD_FILE

  and you will get the logfile on the console; a typical usage
  would be:

    tracan.sh trace.vcd > sim.log

- if you want to improve the script to automatically extract the
  ASCII symbol used in the VCD file for outgoing and incoming
  packets, please modify the tool and we'll be happy to mention
  your name into this file!
- Enjoy!