Updated Printf library to new way of not requiring explicit wiring of any interfaces...

[tinyos-2.x.git] / tos / lib / printf / PrintfC.nc

diff --git a/tos/lib/printf/PrintfC.nc b/tos/lib/printf/PrintfC.nc
index ec3ae397f31b801652782f39e9f017fdbc1f845e..94dc3d52604678a36558c60a6eea46ce96e1dde6 100644 (file)
--- a/tos/lib/printf/PrintfC.nc
+++ b/tos/lib/printf/PrintfC.nc
@@ -21,32 +21,46 @@
  */
 
 /**
+ * This is the PrintfC component.  It provides the printf service for printing
+ * data over the serial interface using the standard c-style printf command.  
+ * It must be started via the SplitControl interface it provides.  Data
+ * printed using printf are buffered and only sent over the serial line after
+ * making a call to PrintfFlush.flush().  This buffer has a maximum size of 
+ * 250 bytes at present.  After calling start on this component, printf
+ * statements can be made anywhere throughout your code, so long as you include
+ * the "printf.h" header file in every file you wish to use it.  Standard
+ * practice is to start the printf service in the main application, and set up 
+ * a timer to periodically flush the printf buffer (500ms should do).  In future
+ * versions, user defined buffer sizes as well as well as automatic flushing at 
+ * user defined intervals will be supported.  
  *
  * @author Kevin Klues (klueska@cs.wustl.edu)
  * @version $Revision$
  * @date $Date$
  */
-
 #include "printf.h"
 
 configuration PrintfC {
   provides {
-       interface SplitControl as PrintfControl;
-       interface PrintfFlush;
+    interface Boot;
   }
+  uses interface Boot as MainBoot @exactlyonce();
 }
 implementation {
   components SerialActiveMessageC;
-  components new SerialAMSenderC(AM_PRINTFMSG);
+  components new SerialAMSenderC(AM_PRINTF_MSG);
+  components new PrintfQueueC(uint8_t, PRINTF_BUFFER_SIZE) as QueueC;
+
   components PrintfP;
   components LedsC;
-
-  PrintfControl = PrintfP;
-  PrintfFlush = PrintfP;
   
-  PrintfP.Leds -> LedsC;
+  MainBoot = PrintfP.MainBoot;
+  Boot = PrintfP.Boot;
+  
   PrintfP.SerialControl -> SerialActiveMessageC;
+  PrintfP.Queue -> QueueC;
   PrintfP.AMSend -> SerialAMSenderC;
   PrintfP.Packet -> SerialAMSenderC;
+  PrintfP.Leds -> LedsC;
 }