probesdru

Detailed USRP radio information

Add-On Required: This feature requires the Communications Toolbox Support Package for USRP Radio 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. If more than one radio is connected to the host computer, use the probesdru(IPAddress) or probesdru(serialNum) syntax instead.

I = probesdru

I = 
    '[INFO] [UHD] Win32; Microsoft Visual C++ version 1936; Boost_108100; UHD_4.6.0.0-vendor
     [INFO] [USRP2] Opening a USRP2/N-Series device...
     [INFO] [USRP2] Current recv frame size: 1472 bytes
     [INFO] [USRP2] Current send frame size: 1472 bytes
       _____________________________________________________
      /
     |       Device: USRP2 / N-Series Device
     |     _____________________________________________________
     |    /
     |   |       Mboard: N210
     |   |   hardware: 2561
     |   |   mac-addr: a0:36:fa:25:30:15
     |   |   ip-addr: 192.168.10.7
     |   |   subnet: 255.255.255.255
     |   |   gateway: 255.255.255.255
     |   |   gpsdo: none
     |   |   serial: E1R10Z5UP
     |   |   FW Version: 12.4
     |   |   FPGA Version: 11.1
     |   |   
     |   |   Time sources:  none, external, _external_, mimo
     |   |   Clock sources: internal, external, mimo
     |   |   Sensors: mimo_locked, ref_locked
     |   |     _____________________________________________________
     |   |    /
     |   |   |       RX DSP: 0
     |   |   |   
     |   |   |   Freq range: -50.000 to 50.000 MHz
     |   |     _____________________________________________________
     |   |    /
     |   |   |       RX DSP: 1
     |   |   |   
     |   |   |   Freq range: -50.000 to 50.000 MHz
     |   |     _____________________________________________________
     |   |    /
     |   |   |       RX Dboard: A
     |   |   |   ID: WBX, WBX + Simple GDB (0x0053)
     |   |   |     _____________________________________________________
     |   |   |    /
     |   |   |   |       RX Frontend: 0
     |   |   |   |   Name: WBXv2 RX+GDB
     |   |   |   |   Antennas: TX/RX, RX2, CAL
     |   |   |   |   Sensors: lo_locked
     |   |   |   |   Freq range: 68.750 to 2200.000 MHz
     |   |   |   |   Gain range PGA0: 0.0 to 31.5 step 0.5 dB
     |   |   |   |   Bandwidth range: 40000000.0 to 40000000.0 step 0.0 Hz
     |   |   |   |   Connection Type: IQ
     |   |   |   |   Uses LO offset: No
     |   |   |     _____________________________________________________
     |   |   |    /
     |   |   |   |       RX Codec: A
     |   |   |   |   Name: ads62p44
     |   |   |   |   Gain range digital: 0.0 to 6.0 step 0.5 dB
     |   |   |   |   Gain range fine: 0.0 to 0.5 step 0.1 dB
     |   |     _____________________________________________________
     |   |    /
     |   |   |       TX DSP: 0
     |   |   |   
     |   |   |   Freq range: -200.000 to 200.000 MHz
     |   |     _____________________________________________________
     |   |    /
     |   |   |       TX Dboard: A
     |   |   |   ID: WBX (0x0052)
     |   |   |     _____________________________________________________
     |   |   |    /
     |   |   |   |       TX Frontend: 0
     |   |   |   |   Name: WBXv2 TX+GDB
     |   |   |   |   Antennas: TX/RX, CAL
     |   |   |   |   Sensors: lo_locked
     |   |   |   |   Freq range: 68.750 to 2200.000 MHz
     |   |   |   |   Gain range PGA0: 0.0 to 25.0 step 0.1 dB
     |   |   |   |   Bandwidth range: 40000000.0 to 40000000.0 step 0.0 Hz
     |   |   |   |   Connection Type: IQ
     |   |   |   |   Uses LO offset: No
     |   |   |     _____________________________________________________
     |   |   |    /
     |   |   |   |       TX Codec: A
     |   |   |   |   Name: ad9777
     |   |   |   |   Gain Elements: None
     
     '

Get Information About USRP Radio at Specified IP Address

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

info = probesdru('192.168.10.7')

info = 
    '[INFO] [UHD] Win32; Microsoft Visual C++ version 1936; Boost_108100; UHD_4.6.0.0-vendor
     [INFO] [USRP2] Opening a USRP2/N-Series device...
     [INFO] [USRP2] Current recv frame size: 1472 bytes
     [INFO] [USRP2] Current send frame size: 1472 bytes
       _____________________________________________________
      /
     |       Device: USRP2 / N-Series Device
     |     _____________________________________________________
     |    /
     |   |       Mboard: N210
     |   |   hardware: 2561
     |   |   mac-addr: a0:36:fa:25:30:15
     |   |   ip-addr: 192.168.10.7
     |   |   subnet: 255.255.255.255
     |   |   gateway: 255.255.255.255
     |   |   gpsdo: none
     |   |   serial: E1R10Z5UP
     |   |   FW Version: 12.4
     |   |   FPGA Version: 11.1
     |   |   
     |   |   Time sources:  none, external, _external_, mimo
     |   |   Clock sources: internal, external, mimo
     |   |   Sensors: mimo_locked, ref_locked
     |   |     _____________________________________________________
     |   |    /
     |   |   |       RX DSP: 0
     |   |   |   
     |   |   |   Freq range: -50.000 to 50.000 MHz
     |   |     _____________________________________________________
     |   |    /
     |   |   |       RX DSP: 1
     |   |   |   
     |   |   |   Freq range: -50.000 to 50.000 MHz
     |   |     _____________________________________________________
     |   |    /
     |   |   |       RX Dboard: A
     |   |   |   ID: WBX, WBX + Simple GDB (0x0053)
     |   |   |     _____________________________________________________
     |   |   |    /
     |   |   |   |       RX Frontend: 0
     |   |   |   |   Name: WBXv2 RX+GDB
     |   |   |   |   Antennas: TX/RX, RX2, CAL
     |   |   |   |   Sensors: lo_locked
     |   |   |   |   Freq range: 68.750 to 2200.000 MHz
     |   |   |   |   Gain range PGA0: 0.0 to 31.5 step 0.5 dB
     |   |   |   |   Bandwidth range: 40000000.0 to 40000000.0 step 0.0 Hz
     |   |   |   |   Connection Type: IQ
     |   |   |   |   Uses LO offset: No
     |   |   |     _____________________________________________________
     |   |   |    /
     |   |   |   |       RX Codec: A
     |   |   |   |   Name: ads62p44
     |   |   |   |   Gain range digital: 0.0 to 6.0 step 0.5 dB
     |   |   |   |   Gain range fine: 0.0 to 0.5 step 0.1 dB
     |   |     _____________________________________________________
     |   |    /
     |   |   |       TX DSP: 0
     |   |   |   
     |   |   |   Freq range: -200.000 to 200.000 MHz
     |   |     _____________________________________________________
     |   |    /
     |   |   |       TX Dboard: A
     |   |   |   ID: WBX (0x0052)
     |   |   |     _____________________________________________________
     |   |   |    /
     |   |   |   |       TX Frontend: 0
     |   |   |   |   Name: WBXv2 TX+GDB
     |   |   |   |   Antennas: TX/RX, CAL
     |   |   |   |   Sensors: lo_locked
     |   |   |   |   Freq range: 68.750 to 2200.000 MHz
     |   |   |   |   Gain range PGA0: 0.0 to 25.0 step 0.1 dB
     |   |   |   |   Bandwidth range: 40000000.0 to 40000000.0 step 0.0 Hz
     |   |   |   |   Connection Type: IQ
     |   |   |   |   Uses LO offset: No
     |   |   |     _____________________________________________________
     |   |   |    /
     |   |   |   |       TX Codec: A
     |   |   |   |   Name: ad9777
     |   |   |   |   Gain Elements: None
     
     '

Get Information About USRP Radio with Specified Serial Number

Get detailed information about the USRP radio with serial number 30AD2D5.

[info,status] = probesdru('30AD2D5')

info = 
    '[INFO] [UHD] Win32; Microsoft Visual C++ version 1936; Boost_108100; UHD_4.6.0.0-vendor
     [INFO] [B200] Detected Device: B210
     [INFO] [B200] Operating over USB 3.
     [INFO] [B200] Initialize CODEC control...
     [INFO] [B200] Initialize Radio control...
     [INFO] [B200] Performing register loopback test... 
     [INFO] [B200] Register loopback test passed
     [INFO] [B200] Performing register loopback test... 
     [INFO] [B200] Register loopback test passed
     [INFO] [B200] Setting master clock rate selection to 'automatic'.
     [INFO] [B200] Asking for clock rate 16.000000 MHz... 
     [INFO] [B200] Actually got clock rate 16.000000 MHz.
       _____________________________________________________
      /
     |       Device: B-Series Device
     |     _____________________________________________________
     |    /
     |   |       Mboard: B210
     |   |   revision: 4
     |   |   product: 2
     |   |   name: MyB210
     |   |   serial: 30AD2D5
     |   |   FW Version: 8.0
     |   |   FPGA Version: 16.0
     |   |   
     |   |   Time sources:  none, internal, external, gpsdo
     |   |   Clock sources: internal, external, gpsdo
     |   |   Sensors: ref_locked
     |   |     _____________________________________________________
     |   |    /
     |   |   |       RX DSP: 0
     |   |   |   
     |   |   |   Freq range: -8.000 to 8.000 MHz
     |   |     _____________________________________________________
     |   |    /
     |   |   |       RX DSP: 1
     |   |   |   
     |   |   |   Freq range: -8.000 to 8.000 MHz
     |   |     _____________________________________________________
     |   |    /
     |   |   |       RX Dboard: A
     |   |   |     _____________________________________________________
     |   |   |    /
     |   |   |   |       RX Frontend: A
     |   |   |   |   Name: FE-RX2
     |   |   |   |   Antennas: TX/RX, RX2
     |   |   |   |   Sensors: temp, rssi, lo_locked
     |   |   |   |   Freq range: 50.000 to 6000.000 MHz
     |   |   |   |   Gain range PGA: 0.0 to 76.0 step 1.0 dB
     |   |   |   |   Bandwidth range: 200000.0 to 56000000.0 step 0.0 Hz
     |   |   |   |   Connection Type: IQ
     |   |   |   |   Uses LO offset: No
     |   |   |     _____________________________________________________
     |   |   |    /
     |   |   |   |       RX Frontend: B
     |   |   |   |   Name: FE-RX1
     |   |   |   |   Antennas: TX/RX, RX2
     |   |   |   |   Sensors: temp, rssi, lo_locked
     |   |   |   |   Freq range: 50.000 to 6000.000 MHz
     |   |   |   |   Gain range PGA: 0.0 to 76.0 step 1.0 dB
     |   |   |   |   Bandwidth range: 200000.0 to 56000000.0 step 0.0 Hz
     |   |   |   |   Connection Type: IQ
     |   |   |   |   Uses LO offset: No
     |   |   |     _____________________________________________________
     |   |   |    /
     |   |   |   |       RX Codec: A
     |   |   |   |   Name: B210 RX dual ADC
     |   |   |   |   Gain Elements: None
     |   |     _____________________________________________________
     |   |    /
     |   |   |       TX DSP: 0
     |   |   |   
     |   |   |   Freq range: -8.000 to 8.000 MHz
     |   |     _____________________________________________________
     |   |    /
     |   |   |       TX DSP: 1
     |   |   |   
     |   |   |   Freq range: -8.000 to 8.000 MHz
     |   |     _____________________________________________________
     |   |    /
     |   |   |       TX Dboard: A
     |   |   |     _____________________________________________________
     |   |   |    /
     |   |   |   |       TX Frontend: A
     |   |   |   |   Name: FE-TX2
     |   |   |   |   Antennas: TX/RX
     |   |   |   |   Sensors: temp, lo_locked
     |   |   |   |   Freq range: 50.000 to 6000.000 MHz
     |   |   |   |   Gain range PGA: 0.0 to 89.8 step 0.2 dB
     |   |   |   |   Bandwidth range: 200000.0 to 56000000.0 step 0.0 Hz
     |   |   |   |   Connection Type: IQ
     |   |   |   |   Uses LO offset: No
     |   |   |     _____________________________________________________
     |   |   |    /
     |   |   |   |       TX Frontend: B
     |   |   |   |   Name: FE-TX1
     |   |   |   |   Antennas: TX/RX
     |   |   |   |   Sensors: temp, lo_locked
     |   |   |   |   Freq range: 50.000 to 6000.000 MHz
     |   |   |   |   Gain range PGA: 0.0 to 89.8 step 0.2 dB
     |   |   |   |   Bandwidth range: 200000.0 to 56000000.0 step 0.0 Hz
     |   |   |   |   Connection Type: IQ
     |   |   |   |   Uses LO offset: No
     |   |   |     _____________________________________________________
     |   |   |    /
     |   |   |   |       TX Codec: A
     |   |   |   |   Name: B210 TX dual DAC
     |   |   |   |   Gain Elements: None
     
     '

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.

To configure these radios for use with Wireless Testbench, see Install Support Package for NI USRP Radios (Wireless Testbench).