From: bengreenstein <bengreenstein>
Date: Wed, 24 Jan 2007 17:18:20 +0000 (+0000)
Subject: updated tep to cover SerialFlush and refer to UartStream.
X-Git-Tag: tinyos/2.0.1~218
X-Git-Url: https://oss.titaniummirror.com/gitweb/?a=commitdiff_plain;h=7438c50817b712378d328f6f949420a84f7be038;p=tinyos-2.x.git

updated tep to cover SerialFlush and refer to UartStream.
---

diff --git a/doc/txt/tep113.txt b/doc/txt/tep113.txt
index 629d7370..5ad7147f 100644
--- a/doc/txt/tep113.txt
+++ b/doc/txt/tep113.txt
@@ -143,6 +143,25 @@ interface to the underlying serial communication. It provides the
     async event void putDone();
   }
 
+Alternatively, ``UartC`` may provide the UartStream multi-byte level
+interface. See the Low-Level I/O TEP [TEP117_] for details.
+
+Additionally, UartC provides a split-phase interface to signal when
+the UART is idle. There are situations (such as when powering down the
+usart, when switching from TX to RX on a radio with a UART data line,
+etc.) when we need explicit information that the data sent over the
+UART has actually been transmitted in full. The problem is that on
+MCUs that double-buffer UART communication (such as the msp430), a
+putDone event signifies that the UART is ready to accept another byte,
+but NOT that the UART is idle.
+
+::
+
+  interface SerialFlush {
+    async command void flush();
+    async event void flushDone();
+  }
+
 It also provides interfaces for configuring the serial port. *NOTE:
 These are not codified yet, and so working out the UART HIL seems like
 a good idea.*
@@ -439,12 +458,12 @@ no snooping capabilities.
 |
 |
 | Ben Greenstein
-| Center for Embedded Networked Sensing
-| UCLA 3563 Boelter Hall
-| Los Angeles, CA 90095-1596
+| Intel Research Seattle
+| 1100 NE 45th Street, 6th Floor
+| Seattle, WA 98105
 |
-| phone -  +1 310 206 3925
-| email - ben@cs.ucla.edu
+| phone -  +1 206 206 545 2501
+| email - benjamin.m.greenstein@intel.com
 
 6. Citations
 ====================================================================