MATLAB XPC TARGET RELEASE NOTES Guida Utente

xPC Target™ 4User’s Guide

Graphical User Interfaces10xPC Target Interface Blocks to Simulink Mo dels ... 10-2Introduction... 10-2Simulink U

3 Signals and ParametersLimitationsThe f ol lowing ar e limitat ions of uploading xPC Target signals to Sim u li n kexternal mode:• When setting up si

Signal Tracing4 Ensure that the Source parameter is set to manual.5 Set the Mode parameter to normal. T his ensures that the scope acquiresdata contin

3 Signals and Parameters10 From the File menu, select Save As and enter a filename. For example,entermy_xpc_osc6.mdl and then click OK.11 Build and do

Signal TracingSignal Tracing with a Web BrowserThe Web brow ser interface allows you to visualize data using a graphicaluser interface.After you conne

3 Signals and Parametersscope, remove existing scopes, and control all aspects of a scope from thispage.Tocreateascopeoftypehost, use the drop-dow n l

Signal LoggingSignal LoggingIn this section...“Introduction” on page 3-57“Signal Logging with xPC Target Explorer” on page 3- 57“Signal Log ging in th

3 Signals and ParametersTo create xpc_os c4:1 In the MATLAB window, typexpc_osc3The xpc_osc3 model opens.2 In the Simu link wi n dow, select and delet

Signal Logging3 Start thetarget application. For example, in the xPC Target Hierarchypane, right-click thexpc_osc4 target application, then select Sta

3 Signals and ParametersYou can examine and otherwise manipulate the data.Signal Logging in the MATLAB InterfaceYou plot the outputs and states of you

Signal Loggingassumes you have created and downloaded the target application for thatmodel. It also assumes that you have assignedtg to the appropriat

Polling Mode ... 12-5Introducing Polling Mode... 12-5Setting the Polling Mode...

3 Signals and ParametersThe plot shown below is the result of a real-time execution. To compare thisplot with a plot f or a non-real-time simulation,

Signal LoggingThe plot shown below is the result of a real-time run.TheTETisthetimetocalculatethesignalvaluesforthemodelduringeach sample interval. If

3 Signals and ParametersThe MATLAB interface displays the following information about theaverage task execution time.ans =5.7528e-006ThepercentageofCP

Signal LoggingTask execution time — Logging the task execution time is possible only ifyou select the Log Task Execution Time check box in the Configu

3 Signals and ParametersParameter Tuning and Inlining ParametersIn this section...“Introduction” on page 3-66“Parameter Tuning with xPC Target Explore

Parameter Tuning and Inlining Pa rametersNote Opening a dialog box for a source block causes Simulink to pause. WhileSimulink is paused, you can edit

3 Signals and ParametersThe Model Hierarchy expands to show the elements in the Simulinkmodel.The model hierarchy shows only those blocks that have tu

Parameter Tuning and Inlining Pa rameters7 Press the Enter key.The box is updated and the Update Param eter button becomes active.If there is a scope,

3 Signals and ParametersParameter Tuning with the MATLAB InterfaceYou use the MATLAB functions to change block parameters. W ith thesefunctions, y ou

Parameter Tuning and Inlining Pa rametersParameters =INDEX VALUE TYPE SIZEPARAMETERNAMEBLOCKNAME0 1000000 D OUBLE Scalar Gain Gain1 400 DOUBLE Scalar

Configuring the xPC Target and Vector CANapeSoftware... 14-4Setting Up and Building the Model...

3 Signals and Parameters-tgortg.stoporstop(tg)The target application on the target PC stops running, and the target PCdisplays mes sag es like the fol

Parameter Tuning and Inlining Pa rameters2 To reset to the previous v alues, typesetparam(tg,pt.parIndexVec,pt.OldValues)ans =parIndexVec: 5OldValues:

3 Signals and ParametersAll of the current Simulink model parameters are downloaded to yourtarget application. This downloading g uarantees the consis

Parameter Tuning and Inlining Pa rameters5 In the Gain text box, ente r 800 and click OK.As soon as you change a model parameter and click OK,oryoucli

3 Signals and ParametersThe target application on the target PC stops running, and the target PCdisplays the following messages:minimal TET: 0.000023

Parameter Tuning and Inlining Pa rametersThe procedures assume that• You have a target application object namedtg.• You have assignedtg to the appropr

3 Signals and ParametersLoading Saved Parameters to a Target Ap plicationTo load a set of saved parameters to a target application, use theloadparamse

Parameter Tuning and Inlining Pa rameters2 Load the parameter file. For example, typetg.loadparamset('xpc_osc4_param1');3 Display a list o f

3 Signals and Parameters3 Double -click the Signal G ene rator block and enter A for the Ampli tudeparameter. Click OK.4 In the MATLAB Command Window,

Parameter Tuning and Inlining Pa rametersThe Model Parameter Configuration dialog box appears as follows.If you have more global parameters you want t

General I/O Troubleshooting Guidelines ... 15-21Can I View the Contents of the Target PC Display on theHost PC?...

3 Signals and ParametersYou next can use xPC Target Explorer or the MATLAB interface to workwith the tunable parameters.Tuning Inlined Parameters with

Parameter Tuning and Inlining Pa rameters5 Enter a new value for the parameter and press Enter.The box is updated and the Update Param eter button bec

3 Signals and ParametersThe value of Signal Generator is show n in t he right pane.8 Stop the target application.Tuning Inlined Parameters with the MA

Parameter Tuning and Inlining Pa rameters1 Sa ve th e following code in a MA T L A B file. For example, change_inlineA.tg=xpc; %Create xPC Target obje

3 Signals and ParametersNonobser vable Signals and ParametersObservable signals are those that you can monitor, trace, and log.Nonobservable signals a

4Booting from a DOS Device• “DOSLoader Mode” on page 4-2• “Creating a DOS System Disk” on page 4-6

4 Bo oting from a DOS DeviceDOSLoader ModeIn this section...“Introduction” on page 4-2“DOSLoader Mode Setup” on page 4-2“Restrictions” on page 4-3“Cre

DOSLoader Mode4 In the Configuration pane, select the DOSLoader tab.5 In the Location field, enter or browse to the directory where you wantto create

4 Bo oting from a DOS Device• While loaded in memo ry, the D OS partition must not overlap the addressrange o f a target application.To satisfy these

DOSLoader Modegetxpcenv2 Ensure that the following xPC Target properties are set as indicated:•TargetBoot — DOSLoader• DOSLoade rLocation — Your host

Scope Object Methods ... 16-4Scope Object Property Commands... 16-6Aliasing with Variable Commands...

4 Bo oting from a DOS DeviceCreating a DOS System DiskTo use the DOSLoader mode, you need a minimal DOS system on the targetPC boot device. MathWorks

5Embedded OptionThe xPC Target Embedded Option™ productallowsyoutobootthetargetPC from a d ev ice other than a 3.5-inch disk or CD drive or network bo

5 Embedded OptionIntroductionThe xPC Target Embedded Option software allows you to boot the xPC Targetkernel from a 3.5-inch disk drive a n d other de

xPC Target Embedded Option™ ModesxPC Target Embedded Option ModesIn this section...“Introduction” on page 5-3“Standalone Mode Overview” on page 5-4“Re

5 Embedded OptionThefollowingaresomeinstanceswhereyoumightwanttousethexPCTarget Embedded Option product. You might have one of these situations ifyou

xPC Target Embedded Option™ Modes8 Copy the contents o f model_name_emb to the target PC hard drive. Thetarget PC hard drive should now contain the fo

5 Embedded Option• While loaded in memo ry, the D OS partition must not overlap the addressrange o f a target application.To satisfy these restriction

Embedded Option SetupEmbedded Option SetupCreating a DOS System DiskWhen using Standalone mode, you must first boot your target PC with DOS.YoucanuseS

5 Embedded OptionStand-Alone Target SetupIn this section...“Before Yo u Start” on page 5-8“Updating Environment Properties” on page 5-9“Creating a Ker

Stand-Alone Target SetupUpdating Environment PropertiesThe xPC Target software uses the environment properties to determine whatfiles to create for th

Functions18Configuration Parameters19xPC Target options Pane ... 19-2xPC Target options Overview... 19-4A

5 Embedded OptionA S imulink window opens with the model.2 From the Tools menu, point to Real-Time Workshop,andthenclickBuild Model.Real-Time Workshop

Stand-Alone Target Setup2 In the MATLAB Command Window, change folder on the host computer tothe folder that contains the kernel/target application fi

5 Embedded OptionNote Do not confuse C:\xpcfiles\autoex ec.bat with C:\autoexec.bat.The fileC:\xpcfiles\autoexec.bat includes the command xpcboot.comt

6Software Environment andDemos• “Using Environment Properties and Functions” on page 6-2• “xPC Target Demos” on page 6-9

6 Software Environment and DemosUsing Environment Properties and FunctionsIn this section...“Introduction” on page 6-2“Getting a List of Environment P

Using Environment Properties and FunctionssetxpcenvThe M ATLA B interface displays a list of xPC Target environmentproperties and the allowed values.

6 Software Environment and DemosThe MATLAB interface opens the xPC Target Explorer window.Note the contents of the left pane. This is the xPC Target H

Using Environment Properties and FunctionsThe Configuration node under the Target PC node has the targetPC-spe cific configuration pane. If your licen

6 Software Environment and Demos• Auto — The target kernel automatica lly attempts to determine theamount of memory.•Manual — The amount of RAM, in MB

Using Environment Properties and Functions9 From the Target scope list, select either Enabled or Disabled.Theproperty Target scope is set by default t

xvi Contents

6 Software Environment and DemosThe environment properties you changed with the function setx pcenvbecome the current values.HostTargetCommRS232HostPo

xPC Target™ DemosxPC Target DemosIn this section...“Introduction” on page 6-9“ToLocateorEditaDemoScript”onpage6-11IntroductionThe xPC Target demos are

6 Software Environment and DemosDescription FilenameLogging signal data to a file on the target PCData Logging W ith a Fi leScopeFrame signal processi

xPC Target™ DemosYou can access xPC Target general application and driver demos throughthe MAT LAB Online H elp. In this window, xPC Target > Demos

6 Software Environment and Demos6-12

7Working with Target PCEnvironments

7 Working with Target PC E nvironmentsTarget Environment Command-Line InterfaceIn this section...“Creating Target PC Environment Object Containers” on

Target Environment Command-Line InterfaceIn the MATLAB window, typetgs.getCCompiler: 'VisualC'CompilerPath: 'c:\Microsoft Visual Studio

7 Working with Target PC E nvironmentsAdding Tar get PCEnvironment Collection ObjectsTo add a target PCenvironment collection o bject, use the target

Target Environment Command-Line InterfaceChanging Target PC Environment Object DefaultsBy default, the first target PC environment object is the defau

1Target and Scope O bjectsBefore you can work with xPC Target™ target and scope objects, you shouldunderstand the concept of target and scope objects.

7 Working with Target PC E nvironmentsTcpIpTargetAddress: '222.222.222.222'TcpIpTargetPort: '22222'TcpIpSubNetMask: '255.255.

Target Environment Command-Line InterfaceAlternatively, you can typeenv.TcpIpTargetPortans =22222env2.TcpIpTargetAddressans =192.168.0.107-7

7 Working with Target PC E nvironments7-8

8Using the Target PCCommand-Line InterfaceYou can interact with the xPC Target environment through the targetPC command window. The xPC Target softwar

8 Us ing the Target PC Command-Line InterfaceTarget PC Command-Line InterfaceIn this section...“Introduction” on page 8-2“Using Target Application Met

Target PC C ommand-Line Inter face2 In the Cmd box, ty pe a target PC com mand. For e xample, to start yo u rtarget application, typestart3 To stop th

8 Us ing the Target PC Command-Line InterfaceThe command window displays a message to indicate that the newparameter has registered.System: p[1] is se

Target PC C ommand-Line Inter faceThe target PC activates the command window.2 Type a scope command. For example, to add a target scope (scope 2) in t

8 Us ing the Target PC Command-Line InterfaceThesecommandscreateatemporarydifferencebetweenthebehaviorofthetarget application and the properties of th

Target PC C ommand-Line Inter face2 Typethevariablenametorunthatcommandsequence. Forexample,toturn the motor on, ty peonThe parameter P7 is changed to

1 Target and Scop e ObjectsTarget ObjectsWhat Is a Target Object?The x PC Target software uses a targ et object (of class xpctarget.xpc)torepresent th

8 Us ing the Target PC Command-Line Interface8-8

9Working with Target PCFiles and File Systems• “Introduction” on page 9-2• “FTP and File System Objects” on page 9-4• “Using xpctarget.ftp Objects” on

9 Working with Target PC Files and File SystemsIntroductionxPC Target file scopes create files on the target PC. To work with thesefiles from the host

IntroductionYou can access signal data files, or any target PC system file, in one of thefollowing ways:• If you are running the target PC as a stand-

9 Working with Target PC Files and File SystemsFTP and File System ObjectsThe xPC Target software uses two objects, xpctarget.ftp and xpctarget. fs(fi

Using xpctarget.ftp ObjectsUsing xpctar get.ftp ObjectsIn this section...“Overview” on page 9-5“Accessing Files on a Specific Target PC ” on page 9-6“

9 Working with Target PC Files and File SystemsAccessing Files o n a Specific Target PCYou can access specific target PC files from the host PC for th

Using xpctarget.ftp ObjectsListing the Contents of the Target PC FolderYou can list the contents of the target PC folder by using xPC Target methodson

9 Working with Target PC Files and File SystemsForexample,toretrieveafilenameddata.dat from the target PC C:\ drive(default),1 Ifyouhavenotalreadydone

Using xpctarget.fs ObjectsUsing xpctar get.fs ObjectsIn this section...“Overview” on page 9-9“Accessing File Systems from a Specific Target PC” on pag

Scope ObjectsScope ObjectsIn this section...“What Is a Scope Object?” o n page 1 -3“Scope Object Types” on page 1-4What Is a Scope Object?The xPC Targ

9 Working with Target PC Files and File Systems• removefi le to remove a file from the target PC•rmdir to remove a folderUseful global utility:•readxp

Using xpctarget.fs Objects1 In the MATLAB window, type a command like the following to assign thexpctarget.xpc object to a v ariable.tg1=xpctarget.xpc

9 Working with Target PC Files and File Systems1 Ifyouhavenotalreadydoneso,intheMATLABwindow,typethefollowingto assign thexpctarget.fs object to a var

Using xpctarget.fs Objectsin xPC Target format. The data must be a vecto r of bytes (uint8). To convertthe data touint8, use a command like the follow

9 Working with Target PC Files and File Systemsx[0] y[0] z[0] t[0] x[1] y[1] z[1] t[1] x[2] y[2] z [2] t[2]...x[N] y[N] z[N] t[N]Nis the number of sam

Using xpctarget.fs Objectsfs_object.method_name(argument_list)For example, to get a list of open files for the file system object fsys,1 Ifyouhavenota

9 Working with Target PC Files and File SystemsUse the method syntax to run an xpctarget.fs object method. The sy ntaxmethod_name(fs_object, argument_

Using xpctarget.fs ObjectsFor examp le, to display the disk i n formation for the C:\ drive,1 Ifyouhavenotalreadydoneso,intheMATLABwindow,typethefollo

9 Working with Target PC Files and File Systems9-18

10Graphical User Interfaces

How to Contact MathWorkswww.mathworks.comWebcomp.soft-sys.matlab Newsgroupwww.mathworks.com/contact_TS.html Technical [email protected] Pro

1 Target and Scop e Objectssample time is 0.005, the scope will acquire five identical samples for thissignal,andthenthenextfiveidenticalsamples,andso

10 Graphical User InterfacesxPC Tar get Interface Blocks to Simulink ModelsIn this section...“Introduction” on page 10-2“Simulink User Interface Model

xPC Target™ Interfac e Bloc ks to Simulink®ModelsSimulink 3D Animation — The Simulink 3D Animation product enablesyou to d isplay a Simulink u ser int

10 Graphical User Interfaces4 In the MATLAB interface, run the function xpcsliface('model _name') tocreatetheuserinterfacetemplatemodel. Thi

xPC Target™ Interfac e Bloc ks to Simulink®ModelsNote The use of To xP C Target blocks requires a connection between the hostand target PC. If there i

10 Graphical User InterfacesBecause only one num erical value per signal is uploaded during a timestep, the number of samples of a scope object is set

xPC Target™ Interfac e Bloc ks to Simulink®Modelstarget application, and you use this model to select the parameters andsignals you want to connect to

10 Graphical User Interfaces4 In the Description box, delete the existing tag and enter a tag to theparameters for this block.For example, the SetPoin

xPC Target™ Interfac e Bloc ks to Simulink®Models5 Repeat steps 1 through 3 for the remaining parameters y ou want to tag.For example, for the Control

10 Graphical User InterfacesAfter you create a Simulink model, you can mark the block signals. Thisprocedure uses the modelxpctank1.mdl (or xpc tank .

xPC Target™ Interfac e Bloc ks to Simulink®ModelsFor example, the block labeled TankLevel is an integrator with a singlesignal that indicates the leve

Scope ObjectsEach scope object type has a group of object properties particular to thatobject type.1-5

10 Graphical User InterfacesTo create the From xPC blocks in an user interface model for a signal linewith four signals (port dimension of 4), use the

11xPC Target Web BrowserInterface

11 xPC Target™ Web Browser InterfaceWeb Browser InterfaceIn this section...“Introduction” on page 11-2“Connecting the Web Interface Through TCP/IP” on

Web Browser InterfaceBefore you connect your Web browser on the h os t PC, you must load a targetapplication onto the target PC. The target applicatio

11 xPC Target™ Web Browser Interface1 In the MATLAB window, typexpcwwwenable or close(xpc)The MATLAB interface is disconnected from the target PC, lea

Web Browser Interface5 In the DOS command window, press Ctrl+C.The TCP/IP to RS-232 Gateway stops running, and the DOS commandwindow displays the mess

11 xPC Target™ Web Browser InterfaceCommand-Line Option Description-vVerbose mode. Pro duces a line of output every time aclient connects or disconnec

Web Browser InterfaceUsing the Main PaneThe Main pane is divided into four parts, one below the other. The four partsare System Status, xPC Target Pro

11 xPC Target™ Web Browser InterfaceAfter you connect a Web browser to the target PC, you can use the Mainpane to control the target application:1 In

Web Browser Interface4 Enter new values in the StopTime and SampleTime boxes, then clickthe Apply button. You can enter-1 or Inf in the StopTime box f

1 Target and Scop e ObjectsThe xpcsctg scope object of type target has the follo w in g object properties:•Grid• Mode• YLimitThe xpcschost scope objec

11 xPC Target™ Web Browser InterfaceSignals with a width greater than the value you enter are not displayedon the Signals pane.2 In the Refresh Interv

Web Browser InterfaceThe Screen Shot pane is loaded a n d a copy of the current target PC screenis displayed. T he screen shot uses the portable netwo

11 xPC Target™ Web Browser Interface3 In the Target selection section, access levels are set in the Systemtarget file box. For example, to set the acc

12Execution Modes• “Introducing Execution Modes” o n page 12-2• “Interrupt Mode” on page 12-3• “Polling Mode” on page 12-5

12 Execution ModesIntroducing Execution ModesIntroductionInterrupt mode is the default real-time execution mode for the xPC Targetkernel. In certain c

Interrupt ModeInterrupt M odeInterrupt mode is the default real-timeexecutionmodefor the kernel. Thismode provides the greatest flexibility and is the

12 Execution Modes• CPU h ardw are latency — Modern CPU s try to predict the next couple ofinstructions, including branches, by the use of instruction

Polling M o dePolling ModePolling m od e fo r the k ern el is de signed to execute target app lic a tion s a tsample times close to the limit of the h

12 Execution ModesEven a h ighly clocke d CPU is not likely to lead to an ov erflow of a 64 bitcounter (2^64 * 1e-9 (1 GHz CPU) = 584 years). The Pent

Polling M o de• Use the fastest available computer hardware — Ensure that the CPU withthehighestclockrateavailableisusedforagivenPCformfactor.Forthede

Scope Objects• TriggerS lope• TypeSee the scope object functionget (scope object) for a description of theseobject properties.1-7

12 Execution Modes3 In the TLC options edit field, specify the o ption-axpcCPUClockPoll=CPUClockRateMHzTheassignmentoftheclockrateofthetargetPC’sCPUis

Polling M o de-axpcCPUClockPoll=1200If you want to execute the target application in interrupt mode again,either remove the option or assign a CPU clo

12 Execution ModesRestrictions Introduced by Polling ModeAs explained above, polling mode ex ecutes the Simulink-based targetapplication in real time

Polling M o deNevertheless, there is a way to stop the execution interactively beforereaching the target application stop time. See “Controlling the T

12 Execution ModesThe Only Rapid-Prototyping Feature Available Is Data LoggingBecause host-target communication and target screen updating are disable

Polling M o derates, the CPU will most likel y overload for the given base sample time. As animportant consequence, polling mode is only a feasible al

12 Execution Modesexecution of the target application, depending on the state of the digital inputsignal. You can either use a hardware switch connect

Polling M o deThe minimu m achievable base sample time for th i s model using an ode4fixed-step integration algorithm is 11 µs with signal logging dis

12 Execution Modes12-16

13Incorporating FortranCode into the xPC TargetEnvironment• “Before You Start” on page 13-2• “Step-by-Step Example of Fortran and xPC Target” on page

1 Target and Scop e Objects1-8

13 Incorporating Fortran Code into the xPC Ta rget™ EnvironmentBefore You StartIn this section...“Introduction” on page 13-2“Simulink D emos Folder” o

Before You StartA list of Simulink examples appears.3 Click Custom Code and H and Coded Blocks using the S-functionAPI.The associated Simulink demos p

13 Incorporating Fortran Code into the xPC Ta rget™ Environment4 Run a simu lation C-MEX file w ith the S imulink sof tw are to va li date thecompiled

Step-by-Step Example of Fortran and xPC Target™Step-by-Step Exam ple of Fortran and xPC TargetIn this section...“In This Example” on page 13-5“Creatin

13 Incorporating Fortran Code into the xPC Ta rget™ Environment2 Typesfcndemo_atmosThe sfcndemo_atmos model is displayed.3 Add an xPC Target Scope blo

Step-by-Step Example of Fortran and xPC Target™8 Click Apply,thenOK.9 Double-click the Sine Wave block.10 For the Sample time parameter, enter 0.05.11

13 Incorporating Fortran Code into the xPC Ta rget™ Environment• svml_dis p.lib3 From a DOS prompt, change folder to the working folder and create the

Step-by-Step Example of Fortran and xPC Target™Note This topic describes how to create a level 2 Fortran S-function for thefortran_atmos_xpc model. Th

13 Incorporating Fortran Code into the xPC Ta rget™ Environment#endif8 Add a typedef to specify the parameters for the block. For example,typedef enum

Step-by-Step Example of Fortran and xPC Target™ssSetOutputPortWidth(S, 1, 3); /* pressure */ssSetOutputPortWidth(S, 2, 3); /* density */#if de fined(M

2Targets and Scopes in theMATLAB InterfaceYou can work with xPC Target target and scope objects through the MATLABinterface (MATLAB Command Window), t

13 Incorporating Fortran Code into the xPC Ta rget™ EnvironmentP[k] = mxGetScalar(P0(S)) * (double) fdelta;rho[k] = mxGetScalar(R0(S)) * (double) fsig

Step-by-Step Example of Fortran and xPC Target™• libifcor e.lib• libifcor emd.lib• ifconsol .lib• libifpor tmd.lib• libifpor t.lib• libmmd.l ib• libm.

13 Incorporating Fortran Code into the xPC Ta rget™ EnvironmentYour next task is to validate the Fortran code and wrapper S-function. See“Validating t

Step-by-Step Example of Fortran and xPC Target™• The build procedure has access to the Fortran run-time libraries (see“Compiling and Linking the Wrapp

13 Incorporating Fortran Code into the xPC Ta rget™ EnvironmentThis command requires that the application build folder be the current folder(one level

14Vector CANape S upportThis topic describes how to use xPC Target to interface thetarget PC to the Vector CAN Application Environment (CANape)(http:/

14 Vector CANape®SupportVector CANapeIn this section...“Introduction” on page 14-2“xPC Target and Vector CANape Limitations” on page 14-3IntroductionY

Vector CANape• An X CP server process in the target a pplication that runs on-demand inthe background.• A generator that produces A2L (ASAP2) files th

14 Vector CANape®SupportConfiguring the xPC Target and Vector CANape SoftwareIn this section...“Setting Up and Building the Model” on page 14-4“Creati

Configuring the xPC Target™ and Vector CANape®Software• Target Address —TargetIPaddressfortargetPC.Thedefaultvalueisgetxpcenv(`TcpIpTargetAddress&apos

2 Targets and Scopes in the MATLAB®InterfaceWorking with Tar get ObjectsIn this section...“Accessing Help f or Target Objects” on page 2-2“Creating Ta

14 Vector CANape®SupportThe xPC Target software builds the target application, including an A2L(ASAP2) data file for the target application.11 On the

Configuring the xPC Target™ and Vector CANape®SoftwareConfiguring the Vector CANape DeviceThis procedure describes how to configure the Vector CANape

14 Vector CANape®SupportThisisthetargetPCtowhichyouhavedownloadedthetargetapplication.11 Ensure that the port number is 5555.12 Click OK.13 If you hav

Configuring the xPC Target™ and Vector CANape®SoftwareConfiguring the Location of the A2L (ASAP2) FileUse this procedure to configure the location of

14 Vector CANape®SupportDuring target application change s, you might need to manually reload theA2L (ASAP2) that is generated by the xPC Target build

Event Mode Da ta AcquisitionEvent Mode Data AcquisitionIn this section...“Guidelines” on page 14-11“Limitations” on page 14-11GuidelinesTo acquire eve

14 Vector CANape®Support14-12

15Frequently Asked Questions• “Overview ” on page 15-2• “BIOS Settings” on page 15-3• “Booting Issues” on page 15-4• “Communications” on page 15-6• “I

15 Frequently Asked QuestionsOver viewThis chapter describes guidelines, hints, and tips for questionsor issues y ou might have while using the xPC Ta

BIOS SettingsBIOS SettingsThe BIOS settings of a PC system can affect how the PC works. If youexperience problems using the xPC Target s oftw are, you

Working with Target Ob jectsto the host through an RS-232 connection. In the MATLAB CommandWindow, typetg = xpctarget.xpc('rs232', 'COM

15 Frequently Asked QuestionsBooting IssuesIn this section...“Is Your Host PC MATLAB Interface H alted?” on page 15-4“Is Your Target PC Unable to Boot

Booting Issues• If you still cannot boot the target PC from a boot disk, you might need toreplace the target PC 3.5-inch or CD disk drive.Is the Targe

15 Frequently Asked QuestionsCommunicationsIn this section...“Is There Communication Between Your PCs ?” on page 15-6“Why Does the xPC Target System L

Communications• If the communication between the host PC and target PC is TCP/IP, set thehost PC network interface card (NIC) card and hub to half-dup

15 Frequently Asked QuestionsBy default, if the host PC does not get a response from the target PC afterdownloading a target application and waiting 5

Communications5 Rebuild the model.In this case, the host PC waits for abo ut 20 seconds before declaring thata time-out has occurred. Note that it doe

15 Frequently Asked QuestionsIf you experience this issue, perform the following to try to connect to thetarget PC:1 Connect the network cable to Ethe

Communicationssuch an event, you need to reboot the target and reestablish communicationbetween the host PC and target PC.To get yourself back up and

15 Frequently Asked QuestionsInstallation, Configuration, a nd Build TroubleshootingIn this section...“Troubleshooting xpctest Results” on page 15-12“

Installation, Configuration, and Build TroubleshootingIf you are using a TCP/IP connection and need more help with Test 1, checkthe following:• Be sur

2 Targets and Scopes in the MATLAB®InterfaceDisplaying Tar get Object PropertiesYou might want tolist the target object properties to monitor a target

15 Frequently Asked Questionsxpctest: Test 3 FailsFirst, follow the procedure in “Test 3, Reboot Target Using Direct Call” in thexPC Target Getting St

Installation, Configuration, and Build Troubleshootingxpctest: Test 4 FailsFirst, follow the procedure in th e “Test 4, Build and Download Application

15 Frequently Asked Questions3 In the Select C compiler field, select the appropriate compiler type(VisualC or Watcom).4 In the Compiler Path field, e

Installation, Configuration, and Build Troubleshooting6 Create the boot disk or boot image.7 Reboot the target PC.8 Rerun xpctest.If this procedure do

15 Frequently Asked Questionssuch as 0.001. This change causes the test, and the MATLAB interface itself,to halt. To correct this, set thexpcosc model

Installation, Configuration, and Build Troubleshootingbottom of the xPC Target block library pop-up window. If the version numberis not the one to whi

15 Frequently Asked QuestionsHow Can I Build a Model That Contains a CAN Board?The procedure to build a model wit hCANblocksdiffersasfollows:• In rele

General xPC Target™ TroubleshootingGeneral xPC Target TroubleshootingIn this section...“General I/O Troubleshooting Guidelines” on page 15-21“Can I Vi

15 Frequently Asked Questions• Ensure that you have properly configured the driver.• Ensure that you are using the latest version of the software .• T

General xPC Target™ Troubleshooting• Spurious CPU overloads — Commonly caused by factors outside of themodel desig n. These overloads are most likely

Working with Target Ob jectstarget_object.property_name = new_property_valueFor example, to change the stop time mode for the target object tg,• In th

15 Frequently Asked QuestionsTarget PC BIOSUndesirable behavior can occur if any of the following BIOS settings areenabled:• Advanced Po we r Managem

General xPC Target™ TroubleshootingOption DescriptionDefaultxPCMaxOverloadsNumber of acceptable overloads.0xPCMaxOverloadLenNumber of contig uo usacce

15 Frequently Asked QuestionsWith the TLC options, you can use the following blocks in your model to helpkeep track of the number of CPU overloads.• U

General xPC Target™ TroubleshootingHow Can I Reduce the TET in My Application?To reduce the Task Execution Time (TET) in your application:• Use fewer

15 Frequently Asked QuestionsIf you have or want to us e multiple board s of a particular type in yoursystem, ensure that the I/O drive supports multi

General xPC Target™ Troubleshooting• Number of I/O channelsWhy Is My Requested xPC Target Sample TimeDifferent from the Measured Sample Time?You might

15 Frequently Asked Questionsprevious ly calculated v alue of 0.25% , there is a di fference of 0.04% from theexpected value.If you want to further re

General xPC Target™ Troubleshootingavailablespaceonthedisk.Thesignaldata will m ost likely be corrupted andirretrievable. You should delete the signal

15 Frequently Asked QuestionsCan I Create a Stand-Alone xPC Target Application toInteract with a Target Application?Yes. You can use either the xPC Ta

General xPC Target™ TroubleshootingFor example, if a model has a stop time of 2.4 and a step size of 1, theReal-TimeWorkshopsoftwareadjuststhestoptime

Revision HistorySeptember 1999 First printing New for Version 1 (Release 11.1)November 2000 Online only Revised for Version 1.1 (Release 12)June 2001

2 Targets and Scopes in the MATLAB®InterfaceSignals are not target object properties. To get the value of the Integ rator1signal from the model xp cos

15 Frequently Asked Questions• If the blocks of interest have special ch aracters, retrieve the mangled namewithtg.showsignals='on' or tg.sh

General xPC Target™ Troubleshooting• An extended counter takes the output of an encoder block and provides acount that is not limited by register size

15 Frequently Asked QuestionsGetting Updated xPC Tar get Releases and HelpIn this section...“How to Get Updated xPC Target Releases” on page 15-36“Are

Getting Updated xPC Target™ Releases and HelpRefer to the MathWorks Support Web SiteThis chapter contains general xPC Target troubleshooting tips. For

15 Frequently Asked Questions15-38

16Target PC Command-LineInterface Reference

16 Target PC Command-Line Inter face ReferenceTarget PC CommandsIn this section...“Introduction” on page 16-2“Target Object Methods” on page 16-2“Targ

Target PC CommandsTarget PCCommand Description and Syntax MATLAB EquivalentstartStart the target applicationcurrently loaded on the targetPC.Syntax:st

16 Target PC Command-Line Inter face ReferenceTarget PCCommand Description and Syntax MATLAB EquivalentSyntax: setparparameter_index =floating_point_n

Target PC Commandsthe difference between a signal index (0, 1,...)andasignalname(S0, S1,...).The following table lists the syntax forthetargetcommands

Working with Scope ObjectsWorking with Scope ObjectsIn this section...“Accessing Help for Sco pe Objects” on page 2 -7“Displaying Scope O b ject Prope

16 Target PC Command-Line Inter face ReferenceTarget PCCommand Description and Syntax MATLAB Equivalentylimit ylimit scope_indexylimit scope_index =au

Target PC CommandsTarget PC MATLAB Equivalenttriggermode scope_index =0, freerun, 1, softwar e, 2,signal, 3, scopesc.TriggerMode = 'freerun'

16 Target PC Command-Line Inter face ReferenceTarget PCCommand Description and SyntaxMATLABEquivale ntsetvarSet a variable to a value. L ater you can

17Function ReferenceSoftware Environment (p. 17-2) Define software and hardwareenvironment of host and target PCsGUI (p. 17-3) Open xPC Target ancilla

17 Function ReferenceSoftware EnvironmentgetxpcenvList environment propertiesassigned to MATLAB variablesetxpcenvChange xPC Target environmentproperti

GUIGUIxpcexplrOpen xPC Target ExplorerxpctargetspyOpen Real-Time x PC Target Spywindow on host PC17-3

17 Function ReferenceTestgetxpcinfoRetrieve diagnostic inf ormationto help troubleshoot configurationissuesgetxpcpciDetermine which PCI boards areinst

Target Application ObjectsTarget Application ObjectsaddscopeCreate scopescloseClose serial port connecting ho st PCwith target PCdeleteRemove target o

17 Function Referenceset (target applicationobject)Change target application objectproperty valuessetparamChange writable target objectparametersstart

Scope ObjectsScope ObjectsaddsignalAdd signals to scope represented byscope objectget (scope object)Return property values for scopeobjectsremsignalRe

2 Targets and Scopes in the MATLAB®Interfacesc1The current s cope properties are uploaded to the host PC, and thenMATLAB displays a lis t of the scope

17 Function ReferenceFile and File System ObjectsDirectories (p. 17-8) Manage file system and F TP objectsFTP (p. 17-8)Manage FTP objectsFile System (

File and File System ObjectsfopenOpen target PC file for readingfreadRead open target PC filefwriteWrite binary data to open target PCfilegetfilesizeS

17 Function ReferencexPC Target Environment Collection ObjectAdd (env collection object)Add new xPC Target environmentcollection o bjectget (env colle

xPC Target™ Utiliti esxPC Tar get UtilitiesmacaddrConvert string-based MAC addressto vector-based onereadxpcfileInterpret raw data from xPC Targetfile

17 Function Reference17-12

18Functions

Add (env c olle ction object)Purpose Add new xPC Target environment collection objectSyntax MATLAB command lineenv_collection_object.AddDescription Me

addscopePurpose Create scopesSyntax MATLAB command lineCreate a scope and scope object w ithout assigning to a M ATLABvariable.addscope(target_object,

addscope10 scopes of type target and h o st, and eight scopes of type file, for amaximum of 28 scopes. If you try to add a scope with the same index a

addscopeorsc1 = tg.addscope('target',1)Create a scope with the method addscope and then create a scopeobject, corresponding to this scope, u

Working with Scope ObjectsSetting the Value of a Scope PropertyWith the xPC Target software you can use either a function syntax or anobject property

addsignalPurpose Add signals to scope represented by scope o bjectSyntax MATLAB command lineaddsignal(scope_object_vector, signal_index_vector)scope_o

addsignalDisplay a list of properties and values for the scope object sc1 with thepropertySignals, as shown below.sc1.SignalsSignals = 1 : Signal Gene

cdPurpose Change folder on target PCSyntax MATLAB command linecd(file_obj,targ et_PC_dir)file_obj.cd(target_PC_dir)Argumentsfile_objName of the xpctar

closePurpose Close seria l port conn ectin g host PC with target PCSyntax MATLAB command lineclose(target_object)target_object.closeArgumentstarget_ob

deletePurpose Remove target obje ctSyntax MATLAB command linedelete(target_object)target_object.deleteArgumentstarget_objectName of a target object.De

dirPurpose List contents of current folder on target P CSyntax MATLAB command linedir(file_obj)Argumentsfile_objName of the xpctarget.ftp or xpctarget

dir• isdir — Logical value indicating that the object is (1)orisnot(0)afolderExamples List the contents of the current folder for the file system obje

diskinfoPurpose Information a bout target PC driveSyntax MATLAB command linediskinfo(filesys_obj,target_PC_drive)filesys_obj.diskinfo(target_PC_drive)

diskinfoExamples Return disk information for the targetPCC:\driveforthefilesystemobjectfsys.diskinfo(fsys,'C:\') or fsys.diskinfo('C:\&

fclosePurpose Close open target PC file(s)Syntax MATLAB command linefclose(filesys_obj,file_ID)filesys_obj.fclose(file_ID)Argumentsfilesys_objName of

2 Targets and Scopes in the MATLAB®InterfaceGetting the Value of a Scope PropertyYou can list a property value in the MATLAB window or assign that val

fc422mexcalcbitsPurpose Calculate parameter values for Fastcom 422/2-PCI boardSyntax MATLAB command line[a b ] = fc422mexcalcbits(frequency)[a b df] =

fileinfoPurpose Target PC file informationSyntax MATLAB command linefileinfo(filesys_obj,file_ID)filesys_obj.fileinfo(file_ID)Argumentsfilesys_objName

filetablePurpose Information about open files in target PC file systemSyntax MATLAB command linefiletable(filesys_obj)filesys_obj.filetableArgumentsfi

filetablefsys.fclose(h1);See Also xPC Target file object methods fopen and fclose.18-19

fopenPurpose Open target PC file fo r readingSyntax MATLAB command linefile_ID = fopen(file_obj,'f ile_name')file_ID= file_obj.fop en('

fopenOpen the file for reading and writing. Initially, the file pointer is atthebeginningofthefile. Themethoddoesnothingifthefiledoesnot already exist

freadPurpose Read open target PC fileSyntax MATLAB command lineA = fread(file_obj,file_ID)A = file_obj.fread(file_ID)A = fread(file_obj, file_ID, offs

freadlength(A) might be less than the number of bytes requested if thatnumber of bytes are not currently available. It is zero if the operationreaches

fwritePurpose Write binary data to open target PC fileSyntax MATLAB command linefwrite(file_obj,file_ID,A)file_obj.fwrite(file_ID,A)Argumentsfile_objN

fwriteSee Also xPC Target file object methods fclose, fop en,andfrea d.MATLABfwrite function.18-25

Working with Scope ObjectsNote Method names a re case sensitive. You must type the entire name.Property names are not case sensitive. You do not need

get (env c olle ction object)Purpose Return target object collection environment property valuesSyntax MATLAB command lineget(env_collection_object, &

get (env collection object)Property Description WritableDefaultTargetContains an instance of thedefaulttargetenvironmentobject(xpctarget.env).NoFloppy

get (env c olle ction object)See Also xPC Target target object e nvironment method set (env collectionobject)Built-in MATLAB functions get and set18-2

get (env object)Purpose Return target environment property v aluesSyntax MATLAB command lineget(env_object)get(env_object, 'property_name1',

get (env object)Environment Property Description WritableNameTarget PC name.YesHostTargetCommValues are 'RS232' and 'TcpIp'.From t

get (env object)Environment Property Description WritableMaxModelSizeBootFloppy and DOSLoader modes ignorethis value.Values are'1MB', '

get (env object)Environment Property Description WritableTargetScopeValues are ' Disabled' and 'Enabled'.From the xPC Target Explo

get (env object)Environment Property Description WritableCDBootImageLocationLocation of cdboot.iso file f o r creation ofCD target boot disk.YesEmbedd

get (env object)Environment Property Description WritableTcpIpTargetAddressValue is 'xxx.xxx.xxx.xxx'.In the xPC Target Explorer window Targ

get (env object)Environment Property Description WritableTcpIpGatewayValue is 'xxx.xxx.xxx.xxx'.In the xPC Target Explorer window TcpIpgatew

2 Targets and Scopes in the MATLAB®Interface1 In the MATLAB window, typesc=tg.addscope('file')The xPC Target software creates a scope of typ

get (env object)Environment Property Description WritableTcpIpTargetBusTypeValues are ' PCI' and 'ISA'.From the xPC Target Explore

get (env object)Environment Property Description Writableanother IRQ and make the correspondingchangestoyourjumpersettings.TcpIpTargetISAMem PortValue

get (env object)See Also set (env object)18-38

get (ftp)Purpose Retrieve copy of requested file from target P CSyntax MATLAB command lineget(file_obj,file_name)file_obj.get(file_name)Argumentsfile_

get (scope object)Purpose Return property values for scope objectsSyntax MATLAB command lineget(scope_object_vector)get(scope_object_vector, 'sco

get (scope object)Property Description Writableboxtohavethescopeoftype'File' collectdata up to Number of samples,thenstop.If the named signa

get (scope object)Property Description Writablename, including the specifie r, cannot exceedeight characters.For scopes of type'Host' or &ap

get (scope object)Property Description Writablebeginning and overwrites the first file namein the series . If you do not retrieve the datafrom ex isti

get (scope object)Property Description Writablewhen the fil e is closed and not du r ing each f ilewrite ope ration. This mode is faster, but if thesy

get (scope object)Property Description WritableScopeIdA numeric index, unique for each scope.NoSignalsList of signal indice s from the target object t

Working with Scope ObjectsNote Remember to start your scope to acquire signal data.For example, configure a scope of type file named sc to the applica

get (scope object)Property Description WritableAs a special case, setting TriggerSample to-1 means that the current scope is triggeredat the end of th

get (scope object)Property Description WritableWriteSizeEnter the block size, in bytes, of the d atachunks. This parameter specifies that amemory buff

get (scope object)See Also The xPC Target scope object method set (scop e object).The target object methodsset (target application object).The built-i

get (target application object)Purpose Return target application object property valuesSyntax MATLAB command lineget(target_object, 'target_objec

get (target application object)Property Description Writable• Asynchronous interruptions.• Parameter updating latency (if theDouble buffer parame t er

get (target application object)Property Description WritableLogModeControls which data points are logged:• Time-equidistant logging. Logs a datapointa

get (target application object)Property Description WritableModeType of Real-Time Workshop codegeneration. Val ue s are'Real-TimeSingletasking&ap

get (target application object)Property Description WritableParametersList of tunable parameter s. This li st isvisible only whenShowParameters is set

get (target application object)Property Description WritableShowSignalsFlag set to view or hide the list of signalsfrom your Simulink blocks. This lis

get (target application object)Property Description WritableTETLogStorage in the MATLAB workspace fora vector containing task execution timesduring ex

2 Targets and Scopes in the MATLAB®Interface6 Toenablethefilescopetocreatemultiplelogfileswiththesamenamepattern, typesc.Filename='file_<%>

getfilesizePurpose Size of file on target P CSyntax MATLAB command linegetfilesize(file_obj,file_ID)file_obj.getfilesize(file_ID)Argumentsfile_objName

getlogPurpose All or part of output logs f rom target objectSyntax MATLAB command linelog = getlog(target_object, 'log_name', first_point,nu

getparamPurpose ValueoftargetobjectparameterindexSyntax MATLAB command linegetparam(target_object, parameter_index)Argumentstarget_objectName of a tar

getparamidPurpose Parameter index from parameter listSyntax MATLAB command linegetparamid(target_object, 'block_name', 'parameter_name&

getparamidTroubleshooting chapter question “Why Does the getparamid FunctionReturn Nothing?” on page 15-33.18-60

getparamnamePurpose Block path and parameter name from index listSyntax MATLAB command linegetparamname(target_object, parameter_index)Argumentstarget

getscopePurpose Scope object pointing to scope defined in kernelSyntax MATLAB command linescope_object_vector = getscope(target_object, scope_number)s

getscopethe target PC. To change the number of samples, you need to create ascope object and then change the scope object propertyNumSamples.sc1 = get

getsignalPurpose ValueoftargetobjectsignalindexSyntax MATLAB command linegetsignal(target_object, signal index)Argumentstarget_objectName of a target

getsignalidPurpose Signal index or signal property from signal listSyntax MATLAB command linegetsignalid(target_object, 'signal_name')tg.get

Working with Scope Objects• Freerun — Starts to acquire data as soon as the scope is started (default)•Software — Starts to acquire data in response t

getsignalidsfromlabelPurpose Return vector of signal indicesSyntax MATLAB command linegetsignalidsfromlabel(target_object, signal_label)target_object.

getsignallabelPurpose Return signal labe lSyntax MATLAB command linegetsignallabel(target_object, signal_index)target_object.getsignallabel(signal_ind

getsignalnamePurpose Signal name from index listSyntax MATLAB command linegetsignalname(target_object, signal_index)target_object.getsignalname(signal

getTargetNames (env collection object)Purpose Retrieve xPC Target environment object namesSyntax MATLAB command lineenv_collection_object.getTargetNam

getxpcenvPurpose List environment properties assigned to MATLAB variableSyntax MATLAB command linegetxpcenvDescription Function to list environment pr

getxpcenvEnvironment P rope rty DescriptionEmbeddedOptionValues are 'Disabled' and 'Enabl ed'. This propertyis read only.Note that

getxpcenvEnvironment P rope rty Descriptionenough memory for the target application and createsan error.Note, you cannot build a 16 MB target applicat

getxpcenvEnvironment P rope rty DescriptionSecondaryIDEValues are 'off' and 'on'.Setthisvalueto'on' onlyif you want to u

getxpcenvEnvironment P rope rty Descriptionmemory up to 64 MB. If the target PC does not containmore than 64 MB of R AM, or yo u do not want to usemor

getxpcenvEnvironment P rope rty DescriptionTcpIpSubNetMaskValue is 'xxx.xxx.xxx.xxx' .In the xPC Target Explorer window LAN subnetmask addre

2 Targets and Scopes in the MATLAB®Interface• If NumPrePostSamples is a positive number, the scope is in a posttriggeringmode, where it starts collect

getxpcenvEnvironment P rope rty DescriptionTcpIpTargetDriverValues are 'NE2000', 'SMC 91C9 X', 'I82559','RTLANCE&ap

getxpcenvEnvironment P rope rty DescriptionTcpIpTargetISAMemPortValue is '0xnnnn'.IfyouareusinganISAbusEthernetcard,youmustenter values for

getxpcinfoPurpose Retrieve di agnostic information to help troubleshoo t configurationissuesSyntax MATLAB command linegetxpcinfogetxpcinfo('-a&ap

getxpcpciPurpose Determine which PCI boards are installed in target PCSyntax MATLAB command linegetxpcpci(target_object, 'type_of_boards')ge

getxpcpciwhichhavetobeprovidedtoadriverblockdialogboxbeforethemodel build process.Examples The following example displays the installed PCI devices, n

getxpcpcipcidevs = getxpcpci18-81

Item (env collection object)Purpose Retrieve specific x P C Target environment (env) o bj ectSyntax MATLAB command lineenv_collection_object.Item(&apo

loadPurpose Download target application to ta rge t PCSyntax MATLAB command lineload(target_object,'target_application')target_object.load(&

loadparamsetPurpose Restore parameter value s saved in specified fileSyntax MATLAB command lineloadparamset(target_object,'filename')target_

macaddrPurpose Convert string-based MAC address to vector-based oneSyntax MATLAB command linemacaddr('MAC address')Argument'MAC address

Working with Scope Objects- sc(2).TriggerSam ple = range 0 to (N + P - 1)In the figures below, TP is the trigger point or sample where a trigger event

makeDefault (env collection o bjec t)Purpose SetspecifictargetPCenvironment object as defaultSyntax MATLAB command lineenv_collection_object.makeDefau

mkdirPurpose Make folder on target PCSyntax MATLAB command linemkdir(file_obj,dir_name)file_obj.mkdir(dir_name)Argumentsfile_objName of the xpctarget.

putPurpose Copy file from host PC to target PCSyntax MATLAB command lineput(file_obj,file_name)file_obj.put(file_name)Argumentsfile_objName of the xpc

pwdPurpose Current folder path of target PCSyntax MATLAB command linepwd(file_obj)file_obj.pwdArgumentsfile_objName of the xpctarget.ftp or xpctarget.

readxpcfilePurpose Interpret raw data from xPC Target file formatSyntax file=readxpcfile(data)readxpcfile('filename')ArgumentsdataVector of

readxpcfilexpcftp=xpctarget.ftpxpcftp.get('filename')datafile = readxpcfile('filename') % Convert the dataUse the xpctarget.ftp ob

rebootPurpose Reboot target PCSyntax MATLAB command linereboot(target_object)Target PC command linerebootArgumentstarget_objectName of an existing tar

Remove (env collection object)Purpose Remove specific xPC Target environment objectSyntax MATLAB command lineenv_collection_object.Remove('env_co

removefilePurpose Remove file from target PCSyntax MATLAB command lineremovefile(file_obj,file_name)file_obj.removefile(file_name)Argumentsfile_nameNa

remscopePurpose Remove scope from ta rget P CSyntax MATLAB command lineremscope(target_object, scope_number_vector)target_object.remscope(scope_number

2 Targets and Scopes in the MATLAB®InterfacePosttriggering (P>0)Scope 1 triggers Scope 2 after the trigger event occurs. The following describessom

remscopeNote that you c an only permanently remove scopes that a re added withthe methodaddscope. This is a scope that is outside a model. If youremov

remsig nalPurpose Remove signals from scope repre sented by scope objectSyntax MATLAB command lineremsignal(scope_object)remsignal(scope_object, signa

remsignalRemove signals from the scope on the target PC w ith the scope objectpropertySignals updated.remsignal(sc1,[0,1])orsc1.remsignal([0,1])See Al

rmdirPurpose Remove folder from target PCSyntax MATLAB command linermdir(file_obj,dir_name)file_obj.rmdir(dir_name)Argumentsdir_nameName of the folder

saveparamsetPurpose Save current target application parameter valuesSyntax MATLAB command linesaveparamset(target_object,'filename')target_o

selectdrivePurpose Select target PC driveSyntax MATLAB command lineselectdrive(file_obj,'drive')file_obj.selectdrive('drive')Argum

set (env collection object)Purpose Change target object environment collection object property valuesSyntax MATLAB command lineset(env_collection_obje

set (env collection object)Property Description WritableCCompilerValues are 'Watcom' and 'VisualC'.From the xPC Target Explorerwin

set (env collection object)set(tgs)ans =CCompiler: {2x1 cell}CompilerPath: {}DefaultTarget: {}NumTargets: {}Change the p roperty CCompiler to Watcom.t

set (env object)Purpose Change target environment object property valuesSyntax MATLAB command lineset(env_object)set(env_object, 'property_name1&

Working with Scope ObjectsNote The difference b etwe en setting TriggerSample = (N + P - 1),whereN and P are the parameters of the triggering scope (S

set (env object)Environment Property Descrip tion WritableNameTarget PC name.YesHostTargetCommValues are 'RS232' and 'TcpIp'.From

set (env object)Environment Property Descrip tion WritableManual, and enter the amount of RAMinstalled in the target PC.MaxModelSizeBootFloppy and DOS

set (env object)Environment Property Descrip tion WritableTargetScopeValues are 'Disable d' and'Enabled'.From the x PC Target Expl

set (env object)Environment Property Descrip tion WritableNetworkBoot.WiththexPCTargetEmbedded Option product licensedand installed, you have the addi

set (env object)Environment Property Descrip tion WritableRS232BaudrateValues are '115200', ' 57600','38400', '1920

set (env object)Environment Property Descrip tion WritableTcpIpGatewayValue is 'xxx.xxx.xxx.xxx'.In the xPC Target Explorer w indowTcpIp gat

set (env object)Environment Property Descrip tion WritableTcpIpTargetBusTypeValues are 'PCI' and 'ISA'.From the x PC Target Explor

set (env object)Environment Property Descrip tion Writablein your target PC, choose anotherI/O po r t base address and mak e thecorresponding changes

set (env object)Environment Property Descrip tion WritableMathWorksrecommendssettingtheIRQ to 5, 10, or11.Ifoneofthesehardware settings leads to a con

set (scope object)Purpose Change property values for scope objectsSyntax MATLAB command lineset(scope_object_vector)set(scope_object_vector, property_

2 Targets and Scopes in the MATLAB®InterfaceAcquisition of Gap-Free DataThe following procedure describes how you can programmatically acquiregap-free

set (scope object)The properties for a scope object are listed in the following table. Thistable includes descriptions of the properties and the prope

set (scope object)Property Description WritableDynamicFileNameValues are 'on' and 'off'.Bydefault,thevalue is'off'.Enabl

set (scope object)Property Description Writablefile nam e, an underscore (_), and a <>specifier. Within the specifier, enter one toeight% symbol

set (scope object)Property Description WritableMaxWriteFileSizeProvide the maximum size of Filename,in bytes. This value must be a multiple ofWriteSiz

set (scope object)Property Description WritableFor scopes of type Host, this parameterhas no effect.NumPrePostSamplesFor scopes of type 'Host&apo

set (scope object)Property Description WritableSignalsList of signal indices from the target objectto display on the scope.YesStatusIndicate whether d

set (scope object)Property Description WritableAs a special case, setting TriggerSam pleto -1 means that the current scope istriggered at the end of t

set (scope object)Property Description WritableWriteSizeEnter the block size, in bytes, of the datachunks. This parameter s pecifies thata m emory buf

set (scope object)NumPrePostSamples: {}Mode: {5x1 cell}YLimit: {}Grid: {}The property value for the scope object sc1 is changed to on:sc1.set('gr

set (target application object)Purpose Change target application object property valuesSyntax MATLAB command lineset(target_object)set(target_object,

Working with Scope Objects5 Set the NumSamples property for both scopes to 500 and the TriggerSamp leproperty for both scopes to -1. With this propert

set (target application object)are listed in the following table. This table includes a description ofthe properties:Property Description WritableComm

set (target application object)Property Description WritableShowParametersFlag set to view or hidethe list of parameters fromyour Simulink blocks. Thi

set (target application object)The function set typically does not return a value. How eve r , if calledwith an explicit return arg u ment, for exampl

setparamPurpose Change writable target object parametersSyntax MATLAB command linesetparam(target_object, parameter_index, parameter_value)Argumentsta

setparamNewValues: {[10] [100]}18-130

setxpcenvPurpose Change xPC Target environment propertiesSyntax MATLAB command linesetxpcenv('property_name', 'property_value')set

setxpcenvEnvironment Property DescriptionCDBootImageLocationLocation of cdboot.i so file for creation of CD target bootdisk.CompilerPathValue is a val

setxpcenvEnvironment Property DescriptionMaxModelSizeBootFloppy and DOSLoader modes ignore this value.Values are'1MB', '4 MB',and&

setxpcenvEnvironment Property DescriptionRS232HostPortValues are 'COM1' and 'COM2'.From the xPC Target Explorer window Host port l

setxpcenvEnvironment Property DescriptionTargetRAMSizeMBValues are 'Auto' and 'Manual'.From the xPC Target Explorer window Target

2 Targets and Scopes in the MATLAB®Interface% Save the data.t( end + 1 : end + 500) = sc(scNum).Time;data(end + 1 : end + 500, :) = sc( scNu m).Data;%

setxpcenvEnvironment Property DescriptionTcpIpGatewayValue is 'xxx.xxx.xxx.xxx'.In the xPC Target E xplo rer window TcpIp gatewayaddress box

setxpcenvEnvironment Property DescriptionTcpIpTargetBusTypeValues are 'PCI' and 'ISA'.From the xPC Target Explorer window TcpIp ta

setxpcenvEnvironment Property DescriptionTcpIpTargetISAIRQValue is 'n',wheren is between 4 and 15.If you are using an ISA bus Ethernet card,

setxpcenvUsing the function set xpce nv w ithout arguments returns a list ofallowed property values in the MATLAB window.Examples List the current env

star t (scope object)Purpose Start execution of scope on target PCSyntax MATLAB command linestart(scope_object_vector)scope_object_vector.start+scope_

start (scope object)Examples Start one scope with the scope object sc1.sc1 = getscope(tg,1) or sc1 = tg.getscope(1)start(sc1) or sc1.start or +sc1or t

star t (target application object)Purpose Start execution of target application on target PCSyntax MATLAB command linestart(target_object)target_objec

stop (scope object)Purpose Stop ex ecution of scope on target PCSyntax MATLAB command linestop(scope_object_vector)scope_object.stop-scope_objectstop(

stop (scope object)allscopes = getscope(tg) or allscopes = tg.getscope.stop(allscopes) or allscopes.stop or -allscopesor typestop(getscope(tg)) or sto

stop (target application object)Purpose Stop execution of target application on target P CSyntax MATLAB command linestop(target_object)target_object.s

Working with Scope Objectsstart(tg);% Star t things off by triggering scope 1.scNum = 1;sc(scNum).trigger;% Use the two scopes as a double buffer to l

tar getpingPurpose Test communication between host and target computersSyntax MATLAB command linetargetping(target_object)target_object.targetpingArgu

triggerPurpose Software-trigger start of data acquisition for scope(s)Syntax MATLAB command linetrigger(scope_object_vector) or scope_object_vector.tr

triggerallscopes.triggermode = 'software'allscopes.start or start(allscopes) or +allscopesallscopes.trigger or trigger(allscopes)18-148

unloadPurpose Remove current target application from target P CSyntax MATLAB command lineunload(target_object)target_object.unloadArgumentstarget_obje

updatexpcenvPurpose Change current environment properties to n ew propertiesSyntax MATLAB command lineupdatexpcenvDescription Function to update envir

xpcPurpose Call target object cons tructor, xpctarget.xpcSee Also xpctarget.xpc18-151

xpcbootdiskPurpose Create xPC Target boo t disk or DO S Loader files and confirm currentenvironment p ropertiesSyntax MATLAB command linexpcbootdiskDe

xpcbootdiskExamples To create a boot floppy disk, in the MATLAB window, type:xpcbootdiskSee Also The xPC Target functions setxpcenv, getxpcenv,andupda

xpcbytes2filePurpose Generate file suitable for use by From File blockSyntax xpcbytes2file(filename, var1, ...,varn)ArgumentsfilenameNameofthedatafile

xpcexplrPurpose Open xPC Target ExplorerSyntax MATLAB command linexpcexplrDescription This graphical user interface (GU I) allows you to• Manage an xP

2 Targets and Scopes in the MATLAB®Interface2-24

xpcnetbootPurpose Create kernel to boot target PC ov er dedicated networkSyntax MATLAB command linexpcnetbootxpcnetboot targetPCnameArgumentstargetPCN

xpctarget.fsPurpose Create xPC Target file system objectSyntax MATLAB command linefilesys_object = xpctarget.fs('mode', 'arg1', &a

xpctarget.fsfilesys_object=xpctarget.fsIf you have multiple target PCs in your system, or if you want toidentify a target PC with the file system obje

xpctarget.ftpPurpose Create xPC Target FTP objectSyntax MATLAB command linefile_object = xpctarget.ftp('mode', 'arg1', 'arg2&

xpctarget.ftpIf you have multiple target PCs in your system, or if you want toidentify a target PC with the file object, use the following syntax tocr

xpctarget.targetsPurpose Create container object to manage target PC environment collectionobjectsSyntax MATLAB command lineenv_collection_object = xp

xpctarget.targetsMethodDescriptionmakeDefault (envcollection object)Set target PC environment collectionobject as default.Remove (env collectionobject

xpctarget.targetstgs =xpctarget.targetst = xpctarget.xpcSee Also xPC Target methods get (env collectio n object) and set (envcollection object)18-163

xpctarget.xpcPurpose Create target object representing target applicationSyntax MATLAB command linetarget_object = xpctarget.xpc('mode', &ap

xpctarget.xpcDescription Constructor of a target object. The target object represents the targetapplication and target PC. You make changes to the tar

3Signals and ParametersChanging parameters in your target application while it is running in realtime, and checking the results by viewing signal d at

xpctarget.xpctg1=xpctarget.xpc('RS232','COM1','115200')xPC ObjectConnected = YesApplication = loaderIf y ou have an xPC

xpctargetpingPurpose Test communication between host and target PCsSyntax MATLAB command linexpctargetpingxpctargetping('mode', 'arg1&a

xpctargetpingIf you have multiple target PCs in your system, use the following syntaxto identify the target PC to ping.xpctargetping('mode',

xpctar getspyPurpose Open Real-Time xPC Target Spy window o n host PCSyntax MATLAB command linexpctargetspyxpctargetspy(target_object)xpctargetspy(&ap

xpctargetspyThe behavio r of this function depends on the value for the environmentpropertyTargetScope:• IfTargetScope is enabled, a single graphics s

xpctestPurpose Test xPC Target installationSyntax MATLAB command linexpctestxpctest('target_name')xpctest('-noreboot')xpctest(&apo

xpctestxpctest('target_name') runs the tests on the target PC identifiedby'target_name'.xpctest('target_name', 'reb

xpcwwwenablePurpose Disconnect target PC from current client applicationSyntax MATLAB command linexpcwwwenablexpcwwwenable('target_obj_name'

xpcwwwenable18-174

19Configuration Parameters

ContentsTarget and Scope Objects1Target Objects ... 1-2What Is a Target Object?... 1-2Scope

3 Signals and ParametersMonitoring SignalsIn this section...“Introduction” on page 3-2“Signal Monitoring with xPC Target Exp lorer” on page 3-2“Signal

19 Configuration ParametersxPC Target options Pane19-2

xPC Target o ptio ns PaneIn this section...“xPC Target options Overview” on page 19-4“Include model hierarchy on the target application” on page 19-27

19 Configuration ParametersxPC Target options OverviewSet up general information about building target applications, includingtarget, execution, data

xPC Target o ptio ns PaneAutomatically download application after buildingEnable Real-Time Workshop t o build and download the target applicationto th

19 Configuration ParametersDownload to default target PCDirect Real-Time Workshop to download the target application to the defaulttarget PC.SettingsD

xPC Target o ptio ns PaneSpecify target PC nameSpecify a target PC name for your target application.Settings''TipThe target PC name appears

19 Configuration ParametersName of xPC Target object created by build processEnter the name of the target object created by the build process.Settings

xPC Target o ptio ns PaneUse default commun ication t imeoutDirect xPC Target software to wait 5 (default) seconds for the targetapplicationtobedownlo

19 Configuration ParametersSpecify the communication timeout in secondsSpecify a timeout, in seconds, to wait for the target application to downloadto

xPC Target o ptio ns PaneExecution modeSpecify target application execution mode.SettingsDefault: Real-TimeReal-TimeExecutes target application in rea

Monitoring Signals1 If xPC Target Explorer is not started, start it now. In xPC TargetExplorer, select the no de of the running target application in

19 Configuration ParametersReal-time interrupt sourceSelect a real-time interrupt source from the I/O board.SettingsDefault: TimerTimerSpecifies that

xPC Target o ptio ns PaneI/O board generating the interruptSpecify the board interrupt source.SettingsDefault: None/OtherNone/OtherSpecifies that the

19 Configuration ParametersSBS_25x0_ID_0x101Specifies that the interrupt source is an SBS Technologies sharedmemory board associated with ID 0x 1 01 .

xPC Target o ptio ns Pane'SBS_25x0_ID_0x100' |'SBS_25x0_ID_0x101' |'SBS_25x0_ID_0x102' |'SBS_25x0_ID_0x103' |&

19 Configuration ParametersPCI slot (-1: autosearch) or ISA base addressEnter the slot number or base address for the I/O board generating theinterrup

xPC Target o ptio ns PaneAllow tasks to execute concurrentlyEnables multirate models to take advantage of t arget PCs that have multicoreprocessors.Se

19 Configuration ParametersValue: 'on' | 'off'Default: 'off'See AlsoxPC Target O ptions“Automatically handle rate transi

xPC Target o ptio ns PaneLog Task Execution TimeLog task execution times to the target object propertytg.TETlog.SettingsDefault: onOnLogs task executi

19 Configuration ParametersDouble buffer parameter changesUse a double buffer for parameter tuning. This enables parameter tuningso that the process o

xPC Target o ptio ns PaneLoad a parameter set from a file on the designatedtarg et file systemLoad a parameter set from a file on the designated targe

3 Signals and ParametersThe model hierarchy expands to show the Simulink objects (signals andparameters) in the Simulink model.3-4

19 Configuration ParametersFile nameSpecify the target PC file name from which to load the parameter set.Settings''TipIf the named file does

xPC Target o ptio ns PaneSignal logging data buffer size in doublesEnterthemaximumnumberofsamplepointstosavebeforewrapping.SettingsDefault: 100000Them

19 Configuration ParametersDefault: '100000'See AlsoxPC Target O ptions19-24

xPC Target o ptio ns PaneBuild COM objects from tagged signals/parametersEnable build process to create a model-specific COM library file.SettingsDefa

19 Configuration ParametersGenerate CANape extensionsEnable targ et a pplications to generate data, such as that for A2L, for VectorCANape.SettingsDef

xPC Target o ptio ns PaneInclude model hierarchy on the target applicationIncludes the Simulink model hierarchy as part of the target application .Set

19 Configuration ParametersEnable Stateflow AnimationEnables visualization of Stateflow chart animation.SettingsDefault: offOnEnables visualization of

IndexIndexAapplication parameterssaving and reloading 3-76applicationswith DOSLoader mode 4-4with Standalone mode 5-9Bblock paramete rsparameter tunin

IndexxPC Target Explorer 6-3environment collection objectstarget PC 7-2environment propertiesand Standalone mode 5-9changing through CLI 6-7changing t

Indexwith MATLAB 3-70with Simulink e xternal mode 3-73parameterschanging with commands 3-70inlining 3-79tuning with external mode 3-73tuning with MATL

Monitoring SignalsThe Model Hierarchy node can have the following types of nodes:IconsNodesSubsystems , includ i ng th eir sign a ls and paramete rRef

Indexsignal properties 3-9target PCcommand-line interface 8-1copying files withxpctarget.ftp 9-8disk information retrieval withxpctarget.fs 9-16enviro

Indexusing xPC Target setup window 6-2WWeb browser 3-55connecting 11-2parameter tuning 3-76signal logging 3-64XxPC Targetfrequently asked questions 15

3 Signals and Parameterse Re-expand the Model Hierarchy node to see the labeled signals.To view the block path for a la beled signal, hover over the l

Monitoring SignalsNote When work in g with signal labels:• Signal labels must be unique.• xPC Target software ignores signal labels in referenced mode

3 Signals and ParametersThe value of the signal is shown in the right pane.7 Right-click the target application and select Start.The application start

Monitoring Signals9 Enter the signal format. Use one of the following. By default, the format is%0.25g.Type Description%e or %EExponential format usin

3 Signals and ParametersThelattercommandcausestheMATLABwindowtodisplayalistofthetarget object properties for the available signals. For example, the s

Monitoring SignalsThe Configuration P arameters dialog box is displayed for the model.3 Click the Real-Time Workshop node.The Real-Time Workshop pane

Signals and Parameters3Monitoring Signals ... 3-2Introduction... 3-2Signal Monitoring

3 Signals and Parameters7 In the old_sf_car model, double-click the shift_logic chart.Theshift_logic chart is displayed .8 In the chart, click Tools &

Monitoring Signals13 Click Apply.14 Bu ild and download the old_sf_car target application to the target PC.You can now view t h e states w i th xPC T

3 Signals and ParametersMonitoring Stateflow States with the MATLAB InterfaceThis topic assumes that you have already set Stateflow states as test po

Monitoring Signals1 En sure that the model is in S i mulink extern al mode.2 In the Simulink window, from the Simulation m enu, click ConfigurationPar

3 Signals and ParametersSignal TracingIn this section...“Introduction” on page 3-16“Signal Tracing with xPC Target Explorer” on page 3-16“Signal Traci

Signal Tracing• “Software Triggering Scopes” on page 3-29• “Configuring the Host Scope Viewer” on page 3-31• “Acquiring Signal Data into Multiple, Dyn

3 Signals and ParametersThe model hierarchy expands to show the elements in the Simulink model.3 To get the list of scope types you ca n have in the t

Signal Tracing4 TocreateascopetodisplayonthetargetPC,right-clicktheTarget Scopesnode under the xPC Scopes node.A context menu appears. This lists the

3 Signals and ParametersYou can add other scopes, including those of typehost and file.Note,youcan add as manyfile and host scopes as you want. as lon

Signal Tracing9 Select View Scopes.The xPC Target Host Scope Viewer window appears. Note that the signalsyou add to the scope will appear at the top r

Booting from a DOS Device4DOSLoader Mode ... 4-2Introduction... 4-2DOSLoader Mode Se

3 Signals and Parameters11 To create a scope to acquire signal data into a file o n the target P C filesystem, right-click theFile Scopes node under t

Signal Tracing12 If you want to specify a different folder or filename, select the scope.The scope property pane is displayed. In the File name field,

3 Signals and ParametersYour next task is to add signals to the scopes. The following procedureassumes that you have added scopes to the target PC and

Signal Tracing3 Start the scope. For exa mple, to startScope 1, rig ht-click it an d sele c tStart.3-25

3 Signals and ParametersThe target screen plots the signals after collecting each data package.During this time, you can observe the behavior of the s

Signal Tracing6 Start the scope. For example, to start the scope Scope 2, right-click Scope2 in theHost Scopes node of the xPC Target Explorer and se

3 Signals and Parameters7 Add signals to the scope of type fil e. For example, to add signalsIntegrator1 and Signal Generator, right-cli ck each signa

Signal TracingThe signals shown on the target PC stop updating while the targetapplication continues running, and the target PC displays the following

3 Signals and Parameters2 From the Trigger mode list, select Software.ClickApply.3 Start the scope and target application.4 Observethatthescopehasnopl

Signal TracingConfiguring the Host Scope ViewerYou can customize your host scope viewer. This section assumes thatyou have added a host scope to your

Software Environment and Demos6Usin g Environment Properties and Functions...6-2Introduction... 6-2Getting a L

3 Signals and Parametersof type file to that application. You can then configure that scope to logsignal data to multiple files. This section assumes

Signal Tracing6 To enablethefilescopetocreatemultiplelogfileswiththesamenamepattern, in the File name box, en ter a name likefile_<%>.dat.This s

3 Signals and Parameters7 Select the Enable auto restart check box. The Enable file autoincrement check box is enabled.8 Select the Enable file au to

Signal TracingYou can enable the creation of up to 99999999 files (<%%%%%%%%>.da t). Thelength of a file name, including the specifier, cannot e

3 Signals and Parameters6 Select Save to Host PC.A browser dialog box is displayed.7 Ch oose the folder to contain the signal data file. If you want,

Signal Tracingcreated a s cope of type file that contains signal data (see “Adding Signals toScopes” on page 3-24).1 In xPC Ta rge t Explorer, e xpand

3 Signals and ParametersYou can examine and otherwise m anipulate the data. You can also plot thedata withplot(sig_integ.data). This is an alternate m

Signal TracingA Save Target Session as dialog box is displayed.4 As necessary, browse to the desired folderandenterauniquename. Forexample,xpcsession1

3 Signals and ParametersA Load Target Session as dialog box is displayed.4 As necessary, browse to the desired folde r and select the session you arei

Signal Tracingfunctions instead of using the xPC Target graphical user interface. Thisprocedure assumes that you have assignedtg to the appropriate ta

Introduction ... 8-2Using Target Application Methods on the Target PC... 8-2Manipulating Target Object Properties

3 Signals and Parameterstg.ShowSignals='on'The MATLAB window displays a list of the target object properties forthe available signals. For e

Signal TracingNumSamples = 250NumPrePostSamples = 0Decimation = 1TriggerMode = FreeRunTriggerSignal = -1TriggerLevel = 0.0000 00TriggerSlope = EitherT

3 Signals and ParametersThe target screen plots the signals after collecting each data package.During this time, you can observe the behavior of the s

Signal TracingSignal Tracing with the MATLAB Inter face and File ScopesThis procedure uses the Simulink model xpcosc.mdl as an example, andassumes you

3 Signals and Parameters3 Start running your target application. Type+tgortg.startorstart(tg)The t arget PC displ ays the following message:System: ex

Signal TracingTriggerScope = 2TriggerSample = 0TriggerSignal = -1TriggerLevel = 0.0000 00TriggerSlope = EitherShowSignals = offFileName = unsetMode =

3 Signals and Parametersorstart(sc2)The MATLAB window displays a list of the scope object properties. N oticethatFileName is assigned a defau lt fi le

Signal Tracingstop(sc2)9 Stop the target application. In the MATLAB window, type-tgortg.stoporstop(tg)The target application on the target PC stops ru

3 Signals and ParametersNote If your model has the output of a Mu x block connected to the input ofan xPC Target Scope block, the signal might not b e

Signal TracingIf you want the same data fo r the same signals on the host PC while the datais displayed on the target PC , you need to define a second