This class implements the content of one individual DVB-RCS2 waveform. More...

#include "satellite-wave-form-conf.h"

Inheritance diagram for ns3::SatWaveform:

Collaboration diagram for ns3::SatWaveform:

Public Member Functions
	SatWaveform ()
	Default constructor for SatWaveform. More...

	SatWaveform (uint32_t wfId, uint32_t modulatedBits, double codingRate, SatEnums::SatModcod_t modcod, uint32_t payloadBytes, uint32_t lengthInSymbols, uint32_t preambleLengthInSymbols)
	Constructor for SatWaveform. More...

void	Dump (double carrierBandwidthInHz, double symbolRateInBaud) const
	Dump the contents of the waveform. More...

Time	GetBurstDuration (double symbolRateInBaud) const
	Get/calculate the burst duration of a waveform based on symbol rate. More...

uint32_t	GetBurstLengthInSymbols () const
	Get burst length of the waveform in symbols. More...

double	GetCNoThreshold (double symbolRateInBaud) const
	Get the C/No threshold of the waveform in linear domain. More...

SatEnums::SatModcod_t	GetModCod () const
	Get MODCOD enum. More...

uint32_t	GetPayloadInBytes () const
	Get payload of a waveform in bytes. More...

Time	GetPreambleDuration (double symbolRateInBaud) const
	Get/calculate the preamble duration of a waveform based on symbol rate. More...

uint32_t	GetPreambleLengthInSymbols () const
	Get preamble length of the waveform in symbols. More...

double	GetSpectralEfficiency (double carrierBandwidthInHz, double symbolRateInBaud) const
	Get/calculate the spectral efficiency of a waveform. More...

double	GetThroughputInBitsPerSecond (double symbolRateInBaud) const
	Get/calculate the throughput of a waveform based on symbol rate. More...

uint32_t	GetWaveformId () const
	Get waveform id. More...

void	SetEbNoRequirement (double ebnoRequirement)
	Set the Eb/No requirement of the waveform in linear domain based on the used link results. More...

Private Attributes
double	m_codingRate
	Coding rate. More...

double	m_ebnoRequirement
	Eb/No threshold calculated with a certain BLER target from the link results. More...

uint32_t	m_lengthInSymbols
	Length of the burst in symbols. More...

SatEnums::SatModcod_t	m_modCod
	MODCOD enum. More...

uint32_t	m_modulatedBits
	Modulated bits QPSK = 2 8PSK = 3 16QAM = 4. More...

uint32_t	m_payloadBytes
	Payload in bytes. More...

uint32_t	m_preambleLengthInSymbols
	Length of the preamble in symbols. More...

uint32_t	m_waveformId
	Id of this waveform. More...

Detailed Description

This class implements the content of one individual DVB-RCS2 waveform.

Waveform is defined by modulation scheme, coding rate, payload size in bytes and burst length in symbols.

See also

ETSI EN 301 545-2 Digital Video Broadcasting (DVB); Second Generation Interactive Satellite System (DVB-RCS2); Part 2: Lower Layers for Satellite Standard

Annex A Reference waveforms

Definition at line 50 of file satellite-wave-form-conf.h.

Constructor & Destructor Documentation

◆ SatWaveform() [1/2]

ns3::SatWaveform::SatWaveform ( )

Default constructor for SatWaveform.

Definition at line 51 of file satellite-wave-form-conf.cc.

◆ SatWaveform() [2/2]

ns3::SatWaveform::SatWaveform	(	uint32_t	wfId,
		uint32_t	modulatedBits,
		double	codingRate,
		SatEnums::SatModcod_t	modcod,
		uint32_t	payloadBytes,
		uint32_t	lengthInSymbols,
		uint32_t	preambleLengthInSymbols
	)

Constructor for SatWaveform.

Parameters

wfId	Waveform id
modulatedBits	Modulated bits
codingRate	Coding rate
modcod	ModCod
payloadBytes	Payload in bytes
lengthInSymbols	Duration in symbols
preambleLengthInSymbols	Preamble duration in symbols

Definition at line 64 of file satellite-wave-form-conf.cc.

Member Function Documentation

◆ Dump()

void ns3::SatWaveform::Dump	(	double	carrierBandwidthInHz,
		double	symbolRateInBaud
	)		const

Dump the contents of the waveform.

The total carrier bandwidth and symbol rate are needed for spectral efficiency calculation.

Parameters

carrierBandwidthInHz	Total carrier bandwidth including e.g. guard band.
symbolRateInBaud	Effective symbol rate where guard band and roll-off has been deduced.

Definition at line 170 of file satellite-wave-form-conf.cc.

References GetBurstDuration(), GetCNoThreshold(), GetSpectralEfficiency(), GetThroughputInBitsPerSecond(), ns3::SatUtils::LinearToDb(), m_codingRate, m_ebnoRequirement, m_lengthInSymbols, m_modulatedBits, and m_payloadBytes.

Here is the call graph for this function:

◆ GetBurstDuration()

Time ns3::SatWaveform::GetBurstDuration ( double symbolRateInBaud ) const

Get/calculate the burst duration of a waveform based on symbol rate.

Parameters

symbolRateInBaud Symbol rate

Returns: Burst duration

Definition at line 118 of file satellite-wave-form-conf.cc.

References m_lengthInSymbols.

Referenced by Dump().

Here is the caller graph for this function:

◆ GetBurstLengthInSymbols()

uint32_t ns3::SatWaveform::GetBurstLengthInSymbols ( ) const

Get burst length of the waveform in symbols.

Returns: Burst length

Definition at line 104 of file satellite-wave-form-conf.cc.

References m_lengthInSymbols.

◆ GetCNoThreshold()

double ns3::SatWaveform::GetCNoThreshold ( double symbolRateInBaud ) const

Get the C/No threshold of the waveform in linear domain.

Parameters

symbolRateInBaud Symbol rate in baud

Returns: C/No threshold

Convert the Eb/No requirement into C/No requirement by using the carrier symbol rate and log2(modulatedBits). Eb/No = (Es/log2M)/No = (Es/No)*(1/log2M) = C/N * (1/log2M) = C/No * (1/fs) * (1/log2M)

Definition at line 148 of file satellite-wave-form-conf.cc.

References m_codingRate, m_ebnoRequirement, and m_modulatedBits.

Referenced by Dump().

Here is the caller graph for this function: