AbstractBlock.h

   1 #ifndef __ABSTRACTBLOCK_H__\r
   2 #define __ABSTRACTBLOCK_H__\r
   3 \r
   4 #include <iostream>\r
   5 \r
   6 #include <QtCore>\r
   7 #include <QtXml>\r
   8 \r
   9 #include "AbstractInterface.h"\r
  10 class AbstractInterface;\r
  11 class BlockParameter;\r
  12 class Graph;\r
  13 \r
  14 #define AB_TO_REF(ptr) ((ReferenceBlock*)ptr)\r
  15 #define AB_TO_FUN(ptr) ((FunctionalBlock*)ptr)\r
  16 #define AB_TO_SPE(ptr) ((SpecialBlock*)ptr)\r
  17 #define AB_TO_GRP(ptr) ((GroupBlock*)ptr)\r
  18 \r
  19 using namespace std;\r
  20 using namespace Qt;\r
  21 \r
  22 class AbstractBlock {\r
  23 \r
  24 public:  \r
  25       \r
  26   enum BlockVHDLContext {AnyContext = 0, Entity = 1, Component = 2, Architecture = 3 }; // NB : 3 is when creating an instance of the block that owns this iface\r
  27   enum SpecialType { NotSpecial = 0, Source = 1, Sink = 2, ClkConvert = 3 };\r
  28 \r
  29 \r
  30   AbstractBlock(Graph* _graph);\r
  31   //AbstractBlock(const QString& _name);\r
  32   virtual ~AbstractBlock();\r
  33 \r
  34   // getters\r
  35   inline QString getName() { return name; }\r
  36   inline int getSpecialType() { return specialType; }\r
  37   inline QString getVersion() { return version; }\r
  38   inline int nbParameters() { return params.size(); }\r
  39   inline Graph* getGraph() { return graph; }\r
  40 \r
  41   inline QList<AbstractInterface*> getInputs() { return inputs; }\r
  42   inline QList<AbstractInterface*> getOutputs() { return outputs; }\r
  43   inline QList<AbstractInterface*> getBidirs() { return bidirs; }  \r
  44   QList<AbstractInterface *> getInterfaces(int direction = AbstractInterface::AnyDirection, int purpose = AbstractInterface::AnyPurpose);\r
  45   QList<AbstractInterface *> getDataInputs(); //! return all inputs of type data\r
  46   QList<AbstractInterface *> getDataOutputs(); //! return all inputs of type data\r
  47   QList<AbstractInterface *> getControlInputs(); //! return all inputs of type control\r
  48   QList<AbstractInterface *> getControlOutputs(); //! return all outputs of type control\r
  49   AbstractInterface* getIfaceFromName(QString name);\r
  50 \r
  51   inline QList<BlockParameter *> getParameters() { return params; }\r
  52   BlockParameter* getParameterFromName(QString name);\r
  53   QList<BlockParameter *> getUserParameters();\r
  54   QList<BlockParameter *> getGenericParameters();\r
  55   QList<BlockParameter *> getPortParameters();\r
  56   QList<BlockParameter *> getWishboneParameters();\r
  57 \r
  58   inline AbstractBlock* getParent() { return parent; }\r
  59   inline bool getOutputPatternComputed() { return outputPatternComputed; }\r
  60   inline int getTraversalLevel() { return traversalLevel; }\r
  61   \r
  62   // setters\r
  63   void setName(const QString& str);\r
  64   void setSpecialType(int type);\r
  65   inline void setVersion(const QString& _version) { version = _version; }\r
  66   virtual void setParent(AbstractBlock* _parent);\r
  67   inline void setOutputPatternComputed(bool state) {  outputPatternComputed = state; }\r
  68   inline void resetTraversalLevel() { traversalLevel = -1; }\r
  69   inline void setTraversalLevel(int level) { traversalLevel = level; }\r
  70 \r
  71   // testers\r
  72   virtual bool isReferenceBlock();\r
  73   virtual bool isFunctionalBlock();\r
  74   virtual bool isSpecialBlock();\r
  75   virtual bool isGroupBlock();\r
  76   virtual bool isStimuliBlock(); //! a stimuli block is outside the top group and simulates a peripheral (NB: this is also a source)\r
  77   virtual bool isTopGroupBlock();\r
  78   bool isSourceBlock(); //! a source block has no data inputs and thus executes infinitely\r
  79   bool isSinkBlock(); //! a sink block has no data outputs and just collects what it receives (i.e. no compatibility check)\r
  80   bool isWBConfigurable();\r
  81 \r
  82   // others\r
  83   int getSpecialTypeFromString(QString str);\r
  84 \r
  85   /*!\r
  86    * \brief connectClkReset connects the clock and reset inputs to a clkrstgen block or the the group ifaces\r
  87    * \param idBlockClk is the id of the clock interface (there may be severals)\r
  88    * \param idGen is the id of the clkrstgen block\r
  89   */\r
  90   void connectClock(QString clkName, int idGen = 0) throw(Exception);\r
  91   void connectReset(QString rstName, int idGen = 0) throw(Exception);\r
  92   virtual QList<QString> getExternalResources() = 0; // returns the list of all external files needed for VHDL generation\r
  93   virtual void generateVHDL(const QString& path) throw(Exception) = 0; // main entry to generate the VHDL code\r
  94   void generateComponent(QTextStream& out, bool hasController=false) throw(Exception); // generate the component using reference\r
  95   void generateEntity(QTextStream& out, bool hasController=false) throw(Exception); // generate the entity using reference\r
  96 \r
  97   virtual void parametersValidation(QList<AbstractBlock*>* checkedBlocks, QList<AbstractBlock*>* blocksToConfigure) = 0; // ugly but usefull   \r
  98 \r
  99   void addParameter(BlockParameter *param);\r
 100   void addInterface(AbstractInterface *inter);\r
 101   void removeInterface(AbstractInterface *inter);\r
 102   void removeAllInterfaces();\r
 103   void defineBlockParam(BlockParameter *param);\r
 104 \r
 105 \r
 106   // patterns\r
 107   virtual void checkInputPatternCompatibility() throw(Exception) = 0;\r
 108   virtual void computeOutputPattern(int nbExec = -1) throw(Exception) = 0;\r
 109   virtual void computeAdmittanceDelays() throw(Exception) = 0;\r
 110   \r
 111 protected:\r
 112 \r
 113 \r
 114   QString name;\r
 115   int specialType;\r
 116   QString version;\r
 117   Graph* graph;\r
 118 \r
 119   // parameters\r
 120   QList<BlockParameter *> params;\r
 121 \r
 122   // interfaces\r
 123   QList<AbstractInterface*> inputs;\r
 124   QList<AbstractInterface*> outputs;\r
 125   QList<AbstractInterface*> bidirs;\r
 126   \r
 127   // others\r
 128   \r
 129   // patterns  \r
 130   bool outputPatternComputed;\r
 131   int traversalLevel; // the level (0, 1, ...) during the traversal of the graph\r
 132   \r
 133   // NB: only GroupBlock and FunctionalBlock have a real parent, except sources that have no parents\r
 134   AbstractBlock* parent;\r
 135 \r
 136   virtual void generateComments(QTextStream& out, QDomElement &elt, QString coreFile) throw(Exception) = 0; // generates comments from <comments> element\r
 137   virtual void generateLibraries(QTextStream& out, QDomElement &elt) throw(Exception) = 0; // generates libraries from <libraries> element  \r
 138   virtual void generateArchitecture(QTextStream& out, QDomElement &elt ) throw(Exception) = 0; // generate the architecture using <architecture> element\r
 139   virtual void generateController(QTextStream& out) throw(Exception) = 0; // generate the wishbone controller of the block\r
 140   virtual void generateEntityOrComponentBody(QTextStream& out, int indentLevel, bool hasController=false) throw(Exception) = 0; // generate the entity/compo body using reference\r
 141 \r
 142 };\r
 143 \r
 144 #endif // __ABSTRACTBLOCK_H__\r