7.9.8.51. GEL_PortConnect()¶
For simulator only, connects a data file to a memory (port) address.
Syntax
GEL_PortConnect(portAddress, page, length, accessType, “fileName” );
Parameters
portAddressstarting address of a range in memory. This Parameters can be an absolute address, any C expression, the name of a C function, or an assembly language label. If you want to specify a hex address, be sure to prefix the address number with 0x; otherwise, Code Composer Studio treats the number as a decimal address.
pageidentifies the type of memory: 0 (Program memory), 1 (Data memory) or 2 (I/O space)
For processors that do not have more than one type of memory, use 0 for this Parameters.
lengthdefines the length of the range. This Parameters can be any C expression.
accessTypespecifies the type of access allowed. The access type can be any combination of the following values:
Access Type #define GTI_ATTR_PORT_READ #define GTI_ATTR_PORT_WRITE #define GTI_ATTR_PORT_NOREWIND #define GTI_ATTR_PORT_UPDATE #define GTI_ATTR_PORT_EXTERN |
Value 0x01 0x02 0x04 0x08 0x10 |
fileNamenames the data file. The fileName must be enclosed in quotation marks.
Description
The simulator allows you to access a data file through a memory address. This function connects a data file to a memory (port) address. You can then read data from the file or write data to the file.
If the file is not in the current directory, provide a full path name within the string. A double backslash escape sequence is required to ensure that you get a backslash into the fileName Parameters.
Synchronous
Synchronous from GEL: Yes
Completely synchronous: Yes
Example
GEL_PortConnect( 0x1000, 0, 0x100, , “c:\mydir\myfile.dat”);
Related Topics
Connecting a File to a Memory Address