User Manual, Developers Guide and API Documentation

PhysicalResource.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 _PHYSICALRESOURCE_HPP
#define _PHYSICALRESOURCE_HPP

#include <RISE/medium/PhysicalResourceObserver.hpp>
#include <RISE/transmissionobjects/transmissionobject.hpp>
#include <RISE/misc/pointer.hpp>
#include <RISE/misc/RISELogger.hpp>

#include <WNS/Functor.hpp>
#include <WNS/container/FastList.hpp>
#include <WNS/Interval.hpp>
#include <WNS/PowerRatio.hpp>

#ifndef WNS_USE_STLPORT
#include <ext/slist>
#else
#include <slist>
#endif

namespace rise {
    class PhysicalResourceObserver;
}

namespace rise { namespace medium {
    class PhysicalResource {
        friend class Gather80211StationData;
        // Medium manages PhysicalResources
        friend class Medium;

#ifndef WNS_USE_STLPORT
        typedef __gnu_cxx::slist<PhysicalResourceObserver*> ReceiverContainer;
#else
        typedef std::slist<PhysicalResourceObserver*> ReceiverContainer;
#endif

        typedef ReceiverContainer::const_iterator ReceiverIterator;

        typedef wns::container::FastList<TransmissionObjectPtr> TransmissionObjectContainer;

        typedef wns::Interval<double> Range;

    public:
        typedef wns::container::FastList<TransmissionObjectPtr>::iterator TransmissionObjectIterator;

        void startTransmission(TransmissionObjectPtr transmissionObject)
        {
            transmissionObject->setPhysicalResource(this);
            transmissionObject->setIsStart(true);
            notifyReceivers(transmissionObject);
            transmissionObjects.push_front(transmissionObject);
        };

        void stopTransmission(TransmissionObjectPtr transmissionObject)
        {
            transmissionObject->setIsStart(false);
            notifyReceivers(transmissionObject);
            transmissionObjects.remove(transmissionObject);
        };

        void attach(PhysicalResourceObserver *r);

        void detach(PhysicalResourceObserver *r);

        bool operator ==(const PhysicalResource &p) const
        {
            return (frequencyRange == p.frequencyRange);
        }

        bool operator !=(const PhysicalResource &p) const
        {
            return !(*this==p);
        }

        TransmissionObjectIterator getTOBegin() const
        {
            return transmissionObjects.begin();
        }

        TransmissionObjectIterator getTOEnd() const
        {
            return transmissionObjects.end();
        }

        bool contains(TransmissionObjectPtr t)
        {
            return transmissionObjects.contains(t);
        }

        double getFrequency() const
        {
            return frequency;
        }

        double getBandwidth() const
        {
            return bandwidth;
        }

        Range getFrequencyRange()
        {
            return frequencyRange;
        }

        void mobilityUpdate(Transmitter* transmitter)
        {
            MESSAGE_BEGIN(NORMAL, log, m, "Calling Mobility update for ");
            m << receivers.size() << " receivers on PhysicalResource";
            MESSAGE_END();
            std::for_each(
                receivers.begin(),
                receivers.end(),
                std::bind2nd(
                    std::mem_fun(
                        &PhysicalResourceObserver::mobilityUpdate),
                    transmitter));
        };

    private:
        PhysicalResource(double f, double b);

        virtual ~PhysicalResource();

        PhysicalResource();

        void notifyReceivers(const TransmissionObjectPtr& transmissionObject) const
        {
            MESSAGE_BEGIN(NORMAL, log, m, "NotifyReceivers (start=");
            m << transmissionObject->getIsStart()<< ")";
            MESSAGE_END();
            std::for_each(
                receivers.begin(),
                receivers.end(),
                std::bind2nd(
                    std::mem_fun(
                        &PhysicalResourceObserver::notify),
                    transmissionObject));
            // this calls Receiver::notify(TransmissionObjectPtr t)
            // in class Receiver derived from PhysicalResourceObserver
        };

        double frequency;

        double bandwidth;

        Range frequencyRange;

        ReceiverContainer receivers;

        TransmissionObjectContainer transmissionObjects;

        RISELogger log;

        PhysicalResource(const PhysicalResource&);

        PhysicalResource& operator=(const PhysicalResource&);

    };
}}
#endif

---