emulib.runtime

Class HEXFileManager

java.lang.Object

emulib.runtime.HEXFileManager

public class HEXFileManager
extends Object

This class generates and loads 16 bit Intel hex files.

Constructor Summary

Constructors

Constructor and Description
HEXFileManager()

Method Summary

Modifier and Type	Method and Description
void	addTable(Map<Integer,String> ha) Keys of the HashMap have to represent adresses and values have to represent compiled code.
void	generateFile(String filename) Generates a Intel Hex file based on the cached program map.
int	getProgramStart() Get the program starting address (the first address that has occured in the program HashMap).
Map<Integer,String>	getTable() Get the Map representing the program hex code.
static int	loadIntoMemory(File file, MemoryContext<Short> memory)
boolean	loadIntoMemory(MemoryContext<Short> mem) Method is similar to generateHex() method in that way, that compiled program is also transformed into chunk of bytes, but not to hex file but to the operating memory.
static HEXFileManager	parseFromFile(File file)
int	putCode(String code) Put a series of bytes to the code table.
void	setNextAddress(int address) Set the next address where the next value will be assigned.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

HEXFileManager

public HEXFileManager()

Method Detail

putCode

public int putCode(String code)

Put a series of bytes to the code table. The bytes must be given as a hexadecimal string of any length. Each byte must have a form of two characters. For example: 0A0B10 represents 3 bytes: 0x0A, 0x0B and 0x10. The code table is modified so that all addresses starting from the current one up to the code length will contain corresponding byte. The current address is then increased by the code length. If a byte exists on an address already, it is overwritten.

Parameters:

code - Hexadecimal representation of binary code

Returns:

updated current address

setNextAddress

public void setNextAddress(int address)

Set the next address where the next value will be assigned.

Parameters:

address - next address

addTable

public void addTable(Map<Integer,String> ha)

Keys of the HashMap have to represent adresses and values have to represent compiled code. Method copies all elements from param HashMap to internal data member.

Parameters:

ha - sub-table with addresses and codes

getTable

public Map<Integer,String> getTable()

Get the Map representing the program hex code.

Returns:

Map representing the program hex code

loadIntoMemory

public boolean loadIntoMemory(MemoryContext<Short> mem)

Method is similar to generateHex() method in that way, that compiled program is also transformed into chunk of bytes, but not to hex file but to the operating memory.

Parameters:

mem - context of operating memory

Returns:

true if the hex file was successfully loaded, false otherwise

generateFile

public void generateFile(String filename)
                  throws IOException

Generates a Intel Hex file based on the cached program map.

Parameters:

filename - file name where to store the hex file

Throws:

IOException - if the HEX file could not be written

getProgramStart

public int getProgramStart()

Get the program starting address (the first address that has occured in the program HashMap).

Returns:

program starting memory location

parseFromFile

public static HEXFileManager parseFromFile(File file)
                                    throws Exception

Throws:

Exception

loadIntoMemory

public static int loadIntoMemory(File file,
                                 MemoryContext<Short> memory)
                          throws Exception

Throws:

Exception