iverilog/vhdlpp/entity.h

#ifndef IVL_entity_H
#define IVL_entity_H
/*
 * Copyright (c) 2011-2021 Stephen Williams (steve@icarus.com)
 *
 *    This source code is free software; you can redistribute it
 *    and/or modify it in source code form 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.
 *
 *    This program 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 General Public License for more details.
 *
 *    You should have received a copy of the GNU General Public License
 *    along with this program; if not, write to the Free Software
 *    Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
 */

# include  <map>
# include  <list>
# include  <vector>
# include  <iostream>
# include  "vtype.h"
# include  "StringHeap.h"
# include  "LineInfo.h"

typedef enum { PORT_NONE=0, PORT_IN, PORT_OUT, PORT_INOUT } port_mode_t;

class Architecture;
class Expression;

class InterfacePort : public LineInfo {
    public:
      InterfacePort(port_mode_t mod = PORT_NONE,
                    perm_string nam = empty_perm_string,
                    const VType*typ = NULL,
                    Expression*exp = NULL)
          : mode(mod), name(nam), type(typ), expr(exp)
      {}

      explicit InterfacePort(const VType*typ)
          : mode(PORT_NONE), type(typ), expr(NULL)
      {}

      InterfacePort(const VType*typ, port_mode_t mod)
          : mode(mod), type(typ), expr(NULL)
      {}

	// Port direction from the source code.
      port_mode_t mode;
	// Name of the port from the source code
      perm_string name;
	// Name of interface type as given in the source code.
      const VType*type;
	// Default value expression (or nil)
      Expression*expr;
};

/*
 * The ComponentBase class represents the base entity
 * declaration. When used as is, then this represents a forward
 * declaration of an entity. Elaboration will match it to a proper
 * entity. Or this can be the base class for a full-out Entity.
 */
class ComponentBase : public LineInfo {

    public:
      explicit ComponentBase(perm_string name);
      ~ComponentBase();

	// Entities have names.
      perm_string get_name() const { return name_; }

      const InterfacePort* find_port(perm_string by_name) const;
      const InterfacePort* find_generic(perm_string by_name) const;
      const std::vector<InterfacePort*>& get_generics() const { return parms_; }

	// Declare the ports for the entity. The parser calls this
	// method with a list of interface elements that were parsed
	// for the entity. This method collects those entities, and
	// empties the list in the process.
      void set_interface(std::list<InterfacePort*>*parms,
			 std::list<InterfacePort*>*ports);


      void write_to_stream(std::ostream&fd) const;

    public:
      void dump_generics(std::ostream&out, int indent =0) const;
      void dump_ports(std::ostream&out, int indent = 0) const;

    private:
      perm_string name_;
    protected:
      std::vector<InterfacePort*> parms_;
      std::vector<InterfacePort*> ports_;
};

/*
 * Entities are fully declared components.
 */
class Entity : public ComponentBase {

    public:
      explicit Entity(perm_string name);
      ~Entity();

	// bind an architecture to the entity, and return the
	// Architecture that was bound. If there was a previous
	// architecture with the same name bound, then do not replace
	// the architecture and instead return the old
	// value. The caller can tell that the bind worked if the
	// returned pointer is the same as the passed pointer.
      Architecture* add_architecture(Architecture*);

	// After the architecture is bound, elaboration calls this
	// method to elaborate this entity. This method arranges for
	// elaboration to happen all the way through the architecture
	// that is bound to this entity.
      int elaborate();

	// During elaboration, it may be discovered that a port is
	// used as an l-value in an assignment. This method tweaks the
	// declaration to allow for that case.
      void set_declaration_l_value(perm_string by_name, bool flag);

      int emit(std::ostream&out);

      void dump(std::ostream&out, int indent = 0) const;

    private:
      std::map<perm_string,Architecture*>arch_;
      Architecture*bind_arch_;

      std::map<perm_string,VType::decl_t> declarations_;

      int elaborate_generic_exprs_(void);
      int elaborate_ports_(void);
};

/*
 * As the parser parses entities, it puts them into this map. It uses
 * a map because sometimes it needs to look back at an entity by name.
 */
extern std::map<perm_string,Entity*> design_entities;

/*
 * Elaborate the collected entities, and return the number of
 * elaboration errors.
 */
extern int elaborate_entities(void);

extern int emit_entities(void);

/*
 * Use this function to dump a description of the design entities to a
 * file. This is for debug, not for any useful purpose.
 */
extern void dump_design_entities(std::ostream&file);

#endif /* IVL_entity_H */