NI-FGEN for Linux x86-64 Architecture Readme, Version 21.8

April 2022


This file contains late breaking news about NI-FGEN and supersedes any information found in other documentation included in the distribution.

Refer to NI Linux Technology for the most recent information about Linux support at NI.

Refer to NI Linux Device Drivers for compatibility information about NI Linux Device Drivers.

Refer to NI-FGEN Release Notes for known issues, bugs fixed since the last release, and other release details.


System Requirements

NI-FGEN software for the Linux/x86 64-bit architecture has been tested on the following distributions:

  • openSUSE Leap 15.1
  • openSUSE Leap 15.2
  • Red Hat Enterprise Linux 7
  • Red Hat Enterprise Linux 8
  • CentOS 7
  • Ubuntu 18.04
  • Ubuntu 20.04

NI-FGEN requires a 64-bit distribution and does not support 32-bit applications.

Supported Hardware

Visit NI Hardware and Operating System Compatibility to view driver, desktop operating system, and real-time operating system support for individual hardware devices.

To view information for your device:

  • Select your hardware model in the dropdown list on the page to view compatibility information for your device.
  • Type your hardware model number in the dropdown list on the web page to filter the list of available devices.

Note: Some compatibility information may only be available in the archive attached to the NI Hardware and Operating System Compatibility page. For historic driver and OS support information, refer to the readme for the relevant driver version.

Installation

NI provides a repository add-on for all supported drivers that you can install using your Linux distribution's native package manager.

  1. Visit ni.com/info and enter the Info Code LinuxRepository.
  2. Download and install the repository add-on for your Linux distribution.
  3. Install the following driver packages through your Linux distribution's package manager:
    • ni-fgen
    • ni-fgen-daqmx
    • ni-fgen-devel (for C/C++ development support)
    • ni-fgen-labview-20xy-support (for development support and examples on LabVIEW 2021 and earlier)
    • ni-fgen-labview-support (for development support and examples on LabVIEW 2022 and later)
  4. After the driver package(s) are installed, you must rebuild the new packages for the system kernel. NI recommends that you run the command 'dkms autoinstall' after installation, and before rebooting the system, to install the latest revision of all modules that have been installed for other kernel revisions. After doing so, the installed device drivers will function immediately on the next system start.

Updated LabVIEW Compatibility Policy

When installing NI-FGEN, the ni-fgen-labview-support package will be recommended if you have already installed LabVIEW 2022 or later and installs to the LVAddons directory. This package supports applications using NI-FGEN with LabVIEW 2022 or later.

Examples

This release includes examples showing the use of NI-FGEN in C and LabVIEW.

C examples are located in /usr/share/nifgen-devel/examples. Make files are provided that link to the necessary libraries.

The LabVIEW examples are located in the LabVIEW examples directory.

Linux Limitations

Some features discussed in the NI-FGEN documentation are unavailable on Linux.

  • NI-FGEN for Linux supports two application development environments:
    • LabVIEW (64-bit): 2019 and later
      • LabVIEW 2020 is not supported on openSUSE Leap 15.2 and Ubuntu
      • LabVIEW 2019 is not supported on openSUSE Leap and Ubuntu
    • C and C++ (gcc)
  • NI-FGEN for Linux does not support other ADEs, such as the LabVIEW Real-Time Module, LabWindows/CVI, Microsoft Visual C/C++, or Microsoft Visual Basic.
  • NI-FGEN for Linux does not provide the following graphical configurations or debug utilities that are available for other operating systems:
    • Test Panels
    • NI I/O Trace
    • Measurement and Automation Explorer (MAX) graphical configuration utility
      • The NI Hardware Configuration Utility (22.0 or later) is an alternative to discover and rename devices and is available with the ni-hwcfg-utility package.
      • Additionally, all supported NI-FGEN hardware can be discovered and renamed through the NI System Configuration (NI-SysCfg) API.
        • Install the following:
          • ni-syscfg-runtime
          • ni-syscfg-devel (for C/C++ development)
          • ni-syscfg-labview-2021-support (for LabVIEW development)
        • Run the ./local/natinst/LabVIEW-2021-64/examples/nisyscfg/Rename Aliases.vi example to change aliases in LabVIEW
      • To read device aliases and general device properties directly from the command line, use the lsni -v or the lsni -u command.
  • The Onboard Signal Processing (OSP) functionality of the PXI-5441, PXIe-5442, PXIe-5450, and PXIe-5451 is not supported on Linux.
  • NI-FGEN for Linux does not support external calibration of devices.
  • NI-FGEN for Linux does not support remote debugging of applications.
  • NI-FGEN for Linux does not support Japanese localization for driver, LabVIEW application programming interface (API), and documentation.
  • NI-FGEN for Linux does not support Firmware Updater application.

Legal Information

COPYRIGHT:

© 2022 National Instruments Corporation. All rights reserved.

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

Notices are located in the /usr/share/doc/ni-fgen/NOTICES directory EULAs are located in the /usr/share/ni/licenses directory

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 NI Patent Notice at ni.com/patents.

378804A-01