EMANE  1.2.1
EMANE::Models::Bypass::MACLayer Class Reference

Implementation of the bypass MAC layer. More...

#include <maclayer.h>

Inheritance diagram for EMANE::Models::Bypass::MACLayer:
EMANE::MACLayerImplementor EMANE::NEMLayer EMANE::RadioServiceUser EMANE::Component EMANE::UpstreamTransport EMANE::DownstreamTransport EMANE::PlatformServiceUser EMANE::Buildable EMANE::RunningStateMutable EMANE::EventServiceUser EMANE::TimerServiceUser

Public Member Functions

 MACLayer (NEMId id, PlatformServiceProvider *pPlatformService, RadioServiceProvider *pRadioServiceProvider)
 constructor More...
 
 ~MACLayer ()
 destructor More...
 
void initialize (EMANE::Registrar &registrar) override
 
void configure (const EMANE::ConfigurationUpdate &update) override
 
void start () override
 
void stop () override
 
void destroy () override throw ()
 
void processUpstreamControl (const EMANE::ControlMessages &msgs)
 
void processUpstreamPacket (const EMANE::CommonMACHeader &hdr, EMANE::UpstreamPacket &pkt, const EMANE::ControlMessages &msgs)
 
void processDownstreamControl (const EMANE::ControlMessages &msgs)
 
void processDownstreamPacket (EMANE::DownstreamPacket &pkt, const EMANE::ControlMessages &msgs)
 
void processEvent (const EMANE::EventId &id, const EMANE::Serialization &serialization)
 
void processTimedEvent (EMANE::TimerEventId eventId, const EMANE::TimePoint &timePoint, const void *arg)
 
void sendDownstreamPacket (const CommonMACHeader &hdr, DownstreamPacket &pkt, const ControlMessages &msgs=DownstreamTransport::empty)
 
NEMId getNEMId () const
 
virtual void postStart ()
 
virtual void setDownstreamTransport (DownstreamTransport *pDownstreamTransport)
 
void sendDownstreamControl (const ControlMessages &msgs)
 
virtual void setUpstreamTransport (UpstreamTransport *pUpstreamTransport)
 
void sendUpstreamPacket (UpstreamPacket &pkt, const ControlMessages &msgs=empty)
 
void sendUpstreamControl (const ControlMessages &msgs)
 
virtual void processTimedEvent (TimerEventId eventId, const TimePoint &expireTime, const TimePoint &scheduleTime, const TimePoint &fireTime, const void *arg)
 
BuildId getBuildId () const
 
void setBuildId (BuildId bid)
 
virtual void processConfiguration (const ConfigurationUpdate &update)
 

Static Public Attributes

static const ControlMessages empty
 
static const ControlMessages empty
 

Protected Attributes

NEMId id_
 
PlatformServiceProviderpPlatformService_
 
RadioServiceProviderpRadioService_
 

Detailed Description

Implementation of the bypass MAC layer.

Definition at line 52 of file models/mac/bypass/maclayer.h.

Constructor & Destructor Documentation

◆ MACLayer()

EMANE::Models::Bypass::MACLayer::MACLayer ( NEMId  id,
PlatformServiceProvider pPlatformService,
RadioServiceProvider pRadioServiceProvider 
)

constructor

Definition at line 43 of file models/mac/bypass/maclayer.cc.

◆ ~MACLayer()

EMANE::Models::Bypass::MACLayer::~MACLayer ( )

destructor

Definition at line 51 of file models/mac/bypass/maclayer.cc.

Member Function Documentation

◆ configure()

void EMANE::Models::Bypass::MACLayer::configure ( const EMANE::ConfigurationUpdate update)
overridevirtual

Configure the component.

Parameters
updateConfiguration update values
Exceptions
ConfigureExceptionthrown when a unexpected configuration item is encountered or there is a problem with the specified item value

Implements EMANE::Component.

Definition at line 150 of file models/mac/bypass/maclayer.cc.

◆ destroy()

void EMANE::Models::Bypass::MACLayer::destroy ( )
throw (
)
overridevirtual

Destroy the component.

Implements EMANE::Component.

Definition at line 182 of file models/mac/bypass/maclayer.cc.

◆ getBuildId()

EMANE::BuildId EMANE::Buildable::getBuildId ( ) const
inlineinherited

Gets the application wide unique BuildId of this object.

Returns
the BuildId

Definition at line 34 of file buildable.inl.

◆ getNEMId()

NEMId EMANE::NEMLayer::getNEMId ( ) const
inlineinherited

Get the NEM identifier.

Returns
NEM identifier

Definition at line 72 of file nemlayer.h.

◆ initialize()

void EMANE::Models::Bypass::MACLayer::initialize ( EMANE::Registrar registrar)
overridevirtual

Initialize the component.

Exceptions
InitializeExceptionthrown when an error is encountered during initialization

Implements EMANE::Component.

Definition at line 139 of file models/mac/bypass/maclayer.cc.

◆ postStart()

◆ processConfiguration()

virtual void EMANE::RunningStateMutable::processConfiguration ( const ConfigurationUpdate update)
inlinevirtualinherited

Process dynamic running-state configuration updates

Parameters
updateConfiguration update
Note
Running state configuration errors are indicated using a validator. Validators can be registered using the ConfigurationRegistrar.

Reimplemented in EMANE::Models::IEEE80211ABG::MACLayer, EMANE::Models::RFPipe::MACLayer, EMANE::Models::TDMA::BaseModel::Implementation, EMANE::Models::TDMA::BaseModel, EMANE::NEMStatefulLayer, EMANE::NEMQueuedLayer, and EMANE::FrameworkPHY.

Definition at line 63 of file runningstatemutable.h.

◆ processDownstreamControl()

void EMANE::Models::Bypass::MACLayer::processDownstreamControl ( const EMANE::ControlMessages msgs)
virtual

Process downstream control message

Parameters
msgsReference to the ControlMessages

Implements EMANE::DownstreamTransport.

Definition at line 63 of file models/mac/bypass/maclayer.cc.

◆ processDownstreamPacket()

void EMANE::Models::Bypass::MACLayer::processDownstreamPacket ( EMANE::DownstreamPacket pkt,
const EMANE::ControlMessages msgs 
)
virtual

Process downstream packet

Parameters
pktReference to the DownstreamPacket to process
msgsoptional reference to the ControlMessages

Implements EMANE::DownstreamTransport.

Definition at line 116 of file models/mac/bypass/maclayer.cc.

◆ processEvent()

void EMANE::Models::Bypass::MACLayer::processEvent ( const EMANE::EventId eventId,
const EMANE::Serialization serialization 
)
virtual

Process an event.

Parameters
eventIdevent identifier corresponding to the serialized event
serializationopaque event object data

Reimplemented from EMANE::EventServiceUser.

Definition at line 192 of file models/mac/bypass/maclayer.cc.

◆ processTimedEvent() [1/2]

virtual void EMANE::TimerServiceUser::processTimedEvent ( TimerEventId  eventId,
const TimePoint expireTime,
const TimePoint scheduleTime,
const TimePoint fireTime,
const void *  arg 
)
inlinevirtualinherited

Process a timed event

Parameters
eventIdIdentifier corresponding to the timer being processed
expireTimeThe time the timer was scheduled to expire
scheduleTimeThe Time the timer was scheduled
fireTimeTime time The time the timer actually fired
argOpaque timed event data
Note
All times are abosulte using CLOCK_REALTIME

Reimplemented in EMANE::NEMStatefulLayer, EMANE::Models::Bypass::PHYLayer, EMANE::NEMQueuedLayer, EMANE::Models::PHYAPITest::ShimLayer, EMANE::Models::CommEffect::Shim, EMANE::Agents::GPSDLocation::Agent, EMANE::TimerServiceProxy, and EMANE::NEMTimerServiceProxy.

Definition at line 62 of file timerserviceuser.h.

◆ processTimedEvent() [2/2]

void EMANE::Models::Bypass::MACLayer::processTimedEvent ( EMANE::TimerEventId  eventId,
const EMANE::TimePoint timePoint,
const void *  arg 
)

Definition at line 201 of file models/mac/bypass/maclayer.cc.

◆ processUpstreamControl()

void EMANE::Models::Bypass::MACLayer::processUpstreamControl ( const EMANE::ControlMessages msgs)
virtual

Process upstream control message

Parameters
msgsreference to the ControlMessages

Implements EMANE::UpstreamTransport.

Definition at line 54 of file models/mac/bypass/maclayer.cc.

◆ processUpstreamPacket()

void EMANE::Models::Bypass::MACLayer::processUpstreamPacket ( const EMANE::CommonMACHeader hdr,
EMANE::UpstreamPacket pkt,
const EMANE::ControlMessages msgs 
)
virtual

Process an upstream packet

Parameters
hdrMAC message header
pktUpstream packet reference
msgsOptional control messages
Note
Control message ownership is transferred with this call. Control messages should not be accessed after this point.

Implements EMANE::MACLayerImplementor.

Definition at line 73 of file models/mac/bypass/maclayer.cc.

◆ sendDownstreamControl()

void EMANE::UpstreamTransport::sendDownstreamControl ( const ControlMessages msgs)
inlineinherited

Send downstream control message

Parameters
msgsreference to the ControlMessages

Definition at line 44 of file upstreamtransport.inl.

◆ sendDownstreamPacket()

void EMANE::MACLayerImplementor::sendDownstreamPacket ( const CommonMACHeader hdr,
DownstreamPacket pkt,
const ControlMessages msgs = DownstreamTransport::empty 
)
inlineinherited

Sends a downstream packet

Parameters
hdrMAC message header
pktDownstream packet reference
msgsOptional control messages
Note
Control message ownership is transferred with this call. Control messages should not be accessed after this point.

Definition at line 37 of file maclayerimpl.inl.

◆ sendUpstreamControl()

void EMANE::DownstreamTransport::sendUpstreamControl ( const ControlMessages msgs)
inlineinherited

Send upstream control message

Parameters
msgsReference to the ControlMessages

Definition at line 44 of file downstreamtransport.inl.

◆ sendUpstreamPacket()

void EMANE::DownstreamTransport::sendUpstreamPacket ( UpstreamPacket pkt,
const ControlMessages msgs = empty 
)
inlineinherited

Send upstream packet

Parameters
pktReference to the UpstreamPacket to process
msgsoptional reference to the ControlMessages

Definition at line 37 of file downstreamtransport.inl.

◆ setBuildId()

void EMANE::Buildable::setBuildId ( BuildId  bid)
inlineinherited

Sets the application wide unique BuildId of this object. Builders assign a BuildId to objects at instantiation.

Parameters
bidthe BuildId
Note
: This method is for internal framework use only.

Definition at line 40 of file buildable.inl.

◆ setDownstreamTransport()

virtual void EMANE::UpstreamTransport::setDownstreamTransport ( DownstreamTransport pDownstreamTransport)
inlinevirtualinherited

Set the downstream transport.

Parameters
pDownstreamTransportPointer to the downstream transport of this upstream transport.
Note
: This method is for internal framework use only.

Reimplemented in EMANE::NEMStatefulLayer, EMANE::PHYLayer, EMANE::MACLayer, EMANE::ShimLayer, and EMANE::TransportLayer.

Definition at line 82 of file upstreamtransport.h.

◆ setUpstreamTransport()

virtual void EMANE::DownstreamTransport::setUpstreamTransport ( UpstreamTransport pUpstreamTransport)
inlinevirtualinherited

Set the upstream transport.

Parameters
pUpstreamTransportPointer to the upstream transport of this downstream transport.

Reimplemented in EMANE::NEMStatefulLayer, EMANE::MACLayer, EMANE::ShimLayer, EMANE::PHYLayer, and EMANE::TransportLayer.

Definition at line 79 of file downstreamtransport.h.

◆ start()

void EMANE::Models::Bypass::MACLayer::start ( )
overridevirtual

Start the component.

Exceptions
StartExceptionthrown when an error is encountered during start.

Implements EMANE::Component.

Definition at line 164 of file models/mac/bypass/maclayer.cc.

◆ stop()

void EMANE::Models::Bypass::MACLayer::stop ( )
overridevirtual

Stop the component.

Exceptions
StopExceptionthrown when an error is encountered during stop

Implements EMANE::Component.

Definition at line 173 of file models/mac/bypass/maclayer.cc.

Member Data Documentation

◆ empty [1/2]

const EMANE::ControlMessages EMANE::DownstreamTransport::empty
staticinherited

Definition at line 102 of file downstreamtransport.h.

◆ empty [2/2]

const EMANE::ControlMessages EMANE::UpstreamTransport::empty
staticinherited

Definition at line 106 of file upstreamtransport.h.

◆ id_

NEMId EMANE::NEMLayer::id_
protectedinherited

Definition at line 81 of file nemlayer.h.

◆ pPlatformService_

PlatformServiceProvider* EMANE::PlatformServiceUser::pPlatformService_
protectedinherited

Definition at line 64 of file platformserviceuser.h.

◆ pRadioService_

RadioServiceProvider* EMANE::RadioServiceUser::pRadioService_
protectedinherited

Definition at line 57 of file radioserviceuser.h.


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