User Manual, Developers Guide and API Documentation

BeaconLinkQualityMeasurement.hpp

Go to the documentation of this file.

/******************************************************************************
 * WiFiMac                                                                    *
 * This file is part of openWNS (open Wireless Network Simulator)
 * _____________________________________________________________________________
 *
 * Copyright (C) 2004-2007
 * Chair of Communication Networks (ComNets)
 * Kopernikusstr. 16, D-52074 Aachen, Germany
 * phone: ++49-241-80-27910,
 * fax: ++49-241-80-22242
 * email: info@openwns.org
 * www: http://www.openwns.org
 * _____________________________________________________________________________
 *
 * openWNS is free software; you can redistribute it and/or modify it under the
 * terms of the GNU Lesser General Public License version 2 as published by the
 * Free Software Foundation;
 *
 * openWNS is distributed in the hope that it will be useful, but WITHOUT ANY
 * WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR
 * A PARTICULAR PURPOSE.  See the GNU Lesser General Public License for more
 * details.
 *
 * You should have received a copy of the GNU Lesser General Public License
 * along with this program.  If not, see <http://www.gnu.org/licenses/>.
 *
 ******************************************************************************/

#ifndef WIFIMAC_PATHSELECTION_BEACONLINKQUALITYMEASUREMENT_HPP
#define WIFIMAC_PATHSELECTION_BEACONLINKQUALITYMEASUREMENT_HPP

#include <WIFIMAC/lowerMAC/Manager.hpp>
#include <WIFIMAC/pathselection/Metric.hpp>
#include <WIFIMAC/pathselection/IPathSelection.hpp>
#include <WIFIMAC/management/Beacon.hpp>
#include <WIFIMAC/management/SINRInformationBase.hpp>

#include <WNS/ldk/Command.hpp>
#include <WNS/ldk/fu/Plain.hpp>
#include <WNS/ldk/probe/Probe.hpp>
#include <WNS/probe/bus/ContextCollector.hpp>

#include <WNS/events/PeriodicTimeout.hpp>
#include <WNS/events/CanTimeout.hpp>
#include <WNS/logger/Logger.hpp>
#include <WNS/Observer.hpp>
#include <WNS/distribution/Uniform.hpp>
#include <WNS/SlidingWindow.hpp>

namespace wifimac { namespace pathselection {

    typedef wns::container::Registry<wns::service::dll::UnicastAddress, double> Address2SuccessRateMap;
    typedef wns::container::Registry<wns::service::dll::UnicastAddress, wns::Ratio> Address2RatioMap;

    class BeaconLinkQualityMeasurementCommand :
        public wns::ldk::Command
    {
    public:
        struct { } local;

        struct {
            wns::simulator::Time interval;

            Address2SuccessRateMap rxBeaconSuccessRates;

            Address2RatioMap rxBeaconSINRs;
        } peer;

        struct { } magic;
    };

    class BeaconLinkQualityMeasurement;

    class BroadcastLinkQuality:
        public wns::events::CanTimeout
    {
    public:
        BroadcastLinkQuality(const wns::pyconfig::View& config_,
                             BeaconLinkQualityMeasurement* parent_,
                             wns::service::dll::UnicastAddress peerAddress_,
                             wns::service::dll::UnicastAddress myAddress_,
                             wns::simulator::Time interval_);
        double
        getSuccessRate();

        wns::Ratio
        getAverageSINR();

        void
        newBeacon(wns::simulator::Time interval);

        Metric
        newPeerMeasurement(double peerSuccessRate, wns::Ratio peerSINR);

        void
        deadPeerMeasurement();

        bool
        isActive() const;

    private:
        void
        onTimeout();

        double
        getBestRate(wns::Ratio sinr);

        const wns::pyconfig::View config;

        BeaconLinkQualityMeasurement* parent;

        const wns::service::dll::UnicastAddress peerAddress;

        wns::service::dll::UnicastAddress myAddress;

        wns::simulator::Time curInterval;

        wns::SlidingWindow successRate;

        int missedBeaconsInRow;

        bool linkCreated;

        IPathSelection* ps;

        wifimac::management::SINRInformationBase* sinrMIB;

        const Bit meanFrameSize;
        const wns::simulator::Time maximumACKDuration;
        const wns::simulator::Time slotDuration;
        const wns::simulator::Time sifsDuration;
        const wns::simulator::Time preambleDuration;
        const double scalingFactor;
        const int maxMissedBeacons;
    };

    class BeaconLinkQualityMeasurement :
        public wns::ldk::fu::Plain<BeaconLinkQualityMeasurement, BeaconLinkQualityMeasurementCommand>,
        public wns::ldk::probe::Probe
    {
    public:
        BeaconLinkQualityMeasurement(wns::ldk::fun::FUN* fun, const wns::pyconfig::View& config);

        virtual 
        ~BeaconLinkQualityMeasurement();

        void newLinkCost(wns::service::dll::UnicastAddress rx, Metric cost);

        wns::logger::Logger logger;

    private:
        virtual bool doIsAccepting(const wns::ldk::CompoundPtr& _compound) const;

        virtual void doSendData(const wns::ldk::CompoundPtr& _compound);

        virtual void doWakeup();

        virtual void doOnData(const wns::ldk::CompoundPtr& _compound);

        virtual void onFUNCreated();

        void calculateSizes(const wns::ldk::CommandPool* commandPool, Bit& commandPoolSize, Bit& dataSize) const;

        const wns::pyconfig::View config;

        wns::simulator::Time beaconInterval;

        IPathSelection* ps;

        typedef wns::container::Registry<wns::service::dll::UnicastAddress, BroadcastLinkQuality*> adr2qualityMap;

        adr2qualityMap linkQualities;

        wns::service::dll::UnicastAddress myMACAddress;

        const std::string phyUserCommandName;

        wns::probe::bus::ContextCollectorPtr receivedPower;

        wns::probe::bus::ContextCollectorPtr peerMeasurement;

        wns::probe::bus::ContextCollectorPtr linkCost;

        struct Friends
        {
            wifimac::lowerMAC::Manager* manager;
        } friends;
    };

}}

#endif

---