GW specific Mac class for Sat Net Devices. More...

#include "satellite-gw-mac.h"

Inheritance diagram for ns3::SatGwMac:

Collaboration diagram for ns3::SatGwMac:

Public Types
typedef Callback< void, Address, uint32_t, uint32_t >	ControlMessageReceivedCallback
	Callback to inform NCC a control burst has been received. More...

typedef Callback< void, uint32_t, uint32_t, Address, Ptr< SatCrMessage > >	CrReceiveCallback
	Callback to receive capacity request (CR) messages. More...

typedef Callback< void, Address, uint32_t, uint32_t, uint32_t >	HandoverCallback
	Callback to query/apply handover on the terrestrial network. More...

typedef Callback< void, Address, uint32_t, uint32_t, Callback< void, uint32_t > >	LogonCallback
	Callback to register UT logon. More...

typedef Callback< void, Address, uint32_t, uint32_t >	RemoveUtCallback
	Callback to indicate NCC a UT needs to be removed. More...

typedef Callback< Ptr< Packet >, uint32_t, Mac48Address, uint32_t & >	TxOpportunityCallback
	Callback to notify upper layer about Tx opportunity. More...

Public Types inherited from ns3::SatMac
typedef Callback< void, Ptr< const Packet > >	LoraReceiveCallback
	Callback to receive packet by upper layer. More...

typedef Callback< Ptr< SatControlMessage >, uint32_t >	ReadCtrlMsgCallback
	Callback to read control messages from container storing control messages. More...

typedef Callback< void, Ptr< Packet >, Mac48Address, Mac48Address >	ReceiveCallback
	Callback to receive packet by upper layer. More...

typedef Callback< uint32_t, Ptr< SatControlMessage > >	ReserveCtrlMsgCallback
	Callback to reserve an id and initially store the control message. More...

typedef Callback< void, Address, Address >	RoutingUpdateCallback
	Callback to update routing and ARP tables after handover. More...

typedef Callback< uint32_t, uint32_t >	SendCtrlMsgCallback
	Callback to send a control message and allocate a recv ID for it. More...

typedef Callback< void, SatPhy::PacketContainer_t, uint32_t, Time, SatSignalParameters::txInfo_s >	TransmitCallback
	Callback to send packet to lower layer. More...

Public Member Functions
	SatGwMac ()
	Default constructor, which is not used. More...

	SatGwMac (uint32_t satId, uint32_t beamId, SatEnums::RegenerationMode_t forwardLinkRegenerationMode, SatEnums::RegenerationMode_t returnLinkRegenerationMode)
	Construct a SatGwMac. More...

	~SatGwMac ()
	Destroy a SatGwMac. More...

TypeId	GetInstanceTypeId (void) const
	Derived from Object. More...

void	Receive (SatPhy::PacketContainer_t packets, Ptr< SatSignalParameters >)
	Receive packet from lower layer. More...

void	SetControlMessageReceivedCallback (SatGwMac::ControlMessageReceivedCallback cb)
	Method to set callback for control burst reception. More...

void	SetCrReceiveCallback (SatGwMac::CrReceiveCallback cb)
	Method to set read control message callback. More...

void	SetFwdScheduler (Ptr< SatFwdLinkScheduler > fwdScheduler)
	Method to set forward link scheduler. More...

void	SetHandoverCallback (SatGwMac::HandoverCallback cb)
	Method to set handover callback. More...

void	SetLogonCallback (SatGwMac::LogonCallback cb)
	Method to set logon callback. More...

void	SetRemoveUtCallback (SatGwMac::RemoveUtCallback cb)
	Method to set callback for UT removing. More...

void	SetTxOpportunityCallback (SatGwMac::TxOpportunityCallback cb)
	Method to set Tx opportunity callback. More...

void	StartPeriodicTransmissions ()
	Starts periodical transmissions. More...

void	TbtpSent (Ptr< SatTbtpMessage > tbtp)
	Function called when a TBTP has been sent by the SatBeamScheduler. More...

Public Member Functions inherited from ns3::SatMac
	SatMac ()
	Construct a SatMac. More...

	SatMac (uint32_t satId, uint32_t beamId, SatEnums::RegenerationMode_t forwardLinkRegenerationMode, SatEnums::RegenerationMode_t returnLinkRegenerationMode)
	Construct a SatMac. More...

	~SatMac ()
	Destroy a SatMac. More...

virtual void	Disable ()
	Disable the MAC layer, i.e. More...

virtual void	Enable ()
	Enable the MAC layer, i.e. More...

Address	GetAddress () const
	Get MAC address. More...

uint32_t	GetBeamId () const
	Get beam ID of the object. More...

uint32_t	GetSatId () const
	Get sat ID of the object. More...

virtual void	ReceiveQueueEvent (SatQueue::QueueEvent_t event, uint8_t flowIndex)
	Receive a queue event: More...

uint32_t	ReserveIdAndStoreCtrlMsgToContainer (Ptr< SatControlMessage > msg)
	Reserve id and store the control message. More...

uint32_t	SendCtrlMsgFromContainer (uint32_t sendId)
	Send the control message from the container. More...

void	SetLoraReceiveCallback (SatMac::LoraReceiveCallback cb)
	Method to set receive callback. More...

virtual void	SetNodeInfo (Ptr< SatNodeInfo > nodeInfo)
	Set the node info. More...

void	SetReadCtrlCallback (SatMac::ReadCtrlMsgCallback cb)
	Method to set read control message callback. More...

void	SetReceiveCallback (SatMac::ReceiveCallback cb)
	Method to set receive callback. More...

void	SetReserveCtrlCallback (SatMac::ReserveCtrlMsgCallback cb)
	Method to set reserve control message id callback. More...

void	SetRoutingUpdateCallback (SatMac::RoutingUpdateCallback cb)
	Method to set the routing update callback. More...

virtual void	SetSatelliteAddress (Address satelliteAddress)
	Set the satellite MAC address on the other side of this link (if regenerative satellite). More...

void	SetSendCtrlCallback (SatMac::SendCtrlMsgCallback cb)
	Method to set send control message callback. More...

void	SetTransmitCallback (SatMac::TransmitCallback cb)
	Method to set transmit callback. More...

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

Static Public Member Functions inherited from ns3::SatMac
static TypeId	GetTypeId (void)
	Derived from Object. More...

Private Member Functions
	SatGwMac (const SatGwMac &)

void	DoDispose (void)

SatGwMac &	operator= (const SatGwMac &)

void	ReceiveSignalingPacket (Ptr< Packet > packet, uint32_t satId, uint32_t beamId)
	Signaling packet receiver, which handles all the signaling packet receptions. More...

void	RemoveTbtp (uint32_t superframeCounter)
	Function used to clear old TBTP. More...

void	SendCmtMessage (Address utId, Time burstDuration, Time satelliteReceptionTime, uint32_t satId, uint32_t beamId)

void	SendLogonResponse (Address utId, uint32_t raChannel)

void	SendNcrMessage ()

void	StartNcrTransmission ()
	Send a NCR packet to the UTs. More...

void	StartTransmission (uint32_t carrierId)
	Start sending a Packet Down the Wire. More...

Static Private Member Functions
static void	SendLogonResponseHelper (SatGwMac *self, Address utId, uint32_t raChannel)

Private Attributes
TracedCallback< Ptr< SatBbFrame > >	m_bbFrameTxTrace
	Trace for transmitted BB frames. More...

bool	m_broadcastNcr
	Broadcast NCR messages to all UTs. More...

Time	m_cmtPeriodMin
	Minimum interval between two CMT control messages for a same UT. More...

SatGwMac::ControlMessageReceivedCallback	m_controlMessageReceivedCallback
	Callback to indicate NCC a control burst has been received. More...

SatGwMac::CrReceiveCallback	m_crReceiveCallback
	Capacity request receive callback. More...

Ptr< SatFwdLinkScheduler >	m_fwdScheduler
	Scheduler for the forward link. More...

Time	m_guardTime
	Guard time for BB frames. More...

SatGwMac::HandoverCallback	m_handoverCallback
	Callback to query/apply handover on the terrestrial network. More...

std::map< Address, Time >	m_lastCmtSent
	Time of last CMT sending for each UT. More...

SatGwMac::LogonCallback	m_logonCallback
	Callback to log a terminal on. More...

Time	m_ncrInterval
	Interval between two broadcast of NCR dates. More...

SatGwMac::RemoveUtCallback	m_removeUtCallback
	Callback to indicate NCC a UT needs to be removed. More...

std::map< uint32_t, std::vector< Ptr< SatTbtpMessage > > >	m_tbtps
	List of TBTPs sent to UTs. More...

SatGwMac::TxOpportunityCallback	m_txOpportunityCallback
	Callback to notify the txOpportunity to upper layer Returns a packet Attributes: payload in bytes. More...

bool	m_useCmt
	Use CMT control messages to correct time on the UTs. More...

Additional Inherited Members
Protected Member Functions inherited from ns3::SatMac
void	DoDispose (void)
	Dispose of SatMac. More...

void	RxTraces (SatPhy::PacketContainer_t packets)
	Invoke the `Rx` trace source for each received packet. More...

virtual void	SendPacket (SatPhy::PacketContainer_t packets, uint32_t carrierId, Time duration, SatSignalParameters::txInfo_s txInfo)
	Send packets to lower layer by using a callback. More...

void	SetTimeTag (SatPhy::PacketContainer_t packets)
	Set SatMacTimeTag of packets. More...

Protected Attributes inherited from ns3::SatMac
Time	m_beamEnabledTime
	Time of the last beam enable event. More...

uint32_t	m_beamId
	The ID of the beam where mac belongs. More...

TracedCallback< Time >	m_beamServiceTrace
	Traced callback for beam being disabled and including service time. More...

SatEnums::RegenerationMode_t	m_forwardLinkRegenerationMode
	Regeneration mode on forward link. More...

bool	m_isRegenerative
	Indicate if satellite is regeneration (at least LINK level) for TX. More...

bool	m_isStatisticsTagsEnabled
	`EnableStatisticsTags` attribute. More...

Time	m_lastDelay
	Last delay measurement. More...

Time	m_lastLinkDelay
	Last delay measurement for link. More...

std::queue< Time >	m_lastSOF
	Store last 3 SOF date for Forward messages, to insert in NCR packets. More...

std::queue< Ptr< SatNcrMessage > >	m_ncrMessagesToSend
	List of NCR control messages created but not sent yet. More...

bool	m_ncrV2
	Use of version 2 of NCR dates. More...

Ptr< SatNodeInfo >	m_nodeInfo
	Node info containing node related information, such as node type, node id and MAC address (of the SatNetDevice) More...

TracedCallback< Time, SatEnums::SatPacketEvent_t, SatEnums::SatNodeType_t, uint32_t, Mac48Address, SatEnums::SatLogLevel_t, SatEnums::SatLinkDir_t, std::string >	m_packetTrace
	Trace callback used for packet tracing. More...

SatMac::ReadCtrlMsgCallback	m_readCtrlCallback
	The read control message callback. More...

SatMac::ReserveCtrlMsgCallback	m_reserveCtrlCallback
	The reserve control message id callback. More...

SatEnums::RegenerationMode_t	m_returnLinkRegenerationMode
	Regeneration mode on return link. More...

SatMac::RoutingUpdateCallback	m_routingUpdateCallback
	Callback to update routing and ARP tables after a beam handover. More...

SatMac::ReceiveCallback	m_rxCallback
	The upper layer package receive callback. More...

TracedCallback< const Time &, const Address & >	m_rxDelayTrace
	Traced callback for all received packets, including delay information and the address of the senders. More...

TracedCallback< const Time &, const Address & >	m_rxJitterTrace
	Traced callback for all received packets, including jitter information and the address of the senders. More...

TracedCallback< const Time &, const Address & >	m_rxLinkDelayTrace
	Traced callback for all received packets, including link delay information and the address of the senders. More...

TracedCallback< const Time &, const Address & >	m_rxLinkJitterTrace
	Traced callback for all received packets, including link jitter information and the address of the senders. More...

SatMac::LoraReceiveCallback	m_rxLoraCallback
	The upper layer package receive callback. More...

TracedCallback< Ptr< const Packet >, const Address & >	m_rxTrace
	Traced callback for all received packets, including the address of the senders. More...

Address	m_satelliteAddress
	MAC address of satellite on other side of the link. More...

uint32_t	m_satId
	The ID of the sat where mac belongs. More...

SatMac::SendCtrlMsgCallback	m_sendCtrlCallback
	The send control message callback. More...

SatMac::TransmitCallback	m_txCallback
	The lower layer packet transmit callback. More...

bool	m_txEnabled
	Flag indicating whether the MAC is enabled, i.e. More...

Detailed Description

GW specific Mac class for Sat Net Devices.

This SatGwMac class specializes the Mac class with GW characteristics.

Definition at line 50 of file satellite-gw-mac.h.

Member Typedef Documentation

◆ ControlMessageReceivedCallback

typedef Callback<void, Address, uint32_t, uint32_t> ns3::SatGwMac::ControlMessageReceivedCallback

Callback to inform NCC a control burst has been received.

Parameters

Address	identification of the UT that sent the burst
uint32_t	satellite ID where the UT is connected
uint32_t	beam ID where the UT is connected

Definition at line 175 of file satellite-gw-mac.h.

◆ CrReceiveCallback

typedef Callback<void, uint32_t, uint32_t, Address, Ptr<SatCrMessage> > ns3::SatGwMac::CrReceiveCallback

Callback to receive capacity request (CR) messages.

Parameters

uint32_t	The satellite ID.
uint32_t	The beam ID.
Address	Address of the sender UT.
Ptr<SatControlMessage>	Pointer to the received CR message.

Definition at line 116 of file satellite-gw-mac.h.

◆ HandoverCallback

typedef Callback<void, Address, uint32_t, uint32_t, uint32_t> ns3::SatGwMac::HandoverCallback

Callback to query/apply handover on the terrestrial network.

Parameters

Address	identification of the UT originating the request
uint32_t	satellite ID
uint32_t	source beam ID the UT is still in
uint32_t	destination beam ID the UT would like to go in

Definition at line 146 of file satellite-gw-mac.h.

◆ LogonCallback

typedef Callback<void, Address, uint32_t, uint32_t, Callback<void, uint32_t> > ns3::SatGwMac::LogonCallback

Callback to register UT logon.

Parameters

Address	identification of the UT originating the request
uint32_t	sat ID the UT is requesting logon on
uint32_t	beam ID the UT is requesting logon on
Callback	setRaChannelCallback the callback to call when RA channel has been selected

Definition at line 161 of file satellite-gw-mac.h.

◆ RemoveUtCallback

typedef Callback<void, Address, uint32_t, uint32_t> ns3::SatGwMac::RemoveUtCallback

Callback to indicate NCC a UT needs to be removed.

Parameters

Address	identification of the UT to remove
uint32_t	satellite ID where the UT is connected
uint32_t	beam ID where the UT is connected

Definition at line 189 of file satellite-gw-mac.h.

◆ TxOpportunityCallback

typedef Callback<Ptr<Packet>, uint32_t, Mac48Address, uint32_t&> ns3::SatGwMac::TxOpportunityCallback

Callback to notify upper layer about Tx opportunity.

Parameters

uint32_t	payload size in bytes
Mac48Address	address

Returns: packet Packet to be transmitted to PHY

Definition at line 130 of file satellite-gw-mac.h.

Constructor & Destructor Documentation

◆ SatGwMac() [1/3]

ns3::SatGwMac::SatGwMac ( )

Default constructor, which is not used.

Definition at line 103 of file satellite-gw-mac.cc.

◆ SatGwMac() [2/3]

ns3::SatGwMac::SatGwMac	(	uint32_t	satId,
		uint32_t	beamId,
		SatEnums::RegenerationMode_t	forwardLinkRegenerationMode,
		SatEnums::RegenerationMode_t	returnLinkRegenerationMode
	)

Construct a SatGwMac.

This is the constructor for the SatGwMac

Parameters

satId	ID of sat for UT
beamId	ID of beam for UT
forwardLinkRegenerationMode	Forward link regeneration mode
returnLinkRegenerationMode	Return link regeneration mode

Definition at line 118 of file satellite-gw-mac.cc.

◆ ~SatGwMac()

ns3::SatGwMac::~SatGwMac ( )

Destroy a SatGwMac.

This is the destructor for the SatGwMac.

Definition at line 134 of file satellite-gw-mac.cc.

◆ SatGwMac() [3/3]

ns3::SatGwMac::SatGwMac ( const SatGwMac & )

private

Member Function Documentation

◆ DoDispose()

void ns3::SatGwMac::DoDispose ( void )

private

Definition at line 140 of file satellite-gw-mac.cc.

References ns3::SatMac::DoDispose(), m_controlMessageReceivedCallback, m_crReceiveCallback, m_handoverCallback, m_logonCallback, and m_txOpportunityCallback.

Here is the call graph for this function:

◆ GetInstanceTypeId()

TypeId ns3::SatGwMac::GetInstanceTypeId ( void ) const

Derived from Object.

Definition at line 96 of file satellite-gw-mac.cc.

References GetTypeId().

Here is the call graph for this function:

◆ GetTypeId()

TypeId ns3::SatGwMac::GetTypeId ( void )

static

Get the type ID.

Returns: the object TypeId

Definition at line 52 of file satellite-gw-mac.cc.

References m_bbFrameTxTrace, m_broadcastNcr, m_cmtPeriodMin, m_fwdScheduler, m_guardTime, m_ncrInterval, and m_useCmt.

Referenced by GetInstanceTypeId().

Here is the caller graph for this function:

◆ operator=()

SatGwMac& ns3::SatGwMac::operator= ( const SatGwMac & )

private

◆ Receive()

void ns3::SatGwMac::Receive	(	SatPhy::PacketContainer_t	packets,
		Ptr< SatSignalParameters >	rxParams
	)

Receive packet from lower layer.

Parameters

packets Pointers to packets received.

Definition at line 179 of file satellite-gw-mac.cc.

References ns3::SatUplinkInfoTag::GetBeamId(), ns3::SatMacTag::GetDestAddress(), ns3::SatAddressE2ETag::GetE2EDestAddress(), ns3::SatAddressE2ETag::GetE2ESourceAddress(), ns3::SatControlMsgTag::GetMsgType(), ns3::SatUtils::GetPacketInfo(), ns3::SatUplinkInfoTag::GetSatelliteReceptionTime(), ns3::SatUplinkInfoTag::GetSatId(), ns3::SatMacTag::GetSourceAddress(), ns3::SatUplinkInfoTag::IsControl(), ns3::SatEnums::LD_RETURN, ns3::SatEnums::LL_MAC, m_controlMessageReceivedCallback, ns3::SatMac::m_nodeInfo, ns3::SatMac::m_packetTrace, ns3::SatMac::m_returnLinkRegenerationMode, ns3::SatMac::m_rxCallback, m_useCmt, ns3::SatEnums::PACKET_RECV, ReceiveSignalingPacket(), ns3::SatEnums::REGENERATION_LINK, ns3::SatEnums::REGENERATION_NETWORK, ns3::SatEnums::REGENERATION_PHY, ns3::SatMac::RxTraces(), ns3::SatControlMsgTag::SAT_NON_CTRL_MSG, SendCmtMessage(), and ns3::SatEnums::TRANSPARENT.

Referenced by ns3::SatGwHelper::InstallDvb().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ ReceiveSignalingPacket()

void ns3::SatGwMac::ReceiveSignalingPacket	(	Ptr< Packet >	packet,
		uint32_t	satId,
		uint32_t	beamId
	)

private

Signaling packet receiver, which handles all the signaling packet receptions.

Parameters

packet	Received signaling packet
beamId	ID of beam on UT

Control message NOT found in container anymore! This means, that the SatBeamHelper::CtrlMsgStoreTimeInRtnLink attribute may be set to too short value or there are something wrong in the RTN link RRM.

Definition at line 457 of file satellite-gw-mac.cc.

Referenced by Receive().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ RemoveTbtp()

void ns3::SatGwMac::RemoveTbtp ( uint32_t superframeCounter )

private

Function used to clear old TBTP.

Parameters

superframeCounter The SuperFrame counter to erase.

Definition at line 441 of file satellite-gw-mac.cc.

References m_tbtps.

Referenced by TbtpSent().

Here is the caller graph for this function:

◆ SendCmtMessage()

void ns3::SatGwMac::SendCmtMessage	(	Address	utId,
		Time	burstDuration,
		Time	satelliteReceptionTime,
		uint32_t	satId,
		uint32_t	beamId
	)

private

Definition at line 635 of file satellite-gw-mac.cc.

References m_cmtPeriodMin, m_fwdScheduler, m_lastCmtSent, m_removeUtCallback, m_tbtps, ns3::SatTimeSlotConf::SLOT_TYPE_C, and ns3::SatConstVariables::SUPERFRAME_SEQUENCE.

Referenced by Receive().

Here is the caller graph for this function:

◆ SendLogonResponse()

void ns3::SatGwMac::SendLogonResponse	(	Address	utId,
		uint32_t	raChannel
	)

private

Definition at line 738 of file satellite-gw-mac.cc.

References m_fwdScheduler.

◆ SendLogonResponseHelper()

void ns3::SatGwMac::SendLogonResponseHelper	(	SatGwMac *	self,
		Address	utId,
		uint32_t	raChannel
	)

staticprivate

Definition at line 747 of file satellite-gw-mac.cc.

Referenced by ReceiveSignalingPacket().

Here is the caller graph for this function:

◆ SendNcrMessage()

void ns3::SatGwMac::SendNcrMessage ( )

private

Definition at line 626 of file satellite-gw-mac.cc.

References m_fwdScheduler, and ns3::SatMac::m_ncrMessagesToSend.

Referenced by StartNcrTransmission().

Here is the caller graph for this function:

◆ SetControlMessageReceivedCallback()

void ns3::SatGwMac::SetControlMessageReceivedCallback ( SatGwMac::ControlMessageReceivedCallback cb )

Method to set callback for control burst reception.

Parameters

cb	callback to invoke whenever a control burst is received

Definition at line 774 of file satellite-gw-mac.cc.

References m_controlMessageReceivedCallback.

◆ SetCrReceiveCallback()

void ns3::SatGwMac::SetCrReceiveCallback ( SatGwMac::CrReceiveCallback cb )

Method to set read control message callback.

Parameters

cb	callback to invoke whenever a control message is wanted to read.

Definition at line 753 of file satellite-gw-mac.cc.

References m_crReceiveCallback.

◆ SetFwdScheduler()

void ns3::SatGwMac::SetFwdScheduler ( Ptr< SatFwdLinkScheduler > fwdScheduler )

Method to set forward link scheduler.

Parameters

The	scheduler to use

Definition at line 788 of file satellite-gw-mac.cc.

References m_fwdScheduler, and ns3::SatMac::m_ncrV2.

◆ SetHandoverCallback()

void ns3::SatGwMac::SetHandoverCallback ( SatGwMac::HandoverCallback cb )

Method to set handover callback.

Parameters

cb	callback to invoke whenever a handover recommendation is received

Definition at line 760 of file satellite-gw-mac.cc.

References m_handoverCallback.

◆ SetLogonCallback()

void ns3::SatGwMac::SetLogonCallback ( SatGwMac::LogonCallback cb )

Method to set logon callback.

Parameters

cb	callback to invoke whenever a logon is received

Definition at line 767 of file satellite-gw-mac.cc.

References m_logonCallback.

◆ SetRemoveUtCallback()

void ns3::SatGwMac::SetRemoveUtCallback ( SatGwMac::RemoveUtCallback cb )

Method to set callback for UT removing.

Parameters

cb	callback to invoke whenever a UT needs to be removed

Definition at line 781 of file satellite-gw-mac.cc.

References m_removeUtCallback.

◆ SetTxOpportunityCallback()

void ns3::SatGwMac::SetTxOpportunityCallback ( SatGwMac::TxOpportunityCallback cb )

Method to set Tx opportunity callback.

Parameters

cb	callback to invoke whenever a packet has been received and must be forwarded to the higher layers.

◆ StartNcrTransmission()

void ns3::SatGwMac::StartNcrTransmission ( )

private

Send a NCR packet to the UTs.

This method periodically calls itself.

Definition at line 447 of file satellite-gw-mac.cc.

References m_ncrInterval, and SendNcrMessage().

Referenced by StartPeriodicTransmissions().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ StartPeriodicTransmissions()

void ns3::SatGwMac::StartPeriodicTransmissions ( )

Starts periodical transmissions.

Called when MAC is wanted to take care of periodic sending.

It is currently assumed that there is only one carrier in FWD link. This carrier has a default index of 0. TODO: When enabling multi-carrier support for FWD link, we need to modify the FWD link scheduler to schedule separately each FWD link carrier.

Definition at line 154 of file satellite-gw-mac.cc.

References m_broadcastNcr, m_fwdScheduler, StartNcrTransmission(), and StartTransmission().

Here is the call graph for this function:

◆ StartTransmission()

void ns3::SatGwMac::StartTransmission ( uint32_t carrierId )

private

Start sending a Packet Down the Wire.

The StartTransmission method is used internally in the SatGwMac to begin the process of sending a packet out on the PHY layer.

Parameters

carrierId id of the carrier.

Returns: true if success, false on failure

Decrease a guard time from BB frame duration.

GW MAC is disabled, thus get the duration of the default BB frame and try again then.

It is currently assumed that there is only one carrier in FWD link. This carrier has a default index of 0. TODO: When enabling multi-carrier support for FWD link, we need to modify the FWD link scheduler to schedule separately each FWD link carrier.

Definition at line 352 of file satellite-gw-mac.cc.

References ns3::SatSignalParameters::txInfo_s::frameType, ns3::SatUtils::GetPacketInfo(), ns3::SatEnums::LD_FORWARD, ns3::SatEnums::LL_MAC, m_bbFrameTxTrace, m_fwdScheduler, m_guardTime, ns3::SatMac::m_lastSOF, ns3::SatMac::m_ncrV2, ns3::SatMac::m_nodeInfo, ns3::SatMac::m_packetTrace, ns3::SatMac::m_txEnabled, ns3::SatSignalParameters::txInfo_s::modCod, ns3::SatEnums::NT_GW, ns3::SatEnums::PACKET_SENT, ns3::SatEnums::PACKET_TYPE_DEDICATED_ACCESS, ns3::SatSignalParameters::txInfo_s::packetType, ns3::SatMac::SendPacket(), ns3::SatSignalParameters::txInfo_s::sliceId, and ns3::SatSignalParameters::txInfo_s::waveformId.

Referenced by StartPeriodicTransmissions().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ TbtpSent()

void ns3::SatGwMac::TbtpSent ( Ptr< SatTbtpMessage > tbtp )

Function called when a TBTP has been sent by the SatBeamScheduler.

Parameters

tbtp	The TBTP sent by the scheduler.

Definition at line 425 of file satellite-gw-mac.cc.

References m_tbtps, and RemoveTbtp().

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

Here is the call graph for this function:

Here is the caller graph for this function:

Member Data Documentation

◆ m_bbFrameTxTrace

TracedCallback<Ptr<SatBbFrame> > ns3::SatGwMac::m_bbFrameTxTrace

private

Trace for transmitted BB frames.

Definition at line 294 of file satellite-gw-mac.h.

Referenced by GetTypeId(), and StartTransmission().

◆ m_broadcastNcr

bool ns3::SatGwMac::m_broadcastNcr

private

Broadcast NCR messages to all UTs.

Definition at line 289 of file satellite-gw-mac.h.

Referenced by GetTypeId(), and StartPeriodicTransmissions().

◆ m_cmtPeriodMin

Time ns3::SatGwMac::m_cmtPeriodMin

private

Minimum interval between two CMT control messages for a same UT.

Definition at line 284 of file satellite-gw-mac.h.

Referenced by GetTypeId(), and SendCmtMessage().

◆ m_controlMessageReceivedCallback

SatGwMac::ControlMessageReceivedCallback ns3::SatGwMac::m_controlMessageReceivedCallback

private

Callback to indicate NCC a control burst has been received.

Definition at line 321 of file satellite-gw-mac.h.

Referenced by DoDispose(), Receive(), and SetControlMessageReceivedCallback().

◆ m_crReceiveCallback

SatGwMac::CrReceiveCallback ns3::SatGwMac::m_crReceiveCallback

private

Capacity request receive callback.

Definition at line 299 of file satellite-gw-mac.h.

Referenced by DoDispose(), ReceiveSignalingPacket(), and SetCrReceiveCallback().

◆ m_fwdScheduler

Ptr<SatFwdLinkScheduler> ns3::SatGwMac::m_fwdScheduler

private

Scheduler for the forward link.

Definition at line 258 of file satellite-gw-mac.h.

Referenced by GetTypeId(), ReceiveSignalingPacket(), SendCmtMessage(), SendLogonResponse(), SendNcrMessage(), SetFwdScheduler(), StartPeriodicTransmissions(), and StartTransmission().

◆ m_guardTime

Time ns3::SatGwMac::m_guardTime

private

Guard time for BB frames.

The guard time is modeled by shortening the duration of a BB frame by a m_guardTime set by an attribute.

Definition at line 264 of file satellite-gw-mac.h.

Referenced by GetTypeId(), and StartTransmission().

◆ m_handoverCallback

SatGwMac::HandoverCallback ns3::SatGwMac::m_handoverCallback

private

Callback to query/apply handover on the terrestrial network.

Definition at line 311 of file satellite-gw-mac.h.

Referenced by DoDispose(), ReceiveSignalingPacket(), and SetHandoverCallback().

◆ m_lastCmtSent

std::map<Address, Time> ns3::SatGwMac::m_lastCmtSent

private

Time of last CMT sending for each UT.

Definition at line 279 of file satellite-gw-mac.h.

Referenced by SendCmtMessage().

◆ m_logonCallback

SatGwMac::LogonCallback ns3::SatGwMac::m_logonCallback

private

Callback to log a terminal on.

Definition at line 316 of file satellite-gw-mac.h.

Referenced by DoDispose(), ReceiveSignalingPacket(), and SetLogonCallback().

◆ m_ncrInterval

Time ns3::SatGwMac::m_ncrInterval

private

Interval between two broadcast of NCR dates.

Definition at line 269 of file satellite-gw-mac.h.

Referenced by GetTypeId(), and StartNcrTransmission().

◆ m_removeUtCallback

SatGwMac::RemoveUtCallback ns3::SatGwMac::m_removeUtCallback

private

Callback to indicate NCC a UT needs to be removed.

Definition at line 326 of file satellite-gw-mac.h.

Referenced by SendCmtMessage(), and SetRemoveUtCallback().

◆ m_tbtps

std::map<uint32_t, std::vector<Ptr<SatTbtpMessage> > > ns3::SatGwMac::m_tbtps

private

List of TBTPs sent to UTs.

Key is superframe counter, value is TBTP.

Definition at line 253 of file satellite-gw-mac.h.

Referenced by RemoveTbtp(), SendCmtMessage(), and TbtpSent().

◆ m_txOpportunityCallback

SatGwMac::TxOpportunityCallback ns3::SatGwMac::m_txOpportunityCallback

private

Callback to notify the txOpportunity to upper layer Returns a packet Attributes: payload in bytes.

Definition at line 306 of file satellite-gw-mac.h.

Referenced by DoDispose().

◆ m_useCmt

bool ns3::SatGwMac::m_useCmt

private

Use CMT control messages to correct time on the UTs.

Definition at line 274 of file satellite-gw-mac.h.

Referenced by GetTypeId(), and Receive().

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

/builds/sns3/satellite/satellite/model/satellite-gw-mac.h
/builds/sns3/satellite/satellite/model/satellite-gw-mac.cc

Public Types

Public Member Functions

Static Public Member Functions

Private Member Functions

Static Private Member Functions

Private Attributes

Additional Inherited Members

Detailed Description

Member Typedef Documentation

◆ ControlMessageReceivedCallback

◆ CrReceiveCallback

◆ HandoverCallback

◆ LogonCallback

◆ RemoveUtCallback

◆ TxOpportunityCallback

Constructor & Destructor Documentation

◆ SatGwMac() [1/3]

◆ SatGwMac() [2/3]

◆ ~SatGwMac()

◆ SatGwMac() [3/3]

Member Function Documentation

◆ DoDispose()

◆ GetInstanceTypeId()

◆ GetTypeId()

◆ operator=()

◆ Receive()

◆ ReceiveSignalingPacket()

◆ RemoveTbtp()

◆ SendCmtMessage()

◆ SendLogonResponse()

◆ SendLogonResponseHelper()

◆ SendNcrMessage()

◆ SetControlMessageReceivedCallback()

◆ SetCrReceiveCallback()

◆ SetFwdScheduler()

◆ SetHandoverCallback()

◆ SetLogonCallback()

◆ SetRemoveUtCallback()

◆ SetTxOpportunityCallback()

◆ StartNcrTransmission()

◆ StartPeriodicTransmissions()

◆ StartTransmission()

◆ TbtpSent()

Member Data Documentation

◆ m_bbFrameTxTrace

◆ m_broadcastNcr

◆ m_cmtPeriodMin

◆ m_controlMessageReceivedCallback

◆ m_crReceiveCallback

◆ m_fwdScheduler

◆ m_guardTime

◆ m_handoverCallback

◆ m_lastCmtSent

◆ m_logonCallback

◆ m_ncrInterval

◆ m_removeUtCallback

◆ m_tbtps

◆ m_txOpportunityCallback

◆ m_useCmt