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

[David Gay]

Update of /cvsroot/tinyos/tinyos-2.x/doc/txt
In directory sc8-pr-cvs10.sourceforge.net:/tmp/cvs-serv20386

Modified Files:
	tep109.txt 
Log Message:
more updates to 109

Index: tep109.txt
===================================================================
RCS file: /cvsroot/tinyos/tinyos-2.x/doc/txt/tep109.txt,v
retrieving revision 1.7
retrieving revision 1.8
diff -C2 -d -r1.7 -r1.8
*** tep109.txt	19 Jul 2008 00:32:56 -0000	1.7
--- tep109.txt	21 Jul 2008 18:20:36 -0000	1.8
***************
*** 208,212 ****
  
  - A `Resource` interface for requesting access to the device and
!   possibly performing automated power management.
  
  - Any other interfaces needed to control the device, e.g., to
--- 208,213 ----
  
  - A `Resource` interface for requesting access to the device and
!   possibly performing automated power management, following
!   the conventions described in [TEP108]_ and [TEP115]_.
  
  - Any other interfaces needed to control the device, e.g., to
***************
*** 243,246 ****
--- 244,282 ----
  directory.
  
+ A sensor board MAY contain components that override the default TinyOS
+ *demo sensors*. This allows the sensor board to easily be used with
+ TinyOS sample applications that use the demo sensors. If a sensor 
+ board wishes to override the default demo sensor:
+ 
+ * It MUST provide a generic component named ``DemoSensorC`` with the
+   following signature::
+ 
+     provides interface Read<uint16_t>;
+     provides interface DeviceMetadata;
+ 
+ * It MAY provide a generic component named ``DemoSensorNowC`` with the
+   following signature::
+ 
+     provides interface ReadNow<uint16_t>;
+     provides interface DeviceMetadata;
+ 
+   This component SHOULD sample the same sensor as ``DemoSensorC``.
+ 
+ * It MAY provide a generic component named ``DemoSensorStreamC`` with the
+   following signature::
+ 
+     provides interface ReadStream<uint16_t>;
+     provides interface DeviceMetadata;
+ 
+   This component SHOULD sample the same sensor as ``DemoSensorC``.
+ 
+ These components MUST be an alias for one of the sensor board's usual
+ sensors, though they change the precision of the sensor if necessary.
+ For instance, if ``DemoSensorC`` is an alias for a 20-bit sensor that
+ provides a ``Read<uint32_t>`` interface, ``DemoSensorC`` would still
+ provide ``Read<uint16_t>`` and would include code to reduce the
+ precision of the aliased sensor.
+ 
+ 
  4.1 Compiler Interaction
  ------------------------
***************
*** 360,363 ****
--- 396,400 ----
  
  .. [TEP2] TEP 2: Hardware Abstraction Architecture
+ .. [TEP108] TEP 108: Resource Arbitration
  .. [TEP114] TEP 114: SIDs: Source and Sink Indepedent Drivers
  .. [TEP115] TEP 115: Power Management of Non-Virtualized Devices
***************
*** 863,864 ****
--- 900,939 ----
      }
    }
+ 
+ 4. MDA100 Sensor Board Directory Organization
+ ---------------------------------------------
+ 
+ Here we show the organization of the sensor board directory for the
+ mica-family Xbow MDA100CA and MDA100CB sensor boards, which have
+ temperature and light sensors. It is found in
+ ``tos/sensorboards/mda100``::
+ 
+   ./tos/sensorboards/mda100:
+   .sensor					# Compiler configuration
+   ArbitratedPhotoDeviceP.nc			# Light sensor support component
+   ArbitratedTempDeviceP.nc			# Temperature sensor support component
+   DemoSensorC.nc				# Override TinyOS's default sensor
+   PhotoC.nc					# Light sensor HIL
+   PhotoImplP.nc					# Light sensor support component
+   PhotoTempConfigC.nc				# Shared support component
+   PhotoTempConfigP.nc				# Shared support component
+   SharedAnalogDeviceC.nc			# Shared support component
+   SharedAnalogDeviceP.nc			# Shared support component
+   TempC.nc					# Temperature Sensor HIL
+   ca/TempImplP.nc				# Temperature sensor support component
+   						# (MDA100CA board)
+   cb/TempImplP.nc				# Temperature sensor support component
+   						# (MDA100CB board)
+   mda100.h					# Header file for mda100
+ 
+ This sensor board provides only a HIL (PhotoC and TempC components), and overrides the
+ TinyOS demo sensor (DemoSensorC). The demo sensor is an alias for PhotoC.
+ 
+ The two forms of the mda100 differ only by the wiring of the
+ temperature sensor.  The user has to specify which form of the sensor
+ board is in use by providing a ``-I%T/sensorboards/mda100/ca`` or
+ ``-I%T/sensorboards/mda100/cb`` compiler option.
+ 
+ This sensor board relies on a platform-provided ``MicaBusC`` component
+ that specifies how the mica-family sensor board bus is connected to
+ the microcontroller.