User Manual, Developers Guide and API Documentation

PhyMode.hpp

Go to the documentation of this file.

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

// must be the first include!
#include <WNS/PowerRatio.hpp>
#include <WNS/pyconfig/View.hpp>
#include <WNS/logger/Logger.hpp>
#include <WNS/Ttos.hpp>
#include <WNS/simulator/Bit.hpp>

#include <WIMEMAC/FrameType.hpp>

#include <math.h>
#include <map>

namespace wimemac { namespace convergence {

    class PhyMode;

    class MCS {
        // PhyMode needs to access the nominator and denominator
        friend class PhyMode;
    public:
        MCS();
        MCS(const wns::pyconfig::View& config);
        MCS(const MCS& other);

        std::string getModulation() const
            { return this->modulation;};

        std::string getRate() const
            { return this->codingRate;};

        void
        setIndex(unsigned int index)
            { this->index = index;};
        unsigned int
        getIndex() const
            { return this->index;};

        float getDataRate();

        wns::Ratio getMinSINR() const
            { return this->minSINR;};

        wns::Power getMinRxPower() const
            { return this->minRX;};
        bool operator <(const MCS& rhs) const;
        bool operator ==(const MCS& rhs) const;
        bool operator !=(const MCS& rhs) const;

    private:
        void setModulation(const std::string& modulation);
        void setCodingRate(const std::string codingRate);

        std::string modulation;
        std::string codingRate;

        unsigned int nominator;
        unsigned int denominator;

        unsigned int nIBP6S;
        wns::simulator::Time SymbolDuration;

        unsigned int index;
        wns::Ratio minSINR;
        wns::Power minRX;
    };

    inline std::ostream& operator<< (std::ostream& s, const MCS& mcs)
    {
        return s << mcs.getModulation() << "-" << mcs.getRate();
    };

    class PhyMode {
    public:
        PhyMode();
        PhyMode(const wns::pyconfig::View& config);

        Bit getDataBitsPerSymbol() const;
        Bit getInfoBitsPer6Symbols() const;

        float getDataRate();

        unsigned int getNumberOfSpatialStreams() const
            { return this->numberOfSpatialStreams; };
        void setNumberOfSpatialStreams(unsigned int ss)
            { this->numberOfSpatialStreams = ss; };

        MCS getMCS() const
            { return this->mcs; };
        void setMCS(const MCS& other)
            { this->mcs = other; };

        wns::Ratio getMinSINR() const
            { return this->mcs.getMinSINR();};

        wns::Power getMinRxPower() const
            { return this->mcs.getMinRxPower();};

        unsigned int getNumberOfDataSubcarriers() const
            { return this->numberOfDataSubcarriers;};
        void setNumberOfDataSubcarriers(unsigned int ds)
            { this->numberOfDataSubcarriers = ds; };

        std::string getPreambleMode() const
            { return this->plcpMode;};
        void setPreambleMode(std::string pm)
            { this->plcpMode = pm;}

        wns::simulator::Time getGuardIntervalDuration() const
            { return this->guardIntervalDuration;};
        void setGuardIntervalDuration(wns::simulator::Time gi)
            { this->guardIntervalDuration = gi;};

        bool operator <(const PhyMode& rhs) const;
        bool operator ==(const PhyMode& rhs) const;
        bool operator !=(const PhyMode& rhs) const;

    private:
        MCS mcs;
        std::string codingRate;
        unsigned int numberOfSpatialStreams;
        unsigned int numberOfDataSubcarriers;
        std::string plcpMode;
        wns::simulator::Time guardIntervalDuration;
    };

    inline std::ostream& operator<< (std::ostream& s, const PhyMode& p)
    {
        return s << "(" << p.getMCS() << ")*"
                 << wns::Ttos(p.getNumberOfDataSubcarriers())
                 << "*" << wns::Ttos(p.getNumberOfSpatialStreams())
                 << " (-> " << wns::Ttos(p.getDataBitsPerSymbol()) << " dbps)";
    };
}}

#endif // WIMEMAC_CONVERGENCE_PHYMODE_HPP

---