Documentation

Target Settings Properties

Settings related to target computer

This object defines the settings for the target computer.

The settings define the communication link between the development and target computers and the properties of the target boot image created during the setup process.

Note

  • Support for using ISA bus Ethernet cards to communicate between the development and target computers has ceased to function. Use PCI bus or USB bus Ethernet cards instead.

  • The NonPentiumSupport property has ceased to function. Use a target computer with an Intel® Pentium or AMD® K5/K6/Athlon processor.

  • In a future release, the SecondaryIDE target setting will be read-only and set to 'off'.

  • The MulticoreSupport target setting is read-only and set to 'on'. Single-core target computers still function.

  • The property MaxModelSize has no function.

  • The RAM size check box has been removed from Simulink® Real-Time™ Explorer. The property value TargetRAMSizeMB continues to function.

To create a target computer settings object that is set to default values, use the syntax target_object = SimulinkRealTime.addTarget(target_name).

target_object = SimulinkRealTime.addTarget('TargetPC3')
Simulink Real-Time Target Settings

    Name                     : TargetPC3       

    TargetRAMSizeMB          : Auto            
    LegacyMultiCoreConfig    : on              
    USBSupport               : on             
    ShowHardware             : off            
    EthernetIndex            : 0              

    TcpIpTargetAddress       :                
    TcpIpTargetPort          : 22222          
    TcpIpSubNetMask          : 255.255.255.0  
    TcpIpGateway             : 255.255.255.255
    TcpIpTargetDriver        : Auto           
    TcpIpTargetBusType       : PCI            

    TargetScope              : Enabled        

    TargetBoot               : BootFloppy     
    BootFloppyLocation       : 

The default settings are incomplete. At a minimum, you must assign a value to TcpIpTargetAddress. To change this setting by assignment, use the syntax target_object.property_name = value.

target_object = SimulinkRealTime.getTargetSettings('TargetPC3');
target_object.TcpIpTargetAddress = '10.10.10.15';

To read an existing setting, use the syntax value = target_object.property_name.

target_object = SimulinkRealTime.getTargetSettings('TargetPC3');
value = target_object.TcpIpTargetAddress
value =

10.10.10.15

To mark a target computer as the default computer, use the syntax setAsDefaultTarget(target_object).

target_object = SimulinkRealTime.getTargetSettings('TargetPC3');
setAsDefaultTarget(target_object)

To access the target computer settings in Simulink Real-Time Explorer:

  1. In the Targets pane, expand a target computer node.

  2. In the toolbar, click the Target Properties button .

  3. Expand the sections Host-to-Target communication, Target settings, or Boot configuration.

Host-to-Target Communication

expand all

If your development and target computers connect through a LAN that uses a gateway, you must enter a value for this property.

The default value, 255.255.255.255, means that a gateway is not used to connect to the target computer. If your LAN does not use gateways, you do not need to change this property. Consult your system administrator for this value.

In the Simulink Real-Time Explorer Gateway box, type the IP address for your gateway.

Example: env_object.TcpIpGateway = '192.168.1.1'

In the Simulink Real-Time Explorer Subnet mask box, type the subnet mask of your LAN. Consult your system administrator for this value.

Example: env_object.TcpIpSubNetMask = '255.255.255.0'

In the Simulink Real-Time Explorer IP address box, type a valid IP address for your target computer. Consult your system administrator for this value.

Example: env_object.TcpIpTargetAddress = '192.168.1.10'

This property determines the bus type of your target computer. You do not need to define a bus type for your development computer.

In the Simulink Real-Time Explorer Bus type list, select one of PCI or USB.

Example: env_object.TcpIpTargetBusType = 'USB'

If the target computer contains only one supported Ethernet card, use the default value ('Auto').

If you are using bus type 'USB', use 'USBAX172' or 'USBAX772'.

In the Simulink Real-Time Explorer Target driver list, select one of INTEL_I210, INTEL_I217, INTEL_I8254x, INTEL_I82559, R8139, R8168, USBAX172, USBAX772, or Auto.

Example: env_object.TcpIpTargetDriver = 'USBAX172'

Typically, you do not change this value from the default. Do so only if you are using the default port ('22222') for other purposes.

Use an Ethernet port greater than '20000'. Values in this range are higher than the reserved area (telnet, ftp, . . .).

Example: env_object.TcpIpTargetPort = '24000'

Target settings

expand all

Unique number identifying an Ethernet card on the target computer. If the target computer has multiple Ethernet cards, you must select one of the cards for the Ethernet link. This option returns the index number of the card selected on the target computer upon starting.

Example: env_object.EthernetIndex = '2'

When this value is 'on', the kernel uses the existing multiprocessor floating pointer structure (MPFPS) in the BIOS. When this value is 'off', the kernel uses the Advanced Configuration and Power Interface (ACPI) to query the hardware boards. The kernel uses that information to construct an MPFPS structure.

Set this value to 'off' only if your multicore target computer is fully compliant with the ACPI standard.

Example: env_object.LegacyMultiCoreConfig = 'off'

When you create a target settings object, the software assigns it a name of the form 'TargetPCN+1'. 'TargetPCN' is the previously assigned name. You can assign a new name from the Command Window.

To rename the target computer in Simulink Real-Time Explorer, right-click the target computer node in the MATLAB Session tree, click Rename, and type the new name in the Target environment name box.

Example: env_object.Name = 'NewTarget'

To display Ethernet card information on the target monitor, set ShowHardware to 'on' and then start the target computer. The target computer monitor displays the index, bus, slot, function, and target driver for each Ethernet card.

With ShowHardware set, after the kernel starts, the development computer cannot communicate with the target computer. When you have gathered your information, to resume normal functionality, set this property to 'off', recreate the boot image, and restart the target computer.

Example: env_object.ShowHardware = 'on'

Specifies the total amount of RAM, in megabytes, installed in the target computer. Target computer RAM is used for the kernel, real-time application, data logging, and other functions that use the heap.

If this property is set to 'Auto', the real-time application reads the target computer BIOS and determines the amount of memory installed in the target computer.

To allow the real-time application to determine the amount of memory in Simulink Real-Time Explorer, click RAM size Auto. If the real-time application cannot read the BIOS, click Manual and type into the Size(MB) box the amount of RAM, in megabytes, installed in the target computer.

Target computer memory for the real-time application executable, the kernel, and other uses is limited to a maximum of 4 GB.

Example: env_object.ShowHardware = '2000'

When this property is set to 'Enabled', the target computer shows a graphical window display. When set to 'Disabled', the target computer shows a text-based view.

When the graphical display is present, you can use target scopes to view signal data graphically on the target display. You cannot use target scopes when the text-based view is present.

Using Simulink Real-Time Explorer, to display scope information graphically, set the Graphics mode check box.

To display scope information as text, clear the Graphics mode check box.

To use the full features of a target scope, install a keyboard on the target computer.

Example: env_object.TargetScope = 'Disabled'

Set this property to use a USB port on the target computer, for example to connect a USB mouse.

In Simulink Real-Time Explorer, to enable a USB port, select the USB Support check box. Otherwise, clear it.

Example: env_object.USBSupport = 'off'

Boot configuration

expand all

To create a removable boot disk when the system default drive does not work, set this property.

Example: env_object.BootFloppyLocation='D:\'

Set this property in DOS Loader mode if the default location does not work.

Example: env_object.DOSLoaderLocation='D:\Dosloader'

After making the required target settings, to create a bootable image, type SimulinkRealTime.createTargetImage.

In Simulink Real-Time Explorer, to create a bootable image for the specified boot mode, click Create boot disk.

Example: env_object.TargetBoot='NetworkBoot'

Physical target computer MAC address from which to accept start requests when starting within a dedicated network.

To update the MAC address in Simulink Real-Time Explorer, first click the Reset button in the Target Properties pane. You can then click the Specify new MAC address button to enter a MAC address manually in the MAC address box. If you do not enter a MAC address manually, the software obtains the MAC address the next time you restart the target computer.

Example: env_object.TargetMACAddress='90:e2:ba:17:5d:15'

Introduced in R2014a

Was this topic helpful?