get (env object) - Return target environment property values

Syntax

MATLAB® command line

set(env_object)
set(env_object, 'property_name1', 'property_value1', 
'property_name2', 'property_value2', . . .)
env_object.set('property_name1', 'property_value1')
set(env_object, property_name_vector, property_value_vector)
env_object.property_name = property_value

Arguments

env_object

Name of a target environment object.

'property_name'

Name of a target environment object property. Always use quotation marks.

property_value

Value for a target environment object property. Always use quotation marks for character strings; quotation marks are optional for numbers.

parameter_name

The letter p followed by the parameter index. For example, p0, p1, p2.

Description

get retrieves the properties of the target environment object. Not all properties are user writable.

The environment properties for a target environment object are listed in the following table. This table includes a description of the properties and which properties you can change directly by assigning a value:

Environment Property

Description

Writable

Name

Target PC name.

Yes

HostTargetComm

Values are 'RS232' and 'TcpIp'.

From the xPC Target™ Explorer window Host target communication list, select either RS232 or TCP/IP.

If you select RS232, you also need to set the property RS232HostPort. If you select TCP/IP, then you also need to set all properties that start with TcpIp.

Yes

TargetRAMSizeMB

Values are 'Auto' and 'Manual'.

From the xPC Target Explorer window Target RAM size list, select either Auto or Manual. If you select Manual, enter the amount of RAM, in megabytes, installed on the target PC. This property is set by default to Auto.

Target RAM size defines the total amount of installed RAM in the target PC. This RAM is used for the kernel, target application, data logging, and other functions that use the heap.

If Target RAM size is set to Auto, the target application automatically determines the amount of memory up to 64 MB. If the target PC does not contain more than 64 MB of RAM, or you do not want to use more than 64 MB, select Auto. If the target PC has more than 64 MB of RAM, and you want to use more than 64 MB, select Manual, and enter the amount of RAM installed in the target PC.

Yes

MaxModelSize

BootFloppy and DOSLoader modes ignore this value.

Values are '1MB', '4MB', and '16MB'.

From the xPC Target Explorer window Maximum model size list, select either 1 MB, 4 MB, or 16 MB. This value is unavailable for BootFloppy or DOSLoader modes.

Choosing the maximum model size reserves the specified amount of memory on the target PC for the target application. The remaining memory is used by the kernel and by the heap for data logging.

Selecting too high a value leaves less memory for data logging. Selecting too low a value does not reserve enough memory for the target application and creates an error.

Note that you cannot build a 16 MB target application to run in StandAlone mode.

Yes

TargetScope

Values are 'Disabled' and 'Enabled'.

From the xPC Target Explorer window Enable target scope list, select either Enabled or Disabled.

The property TargetScope is set by default to Enabled. If you set TargetScope to Disabled, the target PC displays information as text.

To use all the features of the target scope, you also need to install a keyboard on the target PC.

Yes

TargetBoot

Values are 'BootFloppy', 'DOSLoader', and 'StandAlone'.

From the xPC Target Explorer window Target boot mode list, select BootFloppy, DOSLoader, or StandAlone.

If your license file does not include the license for the xPC Target Embedded Option™ product, the Target boot mode box is disabled, with BootFloppy and DOSLoader as your options. With the xPC Target Embedded Option product licensed and installed, you have the additional choice of StandAlone.

Yes

EmbeddedOption

Values are 'Disabled' and 'Enabled'. This property is read only.

Note that the xPC Target Embedded Option product is enabled only if you purchase an additional license.

Yes

SecondaryIDE

Values are 'off' and 'on'. Set this value to 'on' only if you want to use the disks connected to a secondary IDE controller. If you do not have disks connected to the secondary IDE controller, leave this value set to 'off'.

Yes

RS232HostPort

Values are 'COM1' and 'COM2'.

From the xPC Target Explorer window Host port list, select either COM1 or COM2 for the connection on the host computer. The xPC Target software automatically determines the COM port on the target PC.

Before you can select an RS-232 port, you need to set the HostTargetComm property to RS232.

Yes

RS232Baudrate

Values are '115200', '57600', '38400', '19200', '9600', '4800', '2400', and '1200'.

From the Baud rate list, select 115200, 57600, 38400, 19200, 9600, 4800, 2400, or 1200.

Yes

TcpIpTargetAddress

Value is 'xxx.xxx.xxx.xxx'.

In the xPC Target Explorer window Target PC IP address box, enter a valid IP address for your target PC. Ask your system administrator for this value.

For example, 192.168.0.10.

Yes

TcpIpTargetPort

Value is 'xxxxx'.

In the xPC Target Explorer window TcpIp target port box, enter a value greater than 20000.

This property is set by default to 22222 and should not cause any problems. The number is higher than the reserved area (telnet, ftp, ...) and it is only of use on the target PC.

Yes

TcpIpSubNetMask

Value is 'xxx.xxx.xxx.xxx'.

In the xPC Target Explorer window LAN subnet mask address text box, enter the subnet mask of your LAN. Ask your system administrator for this value.

For example, your subnet mask could be 255.255.255.0.

Yes

TcpIpGateway

Value is 'xxx.xxx.xxx.xxx'.

In the xPC Target Explorer window TcpIp gateway address box, enter the IP address for your gateway. This property is set by default to 255.255.255.255, which means that a gateway is not used to connect to the target PC.

If you communicate with your target PC from within a LAN that uses gateways, and your host and target computers are connected through a gateway, then you need to enter a value for this property. If your LAN does not use gateways, you do not need to change this property. Ask your system administrator.

Yes

TcpIpTargetDriver

Values are 'NE2000', 'SMC91C9X', 'I82559', 'RTLANCE', 'R8139', '3C90x', and 'NS83815'.

From the xPC Target Explorer window TcpIp target driver list, select NE2000, SMC91C9X, I82559, RTLANCE, R8139, 3C90x, or NS83815. The Ethernet card provided with your system uses the NE2000 driver.

Yes

TcpIpTargetBusType

Values are 'PCI' and 'ISA'.

From the xPC Target Explorer window TcpIp target bus type list, select either PCI or ISA. This property is set by default to PCI, and determines the bus type of your target PC. You do not need to define a bus type for your host PC, which can be the same or different from the bus type in your target PC.

If TcpIpTargetBusType is set to PCI, then the properties TcpIpISAMemPort and TcpIpISAIRQ have no effect on TCP/IP communication.

If you are using an ISA bus card, set TcpIpTargetBusType to ISA and enter values for TcpIpISAMemPort and TcpIpISAIRQ.

Yes

TcpIpTargetISAMem Port

Value is '0xnnnn'.

If you are using an ISA bus Ethernet card, you must enter values for the properties TcpIpISAMemPort and TcpIpISAIRQ. The values of these properties must correspond to the jumper settings or ROM settings on your ISA bus Ethernet card.

On your ISA bus card, assign an IRQ and I/O port base address by moving the jumpers on the card.

Set the I/O port base address to around 0x300. If one of these hardware settings leads to a conflict in your target PC, choose another I/O port base address and make the corresponding changes to your jumper settings.

Yes

TcpIpTargetISAIRQ

Value is 'n', where n is between 4 and 15.

If you are using an ISA bus Ethernet card, you must enter values for the properties TcpIpISAMemPort and TcpIpISAIRQ. The values of these properties must correspond to the jumper settings or ROM settings on the ISA-bus Ethernet card.

On your ISA bus card, assign an IRQ and I/O-port base address by moving the jumpers on the card.

The MathWorks recommends setting the IRQ to 5, 10, or 11. If one of these hardware settings leads to a conflict in your target PC, choose another IRQ and make the corresponding changes to your jumper settings.

Yes

See Also

set (env object)

  


 © 1984-2008- The MathWorks, Inc.    -   Site Help   -   Patents   -   Trademarks   -   Privacy Policy   -   Preventing Piracy   -   RSS