added an example of source block

[blast.git] / AbstractInterface.h

diff --git a/AbstractInterface.h b/AbstractInterface.h
index 608d04ca8e8867bc273769cb73069ed1de7a3178..29be72915f50648b92b074875d82deb53e2058cd 100644 (file)
--- a/AbstractInterface.h
+++ b/AbstractInterface.h
@@ -24,7 +24,7 @@ class AbstractInterface {
 public :
 
   enum IfaceWidthType { Expression = 1, Boolean, Natural};
-  enum IfacePurpose { Data = 1, Clock = 2, Reset = 3, Wishbone = 4 };
+  enum IfacePurpose { Data = 1, Control, Clock, Reset, Wishbone };
   enum IfaceDirection { Input = 1, Output = 2, InOut = 3 };  
   enum IfaceVHDLContext { Entity = 1, Component = 2, Architecture = 3 }; // NB : 3 is when creating an instance of the block that owns this iface
   enum IfaceVHDLFlags { NoComma = 1 };
@@ -46,6 +46,7 @@ public :
   inline int getDirection() { return direction;}
   QString getDirectionString();  
   inline AbstractBlock *getOwner() { return owner;}
+  inline AbstractInterface* getAssociatedIface() { return associatedIface; }
 
   double getDoubleWidth() throw(QException);
 
@@ -63,7 +64,8 @@ public :
   inline void setType(int _type) { type = _type;}
   inline void setType(const QString& _type) { type = typeFromString(_type);}
   void setPurpose(int _purpose);
-  void setDirection(int _direction);  
+  void setDirection(int _direction);
+  bool setAssociatedIface(AbstractInterface* iface);
 
   // testers
   virtual bool isReferenceInterface();
@@ -95,6 +97,15 @@ protected:
   int direction;
 
   AbstractBlock* owner;
+  /*!
+   * \brief associatedIface the control (resp. data) interface that is bounded to this data (resp. control) interface
+   * If a reference block is designed to be fully integrated in Blast, nearly every data interface is bounded
+   * to a control interface that signals if the value presented on the interface is valid or not. associatedIface
+   * references this control interface if this is a data interface, and a data interface is this is a control interface.
+   * Note that the association is done by the call of setAssociatedIface() that must be done only for a control interface.
+   * (NB: a test is done in the method to prevent the other case).
+   */
+  AbstractInterface* associatedIface;
 };