]> oss.titaniummirror.com Git - tinyos-2.x.git/commitdiff
MORE clarification.
authorscipio <scipio>
Tue, 6 Feb 2007 00:16:15 +0000 (00:16 +0000)
committerscipio <scipio>
Tue, 6 Feb 2007 00:16:15 +0000 (00:16 +0000)
doc/html/tep107.html
doc/txt/tep107.txt

index 907c5754b68c24413d87d7f7a51cfd610c932a40..aa762beb9a2c58fb65b2f83649babcac70cfd28a 100644 (file)
@@ -538,6 +538,14 @@ all three criteria. LED configuration is a special case: while it
 nominally meets all three criteria, the most important one is the third:
 as LEDs are often needed during SoftwareInit initialization, they must
 be set up before it is invoked.</p>
+<p>Note that not all code which meets some of these criteria is wired through
+PlatformC. In particular, criterion 1 is typically necessary but not
+sufficient to require PlatformC. For example, a timer system that
+configures overflow and capture settings or  a UART stack that sets the
+baud rate and transmission options can often be wired to SoftwareInit.
+They are encapsulated abstractions which will not be invoked or
+started until the boot event, and only need to be configured if the
+system includes their functionality.</p>
 <p>Components whose initialization does not directly depend on hardware
 resources SHOULD wire to MainC.SoftwareInit. If a component requires a
 specific initialization ordering, then it is responsible for
index 3ea5ec68667f8738bf77c2bb3826b5e61e4af8bd..221a8aa11d880930ace89a600a4e36e786f9a518 100644 (file)
@@ -242,7 +242,6 @@ PlatformInit is for a small subset of initializations whose properties
 requires that they be performed separately. Initializations invoked
 through PlatformC meet some or all of the following criteria:
 
-
 1. The initialization requires configuring hardware resources. This implies that the code is platform-specific. 
 
 2. The initialization should always be performed.
@@ -260,6 +259,15 @@ nominally meets all three criteria, the most important one is the third:
 as LEDs are often needed during SoftwareInit initialization, they must
 be set up before it is invoked.
 
+Note that not all code which meets some of these criteria is wired through 
+PlatformC. In particular, criterion 1 is typically necessary but not 
+sufficient to require PlatformC. For example, a timer system that
+configures overflow and capture settings or  a UART stack that sets the
+baud rate and transmission options can often be wired to SoftwareInit.
+They are encapsulated abstractions which will not be invoked or
+started until the boot event, and only need to be configured if the 
+system includes their functionality.
+
 Components whose initialization does not directly depend on hardware
 resources SHOULD wire to MainC.SoftwareInit. If a component requires a
 specific initialization ordering, then it is responsible for