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;
	}