NI-CAN 2.7.3 Readme

August 2011

ni.com/support

This file contains information about the NI-CAN™ driver software for Windows 7/Vista/XP and LabVIEW™ Real-Time (ETS). Information in this file is organized in the following sections:


Documentation

The CAN Hardware and NI-CAN Software for Windows Installation Guide included with the NI-CAN CD includes instructions for installing National Instruments CAN hardware and software.

The NI-CAN Hardware and Software Manual is the primary document for NI CAN products. This manual includes an introduction to CAN, specifications for hardware, information about how to get started with application development, and a complete reference for all NI-CAN functions.

The NI-CAN Hardware and Software Manual is in Adobe Acrobat Portable Document Format (PDF). You can download the Acrobat Reader for free at: www.adobe.com.

Open the manual from Start»All Programs»National Instruments»NI-CAN.

Links to the NI-CAN Hardware and Software Manual are in the online help for each NI-CAN function within the National Instruments LabVIEW and LabWindows™/CVI™ development environments.

Online help for the NI-CAN features within Measurement & Automation Explorer (MAX) is in the MAX Help Topics menu. The MAX Help Topics menu for NI-CAN also includes a link to the NI-CAN Hardware and Software Manual.

Back to Top


Supported Platforms

Supported Operating Systems

You must install and run this version of the NI-CAN software on the following operating systems:

Note:  National Instruments recommends using Service Pack 2 or newer when using the USB-847x interfaces in hyperthread or multicore CPU environments on Microsoft Windows XP.

The NI-CAN installer does not support Windows NT/Me/2000/98/95.

Supported Hardware

This version of the NI-CAN software supports the following National Instruments hardware products on Windows and LabVIEW RT:

This version of the NI-CAN software supports the following National Instruments hardware products on Windows:

Note: PCMCIA-CAN and PCMCIA-CAN/2 interfaces are not supported on the 64-bit version of Windows Vista.

Several National Instruments Series 1 CAN hardware products are not supported in this version of NI-CAN. Install NI-CAN version 2.2 for support of the following hardware products (available on ni.com):

Install NI-CAN version 2.1.3 for support of the following AT (ISA) hardware products (available on ni.com):

The NI-CAN software supports only National Instruments CAN hardware products. For information about software for CAN products from other vendors, refer to the documentation you received with those products.

Supported Development Environments

This version of the NI-CAN software supports the following development environments:

Back to Top


Installing NI-CAN 2.7.3

Before installing the NI-CAN software, log on as Administrator or as a user with Administrator privileges. The NI-CAN software setup program must have Administrator privileges because the program modifies the configuration registry of your system. Complete the following steps to install the NI-CAN software.

  1. Insert the NI-CAN software CD into your CD-ROM drive. The installer launches if your CD-ROM drive plays data CDs automatically. If the installer does not launch automatically, navigate to the CD using Windows Explorer and launch the autorun.exe file from your NI-CAN software CD.
  2. The installation wizard guides you through the necessary steps to install the NI-CAN software. You can go back and change values where appropriate by clicking the Back button. You can exit the setup where appropriate by clicking Cancel.
  3. When the installation is complete, click Finish.

Installing NI-CAN Silently

You can control programmatically which features in the NI-CAN distribution to enable or disable for installation. You therefore can install a subset of the NI-CAN distribution silently. Refer to the template_spec.txt file in the specfiles directory on the NI-CAN CD for more information about installing NI-CAN silently and selecting which features to install automatically.

Back to Top


New Features and Changes as Compared to NI-CAN 2.7.2

The NI-CAN 2.7.3 release adds the following features:

New Features and Changes as Compared to NI-CAN 2.7

The NI-CAN 2.7.2 release adds the following features:

New Features and Changes as Compared to NI-CAN 2.6.x

The NI-CAN 2.7 release adds the following features:

For more information about running NI-CAN code on NI-XNET hardware, see the NI-XNET Compatibility for NI-CAN appendix in the NI-CAN Hardware and Software Manual.

New Features and Changes as Compared to NI-CAN 2.5.x

The NI-CAN 2.6.3 release adds the following features:

The NI-CAN 2.6 release adds the following features:

The NI-CAN 2.5.1 release adds the following features:

Back to Top


Bug Fixes

The following items are the IDs and titles of a subset of issues fixed between NI-CAN 2.7.2 and NI-CAN 2.7.3. 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 NI-CAN.

Bug IDFixed Issue
251950 System hangs with ncAction Start when Log Start Trigger attribute is enabled.
282965 USB CAN modules disappear from MAX when multiple processes are executed at the same time.

The following items are the IDs and titles of a subset of issues fixed between NI-CAN 2.7.1 and NI-CAN 2.7.2. 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 NI-CAN.

Bug IDFixed Issue
145168 MUX in Motorola byte order does not work properly when sending less than a full 8-byte frame.
242580 Scheduler assertion error on NI PXI-8109 real-time controller when using ports on two different devices.

The following items are the IDs and titles of a subset of issues fixed between NI-CAN 2.6.2 and NI-CAN 2.7.1. 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 NI-CAN.

Bug IDFixed Issue
142729 NI USB-8473s synchronization fails with traffic on the bus.
226671 Error R6030 when compiling NI-CAN application in Visual Studio 2008.
233936 The nctInitStart function fails with NI-XNET compatibility error.

The following items are the IDs and titles of a subset of issues fixed between NI-CAN 2.6.1 and NI-CAN 2.6.2. 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 NI-CAN.

Bug IDFixed Issue
139394 Terminating an NI-CAN process on one CAN port might affect other CAN ports or cards.

The following items are the IDs and titles of a subset of issues fixed between NI-CAN 2.6 and NI-CAN 2.6.1. 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 NI-CAN.

Bug IDFixed Issue
122723 Blue screen when removing an NI USB-847x or PCMCIA CAN interface while running an NI-CAN application on it.
120242 Warning states should not trigger a notification callback.

The following items are the IDs and titles of a subset of issues fixed between NI-CAN 2.5.2 and NI-CAN 2.6. 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 NI-CAN.

Bug IDFixed Issue
103680 Timeline Recovery attribute for ncWriteNetMult VI/function does not work.
55364 Importing a CAN database in MAX incorrectly changes datatype for extended arbitration IDs.
93911 Calling ncClose frequently may result in a firmware no response error.
95354 Notification functions/ncWait for Read operations do not work on NI-847x interfaces.
42012 Using the timestamped input read mode with 64 tasks causes a kernel overflow error.
40750 You cannot set the Single Shot property when the Network Interface Object is running.
94653 The ncOpen function/VI could fail to start communication fast computers.

The following items are the IDs and titles of a subset of issues fixed between NI-CAN 2.5.1 and NI-CAN 2.5.2. 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 NI-CAN.

Bug IDFixed Issue
4DAGR870 NI-CAN 2.5.1 does not install VIs to support synchronization between Traditional NI-DAQ and CAN for LabVIEW 8.5.

The following items are the IDs and titles of a subset of issues fixed between NI-CAN 2.5 and NI-CAN 2.5.1. 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 NI-CAN.

Bug IDFixed Issue
47P90370 Fixed an issue where the LIN firmware was incorrectly calculating the enhanced checksum using the unprotected ID.
47ICPNSP Fixed an issue where CAN objects would not restart correctly when the Network Interface is restarted.
48H8PQ70 Fixed an issue where the computer would crash when the function SetProcessWorkingSetSize() is used to increase buffer memory.

Back to Top


Additional Programming Topics

NI-DAQ Synchronization VIs

As the Traditional NI-DAQ driver software is not supported on Windows Vista or Windows 7, the following CAN/DAQ synchronization VIs are not available on Windows Vista or Windows 7:

Support of CANdb (*.DBC) Files

NI-CAN provides support for CANdb network files created using the Vector CANdb or CANdb++ editor. You can use the information from the CANdb file in Measurement & Automation Explorer (MAX) or with the NI-CAN Channel API. For more information, refer to the Using the Channel API chapter in the NI-CAN Hardware and Software Manual.

NI-CAN supports CANdb network files created using the CAN module of Vector products. NI-CAN does not provide complete support of CANdb files created using modules for higher-layer CAN protocols, such as J1939, ISO11783, or NMEA2000. To view the set of features supported for these modules, import the CANdb file into MAX. NI-CAN displays an error dialog for any unsupported object and displays those objects with a red mark. For example, the J1939 protocol for multiframe messages (greater than 8 bytes) is not supported in the current version of NI-CAN.

Updating Get/Set Attribute in Frame API for LabVIEW

NI-CAN 2.4 (or newer) includes several new Frame API attributes. If you have a LabVIEW VI written for an earlier version of NI-CAN, upgrading to NI-CAN 2.4 (or newer) will not automatically update constants or controls for the AttrId input. To use the new attributes, replace your older constants and controls using the AttrId input of the updated NI-CAN VIs.

If you do not want to use new Frame API attributes, you can continue to use the older constants and controls for compatibility.

This issue does not apply to the Channel API for LabVIEW. Because the Get/Set Property functions are provided as polymorphic VIs, they are automatically updated.

Back to Top


Release Notes

Back to Top


Copyright

Copyright 1996–2011 National Instruments. 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.

National Instruments respects the intellectual property of others, and we ask our users to do the same. NI software is protected by copyright and other intellectual property laws. Where NI software may be used to reproduce software or other materials belonging to others, you may use NI software only to reproduce materials that you may reproduce in accordance with the terms of any applicable license or other legal restriction.

Trademarks

CVI, 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.

The mark LabWindows is used under a license from Microsoft Corporation. Windows is a registered trademark of Microsoft Corporation in the United States and other countries.

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

Patents

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