com.ti.debug.engine.scripting

Class Port

java.lang.Object

com.ti.debug.engine.scripting.Port

public class Port
extends java.lang.Object

This class serves as a encapsulates the Port Connect methods (used with supported simulators to allow reading and writing of a file through a memory address). An instance of this class is automatically created when a new session is opened.

// Create Environment and open a debug session
ScriptingEnvironment env = new ScriptingEnvironment();
DebugServer myServer = (DebugSer ver) env.getServer("DebugServer.1");
DebugSession mySession = myServer.openSession("*", "*");

...

// Connect a file to a memory address
mySession.port.connect(0x38000000, Page.Data, 4, Port.READ, "./input_data.txt")


Field Summary

Fields

Modifier and Type	Field and Description
static int	EXTERN External
static int	NOREWIND No Rewind
static int	READ Read Access
static int	UPDATE Update
static int	WRITE Write Access

Method Summary

Modifier and Type	Method and Description
void	connect(long nAddress, int nPage, int nLength, int nAccessType, java.lang.String sFile) Connect a data file to a memory (port) address (Simulator only) allowing you to read or write data to that file through the memory address.
void	disconnect(long nAddress, int nPage, int nLength, int nAccessType) Disconnect a data file from a memory (port) address (Simulator only).
java.lang.String	list() List all memory addresses that have been previously connected a data files using portConnect (Simulator only).

Methods inherited from class java.lang.Object

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

Field Detail

EXTERN

public static final int EXTERN

External

See Also:

Constant Field Values

NOREWIND

public static final int NOREWIND

No Rewind

See Also:

Constant Field Values

READ

public static final int READ

Read Access

See Also:

Constant Field Values

UPDATE

public static final int UPDATE

Update

See Also:

Constant Field Values

WRITE

public static final int WRITE

Write Access

See Also:

Constant Field Values

Method Detail

connect

public void connect(long nAddress,
                    int nPage,
                    int nLength,
                    int nAccessType,
                    java.lang.String sFile)
             throws ScriptingException

Connect a data file to a memory (port) address (Simulator only) allowing you to read or write data to that file through the memory address.

Parameters:

nAddress - specifies the starting address of the range in memory.

nPage - the memory page. Use one of Memory.Page enumeration.

nLength - defines the length of the range.

nAccessType -

sFile - the data file to which the memory range (port) is connected. Relative paths are permitted, use ScripingEnvironment.setCurrentDirectory(String) to change the current working directory.

Throws:

ScriptingException

disconnect

public void disconnect(long nAddress,
                       int nPage,
                       int nLength,
                       int nAccessType)
                throws ScriptingException

Disconnect a data file from a memory (port) address (Simulator only).

Parameters:

nAddress - specifies the starting address of the range in memory.

nPage - the memory page. Use one of Memory.Page enumeration.

nLength - defines the length of the range.

nAccessType -

Throws:

ScriptingException

list

public java.lang.String list()
                      throws ScriptingException

List all memory addresses that have been previously connected a data files using portConnect (Simulator only).

Throws:

ScriptingException