LabVIEW 8.6 Statechart Module Readme

June 2008

This file contains the following information about the LabVIEW 8.6 Statechart Module.

New Features

System Requirements

Installation Instructions

Accessing the Help

Known Issues

Bug Fixes

New Features

The LabVIEW 8.6 Statechart Module includes the following new features.

Changing Function Icon Styles

You can change the icon style of a Statechart Communication function on the block diagram. You can right-click a Statechart Communication function and select Icon Style»Custom Icon to display the function with the custom icon of the statechart diagram. You also can right-click a Statechart Communication function and select Icon Style»Configuration to display the function with a list of configuration information.

Displaying the Name of the Current Active State

You can configure the Run Statechart function to display the name of the current active state. Right-click the Run Statechart function and select Configure from the shortcut menu to display the Configure dialog box. The Statechart Active States option specifies to display the name of the current active state.

Displaying Current Active States for Diagrams

You can configure the Run Statechart function to display current active states for diagrams. Right-click the Run Statechart function and select Configure from the shortcut menu to display the Configure dialog box. The Statechart Diagram Display option specifies to display current active states for diagrams. You can choose to display current active states for one diagram, N diagrams, or all diagrams.

Debugging Statecharts on Real-Time Targets

You now can debug statecharts on real-time (RT) targets. Right-click a Run Statechart function and select Debug Statechart to debug a statechart on an RT target. This action is valid only when you have linked the Run Statechart function to a statechart. By default, statechart debugging on RT targets is disabled. You can enable statechart debugging on RT targets by using the Statechart Code Generation page. Enabling statechart debugging on RT targets might increase the code size of the statechart.

Viewing State Configuration in the Context Help Window

You can move the cursor over a state to view the state configuration in the Context Help window. The Context Help window displays the entry action, exit action, and static reactions of the state.

Saving Statecharts for a Previous Version of LabVIEW

You can save a statechart for a previous version of LabVIEW. Select File»Save for Previous Version in the Project Explorer window to display the Save for Previous Version dialog box. Select the version of LabVIEW and save the statechart.

Generating Statechart Code from the Project Explorer Window

You can generate LabVIEW code for a statechart from the Project Explorer window. After you create or update a statechart, right-click the .lvsc file in the Project Explorer window and select Generate LabVIEW Code from the shortcut menu to generate LabVIEW code that corresponds to the statechart.

Using the View Option of the Statechart Communication Functions

In the caller VI, right-click a Statechart Communication function and select View»Statechart to display the Project Explorer window that contains the .lvsc file. Right-click the Statechart Communication function and select View»Statechart Diagram to display the Statechart Editor window.

Deselecting All Triggers

Deselecting all triggers enables a transition or static reaction to react to any triggers in the Triggers list and to any new triggers that you create. You can deselect all triggers by clicking the Deselect All Triggers button in the Triggers/Groups page of the Configure Transition dialog box or Configure State dialog box.

Using New Statechart Module Examples

Refer to the labview\examples\Statechart\ directory for example VIs that demonstrate common tasks and concepts using the LabVIEW Statechart Module. You also can access these VIs by selecting Help»Find Examples and selecting Toolkits and Modules»Statechart in the NI Example Finder window.

System Requirements

Installation Instructions

You can install all of your LabVIEW products—including LabVIEW and the Statechart Module—using the LabVIEW 8.6 Platform DVDs. Refer to the LabVIEW DVD Installation Instructions or the LabVIEW Release Notes, which are available in your LabVIEW box, for information about the LabVIEW Platform DVDs.

Complete the following steps to install the Statechart Module from the LabVIEW 8.6 Statechart Module installation CD.

Note  Some virus detection programs interfere with the installer. Disable any automatic virus detection programs before you install. After installation, check your computer for viruses and enable any virus detection programs you disabled.

  1. Log on as an administrator or as a user with administrator privileges.
  2. Insert the LabVIEW 8.6 Statechart Module installation CD and follow the instructions that appear on the screen.
  3. Activate your LabVIEW products using the NI License Manager.

Accessing the Help

The LabVIEW Statechart Module Help contains conceptual, how-to, and reference information about the Statechart Module. Complete the following steps to access this help file.

  1. Launch LabVIEW.
  2. Select Help»Search the LabVIEW Help to launch the LabVIEW Help.
  3. Click the Contents tab.
  4. Navigate to the Statechart Module top-level topic.

Known Issues

The following items are known issues in the LabVIEW 8.6 Statechart Module.

IDKnown Issue
91194Using LabVIEW Statecharts without the LabVIEW Statechart Module Installed
The creation and usage of LabVIEW statecharts and VIs that call them requires the installation of the LabVIEW Statechart Module. If you create such statecharts and calling VIs and then try to open them in a LabVIEW installation without the Statechart Module present, you will encounter search dialogs and broken calling VIs.

Workaround—Create and build a Source Distribution from a LabVIEW installation with the Statechart Module present. You can then use the output of this Source Distribution, instead of the original Statecharts and calling VIs, in a LabVIEW installation without the Statechart Module present.
91443Statecharts with unsaved library items fail cross-context sync
If you are working with a statechart that is located in certain symbolic paths, such as <vilib> or <userlib>, in multiple contexts at the same time, and you view a state as a subdiagram, LabVIEW might not find the subdiagram in some contexts. In this situation, LabVIEW might show search dialogs. Additionally, saving a statechart when the statechart cannot find a subdiagram might corrupt the statechart file on disk.

Workaround—Either save the statechart in a non-symbolic directory, or save the statechart immediately after you view a state as a subdiagram.
91500Statechart library file cannot do auto save
LabVIEW does not save statechart .lvsc files automatically for recovery.

Workaround—National Instruments recommends saving .lvsc files frequently as you work on them.
91918Revert is not available on statecharts

Workaround—If you want to discard changes you have made to a statechart, close the statechart and all callers and do not save the changes, then reopen the statechart.
92421Data display has stale data for internal trigger queue
The statechart data display and custom data display update only after the statechart executes a transition action. Therefore, these tools might show the internal trigger queue as having a trigger that has been removed from the queue already.
100185Replacing a block diagram constant when configuring a statechart state node or transition node may not delete the original block diagram constant
Replacing a block diagram constant with the Select a VI option in the Configure State or Configure Transition dialog box may not delete original block diagram constant.

Workaround—You can delete original block diagram constants manually.
100729Unexpected searching may occur when saving Statechart Communication functions to a previous LabVIEW version
You may see unexpected search dialogs when saving VIs with Statechart Communication functions to a previous LabVIEW version, but the operation will still complete successfully.
101248Building a build specification may fail if it uses statecharts or their callers last saved in LabVIEW 8.5

Workaround—Save your statecharts and their callers in the current version of LabVIEW before attempting to build.
104376Quick Drop does not work when configuring a Statechart state node or transition node
The Quick Drop feature does not work in the Configure Transition and Configure State dialog boxes.

Bug Fixes

The following items are the IDs and titles of a subset of issues fixed in the LabVIEW 8.6 Statechart Module. If you have a CAR ID, you can search this list to validate that the issue has been fixed. This is not an exhaustive list of issues fixed in the current version of the Statechart Module.

Bug IDFixed Issue
52190The edit triggers dialog should give feedback about non-valid groups so the user knows why the OK button is disabled.
57043When a statechart pauses because of a breakpoint or custom data display, it should flash its debugging window like we do when we hit a traditional VI breakpoint.
57207Wiring from the tip of a transition node is difficult.
57685Statechart does not generate code correctly if Trigger name has dual byte characters.
57692Save changes dialog for .lvsc file should show changes for all pieces of the statechart.
57807State nodes sometimes cannot be resized to be as small as desired.
57874Cannot correctly debug a statechart when its calling VI is running in two different application instances at the same time.
57916Subdiagram still shows up in error list window even after deleting its state node.
58375Statechart typedefs should not throw save changes dialog when closed unless statechart is leaving memory as a result of the operation.
58379Cannot edit statechart typedefs while configuring a state or transition node.
58426A new statechart on a non-desktop target should automatically have code generation settings appropriate for that target.
58480Need to show pictorially the current active state of the Statechart.
58664Context help for a statechart state node should show more information about the actions a state contains.
63095Renaming a .lvsc file on disk does not work.
63208Creating a constant from an input to a statechart guard or action VI places the constant off screen.
63425Easy to confuse statechart editing and debugging windows.
64013VI properties on statechart diagram should show .lvsc file properties.
64382Slowness when generating code for a statechart with many guard and action VIs.
65597Should be able to drop a statechart on a block diagram in all the ways you can drop a subVI on a block diagram.
72668Execution highlighting in statechart debugging window could be clearer.
94777After stepping out of subdiagram during statechart debugging, pause button on subdiagram does not stop execution.
94781Can press execution step buttons while debugging statechart but not paused.
94985Hang when replacing a string constant with an empty string in statechart state or transition configuration dialog.
97915Send External Trigger node slowly leaks memory.
103001Pause button highlighted on statechart debugging window does not always cause execution to be paused.
103002Statechart debugging window should come to front and flash when statechart next runs if debugging window has pause button enabled.

Copyright

© 2008 National Instruments Corporation. All rights reserved.

Under the copyright laws, this publication may not be reproduced or transmitted in any form, electronic or mechanical, including photocopying, recording, storing in an information retrieval system, or translating, in whole or in part, without the prior written consent of National Instruments Corporation.

Trademarks

National Instruments, NI, ni.com, and LabVIEW are trademarks of National Instruments Corporation. Refer to the Terms of Use section on ni.com/legal for more information about National Instruments trademarks.

Other product and company names mentioned herein are trademarks or trade names of their respective companies.

Patents

For patents covering the National Instruments products, refer to the appropriate location: Help»Patents in your software, the patents.txt file on your CD, or ni.com/patents.