User manual MATLAB XPC TARGET 4

[. . . ] xPC TargetTM 4 User's Guide How to Contact The MathWorks Web Newsgroup www. mathworks. com/contact_TS. html Technical Support www. mathworks. com comp. soft-sys. matlab suggest@mathworks. com bugs@mathworks. com doc@mathworks. com service@mathworks. com info@mathworks. com Product enhancement suggestions Bug reports Documentation error reports Order status, license renewals, passcodes Sales, pricing, and general information 508-647-7000 (Phone) 508-647-7001 (Fax) The MathWorks, Inc. 3 Apple Hill Drive Natick, MA 01760-2098 For contact information about worldwide offices, see the MathWorks Web site. xPC TargetTM User's Guide © COPYRIGHT 1999­2010 by The MathWorks, Inc. The software described in this document is furnished under a license agreement. The software may be used or copied only under the terms of the license agreement. [. . . ] These are optional callbacks that you can define for later projects. You do not need to specify these callbacks for this example. 14 Delete or comment out the code for these callbacks. For example, save this file as sfun_atmos. c. Do not overwrite the template file. 16 Copy the file sfun_atmos. c into your Fortran working folder, for example, xpc_fortran_test. Your next task is to compile and link the wrapper S-function. See "Compiling and Linking the Wrapper S-Function" on page 13-12. Compiling and Linking the Wrapper S-Function This topic describes how to create (compile and link) a C-MEX S-function from the sfun_atmos. c file. Before you start, ensure that the following files are in the working folder, xpc_fortran_test. You should have copied these files when you performed the steps in "Compiling Fortran Files" on page 13-7. 13-12 Step-by-Step Example of Fortran and xPC TargetTM · libifcore. lib · libifcoremd. lib · ifconsol. lib · libifportmd. lib · libifport. lib · libmmd. lib · libm. lib · libirc. lib · libmmt. lib · libifcoremt. lib · svml_disp. lib Use the mex command with a C/C++ compiler such as Microsoft Visual C/C++ Version 6. 0. This topic assumes that you have created a C-MEX wrapper S-function. See "Creating a C-MEX Wrapper S-Function" on page 13-8. Invoking the mex command requires you to compile the wrapper C file sfun_atmos. c. Be sure to link in the following: · Compiled Fortran code: sfun_atmos_sub. obj · Necessary Fortran run-time libraries to resolve external function references and the Fortran run-time environment When you are ready, mex the code. For example mex -v LINKFLAGS="$LINKFLAGS /NODEFAULTLIB:libcmt. lib libifcoremd. lib ifconsol. lib libifportmd. lib libmmd. lib libirc. lib svml_disp. lib" sfun_atmos. c sfun_atmos_sub. obj Ensure that this whole command is all on one line. This command compiles and links the sfun_atmos_sub. c file. It creates the sfun_atmos. mex file in the same folder. 13-13 13 Incorporating Fortran Code into the xPC TargetTM Environment Your next task is to validate the Fortran code and wrapper S-function. See "Validating the Fortran Code and Wrapper S-Function" on page 13-14. Validating the Fortran Code and Wrapper S-Function Validate the generated C-MEX S-function, sfun_atmos. mex. Bind the C-MEX S-function to an S-function block found in the Simulink block library. You can mask the S-function block like any other S-function block to give it a specific dialog box. This topic assumes that you have compiled and linked a wrapper S-function. See "Compiling and Linking the Wrapper S-Function" on page 13-12. The Atmosphere model example has a Simulink model associated with it. 1 In the MATLAB window, type fortran_atmos_xpc This opens the Simulink model associated with the Atmosphere model. This model includes the correct S-function block that is bound to sfun_atmos. mex. 2 Select the Simulation menu Start option to simulate the model. 3 Examine the behavior of the Atmosphere model by looking at the signals traced by the Scope block. [. . . ] In the following example, the connection with the second target computer is an RS-232 connection. 18-165 xpctarget. xpc tg1=xpctarget. xpc('RS232', 'COM1', '115200') xPC Object Connected Application = Yes = loader If you have an xPC Target Explorer target object, and you want to construct a corresponding target object in the MATLAB Command Window, use a command like the following: target_object=xpctarget. xpc('TargetPC1') See Also xPC Target methods get (target application object), set (target application object), delete, and targetping. 18-166 xpctargetping Purpose Syntax Test communication between host and target PCs MATLAB command line xpctargetping xpctargetping('mode', 'arg1', 'arg2') Arguments mode Optionally, enter the communication mode: TCPIP RS232 Enable TCP/IP connection with target PC. Enable RS-232 connection with target PC. arg1 Optionally, enter an argument based on the mode value: IP address COM port If mode is 'TCPIP', enter the IP address of the target PC. If mode is 'RS232', enter the host COM port. arg2 Optionally, enter an argument based on the mode value: Port Baud rate If mode is 'TCPIP', enter the port number for the target PC. If mode is 'RS232', enter the baud rate for the connection between the host and target PC. Description Pings the target PC from the host PC and returns either success or failed. [. . . ]