Keysight IO Libraries Suite 2019 Update 1 (for Linux)

 

·         What is the Keysight IO Libraries Suite?

·         What's New in Keysight IO Libraries Suite 2019 Update 1 (for Linux)?

·         System Requirements

·         Installing the Software

o    (Optional) If Additional Users Need Access to Your IOLS Machine

o    (Optional) Silent (Command Line) Installation Mode

·         Uninstalling the Software

·         Known Issues

·         License Grant

·         Trademarks and Copyright

What is the Keysight IO Libraries Suite?

The Keysight IO Libraries Suite is a collection of 64-bit libraries and utility programs. The API libraries (VISA and SICL) enable instrument communications for a variety of Linux distribution environments that are compatible with GPIB, USB, USB-GPIB, LAN, and RS-232 test instruments from a variety of manufacturers. Several utility programs help you quickly and easily connect your instruments to your PC. This is the first release for Linux; a list of supported and unsupported features (in comparison to the Windows product) is included in this ReadMe.

Establishing communication between your instruments and your PC is simple.

1.     Install the IO Libraries Suite: Get all the software you need to connect instruments to your Linux desktop workstation by way of the various supported interfaces.

2.     Connect Your Instruments: Connect cables and power on instruments.

3.     Run Keysight Connection Expert to Identify and Communicate with Instruments: View connected instruments, send commands to your instruments, and configure the settings.

What's New in Keysight IO Libraries Suite 2019 Update 1 (for Linux)?

IO Libraries Suite 2019 Update 1 extends support to Red Hat and CentOS 7.6, and fixes a defect enabling transfer of large buffers over USB connections. Other revisions are minor. 

This release closely follows the original release of  Keysight IO Libraries Suite 2019 (for Linux), the first available version for the Linux operating system.

Major features supported:

·         Utilities including Connection Expert, the Instrument Discovery Service, Interactive IO, and IO Monitor.

·         Programming libraries for VISA and SICL

·         IO Interface supported: LAN (HiSLIP, VXI-11/SICL-LAN, and SOCKET), PCI/PCIe GPIB, USB/GPIB, USBTMC, RS-232, Remote GPIB, Remote USB, and Remote RS-232.

Major features NOT supported:

·         PXI/AXIe

·         VXI

·         Remote IO Server

For more information on these products, consult the IO Libraries Suite Help that installs with the product, or the Keysight IO Libraries Suite web page at www.keysight.com/find/iosuite.

System Requirements

Keysight IO Libraries Suite has been tested on the following system configurations:
Linux Distributions:   

·         64-Bit Red Hat Enterprise Linux Desktop Workstation 7.1 to 7.6

·         64-Bit CentOS Desktop Workstation 7.1 to 7.6

Disk Space Requirement:

·         Keysight IO Libraries Suite package takes about 2GB. 

Installing the Software

You must use the provided installers to install Keysight IO Libraries Suite. Manual installation using rpm package is not supported.

To install Keysight IO Libraries Suite:
 Step 1Disconnect all instruments.
 Step 2Close all applications running on the workstation.
 Steps 3-4. Install the software.
 Step 5. Re-connect instruments. 

NOTE: There are two components to the install. The first is a set of kernel drivers for users wishing to establish USBTMC or USB-to-GPIB (82357) converter connections. If you require this functionality, perform the separate installation for iokerneldrivers-installer.run referenced in step 3 below, then choose either step 4 Option 1 (Typical) or step 4 Option 2 (text-based) to install the remainder of the product suite (iolibrariessuite-installer.run). If you are not connecting via USBTMC or USB-to-GPIB converter, skip step 3. 

Step 3, Install kernel drivers (if connecting via USBTMC or USB-to-GPIB converter)

Please see the separate instructions (ReadMeKernelDrivers) for the Kernel Drivers Installer (iokerneldrivers-installer.run). Both installation packages and their separate ReadMe files are available at Keysight.com/find/iosuite (Trials and Licenses tab). At the end of each installation process, each installer wizard also gives you the option to launch the correct ReadMe.

Step 4, Option 1: (Typical) GUI-based Install

The main IO Libraries Suite installer (iolibrariessuite-installer.run) will automatically provide a graphical user interface if it detects XWindows running on the target Linux PC.

·         Copy the installation package downloaded or from a disk to a local folder.

·         Open a Terminal window and change directory to the local folder where the Keysight IO Libraries Suite for Linux is copied to.

·         If you log in as 'root' user, run the installer by executing ./iolibrariessuite-installer.run in the Terminal window and follow the instructions to finish the installation. If you are not logging in as 'root' user, make sure using the 'sudo' command to run the installer.

o    Note: Make sure the permission for the installer is set properly. It should be set as executable.

Step 4, Option 2:  Force a text-based installation mode.

In order to force the main installer into a textual user interface in a Terminal window on XWindows PCs, use --mode text on the command line like this:

sudo ./iolibrariessuite-installer.run --mode text

Step 5. Re-connect all devices that are disconnected before installation.

After installation, you may need to reboot your machine before attempting to use Keysight VISA or SICL. Refer to keysight.com for the most recent information about  Linux support at Keysight Technologies, Inc.

(Optional) If Additional Users Need Access to Your IOLS Machine

The options below are for users of either RS232 or USBTMC. 

If you are using RS232:

By default, IO Libraries creates a kt-iols group on the machine. The installer will add the installing superuser to both kt-iols and to the existing system dialout groups (for RS-232 usage). If you want other users on that machine to be able to access RS-232, you must manually add those users to both kt-iols and dialout. The administrator/superuser should log out and back in again after adding these users for the changes to take effect. 

If you are using USBTMC: 

By default, IO Libraries creates a kt-iols group and an usbtmc group on the machine. The installer will add the installing superuser to both kt-iols and to usbtmc. If you want other users on that machine to be able to use USBTMC, you must manually add those users to both kt-iols and usbtmc. The administrator/superuser should log out and back in again after adding these users for the changes to take effect. 

(Optional) Silent (Command Line) Installation Mode

Keysight partners may opt to use the command line/ silent installation feature. Silent mode is enabled by adding --mode unattended to the install command line in this fashion:

sudo ./iolibrariessuite-installer.run --mode unattended

Uninstalling the Software

Keysight IO Libraries Suite installation process automatically generates an uninstaller that is put under "/opt/keysight/iolibs/uninstall" and named iolibrariessuite-uninstall. Users can run this uninstaller from a Terminal window to uninstall Keysight IO Libraries Suite.

To force a silent uninstall use:

sudo ./iolibrariessuite-uninstall --mode unattended 

Known Issues

·         Some Virtual Network Computing (VNC) clients will not work. We recommend using X11VNC.  

·         For users accessing their IO Libraries machine using VNC, a known compatibility issue can cause the display driver to crash all open programs when the Connection Expert window is re-sized. To correct this issue, open the program (using a non-VNC connection). Open settings or options (the gear icon in Connection Expert, or the Options button in IO Monitor and Interactive IO). Locate the Appearance settings, and enable the Use System Title Bar option. You must close and re-open the program for changes to take effect.

License Grant

Keysight grants you a non-exclusive license of the Software at no charge pursuant to the terms of the License Agreement. The License Agreement is displayed when you install the software and is available in the IO Libraries Suite Online Help. You may download the Software, and store or run the Software for internal use and purposes in accordance with this Agreement and the documentation provided with the Software. Such documentation may include license terms provided by Keysight's third party suppliers, which will apply to the use of the Software and take precedence over these license terms. In the absence of documentation specifying the applicable license, you may store or run the Software on your PC(s) and instrument(s). If the Software is otherwise licensed for concurrent or network use, you may not allow more than the maximum number of authorized users to access and use the Software concurrently.

Trademarks and Copyright

PCIe® and PCI EXPRESS® are US registered trademarks and/or service marks of PCI-SIG.

© Keysight Technologies 1983-2019