diff -r 913c9751c067 -r 716254ccbcc0 org.symbian.tools.wrttools.doc.WebDeveloper/html/GUID-FEB5D463-F6A1-44D9-9456-D95DE4BAED77.html --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/org.symbian.tools.wrttools.doc.WebDeveloper/html/GUID-FEB5D463-F6A1-44D9-9456-D95DE4BAED77.html Fri Mar 05 19:11:15 2010 -0800 @@ -0,0 +1,180 @@ + + +Sensor +channel information

Sensor +channel information

+

The Sensor Service API uses objects to represent sensor channels. One +object contains the information for one sensor channel (see the following +table). The Sensor Service API methods use these sensor channel objects as +follows:

+
    +
  • FindSensorChannel

    + +

    The ReturnValue property of the result object is +an iterator containing +the requested sensor channel information. Each item (object) in the iterator corresponds +to one sensor channel matching the search +criteria specified for the FindSensorChannel call.

    + +
  • +
  • RegisterForNotification

    + +

    The criteria.ChannelInfoMap property used +for input is a sensor channel object. It specifies the channel from which +the RegisterForNotification call registers to receive +data.

    + +
  • +
  • GetChannelProperty

    + +

    The criteria.ChannelInfoMap property used +for input is a sensor channel object. It specifies the channel of the property +about which the GetChannelProperty call retrieves information.

    + +
  • +
+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Table: Sensor channel +object properties
+

Property

+
+

Description

+
+

Type

+
+

Value

+
+

ChannelId

+
+

Specifies the inique identifier of the channel.

+
+

number

+
 
+

ContextType

+
+

Specifies the context in which the channel is available.

+
+

number

+
+

Possible values:

+
    +
  • 0 - Not defined

  • +
  • 1 - Ambient sensor, for example to measure +pressure

  • +
  • 2 - Provides information on the device

    +
  • +
  • 3 - Measures user-initiated stimulus

    +
  • +
+
+

Quantity

+
+

Specifies the quantity being sensed.

+
+

number

+
+

Possible values:

+
    +
  • 0 - Not defined

  • +
  • 10 - Acceleration

  • +
  • 11 - Tapping

  • +
  • 12 - Orientation

  • +
  • 13 - Rotation

  • +
  • 14 - Magnetic

  • +
  • 15 - Tilt

  • +
+
+

ChannelType

+
+

Specifies the type of the channel. This is the unique identifier of +the Sensor Subsystem (SSY) that provides data for this channel.

+

Each physical sensor registers to the S60 sensor framework as a Sensor +Subsystem that provides specific sensor data. If the physical sensor provides +multiple types of data, it can register a separate SSY for each type. For +example, a sensor that provides both orientation and rotation data can register +one SSY for orientation data and another for rotation data. ChannelType thus +identifies a particular SSY representing the channel.

+
+

number

+
 
+

Location

+
+

Specifies the location of the sensor related to the channel.

+
+

string

+
 
+

VendorId

+
+

Specifies the vendor ID of the sensor related to the channel.

+
+

string

+
 
+

DataItemSize

+
+

Specifies the data item size delivered in the channel.

+
+

number

+
 
+

ChannelDataTypeId

+
+

Specifies the unique data type identifier for the data being sensed.

+
+

number

+
 
\ No newline at end of file