diff -r 913c9751c067 -r 716254ccbcc0 org.symbian.tools.wrttools.doc.WebDeveloper/html/GUID-4C79E511-1C1A-475D-BBBB-4F1F6D406340.html --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/org.symbian.tools.wrttools.doc.WebDeveloper/html/GUID-4C79E511-1C1A-475D-BBBB-4F1F6D406340.html Fri Mar 05 19:11:15 2010 -0800 @@ -0,0 +1,787 @@ + + +System +data types

System +data types

+

System data types determine what kind of values system attributes are +associated with. In JavaScript terms, the specified data type +determines the SystemData (input) and ReturnValue (output) +object properties that represent the value of a system attribute. Depending +on the system data type, there can be one or more properties. Depending on +the system attribute, the data type used for method input may differ from +the data type used for method output.

+

+

The SystemInfo +Service API supports the following system data types:

+ +

The following tables describes the supported system data types. To find +out which system attribute uses which system data type, and whether the same +data type is used for both input and output, see section Supported system attributes (entities and keys).

+
+ + + + + + + + + + + +
Table: Status
+

Property

+
+

Description

+
+

Type

+
+

Value

+
+

Status

+
+

Specifies status information about the system attribute.

+
+

number

+
+

For example:

+
    +
  • Battery strength (%): 1 - 100

    +
  • +
  • Network mode: 0 - 2

  • +
+
+ + + + + + + + + + + +
Table: StringData
+

Property

+
+

Description

+
+

Type

+
+

Value

+
+

StringData

+
+

Specifies information about the system attribute in text string format.

+

This can be used to indicate wallpaper path, IMEI number, phone model, +manufacturer, and so forth.

+
+

string

+
+

For example:

+
    +
  • Phone model: "N70"

  • +
  • Manufacturer: "Nokia"

  • +
  • Wallpaper path: "C://Data//Others//wallpaper.jpeg"

    +
  • +
+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Table: NetworkInfo
+

Property

+
+

Description

+
+

Type

+
+

Value

+
+

NetworkName

+
+

Specifies the name of the network connection of the device.

+
+

string

+
 
+

NetworkStatus

+
+

Specifies the status of the network.

+
+

number

+
+

Possible values:

+
    +
  • -1 - Unknown

  • +
  • 0 - Available: Specifies the network +ME can register

  • +
  • 1 - Current: Specifies the currently +registered network

  • +
  • 2 - Forbidden: Specifies that the network +ME is not allowed registering

  • +
+
+

NetworkMode

+
+

Specifies the network technology used by the network.

+
+

number

+
+

Possible values:

+
    +
  • -1 - Unknown

  • +
  • 0 - Unregistered

  • +
  • 1 - Global System for Mobile Communications +(GSM)

  • +
  • 2 - Advanced Mobile Phone System (AMPS)

    +
  • +
  • 3 - Code Division Multiple Access (CDMA95)

    +
  • +
  • 4 - Code Division Multiple Access (CDMA2000)

    +
  • +
  • 5 - Wideband Code Division Multiple +Access (WCDMA)

  • +
  • 6 - Time Division, Code Division Multiple +Access (TDCDMA)

  • +
+
+

CountryCode

+
+

Specifies the Mobile Country Code (MCC).

+
+

string

+
 
+

NetworkCode

+
+

Specifies the Mobile Network Code (MNC).

+
+

string

+
 
+

LocationStatus

+
+

Specifies whether the location area information is valid or not.

+
+

boolean

+
+

Possible values:

+
    +
  • true - Location Area Code (LAC) and +cell ID are valid

  • +
  • false - Location Area Code (LAC) and +cell ID are invalid

  • +
+
+

AreaCode

+
+

Specifies Location Area Code (LAC).

+
+

number

+
 
+

CellId

+
+

Specifies the cell ID.

+
+

number

+
 
+ + + + + + + + + + + +
Table: ConnectionList
+

Property

+
+

Description

+
+

Type

+
+

Value

+
+

ConnectionList

+
+

Specifies a list of available active data connections.

+

ConnectionInfo specifies +a data connection.

+
+

iterator

+
+

List of ConnectionInfo objects

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Table: ConnectionInfo
+

Property

+
+

Description

+
+

Type

+
+

Value

+
+

ConnectionStatus

+
+

Specifies the status of the data connection.

+
+

number

+
+

Possible values:

+
    +
  • 0 - Disconnected

  • +
  • 1 - Connected

  • +
+
+

IAPID

+
+

Specifies the access point ID for the data connection.

+
+

number

+
 
+

ConnectionType

+
+

Specifies the type of the data connection.

+
+

number

+
+

Possible values:

+

Note: Unsupported connection types are enclosed in brackets.

+
+
    +
  • -1 - Unknown

  • +
  • 0 - (Circuit Switched Data (CSD))

    +
  • +
  • 1 - (Wideband Code Division Multiple +Access (WCDMA))

  • +
  • 2 - Local Area Network (LAN) [Emulator]

    +
  • +
  • 3 - (Code Division Multiple Access (CDMA2000))

    +
  • +
  • 4 - (General Packet Radio Service (GPRS))

    +
  • +
  • 5 - (High Speed Circuit Switched Data +(HSCSD))

  • +
  • 6 - Enhanced Data rates for Global Evolution +(EDGE), Enhanced GPRS (EGPRS)

  • +
  • 7 - Wireless Local Area Network (WLAN)

    +
  • +
  • 8 - (Bluetooth)

  • +
  • 9 - (Virtual VPN)

  • +
+
+

IAPName

+
+

Specifies the access point name.

+
+

string

+
+

For example: "www.airtelgprs.com"

+
+

NetworkName

+
+

Specifies the network name applicable for WLAN networks.

+
+

string

+
 
+

IAPConnectionName

+
+

Specifies the access point connection name.

+
+

string

+
+

For example: "MobileOffice", "MyGprs"

+
+ + + + + + + + + + + +
Table: AccessoryList
+

Property

+
+

Description

+
+

Type

+
+

Value

+
+

AccessoryList

+
+

Specifies a list of connected accessories.

+

AccessoryInfo specifies +an accessory.

+
+

iterator

+
+

List of AccessoryInfo objects

+
+ + + + + + + + + + + + + + + + + +
Table: AccessoryInfo
+

Property

+
+

Description

+
+

Type

+
+

Value

+
+

AccessoryType

+
+

Specifies the type of the accessory.

+
+

number

+
+

Possible values:

+
    +
  • -1 - Unknown

  • +
  • 0 - HeadSet

  • +
  • 1 - BTHeadSet

  • +
  • 2 - CarKit

  • +
  • 3 - BTCarKit

  • +
+
+

AccessoryState

+
+

Specifies the connection state of the accessory.

+
+

number

+
+

Possible values:

+
    +
  • -1 - Unknown

  • +
  • 0 - Disconnected

  • +
  • 1 - Connected

  • +
+
+ + + + + + + + + + + +
Table: LanguageList
+

Property

+
+

Description

+
+

Type

+
+

Value

+
+

LanguageList

+
+

Specifies a list of supported language enumerations as defined in the +S60 device.

+
+

array of numbers

+
 
+ + + + + + + + + + + + + + + + + +
Table: Version
+

Property

+
+

Description

+
+

Type

+
+

Value

+
+

MajorVersion

+
+

Specifies the major version number of the software in the device.

+
+

string

+
+

For example:

+
    +
  • S60 3rd Edition, Feature Pack 2 ("3.2"): 3

    +
  • +
+
+

MinorVersion

+
+

Specifies the minor version number of the software in the device.

+
+

strings

+
+

For example:

+
    +
  • S60 3rd Edition, Feature Pack 2 ("3.2"): 2

    +
  • +
+
+ + + + + + + + + + + +
Table: DriveList
+

Property

+
+

Description

+
+

Type

+
+

Value

+
+

DriveList

+
+

Specifies a list of drives in the device.

+

DriveInfo specifies +information about a drive.

+
+

array of strings

+
+

For example:

+
    +
  • DriveList[0]: "C:\\"

    +
  • +
  • DriveList[1]: "D:\\"

    +
  • +
+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Table: DriveInfo
+

Property

+
+

Description

+
+

Type

+
+

Value

+
+

Drive

+
+

Specifies the drive.

+
+

string

+
+

For example: "C:\\"

+
+

TotalSpace

+
+

Specifies the total memory space in bytes.

+
+

string

+
 
+

FreeSpace

+
+

Specifies the available free memory space in bytes.

+
+

string

+
 
+

CriticalSpace

+
+

Specifies the critical free memory space in bytes.

+
+

number

+
 
+

MediaType

+
+

Specifies the media type of the drive.

+
+

number

+
+

Possible values:

+
    +
  • 0 - MediaNotPresent

  • +
  • 1 - MediaUnknown

  • +
  • 2 - MediaFloppyDisk

  • +
  • 3 - MediaHardDisk

  • +
  • 4 - MediaCdRom

  • +
  • 5 - MediaRam

  • +
  • 6 - MediaFlash

  • +
  • 7 - MediaRom

  • +
  • 8 - MediaRemote

  • +
  • 9 - MediaNANDFlash

  • +
  • 10 - MediaRotatingMedia

  • +
+
+

BatteryState

+
+

Specifies the state of the drive's own battery unit, if any.

+
+

number

+
+

Possible values:

+
    +
  • 0 - BatNotSupported

  • +
  • 1 - BatGood

  • +
  • 2 - BatLow

  • +
+
+

DriveName

+
+

Specifies the drive name.

+
+

string

+
 
+ + + + + + + + + + + + + + + + + +
Table: Resolution
+

Property

+
+

Description

+
+

Type

+
+

Value

+
+

XPixels

+
+

Specifies the screen resolution of x-pixels.

+
+

number

+
 
+

YPixels

+
+

Specifies the screen resolution of y-pixels.

+
+

number

+
 
+ + + + + + + + + + + +
Table: StringList
+

Property

+
+

Description

+
+

Type

+
+

Value

+
+

StringList

+
+

Specifies a list of the available USB modes.

+
+

array of strings

+
 
\ No newline at end of file