User Manual, Developers Guide and API Documentation

Strategy.hpp

Go to the documentation of this file.

/*******************************************************************************
 * This file is part of openWNS (open Wireless Network Simulator)
 * _____________________________________________________________________________
 *
 * Copyright (C) 2004-2009
 * 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 WNS_SCHEDULER_STRATEGY_STRATEGY_HPP
#define WNS_SCHEDULER_STRATEGY_STRATEGY_HPP

#include <WNS/scheduler/strategy/StrategyInterface.hpp>
#include <WNS/scheduler/strategy/SchedulerState.hpp>
#include <WNS/scheduler/SchedulerTypes.hpp>
#include <WNS/scheduler/queue/QueueInterface.hpp>
#include <WNS/scheduler/grouper/SpatialGrouper.hpp>
#include <WNS/scheduler/strategy/apcstrategy/APCStrategyInterface.hpp>
#include <WNS/scheduler/strategy/dsastrategy/DSAStrategyInterface.hpp>
#include <WNS/service/phy/phymode/PhyModeInterface.hpp>
#include <WNS/logger/Logger.hpp>

namespace wns { namespace scheduler { namespace harq { class HARQInterface; }}}

namespace wns { namespace scheduler { namespace strategy {

            const simTimeType slotLengthRoundingTolerance = 1e-12;

            class CapabilityAspect
            {
            public:
                virtual ~CapabilityAspect(){};
                virtual bool canHandleDL() { return false; };
                virtual bool canHandleUL() { return false; };
                virtual bool canBeSlave()  { return false; };
            };

            class DLAspect
                    : virtual public CapabilityAspect
            {
            public:
                DLAspect(){};
                virtual ~DLAspect(){};
                virtual bool canHandleDL() { return true; };
            };

            class ULAspect
                    : virtual public CapabilityAspect
            {
            public:
                ULAspect(){};
                virtual ~ULAspect(){};
                virtual bool canHandleUL() { return true; };
            };

            class SlaveAspect
                    : virtual public CapabilityAspect
            {
            public:
                SlaveAspect(){};
                virtual ~SlaveAspect(){};
                virtual bool canBeSlave()  { return true; };
            };

            class Strategy
                    : virtual public StrategyInterface,
                      virtual public CapabilityAspect
            {
            public:
                Strategy(const wns::pyconfig::View& config);
                virtual ~Strategy();
                virtual void setColleagues(queue::QueueInterface* _queue,
                                           grouper::GroupingProviderInterface* _grouper,
                                           RegistryProxyInterface* _registry,
                                           wns::scheduler::harq::HARQInterface* _harq
                    );

                virtual void onColleaguesKnown();

                virtual void setFriends(wns::service::phy::ofdma::BFInterface* _ofdmaProvider);

                wns::scheduler::PowerCapabilities
                getPowerCapabilities(const UserID user) const;

                virtual float getResourceUsage() const;

                virtual MapInfoEntryPtr
                doAdaptiveResourceScheduling(wns::scheduler::strategy::RequestForResource& request,
                                             //wns::scheduler::SchedulerStatePtr schedulerState,
                                             wns::scheduler::SchedulingMapPtr schedulingMap);

                virtual wns::scheduler::SchedulerSpotType
                getSchedulerSpotType() const;

                virtual bool isTx() const;

                virtual bool isNewStrategy() const { return false; }

                MapInfoCollectionPtr getMapInfo() const;

                virtual dsastrategy::DSAStrategyInterface*
                getDSAStrategy(){return colleagues.dsafbstrategy;};

            protected:

                virtual SchedulerStatePtr
                getNewSchedulerState();
                virtual SchedulerStatePtr
                revolveSchedulerState(const StrategyInput& strategyInput);
                virtual SchedulerStatePtr
                getSchedulerState();

                virtual StrategyResult
                startScheduling(const StrategyInput& StrategyInput);

                virtual wns::service::phy::phymode::PhyModeInterfacePtr
                getBestPhyMode(const wns::Ratio& sinr) const;

                virtual bool groupingRequired() const;

                struct Colleagues {
                    Colleagues() {queue=NULL;grouper=NULL;registry=NULL;dsastrategy=NULL;dsafbstrategy=NULL;apcstrategy=NULL;harq=NULL;};
                    queue::QueueInterface* queue;
                    grouper::GroupingProviderInterface* grouper;
                    RegistryProxyInterface* registry;
                    wns::scheduler::harq::HARQInterface* harq;
                    dsastrategy::DSAStrategyInterface* dsastrategy;
                    dsastrategy::DSAStrategyInterface* dsafbstrategy;
                    apcstrategy::APCStrategyInterface* apcstrategy;
                } colleagues;

                struct Friends {
                    Friends() {ofdmaProvider=NULL;};
                    wns::service::phy::ofdma::BFInterface* ofdmaProvider;
                } friends;

                wns::pyconfig::View pyConfig;
                wns::logger::Logger logger;

            protected:
                wns::Power getTxPower() const;

            private:
                SchedulerStatePtr schedulerState;
            }; // class Strategy
        }}} // namespace wns::scheduler::strategy
#endif // WNS_SCHEDULER_STRATEGY_STRATEGY_HPP

---