[Tinyos-2-commits] CVS: tinyos-2.x/doc/txt tep112.txt,1.7,1.8

[Phil Levis]

Update of /cvsroot/tinyos/tinyos-2.x/doc/txt
In directory ddv4jf1.ch3.sourceforge.com:/tmp/cvs-serv1780

Modified Files:
	tep112.txt 
Log Message:
Edits for comments.


Index: tep112.txt
===================================================================
RCS file: /cvsroot/tinyos/tinyos-2.x/doc/txt/tep112.txt,v
retrieving revision 1.7
retrieving revision 1.8
diff -C2 -d -r1.7 -r1.8
*** tep112.txt	10 Jan 2007 18:33:38 -0000	1.7
--- tep112.txt	7 Jul 2009 19:03:33 -0000	1.8
***************
*** 252,255 ****
--- 252,263 ----
  timer stack for the Atmega128 microcontroller family.
  
+ As part of power state override, a platform MUST define the enum
+ TOS_SLEEP_NONE in its hardware.h file. This enum defines the highest
+ power state of the platform's microcontroller in a chip-independent
+ way. If a component wires to McuPowerOverride and returns TOS_SLEEP_NONE,
+ this will cause TinyOS to never put the microcontroller into a power
+ saving state. This enum allows a component to prevent sleep in a
+ platform-independent way.
+ 
  4. Peripherals and Subsystems
  ====================================================================
***************
*** 278,282 ****
  ``tinyos-2.x/tos/chips/msp430``, and ``tinyos-2.x/tos/chips/px27ax``. 
  
! An example of a use of McuPowerOverride can be found in the atmega128 timer
  system. Because some low-power states have much longer wakeup latencies than
  others, the timer system does not allow long latencies if it has a timer
--- 286,290 ----
  ``tinyos-2.x/tos/chips/msp430``, and ``tinyos-2.x/tos/chips/px27ax``. 
  
! An example use of McuPowerOverride can be found in the atmega128 timer
  system. Because some low-power states have much longer wakeup latencies than
  others, the timer system does not allow long latencies if it has a timer
***************
*** 286,289 ****
--- 294,310 ----
  wires it to McuSleepC if it is included.
  
+ For the atmega128 microcontroller, TOS_SLEEP_NONE is the "idle" power
+ state.
+ 
+ A second example use of McuPowerOverride is in the msp430 timer system.
+ By default, the msp430 lowest power state is LPM4, which does not keep
+ clocks enabled. If ``tinyos-2.x/tos/chips/msp430/timer/Msp430ClockC.nc''
+ is included in the component graph, however, this configuration wires
+ the McuPowerOverride of ``tinyos-2.x/tos/chips/msp430/timer/Msp430ClockP.nc``
+ to McuSleepC. This implemementation of McuPowerOverride raises the lowest
+ power state to LPM3, which keeps clocks enabled.
+ 
+ For msp430 microcontrollers, TOS_SLEEP_NONE is the "active" power state.
+ 
  6. Author's Address
  ====================================================================