RadioState.h

Go to the documentation of this file.

/* -*- mode:c++ -*- ********************************************************
 * file:        RadioState.h
 *
 * author:      Andreas Koepke
 *              modifications Andras Varga, 2006
 *
 * copyright:   (C) 2004 Telecommunication Networks Group (TKN) at
 *              Technische Universitaet Berlin, Germany.
 *
 *              This program is free software; you can redistribute it
 *              and/or modify it under the terms of the GNU General Public
 *              License as published by the Free Software Foundation; either
 *              version 2 of the License, or (at your option) any later
 *              version.
 *              For further information see file COPYING
 *              in the top level directory
 ***************************************************************************
 * part of:     framework implementation developed by tkn
 **************************************************************************/

#ifndef RADIOSTATE_H
#define RADIOSTATE_H

#include <omnetpp.h>
#include "INETDefs.h"

class INET_API RadioState : public cPolymorphic
{
  public:
    enum State
    {
      IDLE,
      RECV,
      TRANSMIT,
      SLEEP
    };

    //XXX consider adding the following:
    //Q: how to notify a TRANSMIT->RECV transition? as TRANSMIT_END, RECV_START, both, or some 3rd one?
    // enum Transition
    // {
    //   TRANSMIT_START, ///< start of a transmission (non-TRANSMIT to TRANSMIT)
    //   TRANSMIT_END,   ///< TRANSMIT to non-TRANSMIT (note: new state is in "state" field)
    //   RECV_START,     ///< IDLE to RECV
    //   RECV_END_OK,    ///< reception ends, frame received OK
    //   RECV_END_ERROR  ///< reception ends, received frame has bit errors
    // };

  private:
    int radioId; // identifies the radio
    State state; // IDLE, RECV, TRANSMIT, SLEEP
    int channelNumber; // the radio channel
    double bitrate; // the current transmit bitrate

  public:
    RadioState(int radioModuleId) : cPolymorphic() {
        radioId = radioModuleId; state = IDLE; channelNumber = -1; bitrate = -1;
    }

    int getRadioId() const { return radioId; }

    State getState() const { return state; }

    void setState(State s) { state = s; }

    int getChannelNumber() const { return channelNumber; }

    void setChannelNumber(int chan) { channelNumber = chan; }

    double getBitrate() const { return bitrate; }

    void setBitrate(double d) { bitrate = d; }

    static const char *stateName(State state) {
        switch(state) {
            case IDLE: return "IDLE";
            case RECV: return "RECV";
            case TRANSMIT: return "TRANSMIT";
            case SLEEP: return "SLEEP";
            default: return "???";
        }
    }

    std::string info() const {
        std::stringstream out;
        out << stateName(state) << ", channel #" << channelNumber << ", " << (bitrate/1e6) << "Mbps ";
        return out.str();
    }

};


inline std::ostream& operator<<(std::ostream& os, const RadioState& r)
{
    return os << r.info();
}

#endif