Company Events Academic Community Support Solutions Products & Services Contact NI MyNI

NI-XNET 17.5 Readme

October 2017

This file contains important information about NI-XNET, including installation instructions, new features, a partial list of bugs fixed for NI-XNET 17.5, and known issues.


Supported Operating Systems

Application Software Support

Installation Instructions

Product Security and Critical Updates

New Features and Changes

Supported Hardware

Known Issues

Bug Fixes

Additional Programming Topics

Accessing the Help

Automating the Installation of NI Products

Using NI Software with Microsoft Windows 10

Using NI Software with Microsoft Windows 8.1

Legal Information


Supported Operating Systems

NI-XNET supports the following operating systems:

Note  Support for Windows 32-bit operating systems may require disabling physical address extension (PAE). To learn how this might affect your system and what actions you might need to take, visit ni.com/info and enter the Info Code PAESupport.

1 NI software installs VC2015 Runtime and .NET 4.6.2. Windows 8.1 and Windows Server 2012 R2 require Microsoft updates to support these items. Refer to Microsoft KB2919442 and KB2919355 for more information about how to install these updates.

2 NI software is signed with a SHA-256 certificate. Windows 7 SP1, Windows Embedded Standard 7 SP1, and Windows Server 2008 R2 SP1 require Microsoft updates to support SHA-256. Refer to Microsoft KB3033929 for more information about how to install this security update.

The NI-XNET installer does not support Windows Server 2003/NT/Vista/XP/Me/2000/98/95 or the Windows Server non-R2 editions.

NI-XNET does not support guest accounts on Windows 7. You must log into an administrative or user account to use NI-XNET on these operating systems.

Application Software Support

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

Installation Instructions

Before installing the NI-XNET software, log on as Administrator or as a user with Administrator privileges. The NI-XNET 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-XNET software.

  1. Insert the NI-XNET 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-XNET software CD.
  2. The installation wizard guides you through the necessary steps to install the NI-XNET 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.

Product Security and Critical Updates

Visit ni.com/security to view and subscribe to receive security notifications about NI products. Visit ni.com/critical-updates for information about critical updates from NI.

New NI-XNET 17.5 Features and Changes as Compared to NI-XNET 17.0.1

The NI-XNET 17.5 release adds the following features:

The NI-XNET 17.5 release changes the following:

New NI-XNET 17.0.1 Features and Changes as Compared to NI-XNET 17.0

The NI-XNET 17.0.1 release changes the following:

New NI-XNET 17.0 Features and Changes as Compared to NI-XNET 16.1

The NI-XNET 17.0 release adds the following features:

The NI-XNET 17.0 release changes the following:

New NI-XNET 16.1 Features and Changes as Compared to NI-XNET 16.0

The NI-XNET 16.1 release adds the following features:

The NI-XNET 16.1 release changes the following:

Supported Hardware

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

Known Issues

Issue NumberIssue
FlexRay PXI-8517 boards may have memory issues on PXI controllers with less than 2 GB RAM.
When using an .ncd or .dbc database, the baud rate defaults to 500 k (250 k for J1939 databases), and the IO mode defaults to CAN 2.0. You need to programmatically override these values in your session if you need different values.
Changing transceiver cables on NI 9860, PXIe-8510 and PCIe-8510 on RT targets requires a refresh of MAX.
Changed behavior of Frame Default Payload property: If Application Protocol of a Cluster is J1939, the default for Default Payload bytes is now 0xFF instead of 0x00. As a consequence, unused bits in the frame will be set to 1 instead of 0 when J1939 is used (like required by J1939).
Variant Handling, as described within the AUTOSAR 4.x Generic Structure Template, is unsupported by NI-XNET. All AUTOSAR XML elements using the <VARIATION-POINT> tag will be discarded.
If reading AUTOSAR files, some types of frames are not assigned to ECUs as "Tx" (transmitted frames) or "Rx" (received frames).
667510 Changed Alias properties such as Baud Rate and IOMode are ignored the first time a database is opened. Workaround: Close and re-open the session.
672838 Inserting a USB-8502 device can result in an unusable device with internal errors on PharLap. Workaround: Remove and reinsert the device or reboot the system.
673342 NI-XNET Interface and Device property nodes can return erroneous session handles. Workaround: Typecast the Interface or Device Session to an NI-XNET Session and pass it to XNET Clear.

Bug Fixes

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

Bug IDFixed Issue
668124 Using invalid NI-XNET sessions can crash the RT application.
646672 CAN frames with invalid DLC pass through the controller then the firmware sends the Kernel driver a larger than expected array.
639597 The option "Browse for Database File" on an NI-XNET IO control crashes LabVIEW 2017 (64-Bit).
631818 NI-XNET Echoed frames always have the CAN Data type regardless of the type actually transmitted.
612384 NI-XNET Compatibility Library for NI-CAN does not support hardware with transceiver cables.
612146 DBC Import: Unable to read the frame name if there are space characters behind the last character of the frame name and the ':' character following the name.
611887 NI-XNET controls fail to trigger the value changed event.
610257 Error for too many Frame Stream sessions says too many frames instead of too many sessions in NI-XNET error code 0xBFF63012.
609492 NI-XNET LIN C Series devices are unrecoverable after bus power is removed and error -1074384887 is detected.
576222 Manage NI-XNET Databases does not work on RT targets with a non-blank password.

Additional Programming Topics

NI-CAN Compatibility

If you intend to use the NI-CAN API with your NI-XNET PCI/PXI hardware, refer to the NI-XNET Compatibility for NI-CAN appendix in the NI-CAN Hardware and Software Manual.

Deployed databases on LabVIEW Real-Time targets

When upgrading the NI-XNET software on your LabVIEW Real-Time target, you need to re-deploy your database files to that target using a host computer that runs the same version of NI-XNET as the target.

Removing and inserting C Series modules on CompactRIO targets during device communication is not supported

Inserting a module into or removing a module from a cRIO chassis that is actively communicating with an NI 986x module can cause application failures and possibly device damage.


Accessing the Help

Refer to the NI-XNET Hardware and Software Help, accessible from National Instruments»NI-XNET»NI-XNET Documentation, for information about NI-XNET.

Automating the Installation of NI Products

You can automate the installation of most NI products using command-line arguments to suppress some or all of the installer user interface and dialog boxes.

If the NI product you are installing uses Microsoft .NET 4.0, the .NET installer may run before any NI software installs and may require a reboot before the installation of NI software begins. To avoid a .NET reboot, install .NET 4.0 separately before you install NI software.

For more information about automating the installation of NI products, refer to the following KnowledgeBase articles:

Using NI Software with Microsoft Windows 10

Microsoft Windows 10 is the latest version of the Windows operating system and features significant changes compared to previous versions. Windows 10 introduces several new capabilities and also combines features from both Windows 7 and Windows 8. For more information about NI support for Windows 10, visit ni.com/windows10.

Using NI Software with Microsoft Windows 8.1

When you install NI software on Microsoft Windows 8.1, you will notice a few additional tiles in the Apps view, including shortcuts to NI application software products such as NI LabVIEW, Measurement & Automation Explorer (NI MAX), and NI Launcher. For more information about NI support for Windows 8.1, visit ni.com/windows8.


Legal Information

Copyright

© 2009–2017 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.

NI 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.

End-User License Agreements and Third-Party Legal Notices

You can find end-user license agreements (EULAs) and third-party legal notices in the following locations after installation:

U.S. Government Restricted Rights

If you are an agency, department, or other entity of the United States Government ("Government"), the use, duplication, reproduction, release, modification, disclosure or transfer of the technical data included in this manual is governed by the Restricted Rights provisions under Federal Acquisition Regulation 52.227-14 for civilian agencies and Defense Federal Acquisition Regulation Supplement Section 252.227-7014 and 252.227-7015 for military agencies.

IVI Foundation Copyright Notice

Content from the IVI specifications reproduced with permission from the IVI Foundation.

The IVI Foundation and its member companies make no warranty of any kind with regard to this material, including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose. The IVI Foundation and its member companies shall not be liable for errors contained herein or for incidental or consequential damages in connection with the furnishing, performance, or use of this material.

Trademarks

Refer to the NI Trademarks and Logo Guidelines at ni.com/trademarks for information on NI trademarks. Other product and company names mentioned herein are trademarks or trade names of their respective companies.

Patents

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

374802J-01