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 = 
    '[INFO] [UHD] Win32; Microsoft Visual C++ version 1936; Boost_108100; UHD_4.2.0.0-vendor
     [INFO] [MPMD] Initializing 1 device(s) in parallel with args: mgmt_addr=192.168.20.2,type=n3xx,product=n320,serial=3202230,name=ni-n3xx-3202230,fpga=HG,claimed=False,addr=192.168.20.2
     [INFO] [MPM.PeriphManager] init() called with device args `fpga=HG,mgmt_addr=192.168.20.2,name=ni-n3xx-3202230,product=n320,clock_source=internal,time_source=internal'.
     [INFO] [MPM.Rhodium-0] init() called with args `fpga=HG,mgmt_addr=192.168.20.2,name=ni-n3xx-3202230,product=n320,clock_source=internal,time_source=internal'
     [INFO] [MPM.Rhodium-1] init() called with args `fpga=HG,mgmt_addr=192.168.20.2,name=ni-n3xx-3202230,product=n320,clock_source=internal,time_source=internal'
     [INFO] [MPM.Rhodium-1.init.LMK04828] LMK initialized and locked!
     [INFO] [MPM.Rhodium-0.init.LMK04828] LMK initialized and locked!
     [INFO] [MPM.Rhodium-1.DAC37J82] DAC PLL Locked!
     [INFO] [MPM.Rhodium-1.AD9695] ADC PLL Locked!
     [INFO] [MPM.Rhodium-1.init] JESD204B Link Initialization & Training Complete
     [INFO] [MPM.Rhodium-0.DAC37J82] DAC PLL Locked!
     [INFO] [MPM.Rhodium-0.AD9695] ADC PLL Locked!
     [INFO] [MPM.Rhodium-0.init] JESD204B Link Initialization & Training Complete
       _____________________________________________________
      /
     |       Device: N300-Series Device
     |     _____________________________________________________
     |    /
     |   |       Mboard: ni-n3xx-3202230
     |   |   dboard_0_pid: 338
     |   |   dboard_0_serial: 31FF4F1
     |   |   dboard_1_pid: 338
     |   |   dboard_1_serial: 31FF506
     |   |   eeprom_version: 3
     |   |   fs_version: 20220728200715
     |   |   mender_artifact: v4.2.0.1_n3xx
     |   |   mpm_sw_version: 4.2.0.1-g321295fb
     |   |   pid: 16962
     |   |   product: n320
     |   |   rev: 10
     |   |   rpc_connection: remote
     |   |   serial: 3202230
     |   |   type: n3xx
     |   |   MPM Version: 4.2
     |   |   FPGA Version: 8.0
     |   |   FPGA git hash: 8daa80c.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#1:0
     |   |   * 0/DUC#1:0==>0/Radio#1:0
     |   |   * 0/Radio#1:0==>0/DDC#1:0
     |   |   * 0/DDC#1:0==>0/SEP#1:0
     |   |   * 0/SEP#2:0==>0/Replay#0:0
     |   |   * 0/Replay#0:0==>0/SEP#2:0
     |   |   * 0/SEP#3:0==>0/Replay#0:1
     |   |   * 0/Replay#0:1==>0/SEP#3:0
     |     _____________________________________________________
     |    /
     |   |       TX Dboard: 0/Radio#0
     |   |     _____________________________________________________
     |   |    /
     |   |   |       TX Frontend: 0
     |   |   |   Name: Rhodium
     |   |   |   Antennas: TX/RX, CAL, TERM
     |   |   |   Freq range: 1.000 to 6000.000 MHz
     |   |   |   Gain range all: 0.0 to 60.0 step 1.0 dB
     |   |   |   Bandwidth range: 250000000.0 to 250000000.0 step 0.0 Hz
     |   |   |   Connection Type: 
     |   |   |   Uses LO offset: No
     |     _____________________________________________________
     |    /
     |   |       RX Dboard: 0/Radio#0
     |   |     _____________________________________________________
     |   |    /
     |   |   |       RX Frontend: 0
     |   |   |   Name: Rhodium
     |   |   |   Antennas: TX/RX, RX2, CAL, TERM
     |   |   |   Freq range: 1.000 to 6000.000 MHz
     |   |   |   Gain range all: 0.0 to 60.0 step 1.0 dB
     |   |   |   Bandwidth range: 250000000.0 to 250000000.0 step 0.0 Hz
     |   |   |   Connection Type: 
     |   |   |   Uses LO offset: No
     |     _____________________________________________________
     |    /
     |   |       TX Dboard: 0/Radio#1
     |   |     _____________________________________________________
     |   |    /
     |   |   |       TX Frontend: 0
     |   |   |   Name: Rhodium
     |   |   |   Antennas: TX/RX, CAL, TERM
     |   |   |   Freq range: 1.000 to 6000.000 MHz
     |   |   |   Gain range all: 0.0 to 60.0 step 1.0 dB
     |   |   |   Bandwidth range: 250000000.0 to 250000000.0 step 0.0 Hz
     |   |   |   Connection Type: 
     |   |   |   Uses LO offset: No
     |     _____________________________________________________
     |    /
     |   |       RX Dboard: 0/Radio#1
     |   |     _____________________________________________________
     |   |    /
     |   |   |       RX Frontend: 0
     |   |   |   Name: Rhodium
     |   |   |   Antennas: TX/RX, RX2, CAL, TERM
     |   |   |   Freq range: 1.000 to 6000.000 MHz
     |   |   |   Gain range all: 0.0 to 60.0 step 1.0 dB
     |   |   |   Bandwidth range: 250000000.0 to 250000000.0 step 0.0 Hz
     |   |   |   Connection Type: 
     |   |   |   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.40.2.

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

info = 
    '□[0;32m[INFO] [UHD] □[0;39mlinux; GNU C++ version 12.3.0; Boost_108100; UHD_4.2.0.0-vendor
     □[0;32m[INFO] [X300] □[0;39mX300 initialization sequence...
     □[0;32m[INFO] [X300] □[0;39mMaximum frame size: 1472 bytes.
     □[1;33m[WARNING] [X300] □[0;39mFor the 192.168.40.2 connection, UHD recommends a send frame size of at least 8000 for best
     performance, but your configuration will only allow 1472.This may negatively impact your maximum achievable sample rate.
     Check the MTU on the interface and/or the send_frame_size argument.
     □[1;33m[WARNING] [X300] □[0;39mFor the 192.168.40.2 connection, UHD recommends a receive frame size of at least 8000 for best
     performance, but your configuration will only allow 1472.This may negatively impact your maximum achievable sample rate.
     Check the MTU on the interface and/or the recv_frame_size argument.
     □[0;32m[INFO] [X300] □[0;39mRadio 1x clock: 200 MHz
     □[1;33m[WARNING] [RFNOC::BLOCK_FACTORY] □[0;39mCould not find block with Noc-ID 0xdafa7703, 0xffff
     □[0;32m[INFO] [0/Block#0] □[0;39mSetting default MTU forward policy.
     □[1;33m[WARNING] [RFNOC::BLOCK_FACTORY] □[0;39mCould not find block with Noc-ID 0xdafa7703, 0xffff
     □[0;32m[INFO] [0/Block#1] □[0;39mSetting default MTU forward policy.
     □[1;33m[WARNING] [RFNOC::BLOCK_FACTORY] □[0;39mCould not find block with Noc-ID 0xd937c02f, 0xffff
     □[0;32m[INFO] [0/Block#2] □[0;39mSetting default MTU forward policy.
       _____________________________________________________
      /
     |       Device: X-Series Device
     |     _____________________________________________________
     |    /
     |   |       Mboard: X310
     |   |   revision: 11
     |   |   revision_compat: 7
     |   |   product: 30818
     |   |   mac-addr0: 00:80:2f:30:6b:12
     |   |   mac-addr1: 00:80:2f:30:6b:13
     |   |   gateway: 192.168.10.1
     |   |   ip-addr0: 192.168.10.8
     |   |   subnet0: 255.255.255.0
     |   |   ip-addr1: 192.168.20.2
     |   |   subnet1: 255.255.255.0
     |   |   ip-addr2: 192.168.30.2
     |   |   subnet2: 255.255.255.0
     |   |   ip-addr3: 192.168.40.2
     |   |   subnet3: 255.255.255.0
     |   |   serial: 31D3D75
     |   |   FW Version: 6.0
     |   |   FPGA Version: 38.0
     |   |   FPGA git hash: fffffff-dirty
     |   |   RFNoC capable: Yes
     |   |   
     |   |   Time sources:  internal, external, gpsdo
     |   |   Clock sources: internal, external, gpsdo
     |   |   Sensors: ref_locked
     |     _____________________________________________________
     |    /
     |   |       RFNoC blocks on this device:
     |   |   
     |   |   * 0/Block#0
     |   |   * 0/Block#1
     |   |   * 0/Block#2
     |   |   * 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/Block#0:0
     |   |   * 0/Block#0:0==>0/DDC#0:0
     |   |   * 0/DDC#0:0==>0/SEP#0:0
     |   |   * 0/SEP#1:0==>0/DUC#1:0
     |   |   * 0/DUC#1:0==>0/Radio#1:0
     |   |   * 0/Radio#1:0==>0/Block#1:0
     |   |   * 0/Block#1:0==>0/DDC#1:0
     |   |   * 0/DDC#1:0==>0/SEP#1:0
     |   |   * 0/SEP#2:0==>0/Replay#0:0
     |   |   * 0/Replay#0:0==>0/SEP#2:0
     |   |   * 0/SEP#3:0==>0/Replay#0:1
     |   |   * 0/Replay#0:1==>0/SEP#3:0
     |     _____________________________________________________
     |    /
     |   |       TX Dboard: 0/Radio#0
     |   |   ID: UBX-160 v2 (0x007d)
     |   |   Serial: 31D581C
     |   |     _____________________________________________________
     |   |    /
     |   |   |       TX Frontend: 0
     |   |   |   Name: UBX TX
     |   |   |   Antennas: TX/RX, CAL
     |   |   |   Sensors: lo_locked
     |   |   |   Freq range: 10.000 to 6000.000 MHz
     |   |   |   Gain range PGA0: 0.0 to 31.5 step 0.5 dB
     |   |   |   Bandwidth range: 160000000.0 to 160000000.0 step 0.0 Hz
     |   |   |   Connection Type: QI
     |   |   |   Uses LO offset: No
     |     _____________________________________________________
     |    /
     |   |       RX Dboard: 0/Radio#0
     |   |   ID: UBX-160 v2 (0x007e)
     |   |   Serial: 31D581C
     |   |     _____________________________________________________
     |   |    /
     |   |   |       RX Frontend: 0
     |   |   |   Name: UBX RX
     |   |   |   Antennas: TX/RX, RX2, CAL
     |   |   |   Sensors: lo_locked
     |   |   |   Freq range: 10.000 to 6000.000 MHz
     |   |   |   Gain range PGA0: 0.0 to 31.5 step 0.5 dB
     |   |   |   Bandwidth range: 160000000.0 to 160000000.0 step 0.0 Hz
     |   |   |   Connection Type: IQ
     |   |   |   Uses LO offset: No
     |     _____________________________________________________
     |    /
     |   |       TX Dboard: 0/Radio#1
     |   |   ID: UBX-160 v2 (0x007d)
     |   |   Serial: 3204150
     |   |     _____________________________________________________
     |   |    /
     |   |   |       TX Frontend: 0
     |   |   |   Name: UBX TX
     |   |   |   Antennas: TX/RX, CAL
     |   |   |   Sensors: lo_locked
     |   |   |   Freq range: 10.000 to 6000.000 MHz
     |   |   |   Gain range PGA0: 0.0 to 31.5 step 0.5 dB
     |   |   |   Bandwidth range: 160000000.0 to 160000000.0 step 0.0 Hz
     |   |   |   Connection Type: QI
     |   |   |   Uses LO offset: No
     |     _____________________________________________________
     |    /
     |   |       RX Dboard: 0/Radio#1
     |   |   ID: UBX-160 v2 (0x007e)
     |   |   Serial: 3204150
     |   |     _____________________________________________________
     |   |    /
     |   |   |       RX Frontend: 0
     |   |   |   Name: UBX RX
     |   |   |   Antennas: TX/RX, RX2, CAL
     |   |   |   Sensors: lo_locked
     |   |   |   Freq range: 10.000 to 6000.000 MHz
     |   |   |   Gain range PGA0: 0.0 to 31.5 step 0.5 dB
     |   |   |   Bandwidth range: 160000000.0 to 160000000.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

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.