User Manual, Developers Guide and API Documentation

SCReceiver.hpp

Go to the documentation of this file.

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

#include <RISE/transceiver/transmitter.hpp>
#include <RISE/misc/pointer.hpp>
#include <RISE/transceiver/receiver.hpp>
#include <RISE/transmissionobjects/broadcasttransmissionobject.hpp>
#include <RISE/misc/RISELogger.hpp>
#include <RISE/receiver/LossCalculation.hpp>

#include <WNS/PowerRatio.hpp>
#include <WNS/DoubleDispatcher.hpp>
#include <WNS/TypeInfo.hpp>
#include <WNS/TimeWeightedAverage.hpp>
#include <WNS/Cache.hpp>
#include <WNS/pyconfig/View.hpp>

#include <sstream>
#include <list>

namespace rise
{
    class Transmitter;
    class Station;
    class Demodulator;
    class Decoder;
    class PropagationCache;
    class PropCacheEntry;
    class Scenario;

    class SCReceiver :
        public Receiver,
        protected receiver::LossCalculation
    {

    public:

        SCReceiver(const wns::pyconfig::View& config,
                   Station* s,
                   antenna::Antenna* a,
                   Demodulator *demodulator,
                   Decoder *decoder,
                   wns::Ratio rnf);

        virtual ~SCReceiver();
        virtual void startReceiving();


        virtual void stopReceiving();


        virtual void notify(TransmissionObjectPtr transmissionObject);

        //  Receiver is listening to.
        virtual wns::Power getTotalRxPower();

        virtual wns::Power getInterference(const TransmissionObjectPtr& t);

        virtual wns::Power getRxPower(const TransmissionObjectPtr& t);

        virtual wns::Power getNoise();

        virtual wns::Ratio getLoss(Transmitter* t);

        virtual void tune(double f, double b);

        virtual bool contains(TransmissionObjectPtr);

        virtual double getFrequency();
    };


    template<typename DerivedReceiver>
    class ReceiverWithDispatcher : public SCReceiver {
        typedef wns::DoubleDispatcher<DerivedReceiver, const TransmissionObjectPtr&> D;
    public:
        ReceiverWithDispatcher(const wns::pyconfig::View& config,
                               Station* s,
                               antenna::Antenna* a,
                               Demodulator *demodulator,
                               Decoder *decoder,
                               wns::Ratio rnf)
            : SCReceiver(config, s, a, demodulator, decoder, rnf)
            {
                if(!instantiated) {
                    DerivedReceiver::initDispatcher();
                    instantiated = true;
                }
            }
    protected:
        static D* getDispatcher() {
            static D d;
            return &d;
        }

        static bool instantiated;
    };
    template <typename DerivedReceiver> bool ReceiverWithDispatcher<DerivedReceiver>::instantiated = false;

}
#endif

---