GPIB Setup on Windows, Linux, and macOS

What Is GPIB?

GPIB (General Purpose Interface Bus), also known as IEEE-488 or HP-IB, is a parallel interface standard developed by HP in the late 1960s. It connects instruments to controllers (usually a PC) using a dedicated 24-pin connector and cable.

Despite being decades old, GPIB is still widely used in production test environments because it is extremely reliable, deterministic, and supported by virtually every bench instrument made before 2005. Many lab instruments today still include a GPIB port alongside USB and LAN.

A single GPIB bus supports up to 15 instruments, each assigned a unique address (0–30). Typical instrument addresses are 1–22; address 0 is reserved for the controller.

Hardware Requirements

Common GPIB controllers and their typical use cases:

• NI GPIB-USB-HS — USB dongle, the most common choice for modern laptops and desktops. Works with NI-VISA on all three operating systems.
• Keysight 82357B — USB adapter, works with Keysight IO Libraries Suite. Slightly faster than NI for Keysight instruments.
• NI PCIe-GPIB — PCI Express card for desktop workstations. Highest throughput for production test.
• Prologix GPIB-USB — Low-cost USB adapter. Supported by pyvisa-py directly without NI-VISA.

Driver Installation by OS

# Ubuntu / Debian
sudo dpkg -i ni-visa_*.deb
sudo apt-get install -f   # fix any dependency issues

# RHEL / Fedora
sudo rpm -ivh ni-visa_*.rpm

sudo usermod -aG ni $USER
newgrp ni   # apply without logging out

sudo apt-get install linux-headers-$(uname -r) build-essential git

git clone https://git.code.sf.net/p/linux-gpib/code linux-gpib
cd linux-gpib/linux-gpib-kernel
make
sudo make install
sudo modprobe ni_usb_gpib   # for NI USB controllers

sudo gpib_config

cd ../linux-gpib-user
./bootstrap && ./configure && make
sudo make install
pip install gpib-ctypes   # PyVISA backend for linux-gpib

# Add user to dialout group for serial port access
sudo usermod -aG dialout $USER
newgrp dialout

import pyvisa
rm = pyvisa.ResourceManager('@py')
inst = rm.open_resource('GPIB0::22::INSTR',
                        resource_pyclass=pyvisa.resources.GPIBInstrument)

# Verify the device appears after driver installation
ls /dev/tty.usbserial*
# Typical output: /dev/tty.usbserial-0001

Verify with PyVISA

Once the driver is installed and the instrument is connected, use PyVISA to confirm everything works:

import pyvisa

rm = pyvisa.ResourceManager()
resources = rm.list_resources()
print("Found resources:", resources)

# Connect to an instrument at GPIB address 22
inst = rm.open_resource('GPIB0::22::INSTR')
print(inst.query('*IDN?'))

Expected output:

Found resources: ('GPIB0::22::INSTR',)
Keysight Technologies,34461A,MY12345678,A.02.17-02.40-02.17-00.49-03-01

Troubleshooting

GPIB controller not found in NI MAX / Device Manager

Unplug and replug the USB controller. If it still doesn't appear, try a different USB port (avoid hubs). On Windows, open Device Manager and look for unknown devices with a yellow warning icon — right-click and update the driver manually pointing to the NI-VISA installation directory.

list_resources() returns empty — no GPIB devices found

Check the GPIB address on the instrument's front panel (usually under System → I/O → GPIB Address). Default address is often 1 for controllers or 22 for common instruments. Try scanning manually:

import pyvisa
rm = pyvisa.ResourceManager()
# Try a specific address directly if list_resources is empty
inst = rm.open_resource('GPIB0::1::INSTR')
print(inst.query('*IDN?'))

VisaIOError: VI_ERROR_TMO (timeout)

The instrument is not responding within the default timeout. This usually means the GPIB address is wrong, or the instrument is busy. Verify the address on the front panel and increase the timeout:

inst.timeout = 10000  # 10 seconds

Address conflict — multiple instruments not responding correctly

Every instrument on the bus must have a unique GPIB address. If two instruments share the same address, neither will respond reliably. Check and reassign addresses via each instrument's front panel menu (usually System → Interface → GPIB → Address).

Linux: permission denied on GPIB device

With NI-VISA on Linux, ensure your user is in the ni group. With linux-gpib, ensure the group is gpib:

sudo usermod -aG gpib $USER
newgrp gpib

Slow transfer speeds

GPIB transfer speed is limited by the slowest device on the bus. If one old instrument limits bus speed, use inst.visalib.set_attribute to enable T1 delay compensation, or physically remove slow instruments from the chain when doing high-speed transfers.

Next Steps

With GPIB working, explore these resources: