Source code of MARS Assembler
First commit of the 4.5 version (latest version available)
This commit is contained in:
adolphenom
@@ -0,0 +1,345 @@
|
||||
/*
|
||||
Copyright (c) 2009, Ingo Kofler, ITEC, Klagenfurt University, Austria
|
||||
|
||||
Developed by Ingo Kofler (ingo.kofler@itec.uni-klu.ac.at)
|
||||
|
||||
Permission is hereby granted, free of charge, to any person obtaining
|
||||
a copy of this software and associated documentation files (the
|
||||
"Software"), to deal in the Software without restriction, including
|
||||
without limitation the rights to use, copy, modify, merge, publish,
|
||||
distribute, sublicense, and/or sell copies of the Software, and to
|
||||
permit persons to whom the Software is furnished to do so, subject
|
||||
to the following conditions:
|
||||
|
||||
The above copyright notice and this permission notice shall be
|
||||
included in all copies or substantial portions of the Software.
|
||||
|
||||
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
|
||||
EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
|
||||
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
|
||||
IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR
|
||||
ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF
|
||||
CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
|
||||
WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
|
||||
|
||||
(MIT license, http://www.opensource.org/licenses/mit-license.html)
|
||||
*/
|
||||
|
||||
package mars.tools;//.bhtsim;
|
||||
|
||||
import java.awt.BorderLayout;
|
||||
import java.awt.Color;
|
||||
import java.awt.GridBagConstraints;
|
||||
import java.awt.GridBagLayout;
|
||||
import java.awt.Insets;
|
||||
import java.text.DecimalFormat;
|
||||
import java.util.Vector;
|
||||
|
||||
import javax.swing.JComboBox;
|
||||
import javax.swing.JLabel;
|
||||
import javax.swing.JPanel;
|
||||
import javax.swing.JScrollPane;
|
||||
import javax.swing.JTable;
|
||||
import javax.swing.JTextArea;
|
||||
import javax.swing.JTextField;
|
||||
import javax.swing.ListSelectionModel;
|
||||
import javax.swing.SwingConstants;
|
||||
import javax.swing.table.DefaultTableCellRenderer;
|
||||
|
||||
/**
|
||||
* Represents the GUI of the BHT Simulator Tool.
|
||||
* <p>
|
||||
*
|
||||
* The GUI consists of mainly four parts:
|
||||
* <ul>
|
||||
* <li>A configuration panel to select the number of entries and the history size
|
||||
* <li>A information panel that displays the most recent branch instruction including its address and BHT index
|
||||
* <li>A table representing the BHT with all entries and their internal state and statistics
|
||||
* <li>A log panel that summarizes the predictions in a textual form
|
||||
* </ul>
|
||||
*
|
||||
* @author ingo.kofler@itec.uni-klu.ac.at
|
||||
*/
|
||||
//@SuppressWarnings("serial")
|
||||
public class BHTSimGUI extends JPanel {
|
||||
|
||||
/** text field presenting the most recent branch instruction */
|
||||
private JTextField m_tfInstruction;
|
||||
|
||||
/** text field representing the address of the most recent branch instruction */
|
||||
private JTextField m_tfAddress;
|
||||
|
||||
/** text field representing the resulting BHT index of the branch instruction */
|
||||
private JTextField m_tfIndex;
|
||||
|
||||
/** combo box for selecting the number of BHT entries */
|
||||
private JComboBox m_cbBHTentries;
|
||||
|
||||
/** combo box for selecting the history size */
|
||||
private JComboBox m_cbBHThistory;
|
||||
|
||||
/** combo box for selecting the initial value */
|
||||
private JComboBox m_cbBHTinitVal;
|
||||
|
||||
/** the table representing the BHT */
|
||||
private JTable m_tabBHT;
|
||||
|
||||
/** text field for log output */
|
||||
private JTextArea m_taLog;
|
||||
|
||||
/** constant for the color that highlights the current BHT entry */
|
||||
public final static Color COLOR_PREPREDICTION = Color.yellow;
|
||||
|
||||
/** constant for the color to signal a correct prediction */
|
||||
public final static Color COLOR_PREDICTION_CORRECT = Color.green;
|
||||
|
||||
/** constant for the color to signal a misprediction */
|
||||
public final static Color COLOR_PREDICTION_INCORRECT = Color.red;
|
||||
|
||||
/** constant for the String representing "take the branch" */
|
||||
public final static String BHT_TAKE_BRANCH = "TAKE";
|
||||
|
||||
/** constant for the String representing "do not take the branch" */
|
||||
public final static String BHT_DO_NOT_TAKE_BRANCH = "NOT TAKE";
|
||||
|
||||
|
||||
|
||||
/**
|
||||
* Creates the GUI components of the BHT Simulator
|
||||
* The GUI is a subclass of JPanel which is integrated in the GUI of the MARS tool
|
||||
*/
|
||||
public BHTSimGUI() {
|
||||
BorderLayout layout = new BorderLayout();
|
||||
layout.setVgap(10);
|
||||
layout.setHgap(10);
|
||||
setLayout(layout);
|
||||
|
||||
m_tabBHT = createAndInitTable();
|
||||
|
||||
add(buildConfigPanel(), BorderLayout.NORTH);
|
||||
add(buildInfoPanel(), BorderLayout.WEST);
|
||||
add(new JScrollPane(m_tabBHT), BorderLayout.CENTER);
|
||||
add(buildLogPanel(), BorderLayout.SOUTH);
|
||||
}
|
||||
|
||||
/**
|
||||
* Creates and initializes the JTable representing the BHT.
|
||||
*
|
||||
* @return the JTable representing the BHT
|
||||
*/
|
||||
private JTable createAndInitTable() {
|
||||
// create the table
|
||||
JTable theTable = new JTable();
|
||||
|
||||
// create a default renderer for double values (percentage)
|
||||
DefaultTableCellRenderer doubleRenderer = new DefaultTableCellRenderer() {
|
||||
private DecimalFormat formatter = new DecimalFormat("##0.00");
|
||||
|
||||
public void setValue(Object value) {
|
||||
setText((value == null) ? "" : formatter.format(value));
|
||||
}
|
||||
};
|
||||
doubleRenderer.setHorizontalAlignment(SwingConstants.CENTER);
|
||||
|
||||
// create a default renderer for all other values with center alignment
|
||||
DefaultTableCellRenderer defRenderer = new DefaultTableCellRenderer();
|
||||
defRenderer.setHorizontalAlignment(SwingConstants.CENTER);
|
||||
|
||||
theTable.setDefaultRenderer(Double.class, doubleRenderer);
|
||||
theTable.setDefaultRenderer(Integer.class, defRenderer);
|
||||
theTable.setDefaultRenderer(String.class, defRenderer);
|
||||
|
||||
theTable.setSelectionBackground(BHTSimGUI.COLOR_PREPREDICTION);
|
||||
theTable.setSelectionMode(ListSelectionModel.SINGLE_INTERVAL_SELECTION);
|
||||
|
||||
return theTable;
|
||||
|
||||
}
|
||||
|
||||
|
||||
/**
|
||||
* Creates and initializes the panel holding the instruction, address and index text fields.
|
||||
*
|
||||
* @return the info panel
|
||||
*/
|
||||
private JPanel buildInfoPanel() {
|
||||
m_tfInstruction = new JTextField();
|
||||
m_tfAddress = new JTextField();
|
||||
m_tfIndex = new JTextField();
|
||||
|
||||
m_tfInstruction.setColumns(10);
|
||||
m_tfInstruction.setEditable(false);
|
||||
m_tfInstruction.setHorizontalAlignment(JTextField.CENTER);
|
||||
m_tfAddress.setColumns(10);
|
||||
m_tfAddress.setEditable(false);
|
||||
m_tfAddress.setHorizontalAlignment(JTextField.CENTER);
|
||||
m_tfIndex.setColumns(10);
|
||||
m_tfIndex.setEditable(false);
|
||||
m_tfIndex.setHorizontalAlignment(JTextField.CENTER);
|
||||
|
||||
JPanel panel = new JPanel();
|
||||
JPanel outerPanel = new JPanel();
|
||||
outerPanel.setLayout(new BorderLayout());
|
||||
|
||||
GridBagLayout gbl = new GridBagLayout();
|
||||
panel.setLayout(gbl);
|
||||
|
||||
GridBagConstraints c = new GridBagConstraints();
|
||||
|
||||
c.insets = new Insets(5, 5, 2, 5);
|
||||
c.gridx = 1;
|
||||
c.gridy = 1;
|
||||
|
||||
panel.add(new JLabel("Instruction"), c);
|
||||
c.gridy++;
|
||||
panel.add(m_tfInstruction, c);
|
||||
c.gridy++;
|
||||
panel.add(new JLabel("@ Address"), c);
|
||||
c.gridy++;
|
||||
panel.add(m_tfAddress, c);
|
||||
c.gridy++;
|
||||
panel.add(new JLabel("-> Index"), c);
|
||||
c.gridy++;
|
||||
panel.add(m_tfIndex, c);
|
||||
|
||||
outerPanel.add(panel, BorderLayout.NORTH);
|
||||
return outerPanel;
|
||||
}
|
||||
|
||||
|
||||
/**
|
||||
* Creates and initializes the panel for the configuration of the tool
|
||||
* The panel contains two combo boxes for selecting the number of BHT entries and the history size.
|
||||
*
|
||||
* @return a panel for the configuration
|
||||
*/
|
||||
private JPanel buildConfigPanel() {
|
||||
JPanel panel = new JPanel();
|
||||
|
||||
Vector sizes = new Vector();
|
||||
sizes.add(new Integer(8));
|
||||
sizes.add(new Integer(16));
|
||||
sizes.add(new Integer(32));
|
||||
|
||||
Vector bits = new Vector();
|
||||
bits.add(new Integer(1));
|
||||
bits.add(new Integer(2));
|
||||
|
||||
Vector initVals = new Vector();
|
||||
initVals.add(BHTSimGUI.BHT_DO_NOT_TAKE_BRANCH);
|
||||
initVals.add(BHTSimGUI.BHT_TAKE_BRANCH);
|
||||
|
||||
m_cbBHTentries = new JComboBox(sizes);
|
||||
m_cbBHThistory = new JComboBox(bits);
|
||||
m_cbBHTinitVal = new JComboBox(initVals);
|
||||
|
||||
panel.add(new JLabel("# of BHT entries"));
|
||||
panel.add(m_cbBHTentries);
|
||||
panel.add(new JLabel("BHT history size"));
|
||||
panel.add(m_cbBHThistory);
|
||||
panel.add(new JLabel("Initial value"));
|
||||
panel.add(m_cbBHTinitVal);
|
||||
|
||||
return panel;
|
||||
}
|
||||
|
||||
|
||||
/**
|
||||
* Creates and initializes the panel containing the log text area.
|
||||
*
|
||||
* @return the panel for the logging output
|
||||
*/
|
||||
private JPanel buildLogPanel() {
|
||||
JPanel panel = new JPanel();
|
||||
panel.setLayout(new BorderLayout());
|
||||
m_taLog = new JTextArea();
|
||||
m_taLog.setRows(6);
|
||||
m_taLog.setEditable(false);
|
||||
|
||||
panel.add(new JLabel("Log"), BorderLayout.NORTH);
|
||||
panel.add(new JScrollPane(m_taLog), BorderLayout.CENTER);
|
||||
|
||||
return panel;
|
||||
}
|
||||
|
||||
|
||||
/***
|
||||
* Returns the combo box for selecting the number of BHT entries.
|
||||
*
|
||||
* @return the reference to the combo box
|
||||
*/
|
||||
public JComboBox getCbBHTentries() {
|
||||
return m_cbBHTentries;
|
||||
}
|
||||
|
||||
|
||||
/***
|
||||
* Returns the combo box for selecting the size of the BHT history.
|
||||
*
|
||||
* @return the reference to the combo box
|
||||
*/
|
||||
public JComboBox getCbBHThistory() {
|
||||
return m_cbBHThistory;
|
||||
}
|
||||
|
||||
|
||||
/***
|
||||
* Returns the combo box for selecting the initial value of the BHT
|
||||
*
|
||||
* @return the reference to the combo box
|
||||
*/
|
||||
public JComboBox getCbBHTinitVal() {
|
||||
return m_cbBHTinitVal;
|
||||
}
|
||||
|
||||
/***
|
||||
* Returns the table representing the BHT.
|
||||
*
|
||||
* @return the reference to the table
|
||||
*/
|
||||
public JTable getTabBHT() {
|
||||
return m_tabBHT;
|
||||
}
|
||||
|
||||
|
||||
/***
|
||||
* Returns the text area for log purposes.
|
||||
*
|
||||
* @return the reference to the text area
|
||||
*/
|
||||
public JTextArea getTaLog() {
|
||||
return m_taLog;
|
||||
}
|
||||
|
||||
|
||||
/***
|
||||
* Returns the text field for displaying the most recent branch instruction
|
||||
*
|
||||
* @return the reference to the text field
|
||||
*/
|
||||
public JTextField getTfInstruction() {
|
||||
return m_tfInstruction;
|
||||
}
|
||||
|
||||
|
||||
/***
|
||||
* Returns the text field for displaying the address of the most recent branch instruction
|
||||
*
|
||||
* @return the reference to the text field
|
||||
*/
|
||||
public JTextField getTfAddress() {
|
||||
return m_tfAddress;
|
||||
}
|
||||
|
||||
|
||||
/***
|
||||
* Returns the text field for displaying the corresponding index into the BHT
|
||||
*
|
||||
* @return the reference to the text field
|
||||
*/
|
||||
public JTextField getTfIndex() {
|
||||
return m_tfIndex;
|
||||
}
|
||||
|
||||
|
||||
}
|
||||
Reference in New Issue
Block a user