User Manual, Developers Guide and API Documentation

transmitter.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 _TRANSMITTER_HPP
#define _TRANSMITTER_HPP

#include <RISE/misc/pointer.hpp>
#include <RISE/medium/PhysicalResource.hpp>
#include <RISE/scenario/Scenario.hpp>
#include <RISE/scenario/PropagationCharacteristic.hpp>
#include <RISE/transmissionobjects/transmissionobject.hpp>

#include <WNS/PositionObserver.hpp>
#include <WNS/container/FastListEnabler.hpp>
#include <WNS/logger/Logger.hpp>
#include <WNS/pyconfig/View.hpp>
#include <WNS/PowerRatio.hpp>
#include <WNS/Observer.hpp>

#include <sstream>

namespace rise { namespace antenna {
    class Antenna;
}}

namespace rise
{
    class TransmissionObject;
    class Station;

    class Transmitter :
        public wns::container::FastListEnabler<Transmitter*>,
        public wns::Observer<wns::PositionObserver>,
        public scenario::PropagationCharacteristic
    {
    public:
        Transmitter(const wns::pyconfig::View& config, Station* s, antenna::Antenna* a);

        virtual ~Transmitter();


        virtual void startTransmitting(TransmissionObjectPtr transmissionObject, long int Sub_band_Id);


        virtual void stopTransmitting(TransmissionObjectPtr transmissionObject);

        virtual long int getTransmitterId() const
        {
            return transmitterId;
        }
        virtual void tune(double f, double b, long int numberOfSubCarriers);
        virtual void positionChanged();

        virtual void positionWillChange();

        virtual wns::Power getTxPower() const
        {
            return txPwr;
        }
        virtual void setTxPower(wns::Power p)
        {
            txPwr = p;
        }
        virtual wns::Power getMaxTxPower() const
        {
            return maxTxPwr;
        }
        virtual void setMaxTxPower(wns::Power p) {
            maxTxPwr=p;
        }

        antenna::Antenna* getAntenna() const
        {
            return antenna;
        }

        virtual std::string getDebugInfo();

        virtual Station* getStation()=0; // pure virtual! Derive and implement!

    protected:
        wns::Power txPwr;
        long int transmitterId;
        wns::Power maxTxPwr;

        typedef std::vector<medium::PhysicalResource*> PhysicalResourceContainer;
        typedef PhysicalResourceContainer::iterator PhysicalResourceIterator;

        PhysicalResourceContainer prc;

        antenna::Antenna* antenna;

        double midFrequency;

        wns::logger::Logger log;

    private:

        static long int nextid;

        bool active;
    };
}

#endif

---