[Tinyos-contrib-commits] CVS: tinyos-1.x/contrib/wustl/apps/Agilla
README, 1.23, 1.24
Chien-Liang Fok
chien-liang at users.sourceforge.net
Sun May 21 20:36:21 PDT 2006
Update of /cvsroot/tinyos/tinyos-1.x/contrib/wustl/apps/Agilla
In directory sc8-pr-cvs10.sourceforge.net:/tmp/cvs-serv7189
Modified Files:
README
Log Message:
updated to include the new flags. Removed the debugging flags as they are self explanatory.
Index: README
===================================================================
RCS file: /cvsroot/tinyos/tinyos-1.x/contrib/wustl/apps/Agilla/README,v
retrieving revision 1.23
retrieving revision 1.24
diff -C2 -d -r1.23 -r1.24
*** README 18 May 2006 21:41:15 -0000 1.23
--- README 22 May 2006 03:36:19 -0000 1.24
***************
*** 69,90 ****
PFLAGS_AGILLA=-DAGILLA_NUM_AGENTS=3 \
-DAGILLA_NUM_CODE_BLOCKS=12 \
! -DAGILLA_NETWORK_INTERFACE_RECEIVE_QUEUE_SIZE=4 \
! -DAGILLA_NETWORK_INTERFACE_SEND_QUEUE_SIZE=4 \
! -DAGILLA_SNDR_BUFF_SIZE=1 \
! -DAGILLA_SNDR_RETRY_TIMER=512 \
-DAGILLA_SNDR_MAX_RETRIES=2 \
-DAGILLA_SNDR_RXMIT_TIMER=290 \
! -DAGILLA_SNDR_MAX_RETRANSMITS=4 \
! -DAGILLA_SNDR_ABORT_TIMER=1536 \
-DAGILLA_RCVR_ABORT_TIMER=1000 \
-DAGILLA_RCVR_FIN_TIMER=300 \
-DAGILLA_MAX_NUM_NEIGHBORS=20 \
-DDEFAULT_NUM_COLUMNS=4 \
-DAGILLA_REMOTE_TS_OP_Q_SIZE=3 \
-DAGILLA_TS_SIZE=100 \
-DAGILLA_RTS_TIMEOUT=256 \
-DAGILLA_RTS_MAX_NUM_TRIES=4 \
- -DAGILLA_TS_BOUNCEQ_SIZE=2 \
- -DAGILLA_TS_NO_DUPLICATE=0 \
-DREACTION_MGR_BUFFER_SIZE=5 \
-DBEACON_PERIOD=2048 \
--- 69,91 ----
PFLAGS_AGILLA=-DAGILLA_NUM_AGENTS=3 \
-DAGILLA_NUM_CODE_BLOCKS=12 \
! -DMESSAGE_BUFFER_SIZE=10 \
! -DAGILLA_SNDR_BUFF_SIZE=3 \
! -DAGILLA_SNDR_RETRY_TIMER=1536 \
! -DAGILLA_SNDR_ABORT_TIMER=1536 \
-DAGILLA_SNDR_MAX_RETRIES=2 \
-DAGILLA_SNDR_RXMIT_TIMER=290 \
! -DAGILLA_SNDR_MAX_RETRANSMITS=8 \
! -DAGILLA_RCVR_BUFF_SIZE=3 \
-DAGILLA_RCVR_ABORT_TIMER=1000 \
-DAGILLA_RCVR_FIN_TIMER=300 \
+ -DAGILLA_LOCATION_UPDATE_TIMER=2048 \
-DAGILLA_MAX_NUM_NEIGHBORS=20 \
+ -DAGILLA_MAX_NUM_AGENTS=20 \
-DDEFAULT_NUM_COLUMNS=4 \
-DAGILLA_REMOTE_TS_OP_Q_SIZE=3 \
-DAGILLA_TS_SIZE=100 \
+ -DAGILLA_TS_NO_DUPLICATE=0 \
-DAGILLA_RTS_TIMEOUT=256 \
-DAGILLA_RTS_MAX_NUM_TRIES=4 \
-DREACTION_MGR_BUFFER_SIZE=5 \
-DBEACON_PERIOD=2048 \
***************
*** 92,102 ****
--- 93,117 ----
-DBEACON_TIMEOUT=9216 \
-DTIMEOUT_GET_LOCATION=1024 \
+ -DTIMEOUT_GET_NUM_AGENTS=1024 \
+ -DCLUSTER_UPDATE_INTERVAL=10240 \
+ -DCLUSTERMSG_RAND=5120 \
+ -DAGILLA_RF_POWER=31 \
-DENABLE_SPACE_LOCALIZER=1 \
-DENABLE_NEIGHBOR_LIST_FILTER=0 \
+ -DENABLE_GRID_ROUTING=0 \
+ -DENABLE_CLUSTERING=0 \
+ -DENABLE_EXP_LOGGING=0 \
-DOMIT_AGENT_SENDER=0 \
-DOMIT_AGENT_RECEIVER=0 \
-DOMIT_CONTEXT_DISCOVERY=0 \
+ -DOMIT_RXN_MGR=0 \
+ -DOMIT_NETWORK_INTERFACE=0 \
+ -DOMIT_REMOTE_TS_OP_MGR=0 \
+ -DOMIT_ERROR_MGR=0 \
+ -DOMIT_TS=0 \
-DINCLUDE_DEFAULT_AGENT=0 \
-DPRINT_RXN_FIRED=0 \
+ -DDEBUG_NETWORK_INTERFACE=0 \
+ -DDEBUG_MESSAGE_BUFFER=0 \
-DDEBUG_AGENT_RECEIVER=0 \
-DDEBUG_AGENT_SENDER=0 \
***************
*** 110,121 ****
--- 125,149 ----
-DDEBUG_TUPLE_UTIL=0 \
-DDEBUG_NEIGHBORLIST=0 \
+ -DDEBUG_CLUSTERING=0 \
-DDEBUG_AGILLA_ENGINE=0 \
-DDEBUG_OP_SLEEP=0 \
-DDEBUG_OP_RXN=0 \
-DDEBUG_OPCOMPARE=0 \
+ -DDEBUG_OP_RTS=0 \
+ -DDEBUG_OPLOCTOVALUE=0 \
+ -DDEBUG_HEAP_MGR=0 \
-DDEBUG_ADDRESS_MGR=0 \
+ -DDEBUG_TIMESYNC=0 \
+ -DDEBUG_LOCATION_DIRECTORY=0 \
+ -DDEBUG_OP_GET_AGENTS=0 \
+ -DDEBUG_OP_GET_CLOSEST_AGENT=0 \
+ -DDEBUG_OP_GETLOCATION=0 \
+ -DDEBUG_OP_GETNUMAGENTS=0 \
+ -DDEBUG_OP_RTS=0 \
+ -DDEBUG_OP_FIND_MATCH=0 \
-DNBR_LIST_PRINT_CHANGES=0
+
Details on each of these flags is described below. Default values are in
parenthesis.
***************
*** 130,173 ****
agent's code.
! -DAGILLA_NETWORK_INTERFACE_RECEIVE_QUEUE_SIZE=<num> (3)
! The maximum number of incoming messages Agilla should enqueue.
! A higher value makes communication more reliable, but increases
! memory usage.
!
! -DAGILLA_NETWORK_INTERFACE_SEND_QUEUE_SIZE=<num> (3)
! The maximum number of outgoing messages Agilla should enqueue.
! A higher value makes communication more reliable, but increases
! memory usage.
!
! -DDEBUG_NETWORK_INTERFACE=<0/1> (0)
! Prints out debug messages generated from within the NetworkInterface
! components. The NetworkInterface manages the send and receive buffers.
! -DAGILLA_SNDR_BUFF_SIZE=<num> (1)
The maximum number of simultaneous outgoing agents.
! -DAGILLA_SNDR_RETRY_TIMER=<num> (512)
The amount of time in binary milliseconds before the agent sender
aborts the migration process and retries from the beginning.
-DAGILLA_SNDR_MAX_RETRIES=<num> (2)
The maximum number of times the agent sender will retry migrating an
agent before permanently aborting.
-
- -DAGILLA_SNDR_MAX_RETRANSMITS=<num> (4)
- The maximum number of times the agent sender will retransmit a message
- before aborting.
! -DAGILLA_SNDR_RXMIT_TIMER=<num> (256)
The amount of time in binary milliseconds before the agent sender
retransmits a message. If an acknowledgement is received within this
! time, the message is not retransmitted.
!
! -DAGILLA_SNDR_ABORT_TIMER=<num> (1536)
! The amount of time the sender pauses before aborting an agent. This
! ensures that the destination node times out the receive process and
! frees up the memory. This must be higher than -DAGILLA_RCVR_ABORT_TIMER.
! -DAGILLA_RCVR_BUFF_SIZE=<num> (1)
The number of simultaneous incoming agents. This value is limited
by memory availability. NOTE: THIS OPTION IS NO LONGER AVAILABLE
--- 158,192 ----
agent's code.
! -DMESSAGE_BUFFER_SIZE=<num> (10)
! The number of message buffers in NetworkInterfaceM. All messages go through
! the message buffer to handle multiple components performing send operations
! simultaneously.
! -DAGILLA_SNDR_BUFF_SIZE=<num> (3)
The maximum number of simultaneous outgoing agents.
! -DAGILLA_SNDR_RETRY_TIMER=<num> (1536)
The amount of time in binary milliseconds before the agent sender
aborts the migration process and retries from the beginning.
+
+ -DAGILLA_SNDR_ABORT_TIMER=<num> (1536)
+ The amount of time the sender pauses before aborting an agent. This
+ ensures that the destination node times out the receive process and
+ frees up the memory. This must be higher than -DAGILLA_RCVR_ABORT_TIMER.
-DAGILLA_SNDR_MAX_RETRIES=<num> (2)
The maximum number of times the agent sender will retry migrating an
agent before permanently aborting.
! -DAGILLA_SNDR_RXMIT_TIMER=<num> (290)
The amount of time in binary milliseconds before the agent sender
retransmits a message. If an acknowledgement is received within this
! time, the message is not retransmitted.
! -DAGILLA_SNDR_MAX_RETRANSMITS=<num> (8)
! The maximum number of times the agent sender will retransmit a message
! before aborting.
!
! -DAGILLA_RCVR_BUFF_SIZE=<num> (3)
The number of simultaneous incoming agents. This value is limited
by memory availability. NOTE: THIS OPTION IS NO LONGER AVAILABLE
***************
*** 182,189 ****
is to prevent duplicate agents.
-DAGILLA_MAX_NUM_NEIGHBORS=<num> (20)
The size of the neighbor list.
! -DDEFAULT_NUM_COLUMNS=<num> (20)
Specifies the default number of columns. This is used when
DENABLE_NEIGHBOR_LIST_FILTER=1. It creates a virtual multi-hop network
--- 201,216 ----
is to prevent duplicate agents.
+ -DAGILLA_LOCATION_UPDATE_TIMER=<num> (2048)
+ The period of updating a cluster head with an agent's location.
+ This is only used when -DENABLE_CLUSTERING=1.
+
-DAGILLA_MAX_NUM_NEIGHBORS=<num> (20)
The size of the neighbor list.
! -DAGILLA_MAX_NUM_AGENTS=<num> (20)
! The maximum number of agents in a cluster. This is only used when
! -DENABLE_CLUSTERING=1.
!
! -DDEFAULT_NUM_COLUMNS=<num> (4)
Specifies the default number of columns. This is used when
DENABLE_NEIGHBOR_LIST_FILTER=1. It creates a virtual multi-hop network
***************
*** 203,223 ****
in the destination's tuple space.
! -DAGILLA_RTS_TIMEOUT=<num> (1024)
The maximum amount of time a node waits for an acknowledgement when
performing a remove tuple space operation.
- -DTIMEOUT_GET_LOCATION=<num> (1024)
- The amount of time Agilla waits before cancelling a getAgentLocation
- operation.
-
-DAGILLA_RTS_MAX_NUM_TRIES=<num> (4)
The maximum number of times a node will retry transmitting a tuple space
operation before trimming out.
!
! -DAGILLA_TS_BOUNCEQ_SIZE=<num> (1)
! The maximum number of pending remote tuple space operations.
!
-DREACTION_MGR_BUFFER_SIZE=<num> (5
! The maximum number of reactions that can be registered.
-DBEACON_PERIOD=<num> (2048)
--- 230,243 ----
in the destination's tuple space.
! -DAGILLA_RTS_TIMEOUT=<num> (256)
The maximum amount of time a node waits for an acknowledgement when
performing a remove tuple space operation.
-DAGILLA_RTS_MAX_NUM_TRIES=<num> (4)
The maximum number of times a node will retry transmitting a tuple space
operation before trimming out.
!
-DREACTION_MGR_BUFFER_SIZE=<num> (5
! The maximum number of reactions that can be registered.
-DBEACON_PERIOD=<num> (2048)
***************
*** 231,235 ****
--- 251,274 ----
The amount of time over which no beacon from a particular neighbor is
received before removing that neighbor from the neighbor list.
+
+ -DTIMEOUT_GET_LOCATION=<num> (1024)
+ The amount of time Agilla waits before cancelling a getAgentLocation
+ operation.
+
+ -DTIMEOUT_GET_NUM_AGENTS=<num> (1024)
+ The timeout interval when performing a agent location service operation.\
+ These operations include getAgents, getClosestAgent, and getNumAgents.
+
+ -DCLUSTER_UPDATE_INTERVAL=<num> (10240)
+ The period of updating the base station with the cluster's information.
+ This is only used when -DENABLE_CLUSTERING=1.
+ -DCLUSTERMSG_RAND=<num> (5120)
+ The random interval to add to the base CLUSTER_UPDATE_INTERVAL. This is
+ only used when -DENABLE_CLUSTERING=1.
+
+ -DAGILLA_RF_POWER=<num> (31)
+ The power level of the radio. This is only used with the CC2420Control.
+
-DENABLE_SPACE_LOCALIZER=<1/0> (1)
Specifies whether Agilla should use the SpaceLocalizer to change
***************
*** 248,255 ****
is used to simulate a multi-hop network.
! -DINCLUDE_DEFAULT_AGENT=<1/0> (0)
! Sets whether an agent is hard-coded into the middleware and automatically
! started when the mote boots. This is useful for running Agilla without
! an AgentInjector.
-DOMIT_AGENT_SENDER=<1/0> (0)
--- 287,299 ----
is used to simulate a multi-hop network.
! -DENABLE_GRID_ROUTING=<num> (0)
! Toggles whether the neighbor list should be filtered based on a grid topology.
!
! -DENABLE_CLUSTERING=<num> (0)
! Toggles whether clustering is enabled. This is used by the agent location
! directory service.
!
! -DENABLE_EXP_LOGGING=<num> (0)
! Toggles whether experimental logging messages should be sent over the UART.
-DOMIT_AGENT_SENDER=<1/0> (0)
***************
*** 268,326 ****
will not be compiled.
! -DINCLUDE_DEFAULT_AGENT=<1/0> (0)
! Whether to include a default agent within the firmware. If a default agent
! is included, it will be started automatically when the mote is turned on.
! -DDEBUG_AGENT_RECEIVER=<1/0> (0)
! A flag that controls whether to print debug statements to the screen under
! mode "usr1".
! -DDEBUG_AGENT_SENDER=<1/0> (0)
! A flag that controls whether to print debug statements to the screen under
! mode "usr1".
!
! -DDEBUG_OPSTACK=<1/0> (0)
! A flag that controls whether to print debug statements to the screen under
! mode "usr1".
!
! -DDEBUG_HEAPMGR=<1/0> (0)
! A flag that controls whether to print debug statements to the screen under
! mode "usr1".
!
! -DDEBUG_AGENT_MGR=<1/0> (0)
! A flag that controls whether to print debug statements to the screen under
! mode "usr1".
!
! -DDEBUG_CODEMGR=<1/0> (0)
! A flag that controls whether to print debug statements to the screen under
! mode "usr1".
!
! -DDEBUG_REMOTE_TS_OP_MGR=<1/0> (0)
! A flag that controls whether to print debug statements to the screen under
! mode "usr1".
!
! -DDEBUG_RXNMGR=<1/0> (0)
! A flag that controls whether to print debug statements to the screen under
! mode "usr1".
!
! -DDEBUG_TS=<1/0> (0)
! A flag that controls whether to print debug statements to the screen under
! mode "usr1".
!
! -DDEBUG_TUPLE_UTIL=<1/0> (0)
! A flag that controls whether to print debug statements to the screen under
! mode "usr1".
!
! -DDEBUG_NEIGHBORLIST=<1/0> (0)
! A flag that controls whether to print debug statements to the screen under
! mode "usr1".
!
! -DDEBUG_AGILLA_ENGINE=<1/0> (0)
! A flag that controls whether to print debug statements to the screen under
! mode "usr1".
- -DNBR_LIST_PRINT_CHANGES=<1/0> (0)
- A flag that controls whether to print statements to the screen that
- indicate changes to the neighbor list.
--- 312,332 ----
will not be compiled.
! -DOMIT_NETWORK_INTERFACE=<1/0> (0)
! Specifies whether the network interface buffer should be enabled.
! -DOMIT_REMOTE_TS_OP_MGR=<1/0> (0)
! Specifies whether the remote tuple space operation manager should be enabled.
! -DOMIT_ERROR_MGR=<1/0> (0)
! Specifies whether the error manager should be enabled.
!
! -DOMIT_TS=<1/0> (0)
! Specifies whether the tuple space should be enabled or disabled.
!
! -DINCLUDE_DEFAULT_AGENT=<1/0> (0)
! Sets whether an agent is hard-coded into the middleware and automatically
! started when the mote boots. This is useful for running Agilla without
! an AgentInjector.
More information about the Tinyos-contrib-commits
mailing list