User Manual, Developers Guide and API Documentation

DSASlave.cpp

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/>.
 *
 ******************************************************************************/

#include <WNS/scheduler/strategy/dsastrategy/DSASlave.hpp>
#include <WNS/scheduler/strategy/dsastrategy/DSAStrategy.hpp>
#include <WNS/scheduler/strategy/dsastrategy/DSAStrategyInterface.hpp>
#include <WNS/scheduler/SchedulerTypes.hpp>
#include <vector>
#include <iostream>
#include <algorithm>

using namespace wns::scheduler;
using namespace wns::scheduler::strategy;
using namespace wns::scheduler::strategy::dsastrategy;

STATIC_FACTORY_REGISTER_WITH_CREATOR(DSASlave,
                                     DSAStrategyInterface,
                                     "DSASlave",
                                     wns::PyConfigViewCreator);

DSASlave::DSASlave(const wns::pyconfig::View& config)
    : DSAStrategy(config),
      lastUsedSubChannel(0),
      lastUsedTimeSlot(0),
      lastUsedBeam(0)
{
}

DSASlave::~DSASlave()
{
}

// call this before each timeSlot/frame
void
DSASlave::initialize(SchedulerStatePtr schedulerState,
                     SchedulingMapPtr schedulingMap)
{
    assure(schedulerState->schedulerSpot == wns::scheduler::SchedulerSpot::ULSlave(),
           "this DSASlave strategy can only be used as slave scheduler (RS-Tx, uplink)");
    DSAStrategy::initialize(schedulerState,schedulingMap); // must always initialize base class too
    lastUsedSubChannel = 0;
    lastUsedTimeSlot = 0;
    lastUsedBeam = 0;
    // schedulingMap is an inputSchedulingMap
}

DSAResult
DSASlave::getSubChannelWithDSA(RequestForResource& request,
                               SchedulerStatePtr schedulerState,
                               SchedulingMapPtr schedulingMap)
{
    DSAResult dsaResult;
    //simTimeType requestedCompoundDuration = getCompoundDuration(request);
    //MESSAGE_SINGLE(NORMAL, logger, "getSubChannelWithDSA("<<request.toString()<<"): d="<<requestedCompoundDuration<<"s");
    int subChannel = lastUsedSubChannel;
    int timeSlot = lastUsedTimeSlot;
    int spatialLayer = lastUsedBeam;
    int maxSubChannel = schedulerState->currentState->strategyInput->getFChannels();
    int numberOfTimeSlots = schedulerState->currentState->strategyInput->getNumberOfTimeSlots();
    int maxSpatialLayers = schedulerState->currentState->strategyInput->getMaxSpatialLayers();
    assure(subChannel<maxSubChannel,"invalid subChannel="<<subChannel);
    assure(timeSlot<numberOfTimeSlots,"invalid timeSlot="<<timeSlot);
    assure(spatialLayer<maxSpatialLayers,"invalid spatialLayer="<<spatialLayer);
    MESSAGE_SINGLE(NORMAL, logger, "getSubChannelWithDSA("<<request.toString()<<"): lastSC="<<lastUsedSubChannel);
    bool found  = false;
    bool giveUp = false;
    // TODO:
    while(!found && !giveUp) {
        if (channelIsUsable(subChannel, timeSlot, spatialLayer, request, schedulerState, schedulingMap))
        { // PDU fits in
            found=true; break;
        }
        if (++spatialLayer>=maxSpatialLayers)
        { // all spatialLayers full; take next timeSlot
            spatialLayer=0;
            if (++timeSlot>=numberOfTimeSlots)
            { // all timeSlots full; take next subChannel
                timeSlot=0;
                if (++subChannel>=maxSubChannel)
                { // wraparound
                    subChannel=0;
                }
            }
        }
        if (subChannel==lastUsedSubChannel && timeSlot == lastUsedTimeSlot && spatialLayer == lastUsedBeam)
        { // one complete round already done
            giveUp=true; break;
        }
    } // while
    if (giveUp) {
        MESSAGE_SINGLE(NORMAL, logger, "getSubChannelWithDSA(): no free subchannel");
        return dsaResult; // empty with subChannel=DSAsubChannelNotFound
    } else {
        MESSAGE_SINGLE(NORMAL, logger, "getSubChannelWithDSA(): subChannel="<<subChannel<<"."<<timeSlot<<"."<<spatialLayer);
        lastUsedSubChannel = subChannel;
        lastUsedTimeSlot = timeSlot;
        lastUsedBeam = spatialLayer;
        dsaResult.subChannel = subChannel;
        dsaResult.timeSlot = timeSlot;
        dsaResult.spatialLayer = spatialLayer;
        return dsaResult;
    }
} // getSubChannelWithDSA

---