Main Content

describeFPGA

Describe hardware interfaces on NI USRP radio device FPGA

Since R2024a

collapse all in page

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

Syntax

describeFPGA(device,handoffFile)

Description

describeFPGA(device,handoffFile) configures the NI™ USRP™ radio device device according to the information in the hand-off information file handoffFile.

If you have not previously specified the following usrp object properties on the device input, describeFPGA sets them based on the hand-off information file:

example

Examples

collapse all

This example uses:

Open Live Script

Create a usrp System object, specifying a radio setup configuration previously saved in the Radio Setup wizard.

device = usrp("MyRadio")
device = 
  usrp with properties:

          TransmitRadioGain: 10
    TransmitCenterFrequency: 2.4000e+09
           ReceiveRadioGain: 10
     ReceiveCenterFrequency: 2.4000e+09
           DUTInputAntennas: []
          DUTOutputAntennas: []
                  BypassDUT: 0
          BypassPLDDRBuffer: 0
               LoopbackMode: "Disabled"
                 SampleRate: []
            CaptureAntennas: []
           TransmitAntennas: []
       CaptureDDRAllocation: 10000000
      TransmitDDRAllocation: 10000000

Configure your radio with the DUT interfaces described by the hand-off information file and initialize the sample rate on the radio and any DUT input or output antennas. The model this file describes has one data streaming input from the radio to the FPGA, so it requires one DUT input antenna.

describeFPGA(device,"ModelName_wthandoffinfo.mat");

Display the initialised radio properties for a DUT.

device
device = 
  usrp with properties:

          TransmitRadioGain: 10
    TransmitCenterFrequency: 2.4000e+09
           ReceiveRadioGain: 10
     ReceiveCenterFrequency: 2.4000e+09
           DUTInputAntennas: "DB0:RF0:RX1"
          DUTOutputAntennas: []
                  BypassDUT: 0
          BypassPLDDRBuffer: 0
               LoopbackMode: "Disabled"
                 SampleRate: 250000000
            CaptureAntennas: []
           TransmitAntennas: []
       CaptureDDRAllocation: 10000000
      TransmitDDRAllocation: 10000000

Input Arguments

collapse all

NI USRP radio device, specified as a usrp System object™.

Path to the device tree file, specified as a string scalar or character vector. This file is the MAT-file that describes the hardware interfaces on the FPGA. You generate this file in Generate Bitstream and Program FPGA of the targeting workflow.

Example: "<projectFolder>/<modelName>_wthandoffinfo.mat"

Version History

Introduced in R2024a

See Also

Objects

Functions

Topics