User manual MATLAB REAL-TIME WINDOWS TARGET 3

[. . . ] Real-Time Windows TargetTM 3 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. Real-Time Windows 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. [. . . ] After you enter parameters into the Configuration Parameters dialog box for use by the Real-Time Workshop code generation software, you can build a real-time application. This procedure uses the Simulink model rtwin_model. mdl as an example, and assumes you have loaded that model: 1 In the Simulink window, from the Tools menu, point to Real-Time Workshop, and then click Build Model. The build process does the following: · The Real-Time Workshop code generation software creates the C code source files rtwin_model. c and rtwin_model. h. 3-19 3 Basic Procedures · The make utility make_rtw. exe creates the makefile rtwin_model. mk from the template makefile rtwin. tmf. · The make utility make_rtw. exe builds the real-time application rtwin_model. rwd using the makefile rtwin_model. mk created above. The file rtwin_model. rwd is a binary file that we refer to as your real-time application. You can run the real-time application with the Real-Time Windows Target kernel. 2 Connect your Simulink model to your real-time application. See "Entering Additional Scope Parameters for Signal Tracing" on page 3-20. After you create a real-time application, you can exit the MATLAB environment, start the MATLAB environment again, and then connect and run the executable without having to rebuild. Entering Additional Scope Parameters for Signal Tracing Simulink external mode connects your Simulink model to your real-time application. This connection allows you to use the Simulink block diagram as a graphical user interface to your real-time application. After you have created a real-time application, you can enter scope parameters for signal tracing with Simulink external mode: 1 In the Simulation window, and from the Simulation menu, click Configuration Parameters. 2 Select the Real-Time Windows Target node. The Real-Time Windows Target pane opens. 3 Select the External mode check box. The MEX-file name label should have an entry of rtwinext. The MEX-file rtwinext. mex* is supplied with the Real-Time Windows Target software to work with Simulink external mode and support uploading signal data and downloading parameter values. The Real-Time Windows Target pane should appear as follows. 3-20 Using Real-Time Applications 4 Click OK. 5 In the Simulation window, and from the Tools menu, click External Mode Control Panel. The External Mode Control Panel dialog box opens. 3-21 3 Basic Procedures 6 Click the Signal & Triggering button. The External Signal & Triggering dialog box opens. 7 Select the Select all check box. From the Source list, choose manual. From the Mode list, choose normal. The X under Signal selection indicates that a signal is tagged for data collection, and T indicates that the signal is tagged as a trigger signal. 8 In the Duration field, enter the number of sample points in a data buffer. For example, to specify a sample rate of 1000 samples/second and a stop time of 10 seconds, enter 10001 9 Select the Arm when connecting to target check box. If you do not select this check box, data is not displayed in the Scope window. The External Signal & Triggering dialog box looks like this: 3-22 Using Real-Time Applications 10 Do one of the following: · Click Apply to apply the changes to your model and leave the dialog box open. · Click Close to apply the changes to your model and close the dialog box. You must click the Apply or Close button on the External Signal & Triggering dialog box for the changes you made to take effect. Generally it is not necessary to rebuild your real-time application. Running a Real-Time Application You run your real-time application to observe the behavior of your model in real time with the generated code. The process of connecting consists of · Establishing a connection between your Simulink model and the kernel to allow exchange of commands, parameters, and logged data. After you build the real-time application, you can run your model in real time. [. . . ] For example, initially select a sample time of 0. 01 second, and confirm that your system runs correctly and plots are displayed. After you have found an application sample time that gives acceptable Scope block display, again type rtwho and check MATLAB performance. If MATLAB performance is in the range of 98% or so, consider decreasing your sample time by one order of magnitude. After such a change, any previously correct I/O driver sample times remain correct, because they are integer multiples of the new application sample time. 5-6 S-Functions Using Math Functions S-Functions Using Math Functions Possible problem -- When you create your own S-functions that include math functions, the S-functions compile, but you cannot build the application. [. . . ]