Instruments

Discover and list all test instruments connected to a Lager Box.

Syntax

lager instruments [OPTIONS]

Options

Option	Description
`--box BOX`	Lager Box name or IP address

Usage

# List instruments on default Lager Box
lager instruments

# List instruments on specific Lager Box
lager instruments --box my-lager-box

Output

The command displays a table of connected instruments. The Channels column has one line for each net type that the instrument offers, with the channels for that type. Use the name, a channel, and the address from this table with lager nets add.

Name                     Channels                                                       VISA Address
========================================================================================================================
Rigol_DP831              power-supply: 1, 2, 3                                          USB0::0x1AB1::0x0E31::DP8C123456789::INSTR
LabJack_U3               adc: AIN0, AIN1, AIN2, AIN3, AIN4, AIN5, AIN6, AIN7, AIN8,     USB0::0x0CD5::0x0003::port-1-1.3::INSTR
                         AIN9, AIN10, AIN11, AIN12, AIN13, AIN14, AIN15
                         dac: DAC0, DAC1
                         gpio: FIO4, FIO5, FIO6, FIO7, EIO0, EIO1, EIO2, EIO3, EIO4,
                         EIO5, EIO6, EIO7, CIO0, CIO1, CIO2, CIO3
                         i2c: FIO6-FIO7
                         spi: FIO4-FIO7

The box holds the channel list. Run lager update on the box to get the current list.

Instrument Types

The following instrument types are automatically detected:

Power Supplies

Rigol DP800 series (DP811, DP821, DP831, DP832)
Keysight E36233A, E36312A, E36313A
Keithley 2281S
Siglent SPD1168X
EA PSB 10060-60, PSB 10080-60

A Rigol DP711 talks RS-232 through a USB-serial cable, so it is not detected. Assign the cable to it with lager nets assign.

Oscilloscopes

Rigol MSO5204 (analog channels and logic analyzer)
Rigol DS1000Z series
PicoScope

Battery/Solar Simulators

Keithley 2281S (battery)
EA PSB 10060-60, PSB 10080-60 (solar)

Electronic Loads

Rigol DL3021

Multimeters

Siglent SDM3065X

Data Acquisition

LabJack T7 (ADC, DAC, GPIO, SPI, I2C)
LabJack U3 (ADC, DAC, GPIO, SPI, I2C)
MCC USB-202 (ADC, DAC, GPIO)
Phidget thermocouples
Yocto-Watt watt meters

Power Analyzers

Joulescope JS220 (watt meter, energy analyzer)
Nordic PPK2 (watt meter, energy analyzer)

Multi-Protocol Adapters

Total Phase Aardvark (SPI, I2C, GPIO)
FTDI FT232H, FT2232H, FT4232H (SPI, I2C, GPIO, UART, debug)

USB Hubs

Acroname (4-port, 8-port)
YKUSH and YKUSH3 (a YKUSH3 also offers 3 GPIO pins)
Plugable USB hub

Debug Probes

Segger J-Link, J-Link OB, J-Link Plus, J-Link Base Compact, Flasher ARM, Flasher Pro
CMSIS-DAP (DAPLink), Raspberry Pi Picoprobe, Atmel EDBG
ST-Link V2, V2-1, V3 and V3 Mini

Serial Adapters

FTDI FT232R, Silicon Labs CP210x, Prolific USB-serial and ESP32 JTAG serial
The UART channels of the FTDI FT232H, FT2232H and FT4232H

Cameras

Logitech C270, C615, C920, C922 Pro, C925e, C930e, BRIO, StreamCam and 4K Pro
IPEVO V4K Pro and ELP Global Shutter AR0234
Any other UVC camera, as UVC_Camera

Other

YubiHSM 2 (hsm)
Rotrics Dexarm (arm)

Two Devices That Report One Address

An address normally includes the USB serial number of the device, so two devices of one model have different addresses. Both appear in the table, and each can have nets. A LabJack T7 reports no serial number. Two T7 units on one Lager Box therefore report the same address. A net cannot say which device it means. The command hides those rows and prints this message under the table:

LabJack_T7 at USB0::0x0CD5::0x0007::::INSTR: more than one device reports this address, so a net could not say which one it means. This model exposes no unique serial number. Use only one at a time, or drive them from separate boxes.

lager nets add refuses a net on that address. See Nets for the same rule in add-all and the TUI. A LabJack U3 also reports no serial number, but its address names the USB port, for example USB0::0x0CD5::0x0003::port-1-1.3::INSTR. Two U3 units have different addresses, and both appear in the table.

Address Formats

Different instruments use different address formats:

Type	Format	Example
USB instrument	`USB0::0x<VID>::0x<PID>::<serial>::INSTR`	`USB0::0x1AB1::0x0E31::DP8C123456789::INSTR`
LabJack T7	USB resource with an empty serial field	`USB0::0x0CD5::0x0007::::INSTR`
LabJack U3	USB resource with the USB port in the serial field	`USB0::0x0CD5::0x0003::port-1-1.3::INSTR`
Nordic PPK2	`ppk2:<serial>`	`ppk2:ABCDEF123456`
Assigned RS-232 instrument	`serial://<vid>:<pid>/serial/<serial>`	`serial://067b:23a3/serial/00000006`

Examples

# Check what instruments are connected
lager instruments --box my-lager-box

# Use with nets command to configure
lager instruments --box my-lager-box
lager nets --box my-lager-box  # Then configure nets for discovered instruments

Troubleshooting

Issue	Cause	Fix
No instruments listed	USB cables disconnected, or Docker not running	Check physical USB connections. Run `lager hello --box <box>` to verify the service is running.
Specific instrument missing	Instrument needs power, USB re-seat, or updated udev rules	Unplug and replug the USB cable. Ensure the instrument is powered on. Run `lager update --box <box>` for latest drivers.
”more than one device reports this address” message	Two devices with no serial number, such as two LabJack T7 units, are connected	Use only one of them on this Lager Box. Connect the other one to a different Lager Box.

Notes

Instruments must be connected via USB to the Lager Box
Some instruments require specific drivers (udev rules)
Run lager update to install latest udev rules
Use lager nets to configure how instruments are used

Lager Box Management

Configuration

Power & Simulation

Measurement

I/O & Communication

Security

Development

Utilities

Syntax

Options

Usage

Output

Instrument Types

Power Supplies

Oscilloscopes

Battery/Solar Simulators

Electronic Loads

Multimeters

Data Acquisition

Power Analyzers

Multi-Protocol Adapters

USB Hubs

Debug Probes

Serial Adapters

Cameras

Other

Two Devices That Report One Address

Address Formats

Examples

Troubleshooting

Notes

See Also

​Syntax

​Options

​Usage

​Output

​Instrument Types

​Power Supplies

​Oscilloscopes

​Battery/Solar Simulators

​Electronic Loads

​Multimeters

​Data Acquisition

​Power Analyzers

​Multi-Protocol Adapters

​USB Hubs

​Debug Probes

​Serial Adapters

​Cameras

​Other

​Two Devices That Report One Address

​Address Formats

​Examples

​Troubleshooting

​Notes

​See Also

Syntax

Options

Usage

Output

Instrument Types

Power Supplies

Oscilloscopes

Battery/Solar Simulators

Electronic Loads

Multimeters

Data Acquisition

Power Analyzers

Multi-Protocol Adapters

USB Hubs

Debug Probes

Serial Adapters

Cameras

Other

Two Devices That Report One Address

Address Formats

Examples

Troubleshooting

Notes

See Also