eeze/doc: Be a bit more verbose in the entry section of eeze_sensor

SVN revision: 80244
This commit is contained in:
Stefan Schmidt 2012-12-05 13:42:37 +00:00
parent 545057d0b1
commit ac6cadd8dc
1 changed files with 16 additions and 5 deletions

View File

@ -19,16 +19,27 @@
/**
* @file Eeze_Sensor.h
* @brief Sensor information
* @brief Sensor information subsystem
*
* Eeze sensor functions allow you to gather sensor information from different
* sensor sources available on the hardware. It supports a plugin architecture
* sensor sources available on your hardware. It supports a plugin architecture
* to support different hardware platforms and devices. These plugins can be
* loaded at runtime to allow support for a specific set of hardware or
* platform.
* loaded at runtime.
*
* Right now we have support for the Tizen sensor framework as well as a simple
* fake plugin to be used as a test harness for developing.
* fake plugin to be used as a test harness for development. Plugins for other
* sensor frameworks or platforms are always welcome.
*
* Synchronous as well as asynchronous reads are possible. As reading the
* physical sensor might be bound to a high latency and thus cost the value of
* the last read is cached within Eeze_Sensor together with a timestamp of the
* actual read out. This can speed up the value access for application while the
* values are still getting updating asynchronously in the background. The
* timestamp should be checked if the specific time requirements are needed.
*
* As an alternative the sensor could be read synchronously. With the
* disadvantage that the function call will block until the data is read from
* the sensor.
*
* @since 1.8
*