LabVIEW 8.2.1 Touch Panel Module for Windows CE Readme

February 2007

This file contains new features and known issues about the LabVIEW 8.2.1 Touch Panel Module.

Refer to the LabVIEW 8.2.1 Readme, available by selecting Start»All Programs»National Instruments»LabVIEW 8.2»Readme and opening readme.html, for LabVIEW known issues.

New Targets in 8.2.1
Installing Shared Variable and PNG Support
Installation Known Issues
General Known Issues
Windows Vista Known Issues
User Interface Known Issues
VIs and Functions Known Issues
Documentation Known Issues
Changes from 8.2
Resources
LabVIEW 8.2 PDA Module for Windows Mobile and Touch Panel Module for Windows CE Readme

New Targets in 8.2.1

Version 8.2.1 of the Touch Panel Module includes the following targets:

Target	Processor	Version Added	Use
NI TPC-2006	ARM	8.2.1	Use with NI TPC-2006 hardware
NI TPC-2012	x86	8.2.1	Use with NI TPC-2012 hardware
NI TPC-2106	ARM	8.2.1	Use with NI TPC-2106 hardware
Touch Panel Windows CE 4.2 Device	ARM	8.2	Use with third-party touch panel computers running Windows CE 4.2
TOUCH PANEL WINDOWS CE 4.2 Device	ARM or x86	8.2	Use with third-party touch panel computers running Windows CE 4.2
Touch Panel Windows CE 5.0 Device	ARM (8.2, 8.2.1) or x86 (8.2.1 only)	8.2	Use with third-party touch panel computers running Windows CE 5.0

If you are using the x86 TOUCH PANEL WINDOWS CE 4.2 Device Touch Panel target, you must manually download and install the eMbedded Visual Tools and Pocket PC 2003 SDK. Refer to KnowledgeBase 45BE6367: Where Can I Find the Microsoft Tools I Need for the LabVIEW Touch Panel Module? on ni.com for information about how to download and install these tools.
Existing Touch Panel targets from version 8.2 are forward-compatible with version 8.2.1, but new Touch Panel targets are not backward-compatible with version 8.2 of the Touch Panel Module.
New portrait and landscape templates have been added for 12" Touch Panel targets.

Installing Shared Variable and PNG Support

If you are using NI TPC-2012 or NI TPC-2106 hardware, you do not have to manually install shared variable or PNG support because the hardware already contains the necessary files.

Installation Known Issues

The Touch Panel Module installs Microsoft ActiveSync 4.2. You might receive a Microsoft Office Outlook error that states Either there is no default mail client or the current mail client cannot fulfill the messaging request. Please run Microsoft Office Outlook and set it as the default mail client. You do not need to install Microsoft Outlook nor does Outlook have to be your default mail client. Click the OK button to continue installation.
(Windows 2000) The Touch Panel Module automatically installs ActiveSync 4.2 if ActiveSync is not already installed. When you install version 8.2.1 of the Touch Panel Module and do not already have ActiveSync, the installer automatically reboots the computer without alerting you. To resolve this issue, rerun the installer (setup.exe) to complete the installation or install ActiveSync before you install the Touch Panel Module.

General Known Issues

If you use refnums in a cluster and try to build the Touch Panel VI into a Touch Panel application using the debug mode, you receive a run-time error or LabVIEW crashes. To resolve this issue, build the application using release mode.
You receive an error when you build a Touch Panel VI into a Touch Panel application if the top-level VI is in a library. To resolve this issue, move the top-level VI out of a library.
ActiveSync is the default transport protocol in version 8.2.1 of the Touch Panel Module. NI TPC-2012 does not support ActiveSync, so you must use FTP to download your Touch Panel application to the NI TPC-2012.
The NI TPC-2006 does not support .wav files.
When you convert a double-precision, floating-point numeric control to a Boolean array and create an indicator for the array, the Boolean indicator does not work if the data must be coerced. To resolve this issue, convert the value of the double-precision, floating-point numeric control to an integer before you convert it to a Boolean array.
DAQmx Base task constants are not supported. To resolve this issue, use a string control.
The Touch Panel Project Wizard does not filter available Touch Panel templates based on the device.

Windows Vista Known Issues

Because the default fonts on Windows Vista are different than the default fonts on previous versions of Windows, you might notice cosmetic issues, such as overlapping or truncated text strings, in VIs and LabVIEW dialog boxes. To correct this problem, change the theme of the operating system to Windows Classic in the Theme Settings dialog box and then restart LabVIEW. Select Start»Control Panel»Appearance and Personalization and click Change the theme to display the Theme Settings dialog box. You might encounter similar cosmetic issues on Windows XP if you use large fonts.
ActiveSync has been replaced with Windows Mobile Device Center, which you must download from www.microsoft.com, in Vista.
If you install the Touch Panel Module on a computer that runs a non-English version of Vista, you might receive a Command line option syntax error. Type Command/? for Help error. Click the OK button to continue the installation.

User Interface Known Issues

The Touch Panel Module does not support the Transpose Array item on the shortcut menu of a graph or chart.
Increment and decrement buttons on numeric controls revert to gray when you build a Touch Panel VI into an application.
Scroll bars are not visible on array controls when you run the application on the target. To resolve this issue, use horizontal and vertical scroll bars or use a Property Node with the Index Values (Array) property.
You cannot hide an index array indicator in a Touch Panel application even if you hide the indicator in the VI.
Changing the size of increment and decrement buttons on numeric controls is not supported.
You cannot programmatically obtain a reference to individual controls in a cluster control. To resolve this issue, use controls outside of clusters if you want to reference them.
Scales on thermometer controls start at the top and bottom of the control rather than the fill level.
3D borders on tank indicators do not scale with the rest of the indicator when you build a Touch Panel VI into an application.
Redrawing tab controls when you switch tabs is not fast enough, so you see shadows of the old controls as LabVIEW redraws the new controls.
When you move the mouse pointer around a dial control, the needle does not always move correctly in relation to the mouse pointer.
XY graphs with multiple plots do not draw correctly.
Duplicate scales and plot legends are unsupported.
Captions and labels on type definition (typedef) controls are not supported.
Captions and labels of typedef controls are not generated. To resolve this issue for button controls, use Boolean text.
Captions are always displayed behind the control. To resolve this issue for button controls, use Boolean text.

VIs and Functions Known Issues

If you wire a cluster or arrays of integer refnums, such as menu refnums, occurrence refnums, and so on, to the number/path/refnum input in the Not A Number/Path/Refnum? function, the NaN/Path/Refnum? Boolean output always returns FALSE.
The One Button Dialog function might not display a dialog box if the message input is an empty string.
The Configuration File VIs are unsupported.

Documentation Known Issues

The Detailed Help link in the Context Help window does not open the correct topic for the Serial Compatibility VIs. To access the help for these VIs, open the LabVIEW Help by selecting Help»Search the LabVIEW Help. Click the Index tab and search for Serial Compatibility VIs.
The Structures (PDA Module, Touch Panel Module) topic in the LabVIEW Help incorrectly states you must use the pwr() function. The correct function name is pow().

Changes from 8.2

Reentrant Call Library Nodes no longer produce memory leaks. This fix improves the stability of NI-DAQmx Base applications.

LabVIEW includes extensive online and PDF documentation for new and experienced LabVIEW users. Refer to the Related Documentation section in the Getting Started with the Touch Panel Module guide for more information about LabVIEW documentation. Visit the National Instruments Web site at ni.com for software drivers and updates, a searchable KnowledgeBase, product manuals, step-by-step troubleshooting wizards, thousands of example programs, tutorials, application notes, instrument drivers, and so on. The following KnowledgeBase articles contain more information about the NI TPC targets:

KnowledgeBase 45BE6367: Where Can I Find the Microsoft Tools I Need for the LabVIEW Touch Panel Module?
KnowlegeBase 45ABJV2M: What Target Do I Select for TPC-2006, TPC-2012, and 3rd Party TPCs
KnowledgeBase 40EAE6X1: Improved Display Driver for TPC-2006 Industrial Touch Panel Computer
KnowledgeBase 402A280F: Changing the Splash Screen Logo on NI TPC-2006
KnowledgeBase 4361GBMK: Shared Variable and/or PNG Support Is Not Active After Rebooting the TPC-2006

LabVIEW 8.2 PDA Module for Windows Mobile and Touch Panel Module for Windows CE Readme

June 2006

This file contains important information about the LabVIEW 8.2 PDA Module for Windows Mobile and the LabVIEW 8.2 Touch Panel Module for Windows CE.

Refer to the LabVIEW 8.2 Readme, available by selecting Start»All Programs»National Instruments»LabVIEW 8.2»Readme and opening readme.html, for LabVIEW known issues.

General Known Issues
VIs and Functions Known Issues
Graphs and Charts Known Issues
Property Nodes and Properties Known Issues
User Interface Known Issues
Tools and Drivers
Documentation Correction
Resources

General Known Issues

Several front panel and block diagram objects behave differently when the execution target is a PDA or Touch Panel target. Refer to the PDA Module book or the Touch Panel book in the LabVIEW Help for information about different or unsupported front panel or block diagram functionality.
The PDA Module and the Touch Panel Module do not support significant digits. Use digits of precision instead.
If you flatten data that contains an extended precision or complex precision floating-point data type, the flattened data is incompatible with any other LabVIEW version or add-on except the PDA Module or the Touch Panel Module.
Any binary operation involving a dynamic data type and a non-scalar non-dynamic data type, such as a 1D array, does not work correctly.
If you copy and paste global variables, you receive a link error when you try to build the PDA or Touch Panel VI into a PDA or Touch Panel application.
When you create a VI that uses multiple global variables, do not copy controls from one global variable to another global variable. Controls copied from one global variable to another global variable result in errors when you build the PDA or Touch Panel VI into a PDA or Touch Panel application.
XON/XOFF flow control in serial communication causes a timeout if you use the Serial Compatibility VIs. This is not an issue if you use the VISA VIs and functions.
The tutorial VIs in the Getting Started with the LabVIEW PDA Module for Windows Mobile guide and the Getting Started with the LabVIEW Touch Panel Module for Windows CE guide do not work with the LabVIEW Base development system.
Windows CE, Windows Mobile, and Pocket PC 2003 operating systems do not support time resolution at the fractional level, which means that the fractional part of a timestamp is always zero. When a timestamp in a PDA or Touch Panel VI is rounded to the nearest integer, the timestamp is always rounded down to the next lowest integer. The effect of this behavior is that the Round to Nearest and Round to -Infinity functions produce the same output.
LabVIEW must rebuild a PDA or Touch Panel application every time you add a breakpoint to the block diagram. To resolve this issue, add all of the breakpoints at the same time.
LabVIEW stores colors as RGB values. Windows Mobile and Windows CE stores colors as BGR values. If you place a color box constant inside of an array or cluster constant, the colors might render incorrectly because the red and blue components are exchanged when you build a PDA or Touch Panel VI into an application. To resolve this issue, place the color box constant directly on the block diagram and use the Build Array function to create the array constant or the Bundle function to create the cluster constant that contains the color box constant. You also can place the color box constant in an array or cluster and write extra code to flip the bits so the color is represented as a BGR value instead of a RGB value.
A variant with cluster data is an empty variant when you build a PDA VI or Touch Panel VI into an application.
Any variant attributes that are clusters do not contain default data when you build a PDA VI or Touch Panel VI into an application.
PDA Module Different PDA devices have different button behaviors. Use the Button Input VIs example, located in labview\examples\PDA\PocketPC\button input, to determine and test the button behavior for a device. You also can open this example through the NI Example Finder.
Touch Panel Module The Touch Panel Project Wizard is not available from the Targets pull-down menu in the Getting Started window. Complete the following steps to open the Touch Panel Project Wizard.
1. In the Getting Started window, click New to open the New dialog box.
2. Expand Project»Project from Wizard and select Touch Panel Project.
3. Click the OK button.
PDA and Touch Panel VIs do not support the values of Z, X, or T in digital data controls and digital waveform controls. You can use values of 0, 1, L, and H.

VIs and Functions Known Issues

When you launch a PDA or Touch Panel application using the Run button, the PDA Memory Usage VI might incorrectly return Used memory (bytes). To correct this problem, stop the PDA or Touch Panel application and relaunch it using the PDA or Touch Panel device.
With the exception of the PDA Button Input VIs, you can use the PDA-specific VIs, such as the PDA Error Handler VI, in Touch Panel VIs.
Dynamic Add/Remove Signals is unsupported.
If you use the .Net Refnum, Event Callback Refnum, or Code Interface Nodes (CINs) in a PDA or Touch Panel VI, you receive an error if you try to build the VI into a PDA or Touch Panel application.
The PDA Module and the Touch Panel Module do not support paths in the Not a Number/Path/Refnum? function.
If you right-click a terminal on a Call Library Function Node to create a control or indicator, the control or indicator might have an incorrect data range for PDA and Touch Panel targets. When this happens, the data range is from 0 to 0, which renders the increment and decrement arrows nonfunctional. You must manually change the data range of the control or indicator.
You must use strict C code in Formula Nodes you use in PDA or Touch Panel VIs. However, LabVIEW does not check the C syntax in the Formula Node syntax while in edit mode. If you build a VI into a PDA or Touch Panel application that contains a Formula Node with non-strict C code, LabVIEW returns a general error.
Expression Node inputs must be a scalar value. You cannot use arrays or clusters as inputs to an Expression Node in a PDA or Touch Panel VI.
The Delay Values Express VI does not function correctly in PDA or Touch Panel VIs because maintaining state in local variables between calls to a subVI is not supported.
PDA Module The Set PDA Auto Off VI does not work on Pocket PC 2003 devices or emulators.

Graphs and Charts Known Issues

The PDA Module and the Touch Panel Module do not support plotting waveforms with more than 32,000 elements.
If you are zooming a graph or chart in a PDA or Touch Panel application and draw with the log scale, it might appear as if nothing has happened. To resolve this problem, choose a larger zoom rectangle.
Pull-down menus are not visible while a chart or graph is updating. You can place the mouse pointer on the pull-down menu to display it to make a selection.
PDA and Touch Panel VIs do not support plotting dynamic data on a waveform chart. To resolve this issue, plot dynamic data on a waveform graph.

Property Nodes and Properties Known Issues

The PDA Module and the Touch Panel Module do not support the Update Value while Typing property for string objects.
You cannot use a Property Node to set the hex display on a string control or indicator. To resolve this issue, right-click a string control or indicator and select Hex Display from the shortcut menu.

User Interface Known Issues

The 2D Boolean OK, Cancel, and Stop buttons do not support different text strings for TRUE and FALSE states.
If you place a decoration under a tab control, the decoration appears on top of the tab control when you build the PDA or Touch Panel VI into a PDA or Touch Panel application.
Labels on controls inside an array do not appear.
Scroll bars and multiline inputs/outputs are unsupported for string controls if you use the password display mode.
You must place tab controls on the front panel window so that the tabs are either fully visible on the screen or fully off of the screen. If a tab is partially visible on the front panel window, the PDA or Touch Panel application crashes when you run the application on the PDA or Touch Panel target.
PDA and Touch Panel VIs do not support transparency for dials, meters, slides, and picture controls.
You cannot hide the indexes of front panel arrays.

Tools and Drivers

You must install the VISA driver to use VISA. Select Start»All Programs»National Instruments»VISA»Windows Mobile and CE Driver Installation.
You must install the Virtual PC Network Driver to use ARM-based emulators. Download the driver from the Windows Mobile 5.0 Web site.
PDA Module Projects you created in version 8.0 of the PDA Module use the Microsoft eMbedded Visual Tools, which you had to download and install. You do not have to download and install these tools with version 8.2 of the PDA Module. However, if the eMbedded Visual Tools are not installed on the host PC, you receive a build error when you build the PDA VI into a PDA application. To resolve this problem, download and install the eMbedded Visual Tools or use a new target. In version 8.2, targets that are in all capital letters are eMbedded Visual Tools targets. If you need to download and install the eMbedded Visual Tools, visit the National Instruments Web site at ni.com/info and enter pdaevc for more information about the eMbedded Visual Tools.

Documentation Correction

The LabVIEW Help incorrectly states that you cannot use a Property Node with the Display Style property to set the display style of a string control that uses password display. You can use a Property Node with the Display Style property to change the display style of a string control.

Resources

LabVIEW includes extensive online and PDF documentation for new and experienced LabVIEW users. Refer to the Related Documentation section in the Getting Started with the PDA Module guide or the Getting Started with the Touch Panel Module guide for more information about LabVIEW documentation. Visit the National Instruments Web site at ni.com for software drivers and updates, a searchable KnowledgeBase, product manuals, step-by-step troubleshooting wizards, thousands of example programs, tutorials, application notes, instrument drivers, and so on. The following KnowledgeBase articles contain version-specific requirements. The following DevZone tutorials contain tutorials for using shared variables with the PDA Module.

KnowledgeBase 2ZTAQ5DS: Where Can I Find the Microsoft Tools I Need for the LabVIEW PDA Module?
KnowledgeBase 3ANADAKN: LabVIEW PDA Module Software Requirements and Supported Devices
DevZone Tutorial: Creating and Using Shared Variables in the LabVIEW 8.20 PDA Module
DevZone Tutorial: Using Shared Variables with a PDA Emulator in LabVIEW 8.20 PDA Module

Copyright

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.