wifimac::management::SINRInformationBase Class Reference

Storage and retrieval of SINR measurements. More...

#include <management/SINRInformationBase.hpp>

Inheritance diagram for wifimac::management::SINRInformationBase:

[legend]

Collaboration diagram for wifimac::management::SINRInformationBase:

[legend]

List of all members.

Public Member Functions
wns::Ratio	getMeasuredSINR (const wns::service::dll::UnicastAddress tx)
	Returns the averaged SINR of the link tx -> me.
wns::Ratio	getPeerSINR (const wns::service::dll::UnicastAddress peer)
	Get the averaged SINR of link me -> peer.
bool	knowsMeasuredSINR (const wns::service::dll::UnicastAddress tx)
	Ask if SINR value of link tx -> me is known.
bool	knowsPeerSINR (const wns::service::dll::UnicastAddress peer)
	Query if SINR of link me -> peer is known.
void	putFakePeerSINR (const wns::service::dll::UnicastAddress peer, const wns::Ratio sinr)
void	putMeasurement (const wns::service::dll::UnicastAddress tx, const wns::Ratio sinr, const wns::simulator::Time estimatedValidity=0.0)
	Store SINR value measured here (link tx -> me).
void	putPeerSINR (const wns::service::dll::UnicastAddress peer, const wns::Ratio sinr, const wns::simulator::Time estimatedValidity=0.0)
	Store received SINR measurement of link me -> peer.
	SINRInformationBase (wns::ldk::ManagementServiceRegistry *, const wns::pyconfig::View &config)
	Constructor.
virtual	~SINRInformationBase ()
	Destructor.
Private Types
typedef wns::container::Registry < wns::service::dll::UnicastAddress, wns::Ratio * >	ratioMap
	SINR information holder type: Maps peer address to SINR.
typedef std::pair< wns::Ratio, wns::simulator::Time >	ratioTimePair
typedef wns::container::Registry < wns::service::dll::UnicastAddress, ratioTimePair * >	ratioWithTimeMap
typedef wns::container::Registry < wns::service::dll::UnicastAddress, wns::SlidingWindow *, wns::container::registry::DeleteOnErase >	slidingWindowMap
	Measurement holder type: Maps address to sliding window.
Private Member Functions
void	onMSRCreated ()
	Initialization.
Private Attributes
ratioWithTimeMap	fakePeerMeasurement
	Holds fake peer measurements.
ratioWithTimeMap	lastMeasurement
	Holds the last SINR measurement.
ratioWithTimeMap	lastPeerMeasurement
	Holds the last received peer SINR measurement.
wns::logger::Logger	logger
	The logger.
slidingWindowMap	measuredSINRHolder
	Holds SINR values measured here.
ratioMap	peerSINRHolder
	Holds SINR values received by peers.
const simTimeType	windowSize
	Duration of the sliding window for averaging the SINR values.

---

Detailed Description

This information base provides a central point in a node to store and access SINR measurements. Two kind of measurements must be differentiated:

1. Direct measurements at the node (done e.g. by the PHY layer by comparing known symbols with received symbols). Methods to store an to access these measurements are
   • putMeasurement()
   • knowsMeasuredSINR()
   • getAverageMeasuredSINR() As indicated by the last function, the SINR information base performs an averaging of the stored SINR values.
2. Measurements done at a peer node and transmitted as management information to this node. Methods for this are
   • putPeerSINR()
   • knowsPeerSINR()
   • getAveragePeerSINR() Averaging of the peer SINR values is not performed at the node, but at the peer node.

Definition at line 68 of file SINRInformationBase.hpp.

---

Member Typedef Documentation

typedef wns::container::Registry<wns::service::dll::UnicastAddress, wns::Ratio*> wifimac::management::SINRInformationBase::ratioMap [private]

Definition at line 137 of file SINRInformationBase.hpp.

typedef std::pair<wns::Ratio, wns::simulator::Time> wifimac::management::SINRInformationBase::ratioTimePair [private]

Definition at line 142 of file SINRInformationBase.hpp.

typedef wns::container::Registry<wns::service::dll::UnicastAddress, ratioTimePair*> wifimac::management::SINRInformationBase::ratioWithTimeMap [private]

Definition at line 143 of file SINRInformationBase.hpp.

typedef wns::container::Registry<wns::service::dll::UnicastAddress, wns::SlidingWindow*, wns::container::registry::DeleteOnErase> wifimac::management::SINRInformationBase::slidingWindowMap [private]

Definition at line 131 of file SINRInformationBase.hpp.

---

Constructor & Destructor Documentation

SINRInformationBase::SINRInformationBase	(	wns::ldk::ManagementServiceRegistry *	msr,
		const wns::pyconfig::View &	config
	)

Definition at line 39 of file SINRInformationBase.cpp.

virtual wifimac::management::SINRInformationBase::~SINRInformationBase

(

)

[inline, virtual]

Definition at line 76 of file SINRInformationBase.hpp.

---

Member Function Documentation

wns::Ratio SINRInformationBase::getMeasuredSINR

(

const wns::service::dll::UnicastAddress

tx

)

Definition at line 99 of file SINRInformationBase.cpp.

wns::Ratio SINRInformationBase::getPeerSINR

(

const wns::service::dll::UnicastAddress

peer

)

Definition at line 159 of file SINRInformationBase.cpp.

bool SINRInformationBase::knowsMeasuredSINR

(

const wns::service::dll::UnicastAddress

tx

)

Definition at line 78 of file SINRInformationBase.cpp.

bool SINRInformationBase::knowsPeerSINR

(

const wns::service::dll::UnicastAddress

peer

)

Definition at line 139 of file SINRInformationBase.cpp.

void SINRInformationBase::onMSRCreated

(

)

[private, virtual]

Reimplemented from wns::ldk::ManagementService.

Reimplemented in wifimac::draftn::SINRwithMIMOInformationBase.

Definition at line 48 of file SINRInformationBase.cpp.

void SINRInformationBase::putFakePeerSINR	(	const wns::service::dll::UnicastAddress	peer,
		const wns::Ratio	sinr
	)

Definition at line 179 of file SINRInformationBase.cpp.

void SINRInformationBase::putMeasurement	(	const wns::service::dll::UnicastAddress	tx,
		const wns::Ratio	sinr,
		const wns::simulator::Time	estimatedValidity = 0.0
	)

The estimatedValidity parameter gives the duration for which this specific value is accurate. If during this time a getSINR is issued, exactly this value will be taken; otherwise, the averaged value is returned.

Definition at line 54 of file SINRInformationBase.cpp.

void SINRInformationBase::putPeerSINR	(	const wns::service::dll::UnicastAddress	peer,
		const wns::Ratio	sinr,
		const wns::simulator::Time	estimatedValidity = 0.0
	)

This link measurement must have been transported to me by regular management data exchange.

Definition at line 112 of file SINRInformationBase.cpp.

---

Member Data Documentation

ratioWithTimeMap wifimac::management::SINRInformationBase::fakePeerMeasurement [private]

Definition at line 152 of file SINRInformationBase.hpp.

ratioWithTimeMap wifimac::management::SINRInformationBase::lastMeasurement [private]

Definition at line 146 of file SINRInformationBase.hpp.

ratioWithTimeMap wifimac::management::SINRInformationBase::lastPeerMeasurement [private]

Definition at line 149 of file SINRInformationBase.hpp.

wns::logger::Logger wifimac::management::SINRInformationBase::logger [private]

Reimplemented in wifimac::draftn::SINRwithMIMOInformationBase.

Definition at line 155 of file SINRInformationBase.hpp.

slidingWindowMap wifimac::management::SINRInformationBase::measuredSINRHolder [private]

Definition at line 134 of file SINRInformationBase.hpp.

ratioMap wifimac::management::SINRInformationBase::peerSINRHolder [private]

Definition at line 140 of file SINRInformationBase.hpp.

const simTimeType wifimac::management::SINRInformationBase::windowSize [private]

Definition at line 158 of file SINRInformationBase.hpp.

---

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

• modules/dll/wifimac/src/management/SINRInformationBase.hpp
• modules/dll/wifimac/src/management/SINRInformationBase.cpp