Initial commit of OpenSPARC T2 architecture model.

[OpenSPARC-T2-SAM] / legion / docs / readmes / README.exit_time_string

#
# Copyright 2005 Sun Microsystems, Inc.  All rights reserved.
# Use is subject to license terms.
#
# ident "@(#)README.exit_time_string    1.2     06/07/26 SMI"
#
#       Using the 'exit_string' and 'time_string' features 
#       to time the simulation to, and optionally exit upon 
#       a user defined string occurring on the console
#

To enable these features, edit the legion config file.
   
Modify the legion config file and add either an 'exit_string' or 'time_string'
definition to the dumbserial directive.

'exit_string' - display time from sim start to when the string first occurs 
               on the console AND exit the sim

'time_string' - display time from sim start to when the string appears on the
               console.  Simulation will continue and console will continue
               to look for this string on the console until the simulation
               exits.

NOTES:

o Only a single exit_string OR time_string definition is allowed.

o If time_string is specified, time will be reported on every occurrence
of the string.

o An Ascii number (0 - 127) can be specified as a time_string. This
 allows for the time stamp to be printed for each newline (ascii 13);

EXAMPLES: 

Edit your legion conf file to include the following as part of your
dumbserial directive:

To time the simulation and exit upon 'login:'
       // console
       device "dumbserial" PUART0 +0x50 {              
               ...
               exit_string "login:";
       }
       
To time the simulation to 'login:' (simulation will continue):
       // console
       device "dumbserial" PUART0 +0x50 {              
               ...
               time_string "login:";
       }

Print time /instruction counts on every newline character on the console:
       // console
       device "dumbserial" PUART0 +0x50 {              
               ...
               time_string 13;
       }