User Manual, Developers Guide and API Documentation

BeaconEvaluator.hpp

Go to the documentation of this file.

/******************************************************************************
 * WiMeMac                                                                    *
 * This file is part of openWNS (open Wireless Network Simulator)
 * _____________________________________________________________________________
 *
 * Copyright (C) 2004-2011
 * Chair of Communication Networks (ComNets)
 * Kopernikusstr. 5, 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 WIMEMAC_MANAGEMENT_BEACONEVALUATOR_H
#define WIMEMAC_MANAGEMENT_BEACONEVALUATOR_H

#include <WNS/service/dll/Address.hpp>
#include <WNS/container/Registry.hpp>
#include <WIMEMAC/management/BeaconCommand.hpp>
#include <WIMEMAC/drp/DRPmap.hpp>
#include <WIMEMAC/drp/DRPManager.hpp>
#include <WNS/logger/Logger.hpp>

#include <WIMEMAC/helper/IDRPQueueInterface.hpp>
#include <vector>

namespace wimemac { namespace drp {
    class DRPManager;
}}

namespace wimemac { namespace lowerMAC {
        class Manager;
}}

namespace wimemac { namespace management {
typedef std::vector<bool> Vector;

    class BeaconEvaluator
        {
        public:
            BeaconEvaluator();
            void BeaconExamination(wns::service::dll::UnicastAddress tx, wns::service::dll::UnicastAddress iam, BeaconCommand* BeaconCommand,
            wns::logger::Logger _logger);

            void setFriend(helper::IDRPQueueInterface* QueueInterface);

            void setManagerFriend(wimemac::lowerMAC::Manager* manager_);

            int CollectDRPmaps(wns::simulator::Time BPDuration);

            void CreateDRPMaps();
            void EvaluateConnection();

            void CreateDRPManager(wns::service::dll::UnicastAddress rx, int CompoundspSF, int BitspSF, int MaxCompoundSize, wimemac::convergence::PhyMode DefPhyMode);
            void UpdateDRPManager(wns::service::dll::UnicastAddress rx, int CompoundspSF, int BitspSF, int MaxCompoundSize);

            bool CreateDRPIE(BeaconCommand* BeaconCommand);
            bool CreateBPOIE(BeaconCommand* BeaconCommand);
            bool CreateProbeIE(BeaconCommand* BeaconCommand);

            void RequestIE(wns::service::dll::UnicastAddress rx, BeaconCommand::ProbeElementID elementID);

            void UpdateGlobalHardDRPMap(Vector SoftDRPMap);
            void UpdateGlobalSoftDRPMap(Vector HardDRPMap);
            void UpdateGlobalDRPMap(Vector DRPMap);
            void SetLogger(wns::logger::Logger _logger);

            bool UpdateMapWithPeerAvailabilityMap(wns::service::dll::UnicastAddress rx , Vector& DRPMap);

            wimemac::convergence::PhyMode
            getPhyMode(wns::service::dll::UnicastAddress rx, int masNumber);

            void SetBPDuration(wns::simulator::Time duration);
            void evaluatePERforConnections();
            Vector getReservedMASs();



        protected:
            drp::DRPmap* DRPmapManager;
            wns::simulator::Time BPDuration;
            int NumberOfBPSlots;

            struct Probes
            {
                int drpAvailability;
            } requestedProbes;

            Vector getAllocatedMASs();
            
            wns::simulator::Time BPStartTime;

        private:
          
          int calp;
            typedef wns::container::Registry<wns::service::dll::UnicastAddress, drp::DRPManager*> ContainerType;
            ContainerType DRPIncomingConnections;
            ContainerType DRPOutgoingConnections;
            ContainerType::const_iterator it;

            drp::DRPManager* DRPmanager;
            Vector tmpAllocatedMAS; // For allocated MAS probe in beaconbuilder destructor
            
            
            int getBeaconSlot();
            
            void ExamineBeaconPeriodOccupancy(wns::service::dll::UnicastAddress tx, BeaconCommand* BeaconCommand);
            void InsertInNeighoursBPoccupancy(wns::service::dll::UnicastAddress tx, BeaconCommand* BeaconCommand);
            
            std::vector<wns::service::dll::UnicastAddress> BPoccupancy;
            
            struct BPallocation
            {
              BPallocation():
              source(wns::service::dll::UnicastAddress::UnicastAddress())
              {}
              
              wns::service::dll::UnicastAddress source;
              std::vector<wns::service::dll::UnicastAddress> BPoccupancy;
            };
            
            std::vector<BPallocation> NeighboursBPoccupancy;

            wns::container::Registry<wns::service::dll::UnicastAddress, Vector> rxAvailabilityBitmap;
            bool hasPendingProbe;
            bool FirstEval;
            wns::container::Registry<wns::service::dll::UnicastAddress, std::queue<BeaconCommand::ProbeElementID> > pendingProbe;
            wns::logger::Logger logger;
            helper::IDRPQueueInterface* queueInterface;

            struct Friends
            {
                helper::IDRPQueueInterface* QueueInterface;
                wimemac::lowerMAC::Manager* manager;
            } friends;

        };
}//management
}//wimemac
#endif

---