LabVIEW 2010 Simulation Interface Toolkit Help
»View Product Info
Requires: Simulation Interface Toolkit
Select Tools»SIT Connection Manager to display this dialog box.
Use this dialog box to create mappings
between a host VI
and a model and
between certain Real-Time (RT)
Series hardware and a model DLL.
You use these mappings to generate the block diagram code of a host VI or to generate
a driver VI. You also can use this dialog box to configure data logging and file playback.
This dialog box includes the following components:
- Model and Host—Use this page to access options related to the model and the execution host.
- Execution Host—Use this section to specify the location of the SIT Server.
- Simulation Environment—Specifies that the SIT Server is running on a non-RT target.
- Simulation IP Address—Specifies the IP address of the computer on which the SIT Server is running. The default value is localhost, which specifies that the SIT Server is running on the host computer.
- Real-Time Target—Specifies that the SIT Server is running on an RT target. When you select this option, the LabVIEW Simulation Interface Toolkit prompts you for the location of the model DLL.
- Driver VI on Localhost—Specifies that the SIT server is running in a driver VI on the local machine. When you select this option, the LabVIEW Simulation Interface Toolkit prompts you for the location of the model DLL.
- Target—Specifies the IP address of the RT target on which the simulation is running.
- Port—Specifies the port on which the SIT Server is running.
- Current Model or Current Model DLL—Allows you to select a model resource file. If you are connected to The MathWorks, Inc. Simulink® software, use this control to select an MDL file. If you are connected to an RT target or a driver VI, use this control
to select a previously-built model DLL.
- Project Directory—Specifies where the Simulation Interface Toolkit stores files such as data logging configurations, replay configurations, and the driver VI.
- Mappings—Use this page to configure mappings between host VI controls/indicators and model parameters/signals.
|Tip To highlight a control or indicator, right-click the control or indicator in the Current Mappings list box on the Mappings page of the SIT Connection Manager dialog box, and select Highlight Control.|
- Current Mappings—Displays a table of the current mappings between LabVIEW controls/indicators and model parameters/signals.
- Client Settings—Specifies options for how the host VI runs.
- Autoscale Controls—When you enable this control, the Simulation Interface Toolkit adjusts the range of slider and knob controls based on the value of the parameter.
- Signal Decimation—Specifies the decimation factor to apply to incoming signal data. For example, if you enter a value of 10 in this field, the Simulation Interface Toolkit probes every 10th data point instead of every data point. The default is 1, which specifies no signal decimation. Increasing the signal decimation can resolve performance issues and timing errors when running a simulation on a real-time (RT) target.
- Halt Simulation on Data Loss—Specifies that the simulation stops on data loss.
- Load Mappings from File—Loads a table of mappings from a saved text file.
- Save Mappings to File—Saves the Current Mappings table to a text file.
- Refresh—Refreshes the Current Mappings data with any new or deleted controls from the host VI.
- Remove Mapping—Removes the mapping from the selected control or indicator.
- Change Mapping—Prompts you for a new mapping for the selected control or indicator.
- Data Logging—Use this page to configure data logging options for the simulation. This tab is enabled when you specify an MDL or DLL in Current Model or Current Model DLL on the Model and Host page. Click the New button to create a new data log configuration and display the configuration page for it. The configuration page includes the following controls:
- Configuration Name—Specifies the name of this data logging configuration.
- Configuration Description—Specifies the description of this data logging configuration.
- Data Log Filename—Specifies the name of the log file. This log file resides on the execution host.
In any situation, you can enter a custom path and filename, such as C:\logs\logfile.txt, in this text box.
- If you select Real-Time Target on the Model and Host page, the log file resides in the C:\ni-rt\system\ directory.
- If you select Simulation Environment on the Model and Host page, the log file resides in the directory from which you loaded the model.
- If you select Driver VI on Localhost on the Model and Host page, the log file resides in the Project Directory.
- Samples to Log—Use this section to specify the number of samples to log.
- All Samples—Specifies that you want to log all values the simulation returns for the signals you specify in the Signals to Log section. If you select this option, the Simulation Interface Toolkit writes to the log file while the simulation runs.
- Last N Samples—Specifies that the Simulation Interface Toolkit logs only the last N values of the signals you specify in the Signals to Log section. You must enter a value in the N text box. If you select this option, the Simulation Interface Toolkit writes to the log file after the simulation stops or when you select a new log configuration.
- N—Specifies the number of values you want to log prior to the end of the simulation. The default value is 1000. If you select different decimation values for each signal, LabVIEW logs the data from the specified number of non-empty time steps. For example, if you specify a value of 50, the Simulation Interface Toolkit logs only the last 50 values of the signals you specify in the Signals to Log section.
- Logging Format—Use this section to specify the format of the log file.
|Note If you open a model that includes logging in the SDAT format, LabVIEW automatically converts the configuration to the TDMS format and alters the file extension.|
- TDMS—Specifies that the log file is a .tdms file. Refer to the NI Developer Zone for more information about the .tdms file format.
- TXT—Specifies that the log file is a tab-delimited text file.
- Halt Logging on Data Loss—Specifies that data logging stops on data loss.
- Log Data at Configuration Start—Specifies that data logging begins at the same time the configuration is made active.
- Timestamp Filename—Adds a timestamp to the name of the log file you specify in the Data Log Filename text box.
- Example Timestamped Filename—Displays the filename and format you specified.
- Edit Format—Launches the Specify Timestamp Format dialog box.
- Configuration Mappings—Use this tab to specify the signals to log.
- Signals to Log—Use this section to specify the model signals to log.
- All Connected Signals—Specifies that the Simulation Interface Toolkit logs all model signals for which you have created mappings.
- Custom List—Specifies that the Simulation Interface Toolkit logs only the signals in the Logged Signals list. Add signals from the Models Signals tree by selecting the signal and clicking the Add button or by dragging and dropping the signal.
- Find—Launches the Find dialog box. Use this dialog box to search for the signals that you want to log. To log multiple signals, press the <Ctrl> key and click each signal.
- Logged Signals—Displays the list of model signals that the Simulation Interface Toolkit logs. You also can specify how much you want to decimate the signal data in the log file. Right-click the group and select Decimation to specify the decimation value. For example, if you select a value of 10, the Simulation Interface Toolkit logs every 10th data point instead of every data point. The default value is 1, which specifies no signal decimation.
- Model Signals—Displays the list of signals included in the model. Select signals from this list and either drag and drop them into Logged Signals or click the Add button to log them.
- New Group—Adds a new group to the Logged Signals configuration tree. You can drag and drop signals between groups.
- Remove—Removes the logged signal from the Logged Signals list.
- Add—Adds the selected item in the Model Signals list to the Logged Signals list.
- File Playback—Use this page to configure file playback options for the simulation. This page is enabled after you set Execution Host to Real-Time Target or Driver VI on Localhost on the Model and Host page.
- Default Configuration—Specifies which configuration is active when the simulation starts.
- File Playback Configurations—Displays all saved file playback configurations. You can select a configuration and edit, remove, or export it.
- New—Creates a new configuration and displays the Configuration Settings tab, allowing you to set up a new file playback configuration.
- Remove—Deletes the selected file playback configuration.
- Import—Loads previously-saved file playback configuration data.
- Export—Saves the selected file playback configuration data.
- Configuration Settings—Use this tab to set up a new file playback configuration. To display the Configuration Settings tab, click the New button or double-click an item in File Playback Configurations.
- Configuration Name—Specifies the name of this playback configuration.
- Configuration Description—Specifies the description of this playback configuration.
- Playback Filename—Specifies the name of the data file to play back.
- Halt on Buffer Underflow—Specifies to stop the simulation if playback data is not available at the correct time. If you deselect this option and data is not available at the correct time, LabVIEW uses the last available data point for each channel until new data is available.
- Override Inputs at Configuration Start—Specifies to override inputs and begin data playback when the configuration is
made active. You also can start playback by clicking the Play button on the File Playback page of the Simulation Details dialog box.
- Configuration Mappings—Use this tab to map signals for the file playback.
- Model Base Time Step (s)—Specifies the base time step of the model.
- File Channel Mappings—Displays the contents of the file specified in the Playback Filename path control.
- Model Inputs—Displays the signals in the model.
- Properties—Displays the Channel Properties dialog box for the selected signal.
- Remove—Removes the mapping between the selected pair of signals.
- Add—Adds a mapping between the selected pair of signals.
- Hardware I/O—Use this page to configure mappings between RT Series hardware and a model DLL. This page is available only when you specify a Real-Time Target or Driver VI on Localhost on the Model and Host page.
- Hardware Mappings—Displays any hardware mappings you configure in the Configure HW I/O dialog box.
- Force Rebuild of Driver VI—Rebuilds the driver VI when you click the OK button to exit the SIT Connection Manager. If you have made changes, the Simulation Interface Toolkit automatically rebuilds the parts of the driver VI that have changed. This option allows you to rebuild the driver VI even if you have made no changes to it.
- Buffer Settings—Launches the Driver VI Buffer Settings dialog box.
- Configure Hardware I/O—Launches the Configure HW I/O Mappings dialog box.