Initial commit of OpenSPARC T2 architecture model.

[OpenSPARC-T2-SAM] / sam-t2 / sam / cpus / vonk / ss / api / samfe / src / Repository.py

# ========== Copyright Header Begin ==========================================
# 
# OpenSPARC T2 Processor File: Repository.py
# Copyright (c) 2006 Sun Microsystems, Inc.  All Rights Reserved.
# DO NOT ALTER OR REMOVE COPYRIGHT NOTICES.
# 
# The above named program is free software; you can redistribute it and/or
# modify it under the terms of the GNU General Public
# License version 2 as published by the Free Software Foundation.
# 
# The above named program is distributed in the hope that it will be 
# useful, but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
# General Public License for more details.
# 
# You should have received a copy of the GNU General Public
# License along with this work; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA.
# 
# ========== Copyright Header End ============================================
"""repository for focus object, breakpoints, watchpoints, etc.
"""

# message header
msghead     = __name__
msghead_dbx = "DBX-" + msghead


# a global id counter to generate unique ids for watchpoints, breakpoints,
# etc. Use Repository.nextid() to receive the next available id.
__objectid = 0

def nextid():
    """function used to generate a unique id for watchpoints, breakpoints, etc.
    """
    global __objectid
    __objectid += 1
    return str(__objectid)


class Repository:
    """class that serves as repository for shared data
    """

    def __init__ (self):
	"""
	globals - top level globals(), so that we can eval() expression in
                  other places as they are at top level.
	"""
	self.console = None
	self.topName = None
	self.globals = None
	self.riesling = None
	self.fldTable = None
	self.modTable = None
	self.cmdTable = None
	self.symTable = None
	self.memLoad = None

	#self.cycle = 0L
	# the current focus module, in original string
	self.focusSrc = None
	# the corresponding riesling backend module
	self.focus = None
	self.groups = { }
	self.breakpoints = { }
	self.watchpoints = { }
	self.cmdAlias = { }
	# 1 means in rioesling interpreter mode, otherwise in normal python
	# mode
	self.imode = 0
	# 1 means output message will be printed
	self.echo = 1

	# arch config
	self.ncpus = 0
	self.ncores = 0
	self.nucores = 0
	self.nstrands = 0
	# pointer (as uint64_t) to backend system object
	self.sysAddr = 0L
	self.optdir = None
	# fp values
	self.nSpregs = 0
	self.nDpregs = 0
	self.nQpregs = 0
	# array to cpu/core/strand objects
	self.cpus = None
	self.cores = None
	self.ucores = None
	self.strands = None
	self.riesLib = None
	self.socketAPI = None
	self.prompt = 'NA'
	# used in sam mode to indicate whether blaze is running or not,
	# blaze must be in 'stop" mode when conduct breakpoint operaiton.
	# this variable remains as 0 when not in sam mode.
	self.running = 0
	# keep track of blaze numcpu and corresponding pmask
	self.blazeNumcpu = 1
	self.pmask = 0x1L
        # indicate the type of cpu architecture, e.g., n2, etc
        self.arch = None


    def addBreakpoint (self, breakpoint):
	"""
	"""
	if self.breakpoints.has_key(breakpoint.id):
	    raise KeyError, "duplicated breakpoint id %d" % breakpoint.id

	self.breakpoints[breakpoint.id] = breakpoint


    def deleteBreakpoint (self, id):
	"""
	"""
	idstr = str(id)
	if self.breakpoints.has_key(idstr):
	    del self.breakpoints[idstr]
	else:
	    raise KeyError, "does not have breakpoint with id=%s" % idstr


    def showBreakpoint (self, focus=None):
	"""
	"""
	ids = self.breakpoints.keys()
	ids.sort()
	result = [ ]
	for id in ids:
	    bpoint = self.breakpoints[id]
	    if (focus == None) or (focus == bpoint.modSrc):
		result.append("id=%s, mod=%s, cmd='%s', action=%s" % (bpoint.id, bpoint.modSrc, bpoint.src, bpoint.action))

	return '\n'.join(result)


    def addWatchpoint (self, watchpoint):
	"""
	"""
	if self.watchpoints.has_key(watchpoint.id):
	    raise KeyError, "duplicated watchpoint id %d" % watchpoint.id

	self.watchpoints[watchpoint.id] = watchpoint


    def showWatchpoint (self):
	"""
	"""
	ids = self.watchpoints.keys()
	ids.sort()
	result = [ ]
	for id in ids:
	    wpoint = self.watchpoints[id]
	    result.append("id=%s, disable=%d, cmd='%s', watch='%s', action=%s" % (wpoint.id, wpoint.disable, wpoint.src, wpoint.watch, wpoint.action))
	    result.append("DBX: id=%s, watchExpr=%s" % (wpoint.id, wpoint.watchExpr))   #dbx
	return '\n'.join(result)


"""self-testing
"""
if __name__ == "__main__":
    pass