[Tinyos-2-commits] CVS: tinyos-2.x/doc/txt tep119.txt, 1.1.2.1, 1.1.2.2

[Rodrigo Fonseca]

Update of /cvsroot/tinyos/tinyos-2.x/doc/txt
In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv16632/doc/txt

Modified Files:
      Tag: tinyos-2_0_devel-BRANCH
	tep119.txt 
Log Message:
No content changes, only rst formating fixed

Index: tep119.txt
===================================================================
RCS file: /cvsroot/tinyos/tinyos-2.x/doc/txt/Attic/tep119.txt,v
retrieving revision 1.1.2.1
retrieving revision 1.1.2.2
diff -C2 -d -r1.1.2.1 -r1.1.2.2
*** tep119.txt	10 Feb 2006 08:09:51 -0000	1.1.2.1
--- tep119.txt	8 May 2006 03:05:12 -0000	1.1.2.2
***************
*** 101,111 ****
  make the current root no longer a root in the tree specified during
  instantiation. RootControl.unsetRoot() MAY be called on a node that is
! not a root.
  
! interface RootControl {
! 	command error_t setRoot();
! 	command error_t unsetRoot();
! 	command bool isRoot();
! }
  
  
--- 101,111 ----
  make the current root no longer a root in the tree specified during
  instantiation. RootControl.unsetRoot() MAY be called on a node that is
! not a root. ::
  
!  interface RootControl {
!  	command error_t setRoot();
!  	command error_t unsetRoot();
!  	command bool isRoot();
!  }
  
  
***************
*** 116,129 ****
  which has the following signature::
  
! generic configuration CollectionC {
! 	provides {
! 		interface Send[uint8_t tree_id]
! 		interface Receive[uint8_t tree_id];
! 		interface Intercept[uint8_t tree_id];
! 		interface Receive as Snoop[uint8_t tree_id];
! 		interface Packet;
! 		interface RootControl[uint8_t tree_id];
! 	}
! }
  
  CollectionC.Receive.receive is signalled at the root when a collection
--- 116,129 ----
  which has the following signature::
  
!  generic configuration CollectionC {
!  	provides {
!  		interface Send[uint8_t tree_id]
!  		interface Receive[uint8_t tree_id];
!  		interface Intercept[uint8_t tree_id];
!  		interface Receive as Snoop[uint8_t tree_id];
!  		interface Packet;
!  		interface RootControl[uint8_t tree_id];
!  	}
!  }
  
  CollectionC.Receive.receive is signalled at the root when a collection
***************
*** 163,186 ****
  estimation to compute ETX, or their combination are some possible
  approaches to estimating link qualities. LinkEstimatorP MAY have its
! own control messages to compute bi-directional link qualities.
! 
! typedef uint16_t neighbor_t
! 
! LinkEstimatorP {
! 	provides {
! 		interface LinkEstimator;
! 		interface NeighborTable;
! 	}
! }
! 
! interface LinkEstimator {
! 	command uint8_t getLinkQuality(neighbot_t neighbor);
! 	command uint8_t getReverseQuality(neighbot_t neighbor);
! 	command uint8_t getForwardQuality(neighbot_t neighbor);
! }
  
! interface NeighborTable {
! 	event void evicted(neighbot_t neighbor)
! }
  
  
--- 163,186 ----
  estimation to compute ETX, or their combination are some possible
  approaches to estimating link qualities. LinkEstimatorP MAY have its
! own control messages to compute bi-directional link qualities. ::
  
!  typedef uint16_t neighbor_t
!  
!  LinkEstimatorP {
!  	provides {
!  		interface LinkEstimator;
!  		interface NeighborTable;
!  	}
!  }
!  
!  interface LinkEstimator {
!  	command uint8_t getLinkQuality(neighbot_t neighbor);
!  	command uint8_t getReverseQuality(neighbot_t neighbor);
!  	command uint8_t getForwardQuality(neighbot_t neighbor);
!  }
!  
!  interface NeighborTable {
!  	event void evicted(neighbot_t neighbor)
!  }
  
  
***************
*** 196,224 ****
  allow a node to be configured as a root or a non-root node
  dynamically. MTreeRoutingTreeP MAY maintain multiple next hops to a
! root.
! 
! MTreeRoutingEngineP
! 	provides {
! 		interface REControl[uint8_t tree_id];
! 		interface RootControl[uint8_t tree_id];
! 		interface Routing[uint8_t tree_id];
! 	} 
! 	uses {
! 		interface LinkEstimator;
! 		interface NeighborTable;
! 		interface AMSend[COLLECTION_CONTROL_AM_ID];
! 		interface Receive[COLLECTION_CONTROL_AM_ID];
! 	}
! }
! 
! interface REControl {
! 	command error_t initializeRH(message_t *msg);
! 	command uint8_t getHeaderSize();
! }
! 
  
! interface Routing {
! 	command result_t getNextHops(neighbor_t* nextHops, uint8_t* n);
! }
  
  
--- 196,224 ----
  allow a node to be configured as a root or a non-root node
  dynamically. MTreeRoutingTreeP MAY maintain multiple next hops to a
! root. ::
  
!  MTreeRoutingEngineP
!  	provides {
!  		interface REControl[uint8_t tree_id];
!  		interface RootControl[uint8_t tree_id];
!  		interface Routing[uint8_t tree_id];
!  	} 
!  	uses {
!  		interface LinkEstimator;
!  		interface NeighborTable;
!  		interface AMSend[COLLECTION_CONTROL_AM_ID];
!  		interface Receive[COLLECTION_CONTROL_AM_ID];
!  	}
!  }
!  
!  interface REControl {
!  	command error_t initializeRH(message_t *msg);
!  	command uint8_t getHeaderSize();
!  }
!  
!  
!  interface Routing {
!  	command result_t getNextHops(neighbor_t* nextHops, uint8_t* n);
!  }
  
  
***************
*** 228,248 ****
  ForwardingEngineP component provides all the top level interface
  (except RootControl) which is used by an application to interact with
! CollectionC.
  
! ForwardingEngineP {
! 	provides {
! 		interface Send[uint8_t tree_id]
! 		interface Receive[uint8_t tree_id];
! 		interface Intercept;
! 		interface Snoop;
! 		interface Packet;
! 	}
! 	uses {
! 		interface REControl;
! 		interface Routing[uint8_t tree_id];
! 		interface SendMsg[COLLECTION_DATA_AM_ID];
! 		interface ReceiveMsg[COLLECTION_DATA_AM_ID];
! 	}
! }
  
  The forwarding engine MUST must try to transmit a collection packet to
--- 228,248 ----
  ForwardingEngineP component provides all the top level interface
  (except RootControl) which is used by an application to interact with
! CollectionC. ::
  
!  ForwardingEngineP {
!  	provides {
!  		interface Send[uint8_t tree_id]
!  		interface Receive[uint8_t tree_id];
!  		interface Intercept;
!  		interface Snoop;
!  		interface Packet;
!  	}
!  	uses {
!  		interface REControl;
!  		interface Routing[uint8_t tree_id];
!  		interface SendMsg[COLLECTION_DATA_AM_ID];
!  		interface ReceiveMsg[COLLECTION_DATA_AM_ID];
!  	}
!  }
  
  The forwarding engine MUST must try to transmit a collection packet to