This is machine translation

Translated by Microsoft
Mouseover text to see original. Click the button below to return to the English version of the page.

Note: This page has been translated by MathWorks. Click here to see
To view all translated materials including this page, select Country from the country navigator on the bottom of this page.

E310 Transmitter

Send data to USRP® E310 or USRP® E312 radio hardware

  • Library:
  • Communications Toolbox Support Package for USRP Embedded Series Radio / E310

Description

The E310 Transmitter block sends data to USRP®[1] E310 or USRP® E312 radio hardware. This connection enables you to simulate and develop various software-defined radio applications.

The following diagram shows the conceptual overview of transmitting and receiving radio signals with this support package. Simulink® interacts with the E310 Transmitter block to send signals to the radio hardware.

To check connectivity between the E310 Transmitter block and the radio hardware, and to synchronize radio settings between them, on the Main tab of the block, click Info.

Channel Input

The E310 Transmitter block supports up to two channels to send data to the USRP® E310 or USRP® E312 radio hardware. Use the Channel Mapping parameter to indicate whether to use a single channel or both channels. The block accepts a matrix input signal, data, where each column corresponds to one fixed-length channel of data. For each channel, you can set the gain independently, or you can apply the same setting to both channels. All other parameter values are applied to both channels.

Design Custom Filter

You can use the ADI filter wizard to change the default filter design applied to the filter chain in the E310 Transmitter block. To open the filter wizard, on the Advanced tab of the block, click Design custom filter. The wizard enables you to design a custom filter for the Analog Devices® AD9361 RF chip based on the Baseband sample rate (Hz) parameter. You can adjust and optimize the settings for calculating the analog filters, the interpolation and decimation filters, and the FIR coefficients. When you finish with the wizard, to apply the filter settings, click Apply on the block.

The ADI filter wizard requires the following MathWorks® products:

  • MATLAB®

  • Signal Processing Toolbox™

  • DSP System Toolbox™

For instructions on operating the ADI filter wizard, visit the Analog Devices website at MATLAB Filter Design Wizard for AD9361.

For more information, see Baseband Sampling Rate and Filter Chains.

Ports

Input

expand all

Input signal sent to the radio hardware, specified as a complex matrix. The number of columns in the matrix depends on the number of channels in use, as specified by the Channel Mapping parameter. Each column corresponds to a channel of complex data sent via one channel.

This port supports complex values with the following data types:

  • 16-bit signed integers — Since the AD9361 RF chip has a 12-bit DAC, only the 12 most significant bits of the I and Q samples are used.

  • Single-precision floating point — Complex values are scaled to the range of [–1, 1].

  • Double-precision floating point — Complex values are scaled to the range of [–1, 1].

When the block is activated during simulation, the host might not send valid data to the radio hardware. To determine whether data is valid, enable the lost samples port.

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

External RF center frequency source, specified as a nonnegative finite scalar on the port. The valid center frequency range is 70 MHz to 6 GHz.

Dependencies

To enable this port, set Source of Center frequency to Input port.

Data Types: double

External gain source, specified as a scalar or 1-by-2 vector on the port. The valid gain range is –89.75 dB to 0 dB. The resolution is 0.25 dB.

Set the gain value based on the Channel Mapping configuration:

  • For a single channel, specify the gain as a scalar.

  • For two channels that use the same gain value, specify the gain as a scalar. The block applies the gain by scalar expansion.

  • For two channels that use different gain values, specify the values as a 1-by-2 vector. The Nth element of the vector is applied to the Nth channel specified by Channel Mapping.

Dependencies

To enable this port, set Source of gain to Input port.

Data Types: double

Output

expand all

Data discontinuity flag, returned as a logical scalar.

  • 0 indicates no overflow or underflow.

  • 1 indicates the presence of overflow or underflow.

This port is a useful diagnostic tool to determine real-time operation of the E310 Transmitter block. If your model is not running in real time, you can decrease the baseband sampling rate to approach or achieve real-time performance.

Dependencies

To enable this port, on the Main tab, select Enable output port for Lost samples indicator.

Data Types: Boolean

Parameters

expand all

When you set block parameter values, the E310 Transmitter block first checks that the values have the correct data types. If the values pass those checks, the values can still be out of range for the radio hardware. In that case, the radio hardware sets the actual value as close to the specified value as possible. When you next synchronize the block with the radio hardware by clicking Info, a dialog box displays the actual values.

If a parameter is listed as tunable, then you can change its value during simulation.

Main Tab

IP address of the radio hardware, specified as a dotted-quad expression.

This parameter must match the physical IP address of the radio hardware assigned during hardware setup. See Guided Host-Radio Hardware Setup. If you configure the radio hardware with an IP address other than the default, update Radio IP address accordingly.

  • Dialog — Set the center frequency by using the Center frequency (Hz) parameter.

  • Input port — Set the center frequency by using the center frequency input port.

RF center frequency in Hz, specified as a nonnegative finite scalar. The valid range for center frequency is 70 MHz to 6 GHz.

Tunable: Yes

Dependencies

To enable this parameter, set the Source of Center frequency to Dialog.

Data Types: double

  • Dialog — Specify the gain by using the Gain (dB) parameter.

  • Input port — Specify the gain by using the gain input port.

Gain in dB, specified as a scalar or a 1-by-2 vector. The valid range for gain is –89.75 dB to 0 dB. The resolution is 0.25 dB.

Set the gain value based on the Channel Mapping configuration:

  • For a single channel, specify the gain as a scalar.

  • For two channels that use the same gain value, specify the gain as a scalar. The block applies the gain by scalar expansion.

  • For two channels that use different gain values, specify the values as a 1-by-2 vector. The Nth element of the vector is applied to the Nth channel specified by Channel Mapping.

Tunable: Yes

Dependencies

To enable this parameter, set Source of gain to Dialog.

Data Types: double

Channel input mapping, specified as a scalar or a 1-by-2 vector:

  • 1 — Only channel 1 is in use.

  • 2 — Only channel 2 is in use.

  • [1 2] — Both channels are in use.

Baseband sampling rate in Hz, specified as a positive scalar. The valid range of this parameter is 520.841 kHz to 30.72 MHz.

Note

To synchronize the block with the radio hardware, click Info on the block. If the specified and actual rates have a small mismatch, verify that the computed rate is close enough to what you actually want.

Data Types: double

When you select this parameter, the E310 Transmitter block produces a set of contiguous frames. This setting can help simulate models that cannot run in real time. When you enable burst mode, specify the amount of contiguous data using the Number of frames in burst parameter. For more information on how to use this parameter, see Burst Mode.

Number of frames in a contiguous burst, specified as a strictly positive integer.

Dependencies

To enable this parameter, select Enable burst mode.

Select this parameter to enable the lost samples output port during host-radio hardware data transfers.

  • Code generation — Simulation starts up slower but runs faster.

  • Interpreted execution — Simulation starts up faster but runs slower.

Advanced Tab

  • Host — Specify the host as the source of data.

  • DDS — Specify the DDS on the radio hardware as the source of the data. In this case, each channel has two additive tones.

DDS tone frequency, specified as a 2-by-2 matrix of double values in Hz. Each channel has two additive tones. Channel one is configured in the first row, and channel two is configured in the second row. For each tone, the valid range is 0 Hz to Baseband sample rate divided by 2.

Dependencies

To enable this parameter, set Data source select to DDS.

Data Types: double

DDS tone phase, specified as a 2-by-2 matrix of double values. Each channel has two additive tones. Channel one is configured in the first row, and channel two is configured in the second row. The valid value range is 0 to 359,999. Values are relative to the maximum tone phase shift of 360 degrees, where 0 is zero degrees and 359999 is 359.999 degrees.

Dependencies

To enable this parameter, set Data source select to DDS.

Data Types: double

DDS tone scale, specified as a 2-by-2 matrix of double values in millionths of full scale. Each channel has two additive tones. Channel one is configured in the first row, and channel two is configured in the second row. The valid range is –1e6 to 1e6. The values are relative to DAC output amplitude, where 0 is zero amplitude and 1e6 is the maximum DAC output amplitude.

Dependencies

To enable this parameter, set Data source select to DDS.

Data Types: double

When you select this parameter, the radio hardware data path bypasses the algorithm generated and programmed during the FPGA Targeting Workflow or the Hardware-Software Co-Design Workflow.

When you select this parameter, the block displays advanced internal radio properties. Do not edit these settings.

Introduced in R2016b


[1] USRP, USRP2, UHD, and Ettus Research are trademarks of National Instruments Corp.