[Tinyos-2-commits] CVS: tinyos-2.x/tos/lib/mac/tkn154 TKN154_MAC.h, 1.6, 1.7

[Jan-Hinrich Hauer]

Update of /cvsroot/tinyos/tinyos-2.x/tos/lib/mac/tkn154
In directory ddv4jf1.ch3.sourceforge.com:/tmp/cvs-serv22270/tos/lib/mac/tkn154

Modified Files:
	TKN154_MAC.h 
Log Message:
Added some explanation about the serial debugging.

Index: TKN154_MAC.h
===================================================================
RCS file: /cvsroot/tinyos/tinyos-2.x/tos/lib/mac/tkn154/TKN154_MAC.h,v
retrieving revision 1.6
retrieving revision 1.7
diff -C2 -d -r1.6 -r1.7
*** TKN154_MAC.h	25 Mar 2009 09:27:26 -0000	1.6
--- TKN154_MAC.h	26 Mar 2009 15:29:23 -0000	1.7
***************
*** 298,308 ****
     *   the second is a format string (like in printf())
     * - following the second string, there may be zero up to 
!    *   two parameters -- these must be (cast to) uint32_t! 
     * - both strings must be constants (pointers always valid)
     * - no data is sent over serial, unless dbg_serial_flush() is
     *   called; try to call it when the system is idle or at least
!    *   when no time-critical operations are pending
     * - on the PC use the printf java client to display the debug
!    *   output (see tinyos-2.x/apps/tests/TestPrintf/README.txt)
     *
     * The ASSERT(X) macro is used to test for errors. If X evaluates 
--- 298,312 ----
     *   the second is a format string (like in printf())
     * - following the second string, there may be zero up to 
!    *   two parameters -- these must be (cast to) uint32_t and
!    *   the format specifier must be "%lu", e.g.
!    *   dbg_serial("MyComponentP", "Value: %lu\n", (uint32_t) val);
     * - both strings must be constants (pointers always valid)
     * - no data is sent over serial, unless dbg_serial_flush() is
     *   called; try to call it when the system is idle or at least
!    *   when no time-critical operations are pending; on TelosB
!    *   you can also press the user button to trigger a flush
     * - on the PC use the printf java client to display the debug
!    *   output (see tinyos-2.x/apps/tests/TestPrintf/README.txt);
!    *   the output format is component:line-in-source-code:text
     *
     * The ASSERT(X) macro is used to test for errors. If X evaluates 
***************
*** 313,320 ****
     * can typically still pull the information out later.
     *
!    * If TKN154_DEBUG is not defined (which is the default), then
     * dbg_serial() maps to dbg(), i.e. is completely removed unless 
     * the platform is TOSSIM, and in the ASSERT(X) statement X is 
!    * evaluated/executed, but the result is ignored. 
     **/
  
--- 317,324 ----
     * can typically still pull the information out later.
     *
!    * When TKN154_DEBUG is not defined (which is the default), then
     * dbg_serial() maps to dbg(), i.e. is completely removed unless 
     * the platform is TOSSIM, and in the ASSERT(X) statement X is 
!    * evaluated/executed, but the result is ignored.
     **/