ts::LNB Class Reference

#include <tsLNB.h>

Inheritance diagram for ts::LNB:

Collaboration diagram for ts::LNB:

Classes
class	Transposition

Public Member Functions
	LNB ()=default
	LNB (const UString &name, Report &report=(ts::CerrReport::Instance()))
	LNB (uint64_t frequency)
	LNB (uint64_t low_frequency, uint64_t high_frequency, uint64_t switch_frequency)
size_t	bandsCount () const
bool	isPolarizationControlled () const
bool	isValid () const
uint64_t	legacyHighOscillatorFrequency () const
uint64_t	legacyLowOscillatorFrequency () const
uint64_t	legacySwitchFrequency () const
UString	name () const
bool	set (const UString &name, Report &report=(ts::CerrReport::Instance()))
void	set (uint64_t frequency)
void	set (uint64_t low_frequency, uint64_t high_frequency, uint64_t switch_frequency)
virtual UString	toString () const override
bool	transpose (Transposition &transposition, uint64_t satellite_frequency, Polarization polarity, Report &report=(ts::CerrReport::Instance())) const

Static Public Member Functions
static UStringList	GetAllNames (Report &report=(ts::CerrReport::Instance()))

Detailed Description

Description of a Low-Noise Block (LNB) converter in a satellite dish.

The satellite carrier frequency is used to carry the signal from the satellite to the dish. This value is public and is stored in the NIT for instance. The intermediate frequency is used to carry the signal from the dish's LNB to the receiver. The way this frequency is computed depends on the characteristics of the LNB. The intermediate frequency is the one that is used by the tuner in the satellite receiver.

Note: all frequencies are in Hz in parameters.

Constructor & Destructor Documentation

LNB() [1/4]

ts::LNB::LNB ( )

default

Default constructor. The object is initially invalid.

LNB() [2/4]

ts::LNB::LNB	(	const UString &	name,
		Report &	report = (ts::CerrReport::Instance()) )

Constructor from an LNB name.

Parameters

[in]	name	LNB name of alias as found in file tsduck.lnbs.xml. Can also be a full specification in legacy format (frequencies in MHz): "freq" if the LNB has no high band. "low,high,switch" if the LNB has a high band.
[in,out]	report	Where to log errors.

LNB() [3/4]

ts::LNB::LNB

(

uint64_t

frequency

)

Constructor from a simple legacy LNB without high band.

Parameters

[in]

frequency

Low frequency.

LNB() [4/4]

ts::LNB::LNB	(	uint64_t	low_frequency,
		uint64_t	high_frequency,
		uint64_t	switch_frequency )

Constructor from a legacy LNB with low and high band.

Parameters

[in]	low_frequency	Low frequency.
[in]	high_frequency	High frequency.
[in]	switch_frequency	Switch frequency.

Member Function Documentation

GetAllNames()

UStringList ts::LNB::GetAllNames ( Report & report = (ts::CerrReport::Instance()) )

static

Get a list of all available LNB's from the configuration file.

Parameters

[in,out]

report

Where to report errors.

Returns

The list of all available LNB's and aliases.

name()

UString ts::LNB::name ( ) const

inline

Get the official name of the LNB.

Returns

The official name of the LNB.

toString()

virtual UString ts::LNB::toString ( ) const

overridevirtual

Convert the LNB object to a string.

Returns

A string representing the LNB. This may be different from name(). If the official name contains spaces or other not convenient characters to use on the command line, and a more convenient alias is defined in the configuration file, then this alias is used.

See also

StringifyInterface

Implements ts::StringifyInterface.

isValid()

bool ts::LNB::isValid ( ) const

inline

Check if valid (typically after initializing or converting from string).

Returns

True if valid.

isPolarizationControlled()

bool ts::LNB::isPolarizationControlled

(

)

const

Check if the LNB is polarization-controlled. With such LNB's, the satellite frequencies are transposed in different bands depending on the polarity. Also, they use "stacked" transposition: the transposed bands don't overlap and no tone/voltage/DiSEqC command is needed.

Returns

True if the LNB is polarization-controlled.

bandsCount()

size_t ts::LNB::bandsCount ( ) const

inline

Get the number of frequency bands in the LNB.

Returns

The number of frequency bands in the LNB.

legacyLowOscillatorFrequency()

uint64_t ts::LNB::legacyLowOscillatorFrequency

(

)

const

Get the legacy "low oscillator frequency" value.

Returns

The legacy "low oscillator frequency" or zero if there no equivalent.

legacyHighOscillatorFrequency()

uint64_t ts::LNB::legacyHighOscillatorFrequency

(

)

const

Get the legacy "high oscillator frequency" value.

Returns

The legacy "high oscillator frequency" or zero if there no equivalent.

legacySwitchFrequency()

uint64_t ts::LNB::legacySwitchFrequency

(

)

const

Get the legacy "switch frequency" value.

Returns

The legacy "switch frequency" or zero if there no equivalent.

transpose()

bool ts::LNB::transpose	(	Transposition &	transposition,
		uint64_t	satellite_frequency,
		Polarization	polarity,
		Report &	report = (ts::CerrReport::Instance()) ) const

Compute the intermediate frequency and transposition from a satellite carrier frequency.

Parameters

[out]	transposition	Returned transposition information.
[in]	satellite_frequency	Satellite carrier frequency in Hz.
[in]	polarity	Carrier polarity. Used only on polarization-controlled LNB's. These LNB's typically transpose different polarizations in different bands of intermediate frequencies.
[in,out]	report	Where to log errors.

Returns

True on success, false on error. Return zero on error (invalid LNB, frequency out or range).

set() [1/3]

bool ts::LNB::set	(	const UString &	name,
		Report &	report = (ts::CerrReport::Instance()) )

Set the LNB to the specified type of LNB.

Parameters

[in]	name	LNB name of alias as found in file tsduck.lnbs.xml. Can also be a full specification in legacy format (frequencies in MHz): "freq" if the LNB has no high band. "low,high,switch" if the LNB has a high band.
[in,out]	report	Where to log errors.

Returns

True on success, false on error. In case of error, an error is displayed and the LNB object is marked as invalid.

set() [2/3]

void ts::LNB::set

(

uint64_t

frequency

)

Set values of a simple legacy LNB without high band.

Parameters

[in]

frequency

Low frequency.

set() [3/3]

void ts::LNB::set	(	uint64_t	low_frequency,
		uint64_t	high_frequency,
		uint64_t	switch_frequency )

Set values of a legacy LNB with low and high band.

Parameters

[in]	low_frequency	Low frequency.
[in]	high_frequency	High frequency.
[in]	switch_frequency	Switch frequency.

---

The documentation for this class was generated from the following file:

• tsLNB.h