Installing Software on NI Linux Real-Time PXI Controllers

Publish Date: Jul 09, 2019 | 1 Ratings | 1.00 out of 5 | Print | Submit your review

Overview

This document covers the process to format and install software to an NI Linux Real-Time PXI Controller. It includes a discussion of the differences between PXI and past NI Linux Real-Time controllers, and how to configure a password for the controller.

Table of Contents

  1. Introduction
  2. Formatting the Controller
  3. Installing Software
  4. Next Steps
  5. Additional Resources

1. Introduction

With the release of NI Linux Real-Time support for PXIe Controllers, you can install common NI Drivers and Utilities to these Real-Time Controllers from NI Measurement & Automation Explorer (MAX). However, the install process for these Real-Time Targets is different than what many users are familiar with. This document covers the first time install process for a freshly provisioned NI Linux Real-Time PXI Controller for LabVIEW.

Note: For setting up a PXI Controller for use with LabVIEW Communications System Design Suite, refer to Provisioning a Real-Time Controller or USRP Stand-Alone Device for LabVIEW Communications. For the Phar Lap ETS version of this tutorial, refer to Real-Time PXI System Initial Configuration and Software Installation.

Required Hardware

Required Software

  • LabVIEW 2019 or later
  • LabVIEW 2019 Real-Time Module or later
  • NI Measurement and Automation Explorer 19.0 or later

 

Back to Top

2. Formatting the Controller

With NI Linux Real-Time PXI Controllers, a format is required before any software can be installed. This section will cover the changes to the format experience in NI MAX for these controllers and how to perform the format.

 

Standard Format and Formatting with a Base Image

With the release of NI Linux Real-Time Controllers, NI has introduced the concept of Base Images. A Base Image is a light-weight installation of the minimum software needed to configure, install software to, and successfully use all available features with a Linux Real-Time PXI Controller.

In the past, formatting an NI Real-Time Controller from NI MAX would fully wipe all user data and installed software from the controller, leaving just the Linux Operating System. Moving forward, this option will be referred to as a Standard Format. In the case of PXI Linux Real-Time Controllers, there is now an additional format option: Base Images. These will format the controller such that all user data and software are removed, but after doing so will also apply the selected Base Image.

Note: NI Linux Real-Time PXI Controllers can still be formatted with a Standard Format. However, this will prevent the proper installation of available packages and users will be prompted to format with a Base Image when attempting to install software.

 

Formatting from NI MAX

Before installing software from NI MAX the controller must first be formatted with a compatible Base Image. To do so, follow the instructions below.

  1. Locate your PXI Controller in NI MAX under Remote Systems.
  2. Right-click on the controller and select Format Disk. This will launch the Format Disk window.


  3. In the window, select the type of format to apply from the dropdown. For the purpose of this tutorial, select a PXI System Image.


  4. (Optional) To ensure the network settings of the PXI Controller do not change, select Preserve the primary adapter settings and reset the others or Preserve the settings for all network adapters.
  5. Click the Format button to begin the format process.

  6. Once the format is complete, click the Close button to close the window.


  7. The PXI Controller should now appear in NI MAX with a Status of Connected – Running.

 

Back to Top

3. Installing Software

Unlike past NI Real-Time Controllers, NI Linux Real-Time PXI Controllers install NI Drivers and Software as packages within a Linux package manager, opkg. This section will cover the PXI Linux Real-Time install system and how to install software using the wizard.

 

Online Package Repository and opkg

In the past, installing software to NI Real-Time Controllers has required installing the relevant software and drivers to a Host PC and then running an install process to push these items from the Host PC to the Real-Time Controller. This meant that all NI Software necessary for the controller had to be present on the Host PC in the exact versions necessary for a system.

Instead, NI Linux Real-Time PXI Controllers use a process which scripts installation through a lightweight package manager: opkg. Existing users of NI Linux Real-Time may already be familiar with using this package manager to install many third-party software from the official NI-hosted package repository. As of the 2019 release of the LabVIEW Real-Time Module, software and drivers for NI Linux Real-Time PXI software and Controllers are now hosted in this same repository.

As a result of this change, the Host PC no longer needs every driver or utility in order to install software to an NI Linux Real-Time PXI Controller. Only NI MAX is necessary to facilitate the installation once a system has been imaged with a Base Image. This makes replicating or restoring different software versions on a Real-Time controller much easier, with the Base Image ensuring access to the right versions of the repository feeds. However, this also adds a requirement: NI Linux Real-Time PXI Controllers must have access to a repository - such as the online NI-hosted repository or a SystemLink repository - in order to install or upgrade software.  When using the NI-hosted repository, it is required that the controller have direct Internet access in order to reach the repository. If you have questions or feedback about this limitation, please contact NI Support. Note that NI is actively exploring options to enable customers to work with offline repositories outside of SystemLink and a solution for this is on the roadmap.

Once software is installed, the controller can be used as with any other NI Real-Time controller. NI recommends keeping a development machine configured with all relevant software and drivers as the development APIs and environments will still be necessary for programming the controller.

 

Installing Software from NI MAX

To install software from NI MAX, follow the instructions below:

  1. In NI MAX, expand the controller by clicking the arrow to the left of the controller.
  2. Right-Click on Software and select Add/Remove Software.


  3. A prompt to login as the admin user will appear. If an admin password has been set, enter the password and click OK. Otherwise, just click OK without entering a password.
  4. If the controller has not been formatted with a Base Image, the wizard will require this to be done first. Otherwise, the Real-Time Software wizard will appear.


  5. Select the items to install, update, or uninstall from the Add, Update, and Remove tabs respectively.


  6. Click Review changes to see a summary of the changes that will be made to the system through the install process.


  7. Click Continue to make the required updates.
  8.  Once the updates are complete, click the Close button. The software will now appear under the Software dropdown for the controller in NI MAX.

 

Back to Top

4. Next Steps

Once software is installed on the target, it can be used in LabVIEW with the LabVIEW Real-Time Module just like any other Real-Time Controller. Configuration options, such as driver and device settings, will also be available with the proper software installed. Before using the controller, NI recommends following the instructions below to set a secure password.

 

Configuring a Password

NI highly recommends setting a password for any Real-Time devices. As of NI MAX 19.0, users will now be notified via a warning for all Real-Time Linux Controllers with SSH enabled if a password has not been set. This warning will appear as shown in the below image.

To set an administrator password for a Linux Real-Time device:

  1. In NI MAX, select the Real-Time Controller to set a password for.
  2. Click Set Permissions from the top menu for the controller.
  3. Configure the new password as desired, then click OK.



    Note: The default admin password for Linux Real-Time controllers is a blank password. That is, no password is set by default.

 

Back to Top

5. Additional Resources

 

 

Back to Top

Bookmark & Share


Ratings

Rate this document

Answered Your Question?
Yes No

Submit