Observes given mobilities and keeps track of certain wanted properties. More...

#include "satellite-mobility-observer.h"

Inheritance diagram for ns3::SatMobilityObserver:

Collaboration diagram for ns3::SatMobilityObserver:

Public Types
typedef void(*	PropertyChangedCallback) (Ptr< const SatMobilityObserver > mobilityObserver)
	Callback signature for PropertyChanged trace source.

Public Member Functions
	SatMobilityObserver ()
	Default constructor of the mobility observer (should not be called).
	SatMobilityObserver (Ptr< SatMobilityModel > ownMobility, Ptr< SatMobilityModel > geoSatMobility, bool isRegenerative=false)
	Constructor for mobility observer.
virtual	~SatMobilityObserver ()
	Destructor of the mobility observer.
virtual void	DoDispose (void)
	Dispose of this class instance.
double	GetElevationAngle (void)
	Get elevation angle.
Time	GetTimingAdvance (void)
	Get timing advance.
double	GetVelocity (void)
	Get velocity of own movement (speed).
void	ObserveTimingAdvance (Ptr< PropagationDelayModel > ownDelayModel, Ptr< PropagationDelayModel > anotherDelayModel, Ptr< SatMobilityModel > anotherMobility)
	Enable observing of the timing advance.

Static Public Member Functions
static TypeId	GetTypeId (void)
	Get the type ID.

Private Member Functions
void	NotifyPropertyChange (void) const
	Notify listeners about some property is changed.
void	PositionChanged (std::string context, Ptr< const SatMobilityModel > position)
	Listener (callback) for mobility position changes.
void	SatelliteStatusChanged ()
	Do actions needed when satellite position is changed.
void	UpdateElevationAngle ()
	Update elevation angle.
void	UpdateTimingAdvance ()
	Update timing advance.

Private Attributes
Ptr< SatMobilityModel >	m_anotherMobility
Ptr< PropagationDelayModel >	m_anotherProgDelayModel
double	m_earthRadius
double	m_elevationAngle
Ptr< SatMobilityModel >	m_geoSatMobility
bool	m_initialized
bool	m_isRegenerative
double	m_maxAltitude
double	m_maxDistanceToSatellite
double	m_minAltitude
Ptr< SatMobilityModel >	m_ownMobility
Ptr< PropagationDelayModel >	m_ownProgDelayModel
TracedCallback< Ptr< const SatMobilityObserver > >	m_propertyChangeTrace
	Used to alert subscribers that a change in some observed property has occurred.
double	m_radiusRatio
Time	m_timingAdvance_s
bool	m_updateElevationAngle
bool	m_updateTimingAdvance
double	m_velocity

Detailed Description

Observes given mobilities and keeps track of certain wanted properties.

Properties can be observed currently are; the timing advance and elevation angle.

Observing of timing advance is set by method ObserveTimingAdvance If satellite regenerates packets on return link, delay corresponds to SAT<->UT link. Otherwise, delay corresponds to GW<->UT link.

Definition at line 45 of file satellite-mobility-observer.h.

Member Typedef Documentation

◆ PropertyChangedCallback

typedef void(* ns3::SatMobilityObserver::PropertyChangedCallback) (Ptr< const SatMobilityObserver > mobilityObserver)

Callback signature for PropertyChanged trace source.

Parameters

mobilityObserver An instance of SatMobilityObserver which property has changed.

Definition at line 118 of file satellite-mobility-observer.h.

Constructor & Destructor Documentation

◆ SatMobilityObserver() [1/2]

ns3::SatMobilityObserver::SatMobilityObserver ( )

Default constructor of the mobility observer (should not be called).

Definition at line 90 of file satellite-mobility-observer.cc.

◆ SatMobilityObserver() [2/2]

ns3::SatMobilityObserver::SatMobilityObserver	(	Ptr< SatMobilityModel >	ownMobility,
		Ptr< SatMobilityModel >	geoSatMobility,
		bool	isRegenerative = false )

Constructor for mobility observer.

Parameters

ownMobility	Own mobility to observe
geoSatMobility	Satellite mobility to observe
isRegenerative	Indicates if the satellite regenerates packets

Definition at line 98 of file satellite-mobility-observer.cc.

References ns3::GeoCoordinate::GetAltitude(), ns3::GeoCoordinate::GetRefEllipsoid(), m_anotherMobility, m_anotherProgDelayModel, m_earthRadius, m_geoSatMobility, m_initialized, m_isRegenerative, m_ownMobility, m_ownProgDelayModel, m_timingAdvance_s, m_updateElevationAngle, m_updateTimingAdvance, m_velocity, PositionChanged(), SatelliteStatusChanged(), and ns3::GeoCoordinate::ToVector().

Here is the call graph for this function:

◆ ~SatMobilityObserver()

ns3::SatMobilityObserver::~SatMobilityObserver ( )

virtual

Destructor of the mobility observer.

Definition at line 155 of file satellite-mobility-observer.cc.

Member Function Documentation

◆ DoDispose()

void ns3::SatMobilityObserver::DoDispose ( void )

virtual

Dispose of this class instance.

Definition at line 144 of file satellite-mobility-observer.cc.

References m_anotherMobility, m_anotherProgDelayModel, m_geoSatMobility, m_ownMobility, and m_ownProgDelayModel.

◆ GetElevationAngle()

double ns3::SatMobilityObserver::GetElevationAngle ( void )

Get elevation angle.

Returns: the current elevation angle as degrees.

Definition at line 189 of file satellite-mobility-observer.cc.

References m_elevationAngle, m_geoSatMobility, m_ownMobility, m_updateElevationAngle, and UpdateElevationAngle().

Referenced by ns3::SatBeamHelper::InstallFadingContainer().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ GetTimingAdvance()

Time ns3::SatMobilityObserver::GetTimingAdvance ( void )

Get timing advance.

Returns: the current timing advance.

Definition at line 219 of file satellite-mobility-observer.cc.

References m_anotherMobility, m_anotherProgDelayModel, m_geoSatMobility, m_ownMobility, m_timingAdvance_s, m_updateTimingAdvance, and UpdateTimingAdvance().

Referenced by ns3::SatUtHelperDvb::Install().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ GetTypeId()

TypeId ns3::SatMobilityObserver::GetTypeId ( void )

static

Get the type ID.

Returns: the object TypeId

Definition at line 43 of file satellite-mobility-observer.cc.

References m_anotherMobility, m_anotherProgDelayModel, m_geoSatMobility, m_maxAltitude, m_minAltitude, m_ownMobility, m_ownProgDelayModel, and m_propertyChangeTrace.

◆ GetVelocity()

double ns3::SatMobilityObserver::GetVelocity ( void )

Get velocity of own movement (speed).

Returns: the current velocity.

Definition at line 207 of file satellite-mobility-observer.cc.

References m_ownMobility, and m_velocity.

Referenced by ns3::SatBeamHelper::InstallFadingContainer().

Here is the caller graph for this function:

◆ NotifyPropertyChange()

void ns3::SatMobilityObserver::NotifyPropertyChange ( void ) const

private

Notify listeners about some property is changed.

Definition at line 245 of file satellite-mobility-observer.cc.

References m_initialized, and m_propertyChangeTrace.

Referenced by PositionChanged().

Here is the caller graph for this function:

◆ ObserveTimingAdvance()

void ns3::SatMobilityObserver::ObserveTimingAdvance	(	Ptr< PropagationDelayModel >	ownDelayModel,
		Ptr< PropagationDelayModel >	anotherDelayModel,
		Ptr< SatMobilityModel >	anotherMobility )