tlm_phase.h

Go to the documentation of this file.

/*****************************************************************************

  Licensed to Accellera Systems Initiative Inc. (Accellera) under one or
  more contributor license agreements.  See the NOTICE file distributed
  with this work for additional information regarding copyright ownership.
  Accellera licenses this file to you under the Apache License, Version 2.0
  (the "License"); you may not use this file except in compliance with the
  License.  You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

  Unless required by applicable law or agreed to in writing, software
  distributed under the License is distributed on an "AS IS" BASIS,
  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
  implied.  See the License for the specific language governing
  permissions and limitations under the License.

 *****************************************************************************/

#ifndef TLM_CORE_TLM2_TLM_PHASE_H_INCLUDED_
#define TLM_CORE_TLM2_TLM_PHASE_H_INCLUDED_

#include <string>
#include <iostream>
#include <typeinfo>
#include <vector>

#include "sysc/kernel/sc_cmnhdr.h" // SC_API
#include "sysc/kernel/sc_macros.h" // SC_CONCAT_HELPER_, SC_STRINGIFY_HELPER_

namespace tlm {

enum SC_API tlm_phase_enum
{
  UNINITIALIZED_PHASE=0,
  BEGIN_REQ=1,
  END_REQ,
  BEGIN_RESP,
  END_RESP
};

class SC_API tlm_phase
{
public:
  tlm_phase();
  tlm_phase(unsigned int id); // TODO: should be dropped

  tlm_phase(tlm_phase_enum standard);
  tlm_phase& operator=(tlm_phase_enum standard);

  operator unsigned int() const { return m_id; }
  const char* get_name() const;

protected:
  // register extended phase
  tlm_phase( const std::type_info & type, const char* name );

private:
  unsigned int m_id;
};

inline
tlm_phase::tlm_phase()
  : m_id( UNINITIALIZED_PHASE )
{}

inline
tlm_phase::tlm_phase( tlm_phase_enum standard )
  : m_id( standard )
{}

inline
tlm_phase& tlm_phase::operator=( tlm_phase_enum standard )
{
  m_id = standard;
  return *this;
}

inline
std::ostream& operator<<(std::ostream& s, const tlm_phase& p)
{
  s << p.get_name();
  return s;
}

#define TLM_DECLARE_EXTENDED_PHASE(name_arg) \
  static class SC_CONCAT_HELPER_(tlm_phase_, name_arg) \
    : public ::tlm::tlm_phase \
  { \
    typedef SC_CONCAT_HELPER_(tlm_phase_, name_arg) this_type; \
  public: \
    SC_CONCAT_HELPER_(tlm_phase_, name_arg)() /* register extended phase */ \
      : ::tlm::tlm_phase( typeid(*this), SC_STRINGIFY_HELPER_(name_arg) ) \
    {} \
    \
    static const this_type& get_phase() /* needed only for IEEE 1666-2011 */ \
      { static this_type this_; return this_; } \
  } \
  const name_arg

// for backwards-compatibility
#define DECLARE_EXTENDED_PHASE( NameArg ) \
    TLM_DECLARE_EXTENDED_PHASE( NameArg )

} // namespace tlm

#endif /* TLM_CORE_TLM2_TLM_PHASE_H_INCLUDED_ */
// Taf!