Main Content

transmit

Transmit waveform using baseband transmitter or transceiver

Since R2022a

collapse all in page

Syntax

transmit(bba,waveform,mode)

Description

example

transmit(bba,waveform,mode) transmits the IQ waveform waveform to the air using the specified baseband transmitter or baseband transceiver bba. The input mode specifies continuous or single-shot transmission. To stop a continuous transmission, call stopTransmission(bba).

Examples

collapse all

Open Live Script

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

bbtx = basebandTransmitter("MyRadio")
bbtx = 
  basebandTransmitter with properties:

          RadioGain: 10
    CenterFrequency: 2.4000e+09
         SampleRate: 250000000
           Antennas: "RF0:TX/RX"

Set the baseband sample rate and center frequency. 

bbtx.SampleRate = 122.88e6;
bbtx.CenterFrequency = 2.2e9;

Generate random transmit waveform.

txWaveform = complex(randn(1000,1),randn(1000,1));

Transmit the generated waveform continuously with the radio associated with the baseband transmitter object using the default antenna.

transmit(bbtx,txWaveform,"continuous");

Stop the continuous transmission after 5 seconds.

pause(5);
stopTransmission(bbtx);
Open Live Script

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

bbtrx = basebandTransceiver("MyRadio")
bbtrx = 
  basebandTransceiver with properties:

          TransmitRadioGain: 10
    TransmitCenterFrequency: 2.4000e+09
           TransmitAntennas: "RF0:TX/RX"
           CaptureRadioGain: 10
     CaptureCenterFrequency: 2.4000e+09
            CaptureAntennas: "RF0:RX2"
            CaptureDataType: "int16"
       DroppedSamplesAction: "error"
                 SampleRate: 250000000

Set the baseband sample rate.

bbtrx.SampleRate = 122.88e6;

Set the transmit and capture center frequencies. 

bbtrx.TransmitCenterFrequency = 2.2e9;
bbtrx.CaptureCenterFrequency = 2.2e9;

Generate random transmit waveform.

txWaveform = complex(randn(1000,1),randn(1000,1));

Transmit the generated waveform continuously with the radio associated with the baseband transceiver object using the default transmit antenna.

transmit(bbtrx,txWaveform,"continuous");

Capture IQ data with the radio associated with the baseband transceiver object using the default capture antenna.

[data,~] = capture(bbtrx,milliseconds(3));

Stop the continuous transmission after data capture is complete.

stopTransmission(bbtrx);

Input Arguments

collapse all

Baseband application, specified as a basebandTransmitter object or basebandTransceiver object.

Note

The first object function call in which you specify this object as an input requires a few extra seconds to load the application onto the hardware.

IQ waveform to transmit, specified as one of these options.

  • Complex-valued column vector with even number of rows — Use this option to send an IQ waveform on a single transmit antenna.

  • Complex-valued matrix with even number of rows — Use this option to send IQ waveforms on multiple transmit antennas. This option applies only when bba is a baseband transmitter. The number of antennas specified by the Antennas property of the bba input must match the number of matrix columns.

If you specify a waveform with a single or double data type, you must scale the transmit data sample values to the range [–1, 1].

The waveform length across all applicable antennas must be relative to the onboard radio memory buffer size.

Radio DeviceMemory Buffer SizeMaximum Data Samples

USRP™ N310

2 GB229

USRP N320

2 GB229

USRP N321

2 GB229

USRP X310

1 GB228

USRP X410

4 GB230

Note

  • Transmit and capture data samples on the baseband transceiver are buffered in the onboard radio memory. Therefore, if the bba input is a baseband transceiver, you must also take into account the data capture length that you specify when calling the capture object function with the bba input.

  • To avoid underflow during the transmission of a waveform of length less than 513 samples, the function reserves up to 1024 samples on the onboard radio memory.

  • If the bba object uses a Farrow rate converter to achieve the sample rate that you specify by the bba.SampleRate property, the object resamples the transmit waveform. The resulting waveform has an increased number of data samples. For more information, see Baseband Sample Rate in NI USRP Radios.

Data Types: int16 | single | double
Complex Number Support: Yes

Transmission mode, specified as one of these options.

  • "continuous" — The function transmits the waveform waveform continuously to the air by repeating the data samples until you call stopTransmission(bba).

  • "once" — The function transmits the waveform waveform once in a single-shot transmission.

Data Types: string

Version History

Introduced in R2022a

See Also

Functions