Symbian3/SDK/Source/GUID-8B4CC1A0-1A39-4AF0-826B-8DDB9A837A27.dita
changeset 8 ae94777fff8f
parent 7 51a74ef9ed63
child 13 48780e181b38
equal deleted inserted replaced
7:51a74ef9ed63 8:ae94777fff8f
    13 Framework Overview</title><shortdesc>The Sensors Framework consists of a sensor server and channel based
    13 Framework Overview</title><shortdesc>The Sensors Framework consists of a sensor server and channel based
    14 client APIs for supporting an extensible set of sensor hardware. The sensor
    14 client APIs for supporting an extensible set of sensor hardware. The sensor
    15 server defines a plug-in interface for adding sensor plug-ins for any type
    15 server defines a plug-in interface for adding sensor plug-ins for any type
    16 of sensor hardware. The channel APIs enable client applications to interact
    16 of sensor hardware. The channel APIs enable client applications to interact
    17 with the sensor hardware.</shortdesc><prolog><metadata><keywords/></metadata></prolog><conbody>
    17 with the sensor hardware.</shortdesc><prolog><metadata><keywords/></metadata></prolog><conbody>
    18 <section id="GUID-AB7AB8C8-DEB2-445C-A216-1FE142592C7D-GENID-1-8-1-9-1-1-6-1-4-1-3-1-3-1"><title>Key Concepts
    18 <section id="GUID-AB7AB8C8-DEB2-445C-A216-1FE142592C7D-GENID-1-10-1-9-1-1-6-1-4-1-3-1-3-1"><title>Key Concepts
    19 and Terms</title><dl>
    19 and Terms</title><dl>
    20 <dlentry>
    20 <dlentry>
    21 <dt>Sensor Channel</dt>
    21 <dt>Sensor Channel</dt>
    22 <dd><p>The sensor channel forms a medium of interaction between the sensor
    22 <dd><p>The sensor channel forms a medium of interaction between the sensor
    23 hardware and client applications. </p><p>The data from one physical sensor
    23 hardware and client applications. </p><p>The data from one physical sensor
    54 <li><p>OR condition: An OR condition is met if a data value satisfies even
    54 <li><p>OR condition: An OR condition is met if a data value satisfies even
    55 one single condition in the set.</p></li>
    55 one single condition in the set.</p></li>
    56 </ul></p></dd>
    56 </ul></p></dd>
    57 </dlentry>
    57 </dlentry>
    58 </dl>           </section>
    58 </dl>           </section>
    59 <section id="GUID-AB7AB8C8-DEB2-445C-A216-1FE142592C7D-GENID-1-8-1-9-1-1-6-1-4-1-3-1-3-2"><title>Description</title><p>The
    59 <section id="GUID-AB7AB8C8-DEB2-445C-A216-1FE142592C7D-GENID-1-10-1-9-1-1-6-1-4-1-3-1-3-2"><title>Description</title><p>The
    60 sensor server provides a plug-in interface (Sensor Definitions APIs) that
    60 sensor server provides a plug-in interface (Sensor Definitions APIs) that
    61 enables platform developers to create sensor plug-ins for required sensors
    61 enables platform developers to create sensor plug-ins for required sensors
    62 hardware. The sensor plug-ins enable the interaction between a client application
    62 hardware. The sensor plug-ins enable the interaction between a client application
    63 and the sensor hardware through sensor channels. The Sensor Channel APIs provides
    63 and the sensor hardware through sensor channels. The Sensor Channel APIs provides
    64 access to each sensor channel.</p><p>One physical sensor can
    64 access to each sensor channel.</p><p>One physical sensor can
    69 sensor channel. The data definition can also define properties for each data
    69 sensor channel. The data definition can also define properties for each data
    70 item in the data package.</p><p>The sensor server facilitates the transfer
    70 item in the data package.</p><p>The sensor server facilitates the transfer
    71 of data from one sensor hardware to multiple clients simultaneously. It also
    71 of data from one sensor hardware to multiple clients simultaneously. It also
    72 resolves any contention between client applications for opening channels or
    72 resolves any contention between client applications for opening channels or
    73 configuring a sensor device.</p>           </section>
    73 configuring a sensor device.</p>           </section>
    74 <section id="GUID-AB7AB8C8-DEB2-445C-A216-1FE142592C7D-GENID-1-8-1-9-1-1-6-1-4-1-3-1-3-3">       <title>APIs</title> 
    74 <section id="GUID-AB7AB8C8-DEB2-445C-A216-1FE142592C7D-GENID-1-10-1-9-1-1-6-1-4-1-3-1-3-3">       <title>APIs</title> 
    75      <table id="GUID-4D61C176-6A42-4F06-96A2-950F6ACD1C25">
    75      <table id="GUID-4D61C176-6A42-4F06-96A2-950F6ACD1C25">
    76 <tgroup cols="2"><colspec colname="col1" colwidth="0.44*"/><colspec colname="col2" colwidth="1.56*"/>
    76 <tgroup cols="2"><colspec colname="col1" colwidth="0.44*"/><colspec colname="col2" colwidth="1.56*"/>
    77 <thead>
    77 <thead>
    78 <row>
    78 <row>
    79 <entry>API</entry>
    79 <entry>API</entry>
   123 the client when a channel property changes.</entry>
   123 the client when a channel property changes.</entry>
   124 </row>
   124 </row>
   125 </tbody>
   125 </tbody>
   126 </tgroup>
   126 </tgroup>
   127 </table>  <fig id="GUID-90C26AB4-F003-444C-B9AF-422BB816557C">
   127 </table>  <fig id="GUID-90C26AB4-F003-444C-B9AF-422BB816557C">
   128 <image href="GUID-600DCD27-ADC0-40D7-B061-1D44238363BA_d0e134835_href.png" placement="inline"/>
   128 <image href="GUID-600DCD27-ADC0-40D7-B061-1D44238363BA_d0e128297_href.png" placement="inline"/>
   129 </fig><p>A physical sensor can supply data to several sensor channels (<xref href="jar:GUID-759FBC7F-5384-4487-8457-A8D4B76F6AA6.jar!/html/classCSensrvChannel.html" format="application/java-archive"><codeph>CSensrvChannel</codeph></xref>)
   129 </fig><p>A physical sensor can supply data to several sensor channels (<xref href="jar:GUID-759FBC7F-5384-4487-8457-A8D4B76F6AA6.jar!/html/classCSensrvChannel.html" format="application/java-archive"><codeph>CSensrvChannel</codeph></xref>)
   130 . A sensor channel provides data to an application in a channel-specific data
   130 . A sensor channel provides data to an application in a channel-specific data
   131 format (for example, <xref href="jar:GUID-759FBC7F-5384-4487-8457-A8D4B76F6AA6.jar!/html/Sensor_definitions_APIClassesIndexPage.html" format="application/java-archive"><codeph>TSensrvXyzData</codeph></xref>) through a callback to the <xref href="jar:GUID-759FBC7F-5384-4487-8457-A8D4B76F6AA6.jar!/html/classMSensrvDataListener.html#7ddce5c72a9d429ddb9e69f9e3a0a9b6" format="application/java-archive"><codeph>MSensrvDataListener::DataReceived()</codeph></xref> interface. A
   131 format (for example, <xref href="jar:GUID-759FBC7F-5384-4487-8457-A8D4B76F6AA6.jar!/html/Sensor_definitions_APIClassesIndexPage.html" format="application/java-archive"><codeph>TSensrvXyzData</codeph></xref>) through a callback to the <xref href="jar:GUID-759FBC7F-5384-4487-8457-A8D4B76F6AA6.jar!/html/classMSensrvDataListener.html#7ddce5c72a9d429ddb9e69f9e3a0a9b6" format="application/java-archive"><codeph>MSensrvDataListener::DataReceived()</codeph></xref> interface. A
   132 sensor channel has a single channel info item (<xref href="jar:GUID-759FBC7F-5384-4487-8457-A8D4B76F6AA6.jar!/html/classTSensrvChannelInfo.html" format="application/java-archive"><codeph>TSensrvChannelInfo</codeph></xref>) that describes the channel in general. A sensor channel has multiple
   132 sensor channel has a single channel info item (<xref href="jar:GUID-759FBC7F-5384-4487-8457-A8D4B76F6AA6.jar!/html/classTSensrvChannelInfo.html" format="application/java-archive"><codeph>TSensrvChannelInfo</codeph></xref>) that describes the channel in general. A sensor channel has multiple
   133 property items (<xref href="jar:GUID-759FBC7F-5384-4487-8457-A8D4B76F6AA6.jar!/html/classTSensrvProperty.html" format="application/java-archive"><codeph>TSensrvProperty</codeph></xref>)
   133 property items (<xref href="jar:GUID-759FBC7F-5384-4487-8457-A8D4B76F6AA6.jar!/html/classTSensrvProperty.html" format="application/java-archive"><codeph>TSensrvProperty</codeph></xref>)