Main Content

SDRu Receiver

Receive data from USRP device

expand all in page

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

  • SDRu Receiver block

Libraries:
Wireless Testbench Support Package for NI USRP Radios

Description

The SDRu Receiver block supports communication between Simulink® and a Universal Software Radio Peripheral (USRP™) device, enabling simulation and development for various software-defined radio applications. The SDRu Receiver block and the USRP board must be on the same Ethernet subnetwork.

The SDRu Receiver block receives signal and control data from a USRP board using the Universal Hardware Driver (UHD™) from Ettus Research™. The SDRu Receiver block is a Simulink source that receives data from a USRP board and outputs a column vector or matrix signal with a fixed number of rows. The first call to this block can contain transient values, in this case the resulting packets contain undefined data.

This block diagram illustrates how Simulink, the SDRu Transmitter and Receiver blocks, and the USRP hardware interface.

For transmitting a radio signal over the air, pass the signal generated in Simulink to an SDRu transmitter block. The transmitter block forwards the signal to the radio hardware. For receiving a radio signal over the air, use an SDRu receiver block. The receiver block forwards the signal received from the radio hardware for post processing in Simulink.

When this block is called, it is possible that the host has not yet received any data from the USRP hardware. The data length port, length, indicates when valid data is present. When the data length port contains a zero value, there is no data. To qualify the execution of part of the model, use the data length with an enabled subsystem.

If your computer is not connected to any USRP hardware, you can still use this block to develop a model that propagates sample time and data type information. To propagate this information, select Simulation > Update diagram.

For information about the USRP hardware products that interface with this block, see the Supported Radio Devices.

This icon shows all ports, including optional ones: SDRu receiver block with all the ports

Note

Starting in R2024a, the MathWorks® products and support packages you require to use this Simulink block depend on your radio device.

Radio DeviceRequired MathWorks ProductsSupport Package Installation

USRP2™

USRP N200, N210

USRP B200, B210

Communications Toolbox™ Support Package for USRP RadioInstall Communications Toolbox Support Package for USRP Radio

USRP N300, N310, N320, N321

USRP X300, X310

Wireless Testbench™

Wireless Testbench Support Package for NI™ USRP Radios

Install Support Package for NI USRP Radios

For details on how to use this Simulink block with a radio device supported by Communications Toolbox Support Package for USRP Radio, see SDRu Receiver.

Ports

Input

expand all

Center frequency setting in Hz, specified as a positive scalar.

Example: 88.9e6 tunes the receiver to a center frequency of 88.9 MHz.

Dependencies

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

Data Types: double

Local oscillator (LO) offset in Hz, specified as a scalar.

Example: 10 sets the LO offset to 10 Hz.

Dependencies

To enable this port, set Source of LO offset to Input Port.

Data Types: double

Receiver gain setting in dB, specified as a scalar or vector. The valid range of this gain depends on the RF daughterboard of the USRP device.

Dependencies

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

Data Types: double

Output

expand all

Output data received from the radio hardware, returned as a vector of complex values. The complex output data values range from -1 to 1.

Dependencies

To specify the base data type, use the Output data type parameter.

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

Length of the received data, returned as a nonnegative integer. This output port provides the number of samples received from the USRP radio.

Dependencies

To enable this port, select the Enable data length output port parameter.

Data discontinuity flag, returned:

  • 0 — Data samples are not lost.

  • 1 — Data samples are lost

Use this port as a diagnostic tool to determine real-time operation of the SDRu Receiver block. If your model is not running in real time, you can adjust parameters that reduce the number of transported samples. To approach or achieve real-time performance, you can decrease the baseband sampling rate or increase the decimation factor.

Dependencies

To enable this port, select the Enable overrun output port parameter.

Data Types: Boolean

Lock status of the USRP radio to the 10 MHz clock signal, returned as one of these Boolean values.

  • 0 — The USRP radio is not locked to the 10 MHz clock signal of an external clock source or a global positioning system disciplined oscillator (GPSDO).

  • 1 — The USRP radio is locked to the 10 MHz clock signal of an external clock source or a GPSDO.

Dependencies

To enable this port, select the Enable ref_locked output port parameter.

Data Types: Boolean

Lock status of the GPSDO to the GPS constellation, returned as one of these Boolean values.

  • 0 — The GPSDO is not locked to the GPS constellation.

  • 1 — The GPSDO is locked to the GPS constellation.

Dependencies

To enable this port, select the Enable gps_locked output port parameter.

Data Types: Boolean

Time stamp of each received sample, returned as a column vector. The length of timeStamps output equals the length of received data output data.

  • To get GPS time stamp of each received sample from a USRP radio, set the PPS Source parameter to GPSDO.

  • To get time stamp of each received sample from bundled radios, set the PPS Source parameter to GPSDO or External.

Dependencies

To enable this port, select the Enable timestamps output port parameter.

Parameters

expand all

When you set block parameter values, the SDRu Receiver block first checks that the values have the correct data types. Even 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 open to display the actual values along with other radio information.

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

Radio Connection

Radio to configure, specified as one of USRP platforms listed.

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 when you set up your radio using the Radio Setup wizard. If you configure the radio hardware with an IP address other than the default, update IP address accordingly.

The IP address list displays IP addresses for USRP devices attached to the host computer. To specify another known dotted quad IP address, enter it directly into this field.

Refresh the list of all connected devices to update the IP address list. The updated list retains the value in focus before Refresh Device List is selected, even if the device with that setting was disconnected.

To enable the TwinRX daughterboard on an X-series radio, select this parameter.

When you select this parameter, you can use the Enable TwinRX Phase Synchronization parameter to provide phase synchronization between channels of the TwinRX daughterboard.

Dependencies

To enable this parameter, set Platform to 'X300' or 'X310'.

Provides information about the Platform associated with IP address. IP address applies for N-series and X-series devices. When you select the Info button, a new dialog box opens with information about the specified device.

Radio Properties

When you select this parameter, the TwinRX daughterboard provides phase synchronization between all channels. In this case, the value of Center Frequency must be the same for all channels.

Note

The Local oscillator (LO) source present on channel 1 is the master source to drive other LOs of the TwinRx daughterboard channels.

To share LOs between two TwinRx daughterboards, attach the four MMCX RA male cables on one daughterboard to the MMCX RA male cables on the other daughterboard by crisscrossing the cables between the two daughterboards. Make these cable connections, as also shown in the figure.

  • J1 to J2

  • J2 to J1

  • J3 to J4

  • J4 to J3

Crisscross connection of MMCX RA male cables between two TwinRX daughterboards

Dependencies

To enable this property, set Platform to 'X300' or 'X310' and select TwinRX Daughterboard.

Channel output mapping for radio or bundled radios, specified as a positive integer scalar or vector. This table shows valid values for various radio platforms.

Platform ValueChannel mapping Value

N300

  • When IP address includes one IP address, specify this parameter as 1, 2, or [1 2].

  • When IP address includes N IP addresses, specify this parameter as 1-by-2N row vector.

N310

  • When IP address includes one IP address, specify this parameter as 1-, 2-, 3-, or 4-element row vector of channel numbers from the set {1, 2, 3, 4}

  • When IP address includes N IP addresses, specify this parameter as 1-by-4N row vector.

N320/N321

  • When IP address includes one IP address, specify this parameter as 1, 2, or [1 2].

  • When IP address includes N IP addresses, specify this parameter as 1-by-2N row vector.

X300 or X310 when TwinRX Daughterboard parameter is cleared

  • When IP address includes one IP address, specify this parameter as 1, 2, or [1 2].

  • When IP address includes N IP addresses, specify this parameter as 1-by-2N row vector.

X300 or X310 when two TwinRX daughterboards are connected and TwinRX Daughterboard parameter is selected

When you clear the Enable TwinRX Phase Synchronization parameter, specify this parameter as one of these values.

  • [N M], where N and M are distinct integers from 1 to 4 — Channels N and M are in use.

  • [N M P], where N, M, and P are distinct integers from 1 to 4 — Channels N, M, and P are in use.

  • [1 2 3 4]

When you select the Enable TwinRX Phase Synchronization parameter, specify this parameter as 1, [1 2], [1 2 3], or [1 2 3 4].

When a scalar, 1 or 2 is specified, the device operates in SISO mode. When a vector is specified, the device operates in MIMO mode. When IP address includes multiple IP addresses, the channels defined by Channel mapping are sorted, first by the order in which the IP addresses appear in the list and then by the channel order within the same radio.

Example: When you set Platform to X300 or N300 and IP address contains 192.168.20.2, 192.168.10.3, then Channel mapping must be [1 2 3 4]. Channel mapping values 1 and 2 of the bundled radio refer to channels 1 and 2 of the radio with IP address 192.168.20.2. Channel mapping values 3 and 4 of the bundled radio refer to channels 1 and 2 of the radio with IP address 192.168.10.3.

Data Types: double

Select source of center frequency, specified as:

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

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

RF center frequency in Hz, specified as a nonnegative finite scalar or vector of nonnegative finite scalars. The valid range of this parameter depends on the RF daughterboard of the USRP device.

  • For a single channel (SISO), specify the value for the center frequency as a scalar.

  • For multiple channels (MIMO) that use the same center frequency, specify the center frequency value as a scalar. The center frequency is set by scalar expansion.

  • For multiple channels (MIMO) that use different center frequencies, specify the values in a vector. The ith element of the vector is applied to the ith channel specified by Channel mapping.

    Note

    • For MIMO scenario, the center frequency for N300 radio must be a scalar. You cannot specify the frequencies as a vector.

    • The channels corresponding to the same RF daughterboard of N310 must have same center frequency value.

When you select the TwinRX Daughterboard parameter:

  • To tune all channels to the same frequency, select the Enable TwinRX Phase Synchronization parameter and set the center frequency as a scalar or row vector of the same values.

  • To tune channels to different frequencies, clear the Enable TwinRX Phase Synchronization parameter and set the center frequency to a row vector. Each value in the row vector specifies the frequency of the corresponding channel.

Note

When you select the TwinRX Daughterboard and Enable TwinRX Phase Synchronization, the LO source present on channel 1 is the master source to drive other LOs of the TwinRX daughterboard channels. In this case, the Center frequency value must be the same for all channels of the TwinRX daughterboard.

For more information, see Enable TwinRX Phase Synchronization.

Dependencies

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

Data Types: double

Select source of LO offset, specified as:

  • Dialog — Set the LO offset using the LO offset (Hz) parameter.

  • Input port — Set the LO offset using the LO offset input port.

Offset frequency for the local oscillator, specified as a scalar or vector. The valid range of this parameter depends on the RF daughterboard of the USRP device.

This figure shows that the local oscillator offset affects the intermediate center frequency in the USRP hardware. It does not affect the received center frequency.

Impact of LO frequency on the intermediate center frequency of the USRP radio

  • fRF represents the received RF frequency.

  • fcenter represents the center frequency specified by the block.

  • fLO offset is the local oscillator offset frequency.

  • Ideally, fRF – fcenter = 0.

To move the center frequency away from interference or harmonics generated by the USRP hardware, use the LO offset.

  • For a single channel (SISO), specify the value for the LO offset as a scalar.

  • For multiple channels (MIMO), the LO offset must be zero. This restriction is due to a UHD limitation. You can specify the LO offset as a scalar or as a vector.

Dependencies

To enable this parameter, set Source of LO offset to Dialog.

Select source of gain, specified as:

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

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

Receiver gain in dB, specified as a scalar or vector. The valid range of this gain depends on the RF daughterboard of the USRP device.

Set the value of gain based on the Channel Mapping configuration:

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

  • For multiple channels (MIMO) that use the same gain value, specify the gain as a scalar. The gain is set by scalar expansion.

  • For multiple channels (MIMO) that use different gains, specify the values in a row vector. The ith element of the vector is applied to the ith channel specified by Channel Mapping.

Dependencies

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

Data Types: double

Pulse per second (PPS) signal source, specified as one of these values.

  • Internal — Use the internal PPS signal of the USRP radio.

  • External — Use the PPS signal from an external signal generator.

  • GPSDO — Use the PPS signal from a GPSDO.

To synchronize the time for all channels of the bundled radios, you can:

  • Provide a common external PPS signal to all of the bundled radios and set this parameter to External.

  • Use the PPS signal from the GPSDO that is available on the USRP radio by setting this parameter to GPSDO.

To synchronize the USRP time to the valid GPS time, set this parameter to GPSDO. You must also enable the Ensure sync GPS time parameter if the GPSDO is not locked to the GPS constellation at the start of the simulation.

Select this parameter to enable the gpsLocked output port, which indicates the lock status of the GPSDO to the GPS constellation.

Dependencies

To enable this parameter, set the PPS source parameter to GPDSO.

Select this parameter to ensure that the USRP radio time is synchronized to the valid GPS time.

When you select this parameter, the block checks the lock status of the GPSDO. When the GPSDO is locked to the GPS constellation, the block sets the USRP radio time to the valid GPS time.

Dependencies

To enable this parameter, set the PPS source parameter to GPSDO.

Clock source, specified as one of these values.

  • Internal — Use the internal clock signal of the USRP radio.

  • External — Use the 10 MHz clock signal from an external clock generator.

  • GPSDO — Use the 10 MHz clock signal from a GPSDO.

For N3xx and X-series radios, the external clock port is labeled REF IN.

To synchronize the frequency for all channels of the bundled radios, you can:

  • Provide a common external 10 MHz clock signal to all of the bundled radios and set this parameter to External.

  • Provide a 10 MHz clock signal from each GPSDO to the corresponding radio and set this parameter to GPSDO.

Select this parameter to enable the refLocked output port, which indicates the lock status of the USPR radio to the 10 MHz clock signal.

Dependencies

To enable this parameter, set the Clock source parameter to External or GPDSO.

Master clock rate, specified as a scalar in Hz. The master clock rate is the A/D and D/A clock rate. The valid range of values for this property depends on the radio platform that is connected.

Platform ValuePossible Master clock rate (Hz) Value

N300 or N310

122.88e6 Hz, 125e6 Hz, or 153.6e6 Hz

Default value is 125e6 Hz.

N320/N321

200e6 Hz, 245.76e6 Hz, or 250e6 Hz

Default value is 200e6 Hz.

X300 or X310

184.32e6 Hz or 200e6 Hz

200e6 Hz — When TwinRX daughterboard is selected.

Default value 200e6 Hz.

Data Types: double

Decimation factor for the SDRu receiver, specified as an integer in the range [1,1024] with restrictions that depend on the radio you use.

DecimationFactor Property ValueUSRP N3xx Series RadioUSRP X3xx Series Radio

1

Valid

Not valid with TwinRX daughterboard

2

Valid

Valid

3

Valid

Valid

Odd integer from 4 to 128

Not valid

Valid

Even integer in the range [4,256]

Valid

Valid

Integer multiple of 4 in the range [256,512]

Valid

Valid

Integer multiple of 8 in the range [512,1024]

Valid

Valid

The radio uses the decimation factor when it downconverts the intermediate frequency (IF) signal to a complex baseband signal.

Option to enable timed transmission and reception. To enable the radio to transmit or receive data after a specified time, select Enable time trigger.

When you select Enable time trigger parameter, you can:

  • Transmit or receive after the time specified in the Trigger time parameter.

  • Transmit or receive at the specified GPS time in the Trigger time parameter if you set the PPSSource parameter to GPSDO.

  • Simultaneously transmit and receive after the time specified in the Trigger time parameter.

Trigger time in seconds, specified as a nonnegative scalar. Specify the trigger time after which you want the radio to transmit or receive data. The Trigger time value must be greater than the current USRP radio time.

When you set the PPS Source parameter to GPSDO, specify the Trigger time parameter as the exact GPS time in seconds at which the radio transmits and receives data.

Note

For AD936x-based N3xx USRP radios, you can expect a consistent delay between the specified trigger time and the start of transmission or reception.

Dependencies

To enable this parameter, select the Enable trigger time parameter.

Data

This parameter is read-only.

Baseband sample rate of output signal, in Hz, specified as a scalar.

This parameter displays the computed baseband sample rate derived from the Master clock rate (Hz) and Decimation factor parameter values. This computation uses the formula, Baseband sample rate = Master clock rate/Decimation factor. If you change the Decimation factor during simulation, then the block changes hardware data rate, but does not change the Simulink sample time.

To get more information on sample time, see What Is Sample Time? (Simulink).

Data Types: double

Transport data type, specified as:

  • int16 — Uses 16-bit transport. Achieves higher precision than 8-bit transport.

  • int8 — Uses 8-bit transport. Uses a quantization step 256 times larger and achieves approximately two times faster transport data rate than 16-bit transport.

Specifying transport data rate data type as int16, assigns 16 bits for the in-phase component and 16 bits for the quadrature component, resulting in 32 bits for each complex sample of transport data.

Data type of the output signal, specified as Same as transport data type, double, or single. The complex output data values range from –1 to 1.

Number of samples per frame of the output signal that the object generates, specified as a positive integer scalar. This value optimally utilizes the underlying Ethernet packets, which have a size of 1500 8-bit bytes.

To indicate the number of samples received from USRP radio, select this parameter.

To measure the number of samples lost during reception, select this parameter.

If your model is not running in real time, you can adjust parameters that reduce the number of transported samples. To approach or achieve real-time performance, you can increase the decimation factor.

To get time stamp of each received sample from USRP radio, select this parameter.

Option to enable burst mode. To produce a set of contiguous frames without an overrun or underrun to the radio, select Enable burst mode. Enabling burst mode helps you simulate models that cannot run in real time.

When burst mode is enabled, specify the desired amount of contiguous data using the Number of frames in burst parameter.

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

Dependencies

To enable this parameter, select Enable burst mode.

Data Types: double

More About

expand all

Extended Capabilities

C/C++ Code Generation
Generate C and C++ code using Simulink® Coder™.

Version History

Introduced in R2011b

expand all

See Also

Blocks

Objects

Topics