probesdru

Detailed USRP radio information

Add-On Required: This feature requires the Wireless Testbench™ Support Package for NI™ USRP™ Radios add-on.

Syntax

info = probesdru

info = probesdru(IPAddress)

info = probesdru(serialNum)

[info,status] = probesdru(___)

Description

info = probesdru returns information about the USRP™ radio connected to the host computer. If more than one USRP radio is connected to the host computer, the function returns radio information for the first discovered radio.

probesdru calls the UHD™ application uhd_usrp_probe, provided by Ettus Research™, as a system command and returns the output.

info = probesdru(IPAddress) returns detailed information on the USRP radio located at the specified IP address.

info = probesdru(serialNum) returns detailed information on the USRP radio with the specified serial number.

[info,status] = probesdru(___) additionally returns the status of the system command execution status.

Examples

Get USRP Radio Information

Get detailed information about the USRP radio connected to the host computer. This function syntax returns radio information for the first radio that the function finds.

info = probesdru

info = 
    '□[0;32m[INFO] [UHD] □[0;39mlinux; GNU C++ version 12.3.0; Boost_108100; UHD_4.6.0.0-vendor
     □[0;32m[INFO] [MPMD] □[0;39mInitializing 1 device(s) in parallel with args: mgmt_addr=192.168.20.2,type=n3xx,product=n310,serial=3209C74,name=ni-n3xx-3209C74,fpga=HG,claimed=False,addr=192.168.20.2
     □[0;32m[INFO] [MPM.PeriphManager] □[0;39minit() called with device args `fpga=HG,mgmt_addr=192.168.20.2,name=ni-n3xx-3209C74,product=n310,clock_source=internal,time_source=internal'.
       _____________________________________________________
      /
     |       Device: N300-Series Device
     |     _____________________________________________________
     |    /
     |   |       Mboard: ni-n3xx-3209C74
     |   |   dboard_0_pid: 336
     |   |   dboard_0_serial: 3202CC4
     |   |   dboard_1_pid: 336
     |   |   dboard_1_serial: 3202CC5
     |   |   eeprom_version: 3
     |   |   fs_version: 20231113194400
     |   |   mender_artifact: v4.6.0.0_n3xx
     |   |   mpm_sw_version: 4.6.0.0-g50fa3baa
     |   |   pid: 16962
     |   |   product: n310
     |   |   rev: 10
     |   |   rpc_connection: remote
     |   |   serial: 3209C74
     |   |   type: n3xx
     |   |   MPM Version: 5.3
     |   |   FPGA Version: 8.2
     |   |   FPGA git hash: d6608fc.clean
     |   |   RFNoC capable: Yes
     |   |   
     |   |   Time sources:  internal, external, gpsdo, sfp0
     |   |   Clock sources: external, internal, gpsdo
     |   |   Sensors: ref_locked, gps_locked, temp, fan, gps_gpgga, gps_sky, gps_time, gps_tpv
     |     _____________________________________________________
     |    /
     |   |       RFNoC blocks on this device:
     |   |   
     |   |   * 0/DDC#0
     |   |   * 0/DDC#1
     |   |   * 0/DUC#0
     |   |   * 0/DUC#1
     |   |   * 0/Radio#0
     |   |   * 0/Radio#1
     |   |   * 0/Replay#0
     |     _____________________________________________________
     |    /
     |   |       Static connections on this device:
     |   |   
     |   |   * 0/SEP#0:0==>0/DUC#0:0
     |   |   * 0/DUC#0:0==>0/Radio#0:0
     |   |   * 0/Radio#0:0==>0/DDC#0:0
     |   |   * 0/DDC#0:0==>0/SEP#0:0
     |   |   * 0/SEP#1:0==>0/DUC#0:1
     |   |   * 0/DUC#0:1==>0/Radio#0:1
     |   |   * 0/Radio#0:1==>0/DDC#0:1
     |   |   * 0/DDC#0:1==>0/SEP#1:0
     |   |   * 0/SEP#2:0==>0/DUC#1:0
     |   |   * 0/DUC#1:0==>0/Radio#1:0
     |   |   * 0/Radio#1:0==>0/DDC#1:0
     |   |   * 0/DDC#1:0==>0/SEP#2:0
     |   |   * 0/SEP#3:0==>0/DUC#1:1
     |   |   * 0/DUC#1:1==>0/Radio#1:1
     |   |   * 0/Radio#1:1==>0/DDC#1:1
     |   |   * 0/DDC#1:1==>0/SEP#3:0
     |   |   * 0/SEP#4:0==>0/Replay#0:0
     |   |   * 0/Replay#0:0==>0/SEP#4:0
     |   |   * 0/SEP#5:0==>0/Replay#0:1
     |   |   * 0/Replay#0:1==>0/SEP#5:0
     |   |   * 0/SEP#6:0==>0/Replay#0:2
     |   |   * 0/Replay#0:2==>0/SEP#6:0
     |   |   * 0/SEP#7:0==>0/Replay#0:3
     |   |   * 0/Replay#0:3==>0/SEP#7:0
     |     _____________________________________________________
     |    /
     |   |       TX Dboard: 0/Radio#0
     |   |     _____________________________________________________
     |   |    /
     |   |   |       TX Frontend: 0
     |   |   |   Name: Magnesium
     |   |   |   Antennas: TX/RX
     |   |   |   Freq range: 1.000 to 6000.000 MHz
     |   |   |   Gain range rfic: 0.0 to 0.0 step 0.0 dB
     |   |   |   Gain range dsa: 0.0 to 0.0 step 0.0 dB
     |   |   |   Gain range amp: 0.0 to 0.0 step 0.0 dB
     |   |   |   Gain range all: 0.0 to 65.0 step 0.5 dB
     |   |   |   Bandwidth range: 20000000.0 to 100000000.0 step 0.0 Hz
     |   |   |   Connection Type: IQ
     |   |   |   Uses LO offset: No
     |   |     _____________________________________________________
     |   |    /
     |   |   |       TX Frontend: 1
     |   |   |   Name: Magnesium
     |   |   |   Antennas: TX/RX
     |   |   |   Freq range: 1.000 to 6000.000 MHz
     |   |   |   Gain range rfic: 0.0 to 0.0 step 0.0 dB
     |   |   |   Gain range dsa: 0.0 to 0.0 step 0.0 dB
     |   |   |   Gain range amp: 0.0 to 0.0 step 0.0 dB
     |   |   |   Gain range all: 0.0 to 65.0 step 0.5 dB
     |   |   |   Bandwidth range: 20000000.0 to 100000000.0 step 0.0 Hz
     |   |   |   Connection Type: IQ
     |   |   |   Uses LO offset: No
     |     _____________________________________________________
     |    /
     |   |       RX Dboard: 0/Radio#0
     |   |     _____________________________________________________
     |   |    /
     |   |   |       RX Frontend: 0
     |   |   |   Name: Magnesium
     |   |   |   Antennas: TX/RX, RX2, CAL, LOCAL
     |   |   |   Freq range: 1.000 to 6000.000 MHz
     |   |   |   Gain range rfic: 0.0 to 0.0 step 0.0 dB
     |   |   |   Gain range dsa: 0.0 to 0.0 step 0.0 dB
     |   |   |   Gain range amp: 0.0 to 0.0 step 0.0 dB
     |   |   |   Gain range all: 0.0 to 75.0 step 0.5 dB
     |   |   |   Bandwidth range: 20000000.0 to 100000000.0 step 0.0 Hz
     |   |   |   Connection Type: IQ
     |   |   |   Uses LO offset: No
     |   |     _____________________________________________________
     |   |    /
     |   |   |       RX Frontend: 1
     |   |   |   Name: Magnesium
     |   |   |   Antennas: TX/RX, RX2, CAL, LOCAL
     |   |   |   Freq range: 1.000 to 6000.000 MHz
     |   |   |   Gain range rfic: 0.0 to 0.0 step 0.0 dB
     |   |   |   Gain range dsa: 0.0 to 0.0 step 0.0 dB
     |   |   |   Gain range amp: 0.0 to 0.0 step 0.0 dB
     |   |   |   Gain range all: 0.0 to 75.0 step 0.5 dB
     |   |   |   Bandwidth range: 20000000.0 to 100000000.0 step 0.0 Hz
     |   |   |   Connection Type: IQ
     |   |   |   Uses LO offset: No
     |     _____________________________________________________
     |    /
     |   |       TX Dboard: 0/Radio#1
     |   |     _____________________________________________________
     |   |    /
     |   |   |       TX Frontend: 0
     |   |   |   Name: Magnesium
     |   |   |   Antennas: TX/RX
     |   |   |   Freq range: 1.000 to 6000.000 MHz
     |   |   |   Gain range rfic: 0.0 to 0.0 step 0.0 dB
     |   |   |   Gain range dsa: 0.0 to 0.0 step 0.0 dB
     |   |   |   Gain range amp: 0.0 to 0.0 step 0.0 dB
     |   |   |   Gain range all: 0.0 to 65.0 step 0.5 dB
     |   |   |   Bandwidth range: 20000000.0 to 100000000.0 step 0.0 Hz
     |   |   |   Connection Type: IQ
     |   |   |   Uses LO offset: No
     |   |     _____________________________________________________
     |   |    /
     |   |   |       TX Frontend: 1
     |   |   |   Name: Magnesium
     |   |   |   Antennas: TX/RX
     |   |   |   Freq range: 1.000 to 6000.000 MHz
     |   |   |   Gain range rfic: 0.0 to 0.0 step 0.0 dB
     |   |   |   Gain range dsa: 0.0 to 0.0 step 0.0 dB
     |   |   |   Gain range amp: 0.0 to 0.0 step 0.0 dB
     |   |   |   Gain range all: 0.0 to 65.0 step 0.5 dB
     |   |   |   Bandwidth range: 20000000.0 to 100000000.0 step 0.0 Hz
     |   |   |   Connection Type: IQ
     |   |   |   Uses LO offset: No
     |     _____________________________________________________
     |    /
     |   |       RX Dboard: 0/Radio#1
     |   |     _____________________________________________________
     |   |    /
     |   |   |       RX Frontend: 0
     |   |   |   Name: Magnesium
     |   |   |   Antennas: TX/RX, RX2, CAL, LOCAL
     |   |   |   Freq range: 1.000 to 6000.000 MHz
     |   |   |   Gain range rfic: 0.0 to 0.0 step 0.0 dB
     |   |   |   Gain range dsa: 0.0 to 0.0 step 0.0 dB
     |   |   |   Gain range amp: 0.0 to 0.0 step 0.0 dB
     |   |   |   Gain range all: 0.0 to 75.0 step 0.5 dB
     |   |   |   Bandwidth range: 20000000.0 to 100000000.0 step 0.0 Hz
     |   |   |   Connection Type: IQ
     |   |   |   Uses LO offset: No
     |   |     _____________________________________________________
     |   |    /
     |   |   |       RX Frontend: 1
     |   |   |   Name: Magnesium
     |   |   |   Antennas: TX/RX, RX2, CAL, LOCAL
     |   |   |   Freq range: 1.000 to 6000.000 MHz
     |   |   |   Gain range rfic: 0.0 to 0.0 step 0.0 dB
     |   |   |   Gain range dsa: 0.0 to 0.0 step 0.0 dB
     |   |   |   Gain range amp: 0.0 to 0.0 step 0.0 dB
     |   |   |   Gain range all: 0.0 to 75.0 step 0.5 dB
     |   |   |   Bandwidth range: 20000000.0 to 100000000.0 step 0.0 Hz
     |   |   |   Connection Type: IQ
     |   |   |   Uses LO offset: No
     
     '

Get Information About USRP Radio at Specified IP Address

Get detailed information about the USRP radio at the IP address 192.168.10.2.

[info,status] = probesdru('192.168.10.2')

info = 
    '□[0;32m[INFO] [UHD] □[0;39mlinux; GNU C++ version 12.3.0; Boost_108100; UHD_4.6.0.0-vendor
     □[0;32m[INFO] [MPMD] □[0;39mInitializing 1 device(s) in parallel with args: mgmt_addr=192.168.10.2,type=n3xx,product=n310,serial=3209C74,name=ni-n3xx-3209C74,fpga=HG,claimed=False,addr=192.168.10.2
     □[0;32m[INFO] [MPM.PeriphManager] □[0;39minit() called with device args `fpga=HG,mgmt_addr=192.168.10.2,name=ni-n3xx-3209C74,product=n310,clock_source=internal,time_source=internal'.
       _____________________________________________________
      /
     |       Device: N300-Series Device
     |     _____________________________________________________
     |    /
     |   |       Mboard: ni-n3xx-3209C74
     |   |   dboard_0_pid: 336
     |   |   dboard_0_serial: 3202CC4
     |   |   dboard_1_pid: 336
     |   |   dboard_1_serial: 3202CC5
     |   |   eeprom_version: 3
     |   |   fs_version: 20231113194400
     |   |   mender_artifact: v4.6.0.0_n3xx
     |   |   mpm_sw_version: 4.6.0.0-g50fa3baa
     |   |   pid: 16962
     |   |   product: n310
     |   |   rev: 10
     |   |   rpc_connection: remote
     |   |   serial: 3209C74
     |   |   type: n3xx
     |   |   MPM Version: 5.3
     |   |   FPGA Version: 8.2
     |   |   FPGA git hash: d6608fc.clean
     |   |   RFNoC capable: Yes
     |   |   
     |   |   Time sources:  internal, external, gpsdo, sfp0
     |   |   Clock sources: external, internal, gpsdo
     |   |   Sensors: ref_locked, gps_locked, temp, fan, gps_gpgga, gps_sky, gps_time, gps_tpv
     |     _____________________________________________________
     |    /
     |   |       RFNoC blocks on this device:
     |   |   
     |   |   * 0/DDC#0
     |   |   * 0/DDC#1
     |   |   * 0/DUC#0
     |   |   * 0/DUC#1
     |   |   * 0/Radio#0
     |   |   * 0/Radio#1
     |   |   * 0/Replay#0
     |     _____________________________________________________
     |    /
     |   |       Static connections on this device:
     |   |   
     |   |   * 0/SEP#0:0==>0/DUC#0:0
     |   |   * 0/DUC#0:0==>0/Radio#0:0
     |   |   * 0/Radio#0:0==>0/DDC#0:0
     |   |   * 0/DDC#0:0==>0/SEP#0:0
     |   |   * 0/SEP#1:0==>0/DUC#0:1
     |   |   * 0/DUC#0:1==>0/Radio#0:1
     |   |   * 0/Radio#0:1==>0/DDC#0:1
     |   |   * 0/DDC#0:1==>0/SEP#1:0
     |   |   * 0/SEP#2:0==>0/DUC#1:0
     |   |   * 0/DUC#1:0==>0/Radio#1:0
     |   |   * 0/Radio#1:0==>0/DDC#1:0
     |   |   * 0/DDC#1:0==>0/SEP#2:0
     |   |   * 0/SEP#3:0==>0/DUC#1:1
     |   |   * 0/DUC#1:1==>0/Radio#1:1
     |   |   * 0/Radio#1:1==>0/DDC#1:1
     |   |   * 0/DDC#1:1==>0/SEP#3:0
     |   |   * 0/SEP#4:0==>0/Replay#0:0
     |   |   * 0/Replay#0:0==>0/SEP#4:0
     |   |   * 0/SEP#5:0==>0/Replay#0:1
     |   |   * 0/Replay#0:1==>0/SEP#5:0
     |   |   * 0/SEP#6:0==>0/Replay#0:2
     |   |   * 0/Replay#0:2==>0/SEP#6:0
     |   |   * 0/SEP#7:0==>0/Replay#0:3
     |   |   * 0/Replay#0:3==>0/SEP#7:0
     |     _____________________________________________________
     |    /
     |   |       TX Dboard: 0/Radio#0
     |   |     _____________________________________________________
     |   |    /
     |   |   |       TX Frontend: 0
     |   |   |   Name: Magnesium
     |   |   |   Antennas: TX/RX
     |   |   |   Freq range: 1.000 to 6000.000 MHz
     |   |   |   Gain range rfic: 0.0 to 0.0 step 0.0 dB
     |   |   |   Gain range dsa: 0.0 to 0.0 step 0.0 dB
     |   |   |   Gain range amp: 0.0 to 0.0 step 0.0 dB
     |   |   |   Gain range all: 0.0 to 65.0 step 0.5 dB
     |   |   |   Bandwidth range: 20000000.0 to 100000000.0 step 0.0 Hz
     |   |   |   Connection Type: IQ
     |   |   |   Uses LO offset: No
     |   |     _____________________________________________________
     |   |    /
     |   |   |       TX Frontend: 1
     |   |   |   Name: Magnesium
     |   |   |   Antennas: TX/RX
     |   |   |   Freq range: 1.000 to 6000.000 MHz
     |   |   |   Gain range rfic: 0.0 to 0.0 step 0.0 dB
     |   |   |   Gain range dsa: 0.0 to 0.0 step 0.0 dB
     |   |   |   Gain range amp: 0.0 to 0.0 step 0.0 dB
     |   |   |   Gain range all: 0.0 to 65.0 step 0.5 dB
     |   |   |   Bandwidth range: 20000000.0 to 100000000.0 step 0.0 Hz
     |   |   |   Connection Type: IQ
     |   |   |   Uses LO offset: No
     |     _____________________________________________________
     |    /
     |   |       RX Dboard: 0/Radio#0
     |   |     _____________________________________________________
     |   |    /
     |   |   |       RX Frontend: 0
     |   |   |   Name: Magnesium
     |   |   |   Antennas: TX/RX, RX2, CAL, LOCAL
     |   |   |   Freq range: 1.000 to 6000.000 MHz
     |   |   |   Gain range rfic: 0.0 to 0.0 step 0.0 dB
     |   |   |   Gain range dsa: 0.0 to 0.0 step 0.0 dB
     |   |   |   Gain range amp: 0.0 to 0.0 step 0.0 dB
     |   |   |   Gain range all: 0.0 to 75.0 step 0.5 dB
     |   |   |   Bandwidth range: 20000000.0 to 100000000.0 step 0.0 Hz
     |   |   |   Connection Type: IQ
     |   |   |   Uses LO offset: No
     |   |     _____________________________________________________
     |   |    /
     |   |   |       RX Frontend: 1
     |   |   |   Name: Magnesium
     |   |   |   Antennas: TX/RX, RX2, CAL, LOCAL
     |   |   |   Freq range: 1.000 to 6000.000 MHz
     |   |   |   Gain range rfic: 0.0 to 0.0 step 0.0 dB
     |   |   |   Gain range dsa: 0.0 to 0.0 step 0.0 dB
     |   |   |   Gain range amp: 0.0 to 0.0 step 0.0 dB
     |   |   |   Gain range all: 0.0 to 75.0 step 0.5 dB
     |   |   |   Bandwidth range: 20000000.0 to 100000000.0 step 0.0 Hz
     |   |   |   Connection Type: IQ
     |   |   |   Uses LO offset: No
     |     _____________________________________________________
     |    /
     |   |       TX Dboard: 0/Radio#1
     |   |     _____________________________________________________
     |   |    /
     |   |   |       TX Frontend: 0
     |   |   |   Name: Magnesium
     |   |   |   Antennas: TX/RX
     |   |   |   Freq range: 1.000 to 6000.000 MHz
     |   |   |   Gain range rfic: 0.0 to 0.0 step 0.0 dB
     |   |   |   Gain range dsa: 0.0 to 0.0 step 0.0 dB
     |   |   |   Gain range amp: 0.0 to 0.0 step 0.0 dB
     |   |   |   Gain range all: 0.0 to 65.0 step 0.5 dB
     |   |   |   Bandwidth range: 20000000.0 to 100000000.0 step 0.0 Hz
     |   |   |   Connection Type: IQ
     |   |   |   Uses LO offset: No
     |   |     _____________________________________________________
     |   |    /
     |   |   |       TX Frontend: 1
     |   |   |   Name: Magnesium
     |   |   |   Antennas: TX/RX
     |   |   |   Freq range: 1.000 to 6000.000 MHz
     |   |   |   Gain range rfic: 0.0 to 0.0 step 0.0 dB
     |   |   |   Gain range dsa: 0.0 to 0.0 step 0.0 dB
     |   |   |   Gain range amp: 0.0 to 0.0 step 0.0 dB
     |   |   |   Gain range all: 0.0 to 65.0 step 0.5 dB
     |   |   |   Bandwidth range: 20000000.0 to 100000000.0 step 0.0 Hz
     |   |   |   Connection Type: IQ
     |   |   |   Uses LO offset: No
     |     _____________________________________________________
     |    /
     |   |       RX Dboard: 0/Radio#1
     |   |     _____________________________________________________
     |   |    /
     |   |   |       RX Frontend: 0
     |   |   |   Name: Magnesium
     |   |   |   Antennas: TX/RX, RX2, CAL, LOCAL
     |   |   |   Freq range: 1.000 to 6000.000 MHz
     |   |   |   Gain range rfic: 0.0 to 0.0 step 0.0 dB
     |   |   |   Gain range dsa: 0.0 to 0.0 step 0.0 dB
     |   |   |   Gain range amp: 0.0 to 0.0 step 0.0 dB
     |   |   |   Gain range all: 0.0 to 75.0 step 0.5 dB
     |   |   |   Bandwidth range: 20000000.0 to 100000000.0 step 0.0 Hz
     |   |   |   Connection Type: IQ
     |   |   |   Uses LO offset: No
     |   |     _____________________________________________________
     |   |    /
     |   |   |       RX Frontend: 1
     |   |   |   Name: Magnesium
     |   |   |   Antennas: TX/RX, RX2, CAL, LOCAL
     |   |   |   Freq range: 1.000 to 6000.000 MHz
     |   |   |   Gain range rfic: 0.0 to 0.0 step 0.0 dB
     |   |   |   Gain range dsa: 0.0 to 0.0 step 0.0 dB
     |   |   |   Gain range amp: 0.0 to 0.0 step 0.0 dB
     |   |   |   Gain range all: 0.0 to 75.0 step 0.5 dB
     |   |   |   Bandwidth range: 20000000.0 to 100000000.0 step 0.0 Hz
     |   |   |   Connection Type: IQ
     |   |   |   Uses LO offset: No
     
     '

status = 
0

Input Arguments

IPAddress — IP address of USRP radio

dotted-quad character vector | dotted-quad string scalar

IP address of the USRP radio that is connected to the host computer, specified as a dotted-quad character vector or dotted-quad string scalar.

Data Types: char | string

serialNum — Serial number of USRP radio

character vector | string scalar

Serial number of the USRP radio that is connected to the host computer, specified as a character vector or string scalar.

Data Types: char | string

Output Arguments

info — USRP radio information

character vector | string scalar

USRP radio information, returned as a character vector or string scalar. If you connect more than one USRP radio to the host computer, the function returns radio information for the first discovered radio.

status — Status of system command execution

nonnegative integer

Status of system command execution, returned as a nonnegative integer. A nonzero value indicates an error.

Version History

Introduced in R2013a

R2025a: Support for USRP E320 and X410 radios

You can now use the probesdru function to get detailed information about a USRP E320 or X410 radio connected to the host computer.

R2024a: Support for N3xx and X3xx series radio devices moved to Wireless Testbench

Support for NI™ USRP N3xx and X3xx series radio devices has moved from Communications Toolbox™ Support Package for USRP Radio to Wireless Testbench™ Support Package for NI USRP Radios.