Simplex Link

Simplex links represent the signal processing chain of a unidirectional communication betweeen a transmitting device and a receiving device, implementing the digital signal processing before digital-to-analog conversion and after analog-to-digital conversion, respectively. They are a combination of a Transmitting Modem and a Receiving Modem.

After a SimplexLink is added as a type of Transmitter to a Device, a call to Device.transmit will be delegated to TransmittingModem._transmit(). Similarly, after a SimplexLink is added as a type of Receiver to a Device, a call to Device.receive will be delegated to ReceivingModem._receive()

# Initialize a new simulation considering a single device
simulation = Simulation()
tx_device = simulation.new_device(carrier_frequency=1e10)
rx_device = simulation.new_device(carrier_frequency=1e10)

# Configure the links's waveform
waveform = RootRaisedCosineWaveform(
    oversampling_factor=4,
    symbol_rate=1e6,
    num_preamble_symbols=16,
    num_data_symbols=32,
    modulation_order=64,
)

# Configure the link to connect both devices
link = SimplexLink(waveform=waveform)
link.connect(tx_device, rx_device)

For a detailed description of the transmit and receive routines, refer to the Transmitting Modem and a Receiving Modem of the base classes.

The barebone configuration can be extend by additional components such as Custom Bit Sources, Synchronization, Stream Precoding, Channel Estimation, Symbol Precoding, Channel Equalization and Bit Encoders:

# Configure the links's waveform
waveform = RootRaisedCosineWaveform(
    oversampling_factor=4,
    symbol_rate=1e6,
    num_preamble_symbols=16,
    num_data_symbols=32,
    modulation_order=64,
)

# Configure the link to connect both devices
link = SimplexLink(waveform=waveform)
link.connect(tx_device, rx_device)

# Configure a custom bits source for the modem
link.bits_source = RandomBitsSource(seed=42)

# Configure the waveform's synchronization routine
link.waveform.synchronization = SingleCarrierCorrelationSynchronization()

# Add a custom stream precoding to the modem
link.transmit_signal_coding[0] = ConventionalBeamformer()
link.receive_signal_coding[0] = ConventionalBeamformer()

# Add a custom symbol precoding to the modem
link.transmit_symbol_coding[0] = DFT()
link.receive_symbol_coding[0] = DFT()

# Configure the waveform's channel estimation routine
link.waveform.channel_estimation = SingleCarrierLeastSquaresChannelEstimation()

# Configure the waveform's channel equalization routine
link.waveform.channel_equalization = SingleCarrierZeroForcingChannelEqualization()

# Add forward error correction encodings to the transmitted bit stream
link.encoder_manager.add_encoder(RepetitionEncoder(32, 3))

class SimplexLink(*args, bits_source=None, selected_transmit_ports=None, selected_receive_ports=None, **kwargs)

Bases: TransmittingModem, ReceivingModem

Convenience class to manage a simplex communication link between two dedicated devices.

Parameters:

• bits_source (BitsSource, optional) – Source configuration of communication bits transmitted by this modem. Bits are randomly generated by default.

• selected_transmit_ports (Sequence[int] | None) – Indices of antenna ports selected for transmission from the operated Device's antenna array. If not specified, all available ports will be considered.

• selected_receive_ports (Sequence[int] | None) – Indices of antenna ports selected for reception from the operated Device's antenna array. If not specified, all available ports will be considered.

• *args – Modem initialization parameters. Refer to TransmittingModem and ReceivingModem for further details.

• **kwargs – Modem initialization parameters. Refer to TransmittingModem and ReceivingModem for further details.

connect(transmitting_device, receiving_device)

Connect two devices by this simplex link.

Convenience method that assigns this DSP layer as a transmitter to the transmitting device and as a receiver to the receiving device.

Parameters:

• transmitting_device (Device) – Device transmitting over the simplex link.

• receiving_device (Device) – Device receiving over the simplex link.

Return type:

None

yaml_tag: Optional[str] = 'SimplexLink'

YAML serialization tag