adolphenom
92 lines
3.9 KiB
Java
92 lines
3.9 KiB
Java
package mars.mips.dump;
|
|
|
|
import mars.util.Binary;
|
|
import mars.Globals;
|
|
import mars.mips.hardware.*;
|
|
import java.io.*;
|
|
/*
|
|
Copyright (c) 2003-2011, Pete Sanderson and Kenneth Vollmar
|
|
|
|
Developed by Pete Sanderson (psanderson@otterbein.edu)
|
|
and Kenneth Vollmar (kenvollmar@missouristate.edu)
|
|
|
|
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)
|
|
*/
|
|
|
|
/**
|
|
* Class that represents the "ASCII text" memory dump format. Memory contents
|
|
* are interpreted as ASCII codes. The output
|
|
* is a text file with one word of MIPS memory per line. The word is formatted
|
|
* to leave three spaces for each character. Non-printing characters
|
|
* rendered as period (.) as placeholder. Common escaped characters
|
|
* rendered using backslash and single-character descriptor, e.g. \t for tab.
|
|
* @author Pete Sanderson
|
|
* @version December 2010
|
|
*/
|
|
|
|
|
|
public class AsciiTextDumpFormat extends AbstractDumpFormat {
|
|
|
|
/**
|
|
* Constructor. There is no standard file extension for this format.
|
|
*/
|
|
public AsciiTextDumpFormat() {
|
|
super("ASCII Text", "AsciiText", "Memory contents interpreted as ASCII characters", null);
|
|
}
|
|
|
|
|
|
/**
|
|
* Interpret MIPS memory contents as ASCII characters. Each line of
|
|
* text contains one memory word written in ASCII characters. Those
|
|
* corresponding to tab, newline, null, etc are rendered as backslash
|
|
* followed by single-character code, e.g. \t for tab, \0 for null.
|
|
* Non-printing character (control code,
|
|
* values above 127) is rendered as a period (.). Written
|
|
* using PrintStream's println() method.
|
|
* Adapted by Pete Sanderson from code written by Greg Gibeling.
|
|
*
|
|
* @param file File in which to store MIPS memory contents.
|
|
* @param firstAddress first (lowest) memory address to dump. In bytes but
|
|
* must be on word boundary.
|
|
* @param lastAddress last (highest) memory address to dump. In bytes but
|
|
* must be on word boundary. Will dump the word that starts at this address.
|
|
* @throws AddressErrorException if firstAddress is invalid or not on a word boundary.
|
|
* @throws IOException if error occurs during file output.
|
|
*/
|
|
public void dumpMemoryRange(File file, int firstAddress, int lastAddress)
|
|
throws AddressErrorException, IOException {
|
|
PrintStream out = new PrintStream(new FileOutputStream(file));
|
|
String string = null;
|
|
try {
|
|
for (int address = firstAddress; address <= lastAddress; address += Memory.WORD_LENGTH_BYTES) {
|
|
Integer temp = Globals.memory.getRawWordOrNull(address);
|
|
if (temp == null)
|
|
break;
|
|
out.println(Binary.intToAscii(temp.intValue()));
|
|
}
|
|
}
|
|
finally {
|
|
out.close();
|
|
}
|
|
}
|
|
|
|
} |