Thank you for using NI-Serial for LabVIEW Real-Time, Version 17.5.
This file contains important information about NI-Serial for LabVIEW Real-Time, including installation instructions, new features, a partial list of bugs fixed for NI-Serial for LabVIEW Real-Time, and known issues.
To download previous versions of NI-Serial for LabVIEW Real-Time drivers, refer to ni.com/updates and search for NI-Serial.
There are no changes to NI-Serial 17.5 for LabVIEW Real-Time.
NI-Serial 17.0 removes support for the PCI-232, PCI-232I, PCI-485, PCI-485I, PXI-8420, PXI-8421, PXI-8422, and PXI-8423 interfaces.
NI-Serial 15.0 adds serial module (NI 9870 and NI 9871) support for the sbRIO-9607 and sbRIO-9627 controllers.
NI-Serial 14.0 adds serial module (NI 9870 and NI 9871) support for controllers, such as the NI cRIO-9038, which run 64-bit NI Linux Real-time OS.
NI-Serial 14.0 fixes a known issue when running NI Linux Real-time OS, where NI-Serial incorrectly causes NI-VISA to detect RS-232 ports on NI 9870 modules as RS-485 configured for 4-wire mode.
NI-Serial 4.1 adds serial module (NI 9870 and NI 9871) support for the cRIO-9068 controller.
NI-Serial 4.1 fixes an issue where some parity and framing errors received by NI 9870 and NI 9871 modules are not detected by the firmware. This can result in the driver not reporting the errors, leading to data corruption.
NI-Serial 4.0 adds the discovery of NI 9870 and NI 9871 modules through the NI System Configuration API.
The NI System Configuration expert for NI-Serial has been renamed from "ni-serial" to "serial." This change allows for system configuration and MAX import/export operations to be accessed in a consistent manner. Existing applications using the old name will need to be updated.
When using the NI System Configuration API to query information about NI-Serial PCI or PCIe hardware in a Desktop RT system, it would incorrectly specify that the board was in slot 255 of chassis PXI255. This has been resolved, and now reports that the chassis and slot are unavailable.
NI-Serial 4.0 improves the way serial hardware is displayed in MAX. PXI and PXIe hardware are now displayed under their respective chassis in the tree. NI 9870 and NI 9871 modules will also now appear in MAX when configured for use with NI-Serial.
When using a host system with NI-Serial 4.0 installed to view LabVIEW Real-Time controllers running older versions of NI-Serial, the NI-Serial boards will no longer appear in MAX. All ports will still be accessible as VISA ASRL resources.
When installing on Windows 8, NI-Serial no longer pins shortcuts to the Start screen. Shortcuts which are available from the start menu on earlier versions of Windows may be accessed through the NI Launcher utility, or by searching from the Start screen.
NI-Serial 3.9 supports the discovery of PCI-based (PCI, PCIe, PXI, and PXIe) hardware through the NI System Configuration API.
NI-Serial 3.9 fixes an issue where various errors could be manifested if a serial transfer is in progress when the 32-bit system tick count rolls over, which happens once every 49.7 days. Symptoms included failed serial transfers, FIFO overruns, failure of serial transfers to timeout, and system hangs.
A system could hang during reboot if it was transmitting data from a 843x series serial port when the reboot command was sent. This has been fixed.
A system crash or instability could occur when detecting serial ports on any of the mentioned controllers. Some examples when this could occur are expanding Devices & Interfaces in Measurement & Automation Explorer, installing VISA Server on the target, or attempting to use a serial port. This has been fixed.
The serial ports on cFP-2100 and cFP-2110 controllers were not properly detected. This did not impact cFP-2120 controllers. This has been fixed.
NI-Serial 3.8.1 adds support for serial ports on RIO Mezzanine Cards.
The SecondaryInterrupts option used in the niserial.dbs file has been replaced, and will no longer function. Refer to the Performance on LabVIEW Real-Time topic in the NI-Serial Help for more information.
When using the VI_EVENT_ASRL_RI event with some cRIO, sbRIO, and cFP controllers, the event was incorrectly signaled on both rising and falling edges of the RI line. This behavior has now been fixed, and the event is signaled only on the falling edge.
Several enhancements have been made to improve performance and decrease CPU overhead when performing small writes on all interfaces, and small reads on NI 843x series hardware.
NI-Serial 3.8 adds support for additional cRIO, sbRIO, and Smart Camera controllers.
NI-Serial now reserves port numbers for two built-in serial ports on all PXI, Industrial Controller, Desktop RT, and cRIO-908x controllers. On these systems, PnP hardware will now be assigned port numbers starting with COM3, when they may have previously been assigned COM2.
The niserial.dbs file is replaced each time NI-Serial is uninstalled or reinstalled. This has the effect that any customized settings will be removed. This matches the behavior of NI-Serial 3.6 and earlier.
NI-Serial for LabVIEW Real-Time, Version 3.8, requires LabVIEW Real-Time 8.6 or later. It is not possible to install on FP-20xx or cFP-20xx controllers. These controllers will continue to work with previous versions of NI-Serial.
Mark and space parity were not properly configured on some cRIO, sbRIO, and cFP controllers. This has been fixed.
When using multiple forms of flow control simultaneously on a single port, it was possible for flow control to fail to disengage, preventing data transmission. This has been fixed.
Several bytes of valid data could be discarded immediately prior to the reception of a serial error, such as a parity or overrun error. This valid data is now properly received prior to handling the error condition.
When the RX FIFO became completely full on some cRIO, sbRIO, and cFP controllers, the port could stop receiving data. This has been fixed.
It was possible for a cRIO controller to crash during reboot when using serial ports on a C Series module. This has been fixed.
In some rare circumstances, the process of shutting down serial ports for a reboot could cause the controller to hang. This has been fixed.
NI-Serial for LabVIEW Real-Time, Version 3.7.1, adds support for the NI cRIO-9075 and cRIO-9076 Controllers.
NI-Serial 3.7 allows users to access the NI 9870 and 9871 modules directly from LabVIEW Real-Time 2010 without using the LabVIEW FPGA interface.
To enable this support, install NI-Serial 3.7 and NI-VISA for LabVIEW Real-Time on a Compact RIO Target that supports RIO Scan Interface (RSI). When detecting the modules, users will have the option to add the module directly to the chassis in the LabVIEW project.
If using NI-RIO 3.5.x and lower, you may see warning pop-ups indicating that the NI 987x modules are not supported on RSI. These warnings can be ignored. For more information go to ni.com/kb and search for 5DTFTOL1.
NI-Serial 3.7 changes the way that ports are numbered when detecting boards. Under some circumstances inserting new boards into a system may cause port numbers to change. For more information go to ni.com/kb and search for 5D2G85G2.
The behavior of settings on uninstall was reverted in NI-Serial 3.8. Please refer to Changes and Fixed Issues in NI-Serial 3.8 for more information.
Serial settings stored in the niserial.dbs file, including port numbers, will persist after uninstalling NI-Serial 3.7 from a Real-Time target. The modifications to the niserial.dbs file will also persist through reinstalls of the NI-Serial driver. To reset these settings to default, delete the niserial.dbs file from the Real-Time target.
NI-Serial for LabVIEW Real-Time, Version 3.6, adds support for National Instruments PXI Express serial interfaces. Refer to the chart of Supported Interfaces for detailed model information.
For some applications, it may be possible to use a NI PXIe-8431 interface for communicating at up to 10 MBaud. For more information go to ni.com/kb and search for 58KEI82F.
When upgrading to NI-Serial 3.6 on some configurations, port assignments may change. For best results, please identify all PXI chassis through Measurement & Automation Explorer.
NI-Serial for LabVIEW Real-Time, Version 3.5.2, adds support for National Instruments PCI Express serial interfaces. Refer to the chart of Supported Interfaces for detailed model information.
NI-Serial for LabVIEW Real-Time, Version 3.5.2, adds support for the cRIO-9024 and cRIO-9073 controllers.
NI-Serial for LabVIEW Real-Time, Version 3.5.2, adds support for the NI 9792 controller.
NI-Serial for LabVIEW Real-Time, Version 3.5.2, adds support for on-chip flow control. Previous driver versions implemented flow control in the driver, which in some circumstances could allow data loss. All PCI, PXI, and PCI Express interfaces now utilize on-chip RTS/CTS flow control. 8430-series hardware also supports on-chip DTR/DSR and XON/XOFF flow control.
NI-Serial 3.5.2 includes performance changes that impact cRIO-901x, cRIO-907x, sbRIO-96xx, and cFP-22xx controller families. This change greatly reduces the CPU overhead of reading data from the serial port at high speed. An impact of this change is that increased latency may be seen when reading small numbers of bytes from the serial port. For more information about this change and possible solutions if you have issues with the increased latency, visit ni.com/kb and search for Knowledgebase 55597DG2.
NI-Serial for LabVIEW Real-Time, Version 3.3.4, adds support for the NI 3100, NI 3110, and EVS-146x controllers.
NI-Serial for LabVIEW Real-Time, Version 3.3.3, adds support for the NI cRIO-9022 Controller.
NI-Serial for LabVIEW Real-Time, Version 3.3.2, adds support for NI sbRIO controllers.
NI-Serial for LabVIEW Real-Time, Version 3.3.2, adds support for NI 17xx Smart Cameras.
NI-Serial for LabVIEW Real-Time, Version 3.3, adds support for multi-core real-time targets.
NI-Serial for LabVIEW Real-Time, Version 3.3, adds support for the cRIO-9072, and cRIO-9074 controllers.
NI-Serial for LabVIEW Real-Time, Version 3.2, adds support for report generation in Measurement & Automation Explorer (MAX). Report generation allows you to take a snapshot of what hardware is installed and configured on your system.
NI-Serial for LabVIEW Real-Time, Version 3.1, adds support for cRIO, FieldPoint, and Compact Vision controllers running LabVIEW Real-Time.
|PCI Interfaces||Standard||# Ports||Isolated||Max Baud (kbaud)|
|PCI Express Interfaces||Standard||# Ports||Isolated||Max Baud (kbaud)|
|PXI Interfaces||Standard||# Ports||Isolated||Max Baud (kbaud)|
|PXI Express Interfaces||Standard||# Ports||Isolated||Max Baud (kbaud)|
|NI PXIe-8431/8||RS-485/RS-422||8||No||3000.01, 2|
|NI PXIe-8431/16||RS-485/RS-422||16||No||3000.01, 2|
|Real-Time Controllers||Standard||# Ports||Isolated||Max Baud (kbaud)|
|NI 172x Smart Cameras||RS-232||15||No||230.4|
|NI 174x Smart Cameras||RS-232||15||No||230.4|
|NI 176x Smart Cameras||RS-232||15||No||230.4|
|NI 177x Smart Cameras||RS-232||15||No||115.2|
|Serial C Series Modules7||Standard||# Ports||Isolated||Max Baud (kbaud)|
2. For possible use with higher baud rates, refer to ni.com/kb and search for KnowledgeBase 58KEI82F.
3. NI-Serial for LabVIEW Real-Time does not provide native driver support for Serial ENET interfaces. However, you may use your Serial ENET interfaces on LabVIEW Real-Time through the NI-VISA Serial ENET Passport.
7. Serial C Series Modules may be used through NI-Serial and NI-VISA on backplanes configured to use NI-RIO IO Scan. To enable this support, NI-Serial 9870 and 9871 Scan Engine Support must be installed on the controller. For assistance with configuring a controller and backplane to use NI-RIO IO Scan, please refer to the NI-RIO documentation.
© 1996–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.
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.
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.