CW-MAC A MAC protocol similar in idea to the 802.11 DCF with constant backoff window. More...

#include <uan-mac-cw.h>

Inheritance diagram for ns3::UanMacCw:

Collaboration diagram for ns3::UanMacCw:

Public Member Functions
	UanMacCw ()
virtual	~UanMacCw ()
int64_t	AssignStreams (int64_t stream)
virtual void	AttachPhy (Ptr< UanPhy > phy)
virtual void	Clear (void)
virtual bool	Enqueue (Ptr< Packet > pkt, const Address &dest, uint16_t protocolNumber)
virtual Address	GetAddress ()
virtual Address	GetBroadcast (void) const
virtual uint32_t	GetCw (void)
virtual Time	GetSlotTime (void)
virtual void	NotifyCcaEnd (void)
	Function called by UanPhy object to notify of channel no longer sensed busy.
virtual void	NotifyCcaStart (void)
	Function called by UanPhy object to notify of channel sensed busy.
virtual void	NotifyRxEndError (void)
	Function called by UanPhy object to notify of packet received in error.
virtual void	NotifyRxEndOk (void)
	Function called by UanPhy object to notify of packet received successfully.
virtual void	NotifyRxStart (void)
	Function called by UanPhy object to notify of packet reception.
virtual void	NotifyTxStart (Time duration)
	Function called by UanPhy object to notify of outgoing transmission start.
virtual void	SetAddress (UanAddress addr)
virtual void	SetCw (uint32_t cw)
virtual void	SetForwardUpCb (Callback< void, Ptr< Packet >, const UanAddress & > cb)
virtual void	SetSlotTime (Time duration)
Public Member Functions inherited from ns3::UanPhyListener
virtual	~UanPhyListener ()

Static Public Member Functions
static TypeId	GetTypeId (void)
	This method returns the TypeId associated to ns3::UanMacCw.

Protected Member Functions
virtual void	DoDispose ()

Private Types
enum	State { IDLE, CCABUSY, RUNNING, TX }

Private Member Functions
void	EndTx (void)
void	PhyRxPacketError (Ptr< Packet > packet, double sinr)
void	PhyRxPacketGood (Ptr< Packet > packet, double sinr, UanTxMode mode)
void	SaveTimer (void)
void	SendPacket (void)
void	StartTimer (void)

Private Attributes
UanAddress	m_address
bool	m_cleared
uint32_t	m_cw
TracedCallback< Ptr< const Packet >, uint16_t >	m_dequeueLogger
TracedCallback< Ptr< const Packet >, uint16_t >	m_enqueueLogger
Callback< void, Ptr< Packet > , const UanAddress & >	m_forwardUpCb
Ptr< UanPhy >	m_phy
Ptr< Packet >	m_pktTx
uint16_t	m_pktTxProt
Ptr< UniformRandomVariable >	m_rv
	Provides uniform random variables.
TracedCallback< Ptr< const Packet >, UanTxMode >	m_rxLogger
Time	m_savedDelayS
EventId	m_sendEvent
Time	m_sendTime
Time	m_slotTime
State	m_state
EventId	m_txEndEvent

Detailed Description

CW-MAC A MAC protocol similar in idea to the 802.11 DCF with constant backoff window.

For more information on this MAC protocol, see: Parrish, N.; Tracy, L.; Roy, S.; Arabshahi, P.; Fox, W., "System Design Considerations for Undersea Networks: Link and Multiple Access Protocols," Selected Areas in Communications, IEEE Journal on , vol.26, no.9, pp.1720-1730, December 2008

Definition at line 43 of file uan-mac-cw.h.

Member Enumeration Documentation

enum ns3::UanMacCw::State

private

Enumerator:

IDLE
CCABUSY
RUNNING
TX

Definition at line 102 of file uan-mac-cw.h.

Constructor & Destructor Documentation

ns3::UanMacCw::UanMacCw ( )

Definition at line 36 of file uan-mac-cw.cc.

References m_rv.

ns3::UanMacCw::~UanMacCw ( )

virtual

Definition at line 47 of file uan-mac-cw.cc.

Member Function Documentation

int64_t ns3::UanMacCw::AssignStreams ( int64_t stream )

virtual

Assign a fixed random variable stream number to the random variables used by this model. Return the number of streams (possibly zero) that have been assigned.

Parameters

stream first stream index to use

Returns: the number of stream indices assigned by this model

Implements ns3::UanMac.

Definition at line 290 of file uan-mac-cw.cc.

References m_rv, NS_LOG_FUNCTION, and ns3::RandomVariableStream::SetStream().

Here is the call graph for this function:

void ns3::UanMacCw::AttachPhy ( Ptr< UanPhy > phy )

virtual

Attach PHY layer to this MAC. Some MACs may be designed to work with multiple PHY layers. Others may only work with one.

Parameters

phy	Phy layer to attach to this MAC

Implements ns3::UanMac.

Definition at line 193 of file uan-mac-cw.cc.

References m_phy, ns3::MakeCallback(), PhyRxPacketError(), PhyRxPacketGood(), ns3::UanPhy::RegisterListener(), ns3::UanPhy::SetReceiveErrorCallback(), and ns3::UanPhy::SetReceiveOkCallback().

Here is the call graph for this function:

void ns3::UanMacCw::Clear ( void )

virtual

Clears all pointer references

Implements ns3::UanMac.

Definition at line 52 of file uan-mac-cw.cc.

References ns3::EventId::Cancel(), ns3::UanPhy::Clear(), m_cleared, m_phy, m_pktTx, m_sendEvent, and m_txEndEvent.

Referenced by DoDispose().

Here is the call graph for this function:

Here is the caller graph for this function:

void ns3::UanMacCw::DoDispose ( void )

protectedvirtual

This method is called by Object::Dispose or by the object's destructor, whichever comes first.

Subclasses are expected to implement their real destruction code in an overriden version of this method and chain up to their parent's implementation once they are done. i.e., for simplicity, the destructor of every subclass should be empty and its content should be moved to the associated DoDispose method.

It is safe to call GetObject from within this method.

Reimplemented from ns3::Object.

Definition at line 70 of file uan-mac-cw.cc.

References Clear().

Here is the call graph for this function:

void ns3::UanMacCw::EndTx ( void )

private

Definition at line 298 of file uan-mac-cw.cc.

References CCABUSY, GetAddress(), IDLE, ns3::UanPhy::IsStateIdle(), m_phy, m_state, ns3::Simulator::Now(), NS_ASSERT, NS_FATAL_ERROR, NS_LOG_DEBUG, RUNNING, StartTimer(), and TX.

Referenced by NotifyTxStart().

Here is the call graph for this function:

Here is the caller graph for this function:

bool ns3::UanMacCw::Enqueue	(	Ptr< Packet >	pkt,
		const Address &	dest,
		uint16_t	protocolNumber
	)

virtual

Enqueue packet to be transmitted

Parameters

pkt	Packet to be transmitted
dest	Destination address
protocolNumber	Protocol #. Usage varies by MAC

Implements ns3::UanMac.

Definition at line 119 of file uan-mac-cw.cc.

References ns3::Packet::AddHeader(), CCABUSY, ns3::UanAddress::ConvertFrom(), GetAddress(), ns3::UanTransducer::GetArrivalList(), ns3::Time::GetSeconds(), ns3::Packet::GetSize(), ns3::UanPhy::GetTransducer(), ns3::UniformRandomVariable::GetValue(), IDLE, ns3::EventId::IsRunning(), ns3::UanPhy::IsStateBusy(), ns3::UanPhy::IsStateTx(), m_address, m_cw, m_enqueueLogger, m_phy, m_pktTx, m_pktTxProt, m_rv, m_savedDelayS, m_sendTime, m_slotTime, m_state, m_txEndEvent, ns3::Now(), ns3::Simulator::Now(), NS_ASSERT, NS_LOG_DEBUG, RUNNING, ns3::Seconds(), ns3::UanPhy::SendPacket(), ns3::UanHeaderCommon::SetDest(), ns3::UanHeaderCommon::SetSrc(), ns3::UanHeaderCommon::SetType(), and TX.

Here is the call graph for this function:

Address ns3::UanMacCw::GetAddress ( )

virtual

Returns: MAC Address

Implements ns3::UanMac.

Definition at line 107 of file uan-mac-cw.cc.

References m_address.

Referenced by EndTx(), Enqueue(), NotifyCcaEnd(), NotifyCcaStart(), NotifyRxEndError(), NotifyRxEndOk(), NotifyRxStart(), SaveTimer(), SendPacket(), and StartTimer().

Here is the caller graph for this function:

Address ns3::UanMacCw::GetBroadcast ( void ) const

virtual

Returns: Broadcast address

Implements ns3::UanMac.

Definition at line 202 of file uan-mac-cw.cc.

Referenced by PhyRxPacketGood().

Here is the caller graph for this function:

uint32_t ns3::UanMacCw::GetCw ( void )

virtual

Returns: Contention window size

Definition at line 330 of file uan-mac-cw.cc.

References m_cw.

Time ns3::UanMacCw::GetSlotTime ( void )

virtual

Returns: slot time duration

Definition at line 335 of file uan-mac-cw.cc.

References m_slotTime.

TypeId ns3::UanMacCw::GetTypeId ( void )

static

This method returns the TypeId associated to ns3::UanMacCw.

Attributes defined for this type:

CW: The MAC parameter CW
- Set with class: ns3::UintegerValue
- Underlying type: uint32_t 0:4294967295
- Initial value: 10
- Flags: construct write read
SlotTime: Time slot duration for MAC backoff
- Set with class: TimeValue
- Underlying type: Time
- Initial value: +20000000.0ns
- Flags: construct write read