Main Content

describeFPGA

Describe the hardware interfaces on the FPGA on an NI USRP radio device

Since R2024a

collapse all in page

Syntax

describeFPGA(device,handoffFile)

Description

example

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

If they have not previously been specified, describeFPGA sets the following properties of the usrp object specified by device, based on the hand-off information file:

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 with the handoff information file and initialise the sample rate on the radio and any DUT input or output antennas. The model this describes has one data streaming input from the radio to the FPGA, so 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 is the MAT-file that describes the hardware interfaces on the FPGA. You generate this file in Step 5. Generate Bitstream and Program FPGA in the targeting workflow.

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

Version History

Introduced in R2024a

See Also

Objects

Functions

Topics