SystemInfo API

This specification defines interfaces and methods that provide web applications with access to various properties of a system.

This API also provides interfaces and methods that can retrieve statuses of hardware devices, get the value of selected properties, and subscribe to asynchronous notifications of changes for selected values.

Web applications can use this API to access the following system properties:

  • BATTERY
  • BUILD
  • CAMERA_FLASH (Since: 2.4)
  • CELLULAR_NETWORK
  • CPU
  • DEVICE_ORIENTATION
  • DISPLAY
  • ETHERNET_NETWORK (Since: 2.4)
  • LOCALE (Since: 2.1)
  • MEMORY (Since: 2.3)
  • NETWORK
  • PERIPHERAL (Since: 2.1)
  • SIM
  • STORAGE
  • NET_PROXY_NETWORK (Since: 3.0)
  • VIDEOSOURCE (Since: 2.3)
  • WIFI_NETWORK
  • ADS (Since: 3.0)

Not all above properties may be available on every Tizen device. For instance, a device may not support the telephony feature. In that case, CELLULAR_NETWORK and SIM are not available.

To check the available SystemInfoPropertyId, tizen.systeminfo.getCapability() can be used.

For more information on the SystemInfo features, see System Information Guide.

Since: 1.0

Table of Contents

Summary of Interfaces and Methods

Interface Method
SystemInfoObject  
SystemInfo
long long getTotalMemory ()
long long getAvailableMemory ()
SystemInfoDeviceCapability getCapabilities ()
any getCapability (DOMString key)
void getPropertyValue (SystemInfoPropertyId property, SystemInfoPropertySuccessCallback successCallback, optional ErrorCallback? errorCallback)
unsigned long addPropertyValueChangeListener (SystemInfoPropertyId property, SystemInfoPropertySuccessCallback successCallback, optional SystemInfoOptions? options, optional ErrorCallback? errorCallback)
unsigned long addPropertyValueArrayChangeListener (SystemInfoPropertyId property, SystemInfoPropertyArraySuccessCallback successCallback, optional SystemInfoOptions? options, optional ErrorCallback? errorCallback)
void removePropertyValueChangeListener (unsigned long listenerId)
SystemInfoDeviceCapability  
SystemInfoOptions  
SystemInfoPropertySuccessCallback
SystemInfoPropertyArraySuccessCallback
void onsuccess (SystemInfoProperty[] properties)
SystemInfoProperty  
SystemInfoBattery  
SystemInfoCpu  
SystemInfoStorage  
SystemInfoStorageUnit  
SystemInfoDisplay  
SystemInfoDeviceOrientation  
SystemInfoBuild  
SystemInfoLocale  
SystemInfoNetwork  
SystemInfoWifiNetwork  
SystemInfoEthernetNetwork  
SystemInfoCellularNetwork  
SystemInfoNetProxyNetwork  
SystemInfoSIM  
SystemInfoPeripheral  
SystemInfoMemory  
SystemInfoVideoSourceInfo  
SystemInfoVideoSource  
SystemInfoCameraFlash
void setBrightness (double brightness)
SystemInfoADS  

1 Type Definitions

1.1 SystemInfoPropertyId

The device property identifier.
  enum SystemInfoPropertyId { "BATTERY", "CPU", "STORAGE", "DISPLAY", "DEVICE_ORIENTATION", "BUILD", "LOCALE", "NETWORK", "WIFI_NETWORK",
                               "ETHERNET_NETWORK", "CELLULAR_NETWORK", "NET_PROXY_NETWORK", "SIM", "PERIPHERAL", "MEMORY", "VIDEOSOURCE", "CAMERA_FLASH", "ADS" };

Since: 2.0

Remark : CAMERA_FLASH is supported since Tizen 2.4

Remark : ETHERNET_NETWORK is supported since Tizen 2.4

Remark : LOCALE and PERIPHERAL are supported since Tizen 2.1

Remark : MEMORY is supported since Tizen 2.3

Remark : NET_PROXY_NETWORK is supported since Tizen 3.0

Remark : VIDEOSOURCE is supported since Tizen 2.3

Remark : ADS is supported since Tizen 3.0

1.2 SystemInfoNetworkType

Data Network Type.
  enum SystemInfoNetworkType { "NONE", "2G", "2.5G", "3G", "4G", "WIFI", "ETHERNET", "NET_PROXY", "UNKNOWN" };

Since: 2.0

Remark : NET_PROXY is supported since Tizen 3.0

1.3 SystemInfoWifiSecurityMode

Wifi Security Mode.
  enum SystemInfoWifiSecurityMode { "NONE", "WEP", "WPA_PSK", "WPA2_PSK", "EAP" };

Since: 2.4

  • NONE - Open security type
  • WEP - Wired Equivalent Privacy
  • WPA_PSK - Wi-Fi Protected Access with Pre-Shared Key (PSK)
  • WPA2_PSK - Wi-Fi Protected Access version 2 with Pre-Shared Key (PSK)
  • EAP - Extensible Authentication Protocol

1.4 SystemInfoWifiEncryptionType

Wifi Encryption Type.
  enum SystemInfoWifiEncryptionType { "NONE", "WEP", "TKIP", "AES", "TKIP_AES_MIXED" };

Since: 2.4

  • NONE - No encryption
  • WEP - Wired Equivalent Privacy encryption
  • TKIP - Temporal Key Integrity Protocol encryption
  • AES - Advanced Encryption Standard
  • TKIP_AES_MIXED - TKIP and AES are both supported

1.5 SystemInfoNetworkIpMode

IP configuration types.
  enum SystemInfoNetworkIpMode { "NONE", "STATIC", "DYNAMIC", "AUTO", "FIXED" };

Since: 2.4

  • NONE - Default value when network connection is not available
  • STATIC - Manual IP configuration
  • DYNAMIC - Configured IP using DHCP client
  • AUTO - Configured IP from Auto IP pool (169.254/16). Later with DHCP client, if available
  • FIXED - IP cannot be modified

1.6 SystemInfoDeviceOrientationStatus

Device Orientation Status.
  enum SystemInfoDeviceOrientationStatus { "PORTRAIT_PRIMARY", "PORTRAIT_SECONDARY", "LANDSCAPE_PRIMARY", "LANDSCAPE_SECONDARY" };

Since: 2.0

SystemInfo reports the orientation of the device depending on the type of the device and physical position of the device relative to vertical direction. A "phone type device" is a device for which the portrait position is the natural orientation. A "tab type device" is a device for which the landscape position is basic working orientation.

SystemInfoDeviceOrientationStatus phone type device tablet type device
PORTRAIT_PRIMARY natural position rotated 90 degrees right (clockwise)
PORTRAIT_SECONDARY upside down, in other words rotated 180 degrees rotated 90 degrees left (anticlockwise)
LANDSCAPE_PRIMARY rotated 90 degrees left (anticlockwise) natural position
LANDSCAPE_SECONDARY rotated 90 degrees right (clockwise) upside down, in other words rotated 180 degrees

1.7 SystemInfoSimState

Sim State.
  enum SystemInfoSimState { "ABSENT", "INITIALIZING", "READY", "PIN_REQUIRED", "PUK_REQUIRED", "NETWORK_LOCKED", "SIM_LOCKED", "UNKNOWN" };

Since: 2.1

1.8 SystemInfoProfile

Device Profile.

Deprecated. "MOBILE_FULL" and "MOBILE_WEB" are deprecated since Tizen 2.3 and will be removed in Tizen 3.0.
Beginning with Tizen 2.3, "MOBILE" is returned instead of "MOBILE_FULL".

  enum SystemInfoProfile { "MOBILE_FULL", "MOBILE_WEB", "MOBILE", "WEARABLE", "TV" };

Since: 2.2

Remark : "MOBILE" and "WEARABLE" are supported since Tizen 2.3

Remark : TV is supported since Tizen 2.3.

1.9 SystemInfoLowMemoryStatus

The low memory state of a device.
  enum SystemInfoLowMemoryStatus { "NORMAL", "WARNING" };

Since: 2.3

  • NORMAL - indicating the remaining memory is sufficient for an application to run
  • WARNING - indicating the remaining memory is insufficient. Low memory warnings may happen differently according to the system.

1.10 SystemInfoVideoSourceType

An enumerator to indicate the type of video source
  enum SystemInfoVideoSourceType {
      "TV",
      "AV",
      "SVIDEO",
      "COMP",
      "PC",
      "HDMI",
      "SCART",
      "DVI",
      "MEDIA"
  };

Since: 2.3

  • TV - The input source from TV
  • AV - The input source from Component video, three cables, each with RCA plugs (3 or more channels)
  • SVIDEO - S-Video(Super-Video) and Y/C (2 channels)
  • COMP - The input source from Composite video (1 channel)
  • PC - The input source from personal computer (15-pin VGA connector)
  • HDMI - The input source from HDMI(High-Definition Multimedia Interface)
  • SCART - The input source from SCART(21-pin connector)
  • DVI - The input source from DVI(Digital Visual Interface)
  • MEDIA - The input source from media

2 Interfaces

2.1 SystemInfoObject

Defines what is instantiated by Tizen object from Tizen Platform.
  [NoInterfaceObject] interface SystemInfoObject {
    readonly attribute SystemInfo systeminfo;
  };
  Tizen implements SystemInfoObject;

Since: 1.0

There will be a tizen.systeminfo object that allows accessing the functionality of the SystemInfo API.

2.2 SystemInfo

This entry interface queries the information of a system.
  [NoInterfaceObject] interface SystemInfo {
    long long getTotalMemory() raises(WebAPIException);

    long long getAvailableMemory() raises(WebAPIException);

    SystemInfoDeviceCapability getCapabilities() raises(WebAPIException);

    any getCapability(DOMString key) raises(WebAPIException);

    long getCount(SystemInfoPropertyId property) raises(WebAPIException);

    void getPropertyValue(SystemInfoPropertyId property,
                          SystemInfoPropertySuccessCallback successCallback,
                          optional ErrorCallback? errorCallback) raises(WebAPIException);

    void getPropertyValueArray(SystemInfoPropertyId property,
                          SystemInfoPropertyArraySuccessCallback successCallback,
                          optional ErrorCallback? errorCallback) raises(WebAPIException);

    unsigned long addPropertyValueChangeListener(SystemInfoPropertyId property,
                                        SystemInfoPropertySuccessCallback successCallback,
                                        optional SystemInfoOptions? options,
                                        optional ErrorCallback? errorCallback) raises(WebAPIException);

    unsigned long addPropertyValueArrayChangeListener(SystemInfoPropertyId property,
                                        SystemInfoPropertyArraySuccessCallback successCallback,
                                        optional SystemInfoOptions? options,
                                        optional ErrorCallback? errorCallback) raises(WebAPIException);

    void removePropertyValueChangeListener(unsigned long listenerId) raises(WebAPIException);
  };

This API offers methods for retrieving system information and for subscribing notifications of system information changes.

Methods

getTotalMemory
Gets the total amount of system memory (in bytes).
long long getTotalMemory();

Since: 2.3

Exceptions:

  • WebAPIException

    • with error type UnknownError in any error case.

Code example:

 // To get total amount of system memory
 console.log("The total memory size is " + tizen.systeminfo.getTotalMemory() + " bytes.");
getAvailableMemory
Gets the amount of memory that is not in use (in bytes).
long long getAvailableMemory();

Since: 2.3

Exceptions:

  • WebAPIException

    • with error type UnknownError in any error case

Code example:

 // To get total amount of system memory
 console.log("The available memory size is " + tizen.systeminfo.getAvailableMemory() + " bytes.");
getCapabilities
Gets the capabilities of the device.

Deprecated. Deprecated since 2.3. Instead, use getCapability().

SystemInfoDeviceCapability getCapabilities();

Since: 2.0

The function must synchronously acquire the capabilities of the device.

Exceptions:

  • WebAPIException

    • with error type UnknownError in any error case.

Code example:

 var deviceCapabilities;
 deviceCapabilities = tizen.systeminfo.getCapabilities();
 if (deviceCapabilities.bluetooth) {
     console.log("Bluetooth is supported");
 }
getCapability
Gets a device capability related to a given key.
any getCapability(DOMString key);

Since: 2.3

See the available device capability keys. The additional keys for the custom device capability are specified by OEM's and vendors.

Parameters:

  • key: The device capability key for the device or additional custom device capability key specifies by OEM's

Return value:

any The value of the specified device capability

Exceptions:

  • WebAPIException

    • with error type UnknownError in any other error case.

Code example:

 try {
     // Checks if a device supports bluetooth API or not
     var bluetooth = tizen.systeminfo.getCapability("http://tizen.org/feature/network.bluetooth");
     console.log(" Bluetooth = " + bluetooth);
 } catch (error) {
     console.log("Error name: " + error.name + ", message: " + error.message);
 }
getCount
Gets the number of system property information provided for a particular system property.
long getCount(SystemInfoPropertyId property);

Since: 2.3

That is the length of array retrieved by the getPropertyValueArray() method for the given property.

Parameters:

  • property: The name of the system property

Return value:

long The number of property values for the given property. If the property is not supported, 0 is returned.

Exceptions:

  • WebAPIException

    • with error type TypeMismatchError, if the input parameter is not compatible with the expected type.

Code example:

 var count = tizen.systeminfo.getCount("SIM");
 if (count === 0) {
     console.log("There is no available SIM card.");
 } else {
     console.log("There is(are) " + count + " SIM card(s) available.");
 }
getPropertyValue
Gets the current value of a specified system property.
void getPropertyValue(SystemInfoPropertyId property, SystemInfoPropertySuccessCallback successCallback, optional ErrorCallback? errorCallback);

Since: 1.0

The function must asynchronously acquire the current value of the requested property. If it is successful, the successCallback must be invoked with an object containing the information provided by the property.

The ErrorCallback method can be launched with these error types:

  • NotSupportedError - If the given property is not supported. (since Tizen 2.3)
 

Remark : If the given property is not supported, NotSupportedError would be passed through a ErrorCallback() since Tizen 2.3.

Remark : If system provides more than one value for the system property, the primary(first) system property is returned through SystemInfoSuccessCallback.

Parameters:

  • property: The name of the property to retrieve.

  • successCallback: Function called when the properties have been successfully retrieved.
  • errorCallback [optional] [nullable]: Function called when an error occurred while retrieving the properties.

Exceptions:

  • WebAPIException

    • with error type TypeMismatchError, if the input parameter is not compatible with the expected type.

    • with error type UnknownError in any other error case.

    • with error type SecurityError, this error is only thrown for CELLULAR_NETWORK property when an application does not declare http://tizen.org/privilege/telephony privilege in config.xml.

Code example:

 function onSuccessCallback(cpu) {
     console.log("The cpu load is " + cpu.load);
 }

 function onErrorCallback(error) {
     console.log("An error occurred " + error.message);
 }

 tizen.systeminfo.getPropertyValue("CPU", onSuccessCallback, onErrorCallback);

Code example:

 function onSuccessCallback(cellular) {
     console.log("The status of the cellular network is " + cellular.status);
 }

 function onErrorCallback(error) {
     console.log("An error occurred " + error.message);
     // if telephony_capability is false but getPropertyValue("CELLULAR_NETWORK, ..) is called, NotSupportedError would be passed.
 }

 var telephony_capability = tizen.systeminfo.getCapability("http://tizen.org/feature/network.telephony");

 if (telephony_capability === true) {
     // onSuccessCallback will be invoked.
     tizen.systeminfo.getPropertyValue("CELLULAR_NETWORK", onSuccessCallback, onErrorCallback);
 } else {
     console.log("Telephony feature is not supported. Cellular network related information cannot be retrieved.");
 }
getPropertyValueArray
Gets the current values of a specified system property.
void getPropertyValueArray(SystemInfoPropertyId property, SystemInfoPropertyArraySuccessCallback successCallback, optional ErrorCallback? errorCallback);

Since: 2.3

It is recommended that you check if a device provides one or more than one value for a particular system property via getCount().

If one particular system property is provided on a device, it returns an array containing one SystemInfoProperty object through SystemInfoPropertyArraySuccessCallback method.
If more than one particular system property is provided, multiple SystemInfoProperty objects are returned.

The ErrorCallback method can be launched with these error types:

  • NotSupportedError - If the given property is not supported.
 

Remark : see getCount().

Parameters:

  • property: The name of the property to retrieve.

  • successCallback: Callback method that is invoked when the properties have been successfully retrieved.
  • errorCallback [optional] [nullable]: Callback method that is invoked when an error occurs while retrieving the properties.

Exceptions:

  • WebAPIException

    • with error type TypeMismatchError, if the input parameter is not compatible with the expected type.

    • with error type SecurityError, this error is only thrown for CELLULAR_NETWORK property when an application does not declare http://tizen.org/privilege/telephony privilege in config.xml.

Code example:

 function successCB(property) {
     console.log("The SIM's current state is " + property.state);
 }

 function successArrayCB(properties) {
     console.log("The number of the returned system properties is " + properties.length);
     for (var i = 0; i < properties.length; i++) {
         console.log("[" + i + "] SIM's state is " + properties[i].state);
     }
 }

 var count = tizen.systeminfo.getCount("SIM");
 if (count === 0) {
     console.log("This device does not provide SIM card.");
 } else if (count > 1) {
     tizen.systeminfo.getPropertyValueArray("SIM", successArrayCB);
 } else {
     tizen.systeminfo.getPropertyValue("SIM", successCB);
 }
addPropertyValueChangeListener
Adds a listener to allow tracking of changes in one or more system properties.
unsigned long addPropertyValueChangeListener(SystemInfoPropertyId property, SystemInfoPropertySuccessCallback successCallback, optional SystemInfoOptions? options, optional ErrorCallback? errorCallback);

Since: 1.0

When called, it immediately returns and then asynchronously starts a watch process defined by the following steps:

1. Register the successCallback to receive system events that the status of the requested properties may have changed.

2. When a system event is successfully received invoke the associated successCallback with an object containing the property values.

3. Repeat step 2 until removePropertyValueChangeListener function is called.

There are device properties which are never changed (e.g. "BUILD") and properties which are not changed on some devices (e.g. "DEVICE_ORIENTATION" in Tizen TV device). The addPropertyValueChangeListener() method accepts any identifier of these properties, but the listener added for them will not be invoked.

The errorCallback can be launched with any of these error types:

  • NotSupportedError - If the given property is not supported. (since Tizen 2.3)
    For example, monitoring CELLULAR_NETWORK changes is not supported on a device which does not support the telephony feature.
 

Remark : The errorCallback() is newly added as an optional parameter since Tizen 2.3.

Parameters:

  • property: The name of the property to retrieve.

  • successCallback: Function called when the properties have been successfully retrieved.
  • options [optional] [nullable]: An object containing the various options for fetching the properties requested. See details.
  • errorCallback [optional] [nullable]: Function called when an error occurred.

Return value:

unsigned long An identifier used to clear the watch subscription.

Exceptions:

  • WebAPIException

    • with error type TypeMismatchError, if the input parameter is not compatible with the expected type.

    • with error type InvalidValuesError, if any of the input parameters contain an invalid value (e.g. the invalid value for options).

    • with error type UnknownError in any other error case.

    • with error type SecurityError, this error is only thrown for CELLULAR_NETWORK property when an application does not declare http://tizen.org/privilege/telephony privilege in config.xml.

Code example:

 function onSuccessCallback(cpu) {
     console.log("The cpu load : " + cpu.load);
 }

 tizen.systeminfo.addPropertyValueChangeListener("CPU", onSuccessCallback, {lowThreshold : 0.2});
addPropertyValueArrayChangeListener
Adds a listener to allow tracking of changes in one or more values of a system property.
unsigned long addPropertyValueArrayChangeListener(SystemInfoPropertyId property, SystemInfoPropertyArraySuccessCallback successCallback, optional SystemInfoOptions? options, optional ErrorCallback? errorCallback);

Since: 2.3

The ErrorCallback method can be launched with these error types:

  • NotSupportedError - If the given property is not supported. (since Tizen 2.3)
    For example, monitoring CELLULAR_NETWORK changes is not supported on a device which does not support the telephony feature.

There are device properties which never change (for example "BUILD") and properties which do not change on the current platform (for example "DEVICE_ORIENTATION" for some platforms). The addPropertyValueChangeListener() method accepts any identifier of these properties, but the listener added for them will not be invoked.

 

Parameters:

  • property: The name of the property to retrieve.

  • successCallback: Function called when the properties have been successfully retrieved.
  • options [optional] [nullable]: An object containing the various options for fetching the properties requested.
  • errorCallback [optional] [nullable]: Function called when an error occurred.

Return value:

unsigned long An identifier used to clear the watch subscription.

Exceptions:

  • WebAPIException

    • with error type TypeMismatchError, if the input parameter is not compatible with the expected type.

    • with error type InvalidValuesError, if any of the input parameters contain an invalid value (e.g. the invalid value for options).

    • with error type UnknownError in any other error case.

    • with error type SecurityError, this error is only thrown for CELLULAR_NETWORK property when an application does not declare http://tizen.org/privilege/telephony privilege in config.xml.

removePropertyValueChangeListener
Unsubscribes notifications for property changes.
void removePropertyValueChangeListener(unsigned long listenerId);

Since: 1.0

If a valid listenerId argument is passed that corresponds to a subscription already place, then the watch process MUST immediately terminate and no further callback is invoked. If the listenerId argument does not correspond to a valid subscription, the method should return without any further action.

Parameters:

  • listenerId: An identifier of the subscription returned by the addPropertyValueChangeListener()/addPropertyValueArrayChangeListener() method.

Exceptions:

  • WebAPIException

    • with error type TypeMismatchError, if the input parameter is not compatible with the expected type.

    • with error type InvalidValuesError, if any of the input parameters contain an invalid value.

    • with error type UnknownError in any other error case.

Code example:

 var id = null;
 function onSuccessCallback(cpu) {
    console.log("New value for CPU load is " + cpu.load);
    if (id != null) { // After receiving the first notification, we clear it
        tizen.systeminfo.removePropertyValueChangeListener(id);
    }
 }

 id = tizen.systeminfo.addPropertyValueChangeListener("CPU", onSuccessCallback);

2.3 SystemInfoDeviceCapability

SystemInfoDeviceCapability object.

Deprecated. SystemInfoDeviceCapability is deprecated since Tizen 2.3 and will be removed in Tizen 3.0. It is recommended to use the getCapability() method (since Tizen 2.3) instead to query device capabilities.

  [NoInterfaceObject] interface SystemInfoDeviceCapability {
    readonly attribute boolean bluetooth;

    readonly attribute boolean nfc;

    readonly attribute boolean nfcReservedPush ;

    readonly attribute unsigned short multiTouchCount;

    readonly attribute boolean inputKeyboard;

    readonly attribute boolean inputKeyboardLayout;

    readonly attribute boolean wifi;

    readonly attribute boolean wifiDirect;

    readonly attribute boolean opengles;

    readonly attribute DOMString openglestextureFormat;

    readonly attribute boolean openglesVersion1_1;

    readonly attribute boolean openglesVersion2_0;

    readonly attribute boolean fmRadio;

    readonly attribute DOMString platformVersion raises(WebAPIException);

    readonly attribute DOMString webApiVersion raises(WebAPIException);

    readonly attribute DOMString nativeApiVersion raises(WebAPIException);

    readonly attribute DOMString platformName;

    readonly attribute boolean camera;

    readonly attribute boolean cameraFront;

    readonly attribute boolean cameraFrontFlash;

    readonly attribute boolean cameraBack;

    readonly attribute boolean cameraBackFlash;

    readonly attribute boolean location;

    readonly attribute boolean locationGps;

    readonly attribute boolean locationWps;

    readonly attribute boolean microphone;

    readonly attribute boolean usbHost;

    readonly attribute boolean usbAccessory;

    readonly attribute boolean screenOutputRca;

    readonly attribute boolean screenOutputHdmi;

    readonly attribute DOMString platformCoreCpuArch;

    readonly attribute DOMString platformCoreFpuArch;

    readonly attribute boolean sipVoip;

    readonly attribute DOMString duid;

    readonly attribute boolean speechRecognition;

    readonly attribute boolean speechSynthesis;

    readonly attribute boolean accelerometer;

    readonly attribute boolean accelerometerWakeup;

    readonly attribute boolean barometer;

    readonly attribute boolean barometerWakeup;

    readonly attribute boolean gyroscope;

    readonly attribute boolean gyroscopeWakeup;

    readonly attribute boolean magnetometer;

    readonly attribute boolean magnetometerWakeup;

    readonly attribute boolean photometer;

    readonly attribute boolean photometerWakeup;

    readonly attribute boolean proximity;

    readonly attribute boolean proximityWakeup;

    readonly attribute boolean tiltmeter;

    readonly attribute boolean tiltmeterWakeup;

    readonly attribute boolean dataEncryption;

    readonly attribute boolean graphicsAcceleration;

    readonly attribute boolean push;

    readonly attribute boolean telephony;

    readonly attribute boolean telephonyMms;

    readonly attribute boolean telephonySms;

    readonly attribute boolean screenSizeNormal;

    readonly attribute boolean screenSize480_800;

    readonly attribute boolean screenSize720_1280;

    readonly attribute boolean autoRotation;

    readonly attribute boolean shellAppWidget;

    readonly attribute boolean visionImageRecognition;

    readonly attribute boolean visionQrcodeGeneration;

    readonly attribute boolean visionQrcodeRecognition;

    readonly attribute boolean visionFaceRecognition;

    readonly attribute boolean secureElement;

    readonly attribute boolean nativeOspCompatible;

    readonly attribute SystemInfoProfile profile;
  };

Since: 2.0

Attributes

  • readonly boolean bluetooth

    Indicates whether the device supports Bluetooth.

    Since: 2.0

  • readonly boolean nfc
    Indicates whether the device supports NFC.

    Since: 2.0

  • readonly boolean nfcReservedPush
    Indicates whether the device supports NFC reserved push.

    Since: 2.1

  • readonly unsigned short multiTouchCount
    The number of point in Multi-point touch.

    Since: 2.0

  • readonly boolean inputKeyboard
    Indicates whether the device supports the built-in Keyboard.

    Since: 2.0

  • readonly boolean inputKeyboardLayout
    Indicates whether the device supports the built-in keyboard layout.

    Since: 2.1

  • readonly boolean wifi
    Indicates whether the device supports Wi-Fi.

    Since: 2.0

  • readonly boolean wifiDirect
    Indicates whether the device supports Wi-Fi direct.

    Since: 2.0

  • readonly boolean opengles
    Indicates whether the device supports OpenGL-ES.

    Since: 2.1

  • readonly DOMString openglestextureFormat
    The device 3DC texture format for OpenGL-ES. One example of possible output is as follows: "3dc/atc/etc/ptc/pvrtc/utc"

    Since: 2.1

  • readonly boolean openglesVersion1_1
    Indicates whether the device supports OpenGL-ES version 1.1.

    Since: 2.0

  • readonly boolean openglesVersion2_0
    Indicates whether the device supports OpenGL-ES version 2.0.

    Since: 2.0

  • readonly boolean fmRadio
    Indicates whether the device supports FM radio.

    Since: 2.0

  • readonly DOMString platformVersion
    The version of the platform in the [Major].[Minor].[Patch Version] format.
    For example, 1.0.0 represents a platform version where the major version is 1 and the minor and build versions are 0.

    Since: 2.0

    Privilege level: public

    Privilege: http://tizen.org/privilege/system

    Exceptions:

    • WebAPIException

      • with error type SecurityError, if this attribute is not allowed.

  • readonly DOMString webApiVersion
    The version of the Web API in the [Major].[Minor] format.
    For example, 1.0 represents a web api version where the major version is 1 and the minor version is 0.

    Since: 2.1

    Privilege level: public

    Privilege: http://tizen.org/privilege/system

    Exceptions:

    • WebAPIException

      • with error type SecurityError, if this attribute is not allowed.

  • readonly DOMString nativeApiVersion
    The version of the native API in the [Major].[Minor] format.

    For example, 1.0 represents a native api version where the major version is 1 and the minor version is 0. If a device doesn't provide Tizen native API, nativeApiVersion will be a empty string.

    Since: 2.1

    Privilege level: public

    Privilege: http://tizen.org/privilege/system

    Exceptions:

    • WebAPIException

      • with error type SecurityError, if this attribute is not allowed.

  • readonly DOMString platformName
    The name of the platform.

    Since: 2.0

  • readonly boolean camera
    Indicates whether the device supports camera.

    Since: 2.1

  • readonly boolean cameraFront
    Indicates whether the device supports front camera.

    Since: 2.0

  • readonly boolean cameraFrontFlash
    Indicates whether the device supports flash on the front camera.

    Since: 2.0

  • readonly boolean cameraBack
    Indicates whether the device supports back-side camera.

    Since: 2.0

  • readonly boolean cameraBackFlash
    Indicates whether the device supports flash on the back-side camera.

    Since: 2.0

  • readonly boolean location
    Indicates whether the device supports GPS or not.

    Since: 2.0

  • readonly boolean locationGps
    Indicates whether the device supports GPS based location feature.

    Since: 2.0

  • readonly boolean locationWps
    Indicates whether the device supports WPS based location feature.

    Since: 2.0

  • readonly boolean microphone
    Indicates whether the device supports microphone.

    Since: 2.0

  • readonly boolean usbHost
    Indicates whether the device supports USB host.

    Since: 2.0

  • readonly boolean usbAccessory
    Indicates whether the device supports USB accessory.

    Since: 2.0

  • readonly boolean screenOutputRca
    Indicates whether the device supports RCA output.

    Since: 2.0

  • readonly boolean screenOutputHdmi
    Indicates whether the device supports HDMI output.

    Since: 2.0

  • readonly DOMString platformCoreCpuArch
    The device CPU architecture. The possible values for this attribute are: armv6, armv7, x86.

    Since: 2.0

  • readonly DOMString platformCoreFpuArch
    The device FPU architecture. The possible values for this attribute are: vfpv3 / sse2 / sse3 / ssse3.

    Since: 2.0

  • readonly boolean sipVoip
    Indicates whether the device supports VOIP.

    Since: 2.0

  • readonly DOMString duid
    Indicates Tizen ID, not device's unique ID since Tizen 2.3.

    Since: 2.0

    Remark : Tizen ID is a randomly generated value based on the model name.
    It is recommended to use tizen.systeminfo.getCapability("http://tizen.org/system/tizenid") since Tizen 2.3 instead.

  • readonly boolean speechRecognition
    Indicates whether the device supports speech recognition.

    Since: 2.0

  • readonly boolean speechSynthesis
    Indicates whether the device supports speech synthesis.

    Since: 2.1

  • readonly boolean accelerometer
    Indicates whether the device supports Accelerometer sensor.

    Since: 2.0

  • readonly boolean accelerometerWakeup
    Indicates whether the device supports Accelerometer sensor wake-up feature.

    Since: 2.1

  • readonly boolean barometer
    Indicates whether the device supports Barometer sensor.

    Since: 2.0

  • readonly boolean barometerWakeup
    Indicates whether the device supports Barometer sensor wake-up feature.

    Since: 2.1

  • readonly boolean gyroscope
    Indicates whether the device supports Gyroscope sensor.

    Since: 2.0

  • readonly boolean gyroscopeWakeup
    Indicates whether the device supports Gyroscope sensor wake-up feature.

    Since: 2.1

  • readonly boolean magnetometer
    Indicates whether the device supports Magnetometer sensor.

    Since: 2.0

  • readonly boolean magnetometerWakeup
    Indicates whether the device supports Magnetometer sensor wake-up feature.

    Since: 2.1

  • readonly boolean photometer
    Indicates whether the device supports Photometer sensor.

    Since: 2.1

  • readonly boolean photometerWakeup
    Indicates whether the device supports Photometer sensor wake-up feature.

    Since: 2.1

  • readonly boolean proximity
    Indicates whether the device supports Proximity sensor.

    Since: 2.0

  • readonly boolean proximityWakeup
    Indicates whether the device supports Proximity sensor wake-up feature.

    Since: 2.1

  • readonly boolean tiltmeter
    Indicates whether the device supports Tiltmeter sensor.

    Since: 2.1

  • readonly boolean tiltmeterWakeup
    Indicates whether the device supports Tiltmeter sensor wake-up feature.

    Since: 2.1

  • readonly boolean dataEncryption
    Indicates whether the device supports data encryption.

    Since: 2.1

  • readonly boolean graphicsAcceleration
    Indicates whether the device supports hardware acceleration for 2D/3D graphics.

    Since: 2.1

  • readonly boolean push
    Indicates whether the device supports push service.

    Since: 2.1

  • readonly boolean telephony
    Indicates whether the device supports the telephony feature.

    Since: 2.1

  • readonly boolean telephonyMms
    Indicates whether the device supports the mms feature.

    Since: 2.1

  • readonly boolean telephonySms
    Indicates whether the device supports the sms feature.

    Since: 2.1

  • readonly boolean screenSizeNormal
    Indicates whether the device supports the screen normal size.

    Since: 2.1

  • readonly boolean screenSize480_800
    Indicates whether the device supports the 480 * 800 screen size.

    Since: 2.1

  • readonly boolean screenSize720_1280
    Indicates whether the device supports the 720 * 1280 screen size.

    Since: 2.1

  • readonly boolean autoRotation
    Indicates whether the device supports auto rotation.

    Since: 2.1

  • readonly boolean shellAppWidget
    Indicates whether the device supports shell app widget(dynamic box).

    Since: 2.1

  • readonly boolean visionImageRecognition
    Indicates whether the device supports vision image recognition.

    Since: 2.1

  • readonly boolean visionQrcodeGeneration
    Indicates whether the device supports vision qrcode generation.

    Since: 2.1

  • readonly boolean visionQrcodeRecognition
    Indicates whether the device supports vision qrcode recognition.

    Since: 2.1

  • readonly boolean visionFaceRecognition
    Indicates whether the device supports vision face recognition.

    Since: 2.1

  • readonly boolean secureElement
    Indicates whether the device supports secure element.

    Since: 2.1

  • readonly boolean nativeOspCompatible
    Indicates whether the device supports native osp API.

    Since: 2.1

  • readonly SystemInfoProfile profile
    Represents the profile of the current device.

    Since: 2.2

2.4 SystemInfoOptions

An object containing the various options for fetching the properties requested.
  dictionary SystemInfoOptions {
    unsigned long timeout;

    double highThreshold;

    double lowThreshold;
  };

Since: 1.0

The highThreshold and lowThreshold values are only applicable to the following SystemInfoPropertyId.

  • SystemInfoBattery - level : from 0 to 1
  • SystemInfoCpu - load : from 0 to 1
  • SystemInfoDisplay - brightness : from 0 to 1

For other cases, it is ignored.

Dictionary members

unsigned long timeout
The number of milliseconds beyond which the operation must be interrupted.

Since: 1.0

double highThreshold
An attribute to indicate that the successCallback() method in the watch operation will be triggered only if the device property is a number and its value is greater than or equal to this number. This attribute has no effect on the get() method.

Since: 1.0

double lowThreshold
An attribute to indicate that the successCallback() method in the watch operation must be triggered only if the property is a number and its value is lower than or equal to this number. If both highThreshold and lowThreshold parameters are specified, the successCallback() is triggered if and only if the property value is either lower than the value of lowThreshold or higher than the value of highThreshold. This attribute has no effect on the get method.

Since: 1.0

2.5 SystemInfoPropertySuccessCallback

Systeminfo specific success callback.
  [Callback=FunctionOnly, NoInterfaceObject] interface SystemInfoPropertySuccessCallback {
    void onsuccess(SystemInfoProperty property);
  };

Since: 1.0

This callback interface specifies a success callback with SystemInfoProperty as input argument. It is used in asynchronous operations, such as getPropertyValue() or addPropertyValueChangeListener()

Methods

onsuccess
Method invoked when the asynchronous call completes successfully.
void onsuccess(SystemInfoProperty property);

Since: 1.0

Parameters:

  • property: The property returned from a successful asynchronous operation.

2.6 SystemInfoPropertyArraySuccessCallback

Systeminfo specific success callback.
  [Callback=FunctionOnly, NoInterfaceObject] interface SystemInfoPropertyArraySuccessCallback {
    void onsuccess(SystemInfoProperty[] properties);
  };

Since: 2.3

This callback interface specifies a success callback with SystemInfoProperty as input argument. It is used in asynchronous operations, such as getPropertyValueArray() or addPropertyValueArrayChangeListener()

Methods

onsuccess
Method invoked when the asynchronous call completes successfully.
void onsuccess(SystemInfoProperty[] properties);

Since: 2.3

Parameters:

  • properties: The array of SystemInfoProperty objects returned from a successful asynchronous operation.

2.7 SystemInfoProperty

This is a common abstract interface used by different types of system information objects.
  [NoInterfaceObject] interface SystemInfoProperty {
  };

Since: 1.0

2.8 SystemInfoBattery

This property reflects the general state of the system's battery
  [NoInterfaceObject] interface SystemInfoBattery : SystemInfoProperty {
    readonly attribute double level;

    readonly attribute boolean isCharging;
  };

Since: 1.0

Attributes

  • readonly double level

    An attribute to specify the remaining level of an internal battery, scaled from 0 to 1:
    • 0 indicates that the battery level is the lowest and the system is about to enter shutdown mode.
    • 1 indicates that the system's charge is maximum.

    Any threshold parameter used in a watch operation to monitor this property applies to this attribute.

    Since: 1.0

  • readonly boolean isCharging
    Indicates whether the battery source is currently charging.

    Since: 1.0

2.9 SystemInfoCpu

This property reflects the state of the CPUs available to this system.
  [NoInterfaceObject] interface SystemInfoCpu : SystemInfoProperty {
    readonly attribute double load;
  };

Since: 1.0

Attributes

  • readonly double load

    An attribute to indicate the current CPU load, as a number between 0.0 and 1.0, representing the minimum and maximum values allowed on this system. Any threshold parameter used in a watch function to monitor this property applies to this attribute.

    Since: 1.0

2.10 SystemInfoStorage

This property exposes the data storage devices connected to this system.
  [NoInterfaceObject] interface SystemInfoStorage : SystemInfoProperty {
    readonly attribute SystemInfoStorageUnit[] units;
  };

Since: 1.0

Attributes

  • readonly SystemInfoStorageUnit[] units

    The array of storage units connected to this device.

    Since: 1.0

2.11 SystemInfoStorageUnit

This property exposes a single storage device connected to this system.
  [NoInterfaceObject] interface SystemInfoStorageUnit : SystemInfoProperty {
    readonly attribute DOMString type;

    readonly attribute unsigned long long capacity;

    readonly attribute unsigned long long availableCapacity;

    readonly attribute boolean isRemovable;

    readonly attribute boolean isRemoveable;
  };

Attributes

  • readonly DOMString type

    The type of a storage device. The value is one of the constants defined for this type.

    The supported storage unit types are:

    • UNKNOWN
    • INTERNAL
    • USB_DEVICE
    • USB_HOST
    • MMC

    Since: 1.0

  • readonly unsigned long long capacity
    The amount of data that this device can hold, in bytes.

    Since: 1.0

  • readonly unsigned long long availableCapacity
    The amount of available data that this device can hold, in bytes.

    Since: 1.0

  • readonly boolean isRemovable
    An attribute to indicate whether a device can be removed or not.

    The following values are supported:

    • true - If this storage unit can be removed from the system (such as an sdcard unplugged)
    • false - If this storage unit cannot be removed from the system

    Since: 2.1

  • readonly boolean isRemoveable
    true if this unit can be removed from the system (such as an sdcard unplugged), false otherwise.

    Deprecated. Deprecated since 2.1. Instead, use isRemovable.

    Since: 1.0

2.12 SystemInfoDisplay

This property reflects the information of the Display.
  [NoInterfaceObject] interface SystemInfoDisplay : SystemInfoProperty {
    readonly attribute unsigned long resolutionWidth;

    readonly attribute unsigned long resolutionHeight;

    readonly attribute unsigned long dotsPerInchWidth;

    readonly attribute unsigned long dotsPerInchHeight;

    readonly attribute double physicalWidth;

    readonly attribute double physicalHeight;

    readonly attribute double brightness;
  };

Since: 1.0

Attributes

  • readonly unsigned long resolutionWidth

    The total number of addressable pixels in the horizontal direction of a rectangular entity (such as Camera, Display, Image, Video, ...) when held in its default orientation.

    Since: 1.0

  • readonly unsigned long resolutionHeight
    The total number of addressable pixels in the vertical direction of a rectangular element (such as Camera, Display, Image, Video, ...) when held in its default orientation.

    Since: 1.0

  • readonly unsigned long dotsPerInchWidth
    Resolution of this device, along its width, in dots per inch.

    Since: 1.0

  • readonly unsigned long dotsPerInchHeight
    Resolution of this device, along its height, in dots per inch.

    Since: 1.0

  • readonly double physicalWidth
    The display's physical width in millimeters.

    Since: 1.0

  • readonly double physicalHeight
    The display's physical height in millimeters.

    Since: 1.0

  • readonly double brightness
    The current brightness of a display ranging between 0 to 1.

    Since: 1.0

2.13 SystemInfoDeviceOrientation

This property reflects the information of the device orientation in this system.
  [NoInterfaceObject] interface SystemInfoDeviceOrientation : SystemInfoProperty {
    readonly attribute SystemInfoDeviceOrientationStatus status;

    readonly attribute boolean isAutoRotation;
  };

Since: 2.0

Attributes

  • readonly SystemInfoDeviceOrientationStatus status

    Represents the status of the current device orientation.

    Since: 2.0

  • readonly boolean isAutoRotation
    whether the device is in autorotation.

    Since: 2.2

2.14 SystemInfoBuild

This property reflects the information of the current device.
  [NoInterfaceObject] interface SystemInfoBuild : SystemInfoProperty {
    readonly attribute DOMString model;

    readonly attribute DOMString manufacturer;

    readonly attribute DOMString buildVersion;
  };

Since: 2.0

Attributes

  • readonly DOMString model

    Represents the model name of the current device.

    Since: 2.0

  • readonly DOMString manufacturer
    Represents the manufacturer of the device.

    Since: 2.1

  • readonly DOMString buildVersion
    Represents the build version information of the device.

    Since: 2.2

2.15 SystemInfoLocale

This property reflects the locale information of the current device.
  [NoInterfaceObject] interface SystemInfoLocale : SystemInfoProperty {
    readonly attribute DOMString language;

    readonly attribute DOMString country;
  };

Since: 2.1

Attributes

  • readonly DOMString language

    Indicates the current language setting in the (LANGUAGE)_(REGION) syntax. The language setting is in the ISO 630-2 format and the region setting is in the ISO 3166-1 format. The language setting is case-sensitive.

    Since: 2.1

  • readonly DOMString country
    Indicates the current country setting in the (LANGUAGE)_(REGION) syntax. The language setting is in the ISO 630-2 format and the region setting is in the ISO 3166-1 format. The country setting is case-sensitive.

    Since: 2.1

2.16 SystemInfoNetwork

This property reflects the information of the data network in this system.
  [NoInterfaceObject] interface SystemInfoNetwork : SystemInfoProperty {
    readonly attribute SystemInfoNetworkType networkType;
  };

Since: 2.0

Attributes

  • readonly SystemInfoNetworkType networkType

    Represents the network type of the current data network.

    Since: 2.0

2.17 SystemInfoWifiNetwork

This property reflects the information of the Wi-Fi network in this system.
   [NoInterfaceObject] interface SystemInfoWifiNetwork : SystemInfoProperty {
    readonly attribute DOMString status;

    readonly attribute DOMString ssid;

    readonly attribute DOMString ipAddress;

    readonly attribute DOMString ipv6Address;

    readonly attribute DOMString macAddress;

    readonly attribute double signalStrength;

    readonly attribute SystemInfoWifiSecurityMode securityMode;

    readonly attribute SystemInfoWifiEncryptionType encryptionType;

    readonly attribute SystemInfoNetworkIpMode ipMode;

    readonly attribute DOMString subnetMask;

    readonly attribute DOMString gateway;

    readonly attribute DOMString dns;
  };

Since: 1.0

Attributes

  • readonly DOMString status

    Represents the status (ON or OFF) of the Wi-Fi interface.

    Since: 1.0

  • readonly DOMString ssid
    Represents the SSID of the Wi-Fi network.

    Since: 1.0

  • readonly DOMString ipAddress
    Represents the IPv4 address of the Wi-Fi network.

    Since: 1.0

  • readonly DOMString ipv6Address
    Represents the IPv6 address of the Wi-Fi network.

    Since: 2.0

  • readonly DOMString macAddress
    Represents the MAC address of the Wi-Fi interface.

    It is written in MM:MM:MM:SS:SS:SS format.

    Since: 2.3

  • readonly double signalStrength
    This connection's signal strength, as a normalized value between 0 (no signal detected) and 1 (the level is at its maximum value).

    Since: 1.0

  • readonly SystemInfoWifiSecurityMode securityMode
    Represents this connection's security mode.

    Since: 2.4

  • readonly SystemInfoWifiEncryptionType encryptionType
    Represents this connection's encryption type.

    Since: 2.4

  • readonly SystemInfoNetworkIpMode ipMode
    Represents this connection's IP configuration type.

    Since: 2.4

  • readonly DOMString subnetMask
    Represents the subnet mask of this connection.

    It is written in 255.255.255.255 format.

    Since: 2.4

  • readonly DOMString gateway
    Represents the gateway of this connection.

    It is written in 255.255.255.255 format.

    Since: 2.4

  • readonly DOMString dns
    Represents the DNS address of this connection.

    It is written in 255.255.255.255 format.

    Since: 2.4

2.18 SystemInfoEthernetNetwork

This property reflects the information of the Ethernet network in this system.
   [NoInterfaceObject] interface SystemInfoEthernetNetwork : SystemInfoProperty {
    readonly attribute DOMString cable;

    readonly attribute DOMString status;

    readonly attribute DOMString ipAddress;

    readonly attribute DOMString ipv6Address;

    readonly attribute DOMString macAddress;

    readonly attribute SystemInfoNetworkIpMode ipMode;

    readonly attribute DOMString subnetMask;

    readonly attribute DOMString gateway;

    readonly attribute DOMString dns;
  };

Since: 2.4

Attributes

  • readonly DOMString cable

    Represents the cable status (ATTACHED or DETACHED) of the ethernet interface.

    Since: 2.4

  • readonly DOMString status
    Represents the status (DEACTIVATED, DISCONNECTED or CONNECTED) of the ethernet interface.

    Since: 2.4

  • readonly DOMString ipAddress
    Represents the IPv4 address of the ethernet network.

    Since: 2.4

  • readonly DOMString ipv6Address
    Represents the IPv6 address of the ethernet network.

    Since: 2.4

  • readonly DOMString macAddress
    Represents the MAC address of the ethernet interface.

    It is written in MM:MM:MM:SS:SS:SS format.

    Since: 2.4

  • readonly SystemInfoNetworkIpMode ipMode
    Represents this connection's IP configuration type.

    Since: 2.4

  • readonly DOMString subnetMask
    Represents the subnet mask of this connection.

    It is written in 255.255.255.255 format.

    Since: 2.4

  • readonly DOMString gateway
    Represents the gateway of this connection.

    It is written in 255.255.255.255 format.

    Since: 2.4

  • readonly DOMString dns
    Represents the DNS address of this connection.

    It is written in 255.255.255.255 format.

    Since: 2.4

2.19 SystemInfoCellularNetwork

This property reflects the information of the Cellular network in this system.
  [NoInterfaceObject] interface SystemInfoCellularNetwork : SystemInfoProperty {

    readonly attribute DOMString status;

    readonly attribute DOMString apn;

    readonly attribute DOMString ipAddress;

    readonly attribute DOMString ipv6Address;

    readonly attribute unsigned short mcc;

    readonly attribute unsigned short mnc;

    readonly attribute unsigned short cellId;

    readonly attribute unsigned short lac;

    readonly attribute boolean isRoaming;

    readonly attribute boolean isFlightMode;

    readonly attribute DOMString imei raises(WebAPIException);

    readonly attribute SystemInfoNetworkIpMode ipMode;

    readonly attribute DOMString subnetMask;

    readonly attribute DOMString gateway;

    readonly attribute DOMString dns;
  };

Since: 1.0

Attributes

  • readonly DOMString status

    Represents the status (ON or OFF) of the cellular network.

    Since: 1.0

  • readonly DOMString apn
    Represents an Access Point Name of the cellular network.

    Since: 1.0

  • readonly DOMString ipAddress
    Represents the IPv4 address of the cellular network.

    Since: 1.0

  • readonly DOMString ipv6Address
    Represents the IPv6 address of the cellular network.

    Since: 2.0

  • readonly unsigned short mcc
    Represents Mobile Country Code (MCC) of the cellular network.

    Since: 1.0

  • readonly unsigned short mnc
    Represents Mobile Network Code (MNC) of the cellular network. MNC is used in combination with MCC (also known as a "MCC / MNC tuple") to uniquely identify a mobile phone operator/carrier using the GSM, CDMA, iDEN, TETRA and UMTS public land mobile networks and some satellite mobile networks.

    Since: 1.0

  • readonly unsigned short cellId
    Represents Cell Id.

    Since: 1.0

  • readonly unsigned short lac
    Represents Location Area Code.

    Since: 1.0

  • readonly boolean isRoaming
    Whether the connection is set up while the device is roaming.

    Since: 1.0

  • readonly boolean isFlightMode
    Indicates whether the device is in flight mode.

    Since: 2.1

  • readonly DOMString imei
    Represents the International Mobile Equipment Identity (IMEI).

    Since: 2.1

    Privilege level: public

    Privilege: http://tizen.org/privilege/telephony

    Warning: http://tizen.org/privilege/systemmanager (partner level privilege) has been deprecated since 2.3.1. Instead, use http://tizen.org/privilege/telephony.

    Exceptions:

    • WebAPIException

      • with error type SecurityError, if this attribute is not allowed.

  • readonly SystemInfoNetworkIpMode ipMode
    Represents this connection's IP configuration type.

    Since: 2.4

  • readonly DOMString subnetMask
    Represents the subnet mask of this connection.

    It is written in 255.255.255.255 format.

    Since: 2.4

  • readonly DOMString gateway
    Represents the gateway of this connection.

    It is written in 255.255.255.255 format.

    Since: 2.4

  • readonly DOMString dns
    Represents the DNS address of this connection.

    It is written in 255.255.255.255 format.

    Since: 2.4

2.20 SystemInfoNetProxyNetwork

This property reflects the information of the net_proxy network in this system.
  [NoInterfaceObject] interface SystemInfoNetProxyNetwork : SystemInfoProperty {
    readonly attribute DOMString status;
  };

Since: 3.0

Attributes

  • readonly DOMString status

    Represents the status (ON or OFF) of the net_proxy network.

    Since: 3.0

2.21 SystemInfoSIM

This property reflects the information of the SIM card information.
  [NoInterfaceObject] interface SystemInfoSIM : SystemInfoProperty {
    readonly attribute SystemInfoSimState state raises(WebAPIException);

    readonly attribute DOMString operatorName raises(WebAPIException);

    readonly attribute DOMString msisdn raises(WebAPIException);

    readonly attribute DOMString iccid raises(WebAPIException);

    readonly attribute unsigned short mcc raises(WebAPIException);

    readonly attribute unsigned short mnc raises(WebAPIException);

    readonly attribute DOMString msin raises(WebAPIException);

    readonly attribute DOMString spn raises(WebAPIException);
  };

Since: 2.0

Attributes

  • readonly SystemInfoSimState state

    Represents the SIM card state.

    Since: 2.1

    Privilege level: public

    Privilege: http://tizen.org/privilege/system

    Exceptions:

    • WebAPIException

      • with error type SecurityError, if this attribute is not allowed.

  • readonly DOMString operatorName
    Represents the Operator Name String (ONS) of Common PCN Handset Specification (CPHS) in SIM card.

    Since: 2.0

    Privilege level: public

    Privilege: http://tizen.org/privilege/system

    Exceptions:

    • WebAPIException

      • with error type SecurityError, if this attribute is not allowed.

  • readonly DOMString msisdn
    Represents the SIM card subscriber number.

    Since: 2.0

    Privilege level: public

    Privilege: http://tizen.org/privilege/telephony

    Warning: The partner level privilege, http://tizen.org/privilege/systemmanager, has been deprecated. From Tizen 2.4, the public level privilege, http://tizen.org/privilege/telephony, is required.

    Exceptions:

    • WebAPIException

      • with error type SecurityError, if this attribute is not allowed.

  • readonly DOMString iccid
    Represents the Integrated Circuit Card ID.

    Since: 2.0

    Privilege level: public

    Privilege: http://tizen.org/privilege/system

    Exceptions:

    • WebAPIException

      • with error type SecurityError, if this attribute is not allowed.

  • readonly unsigned short mcc
    Represents the Mobile Country Code (MCC) of SIM provider.

    Since: 2.0

    Privilege level: public

    Privilege: http://tizen.org/privilege/system

    Exceptions:

    • WebAPIException

      • with error type SecurityError, if this attribute is not allowed.

  • readonly unsigned short mnc
    Represents the Mobile Network Code (MNC) of SIM provider.

    Since: 2.0

    Privilege level: public

    Privilege: http://tizen.org/privilege/system

    Exceptions:

    • WebAPIException

      • with error type SecurityError, if this attribute is not allowed.

  • readonly DOMString msin
    Represents the Mobile Subscription Identification Number (MSIN) of SIM provider.

    Since: 2.0

    Privilege level: public

    Privilege: http://tizen.org/privilege/telephony

    Warning: The partner level privilege, http://tizen.org/privilege/systemmanager, has been deprecated. From Tizen 2.4, the public level privilege, http://tizen.org/privilege/telephony, is required.

    Exceptions:

    • WebAPIException

      • with error type SecurityError, if this attribute is not allowed.

  • readonly DOMString spn
    Represents the Service Provider Name (SPN) of SIM card.

    Since: 2.0

    Privilege level: public

    Privilege: http://tizen.org/privilege/system

    Exceptions:

    • WebAPIException

      • with error type SecurityError, if this attribute is not allowed.

2.22 SystemInfoPeripheral

This property reflects the peripheral information of the current device.
  [NoInterfaceObject] interface SystemInfoPeripheral : SystemInfoProperty {
    readonly attribute boolean isVideoOutputOn;
  };

Since: 2.1

Attributes

  • readonly boolean isVideoOutputOn

    Represents the video out status.

    Since: 2.1

2.23 SystemInfoMemory

This property represents information about the memory state on the device system.
  [NoInterfaceObject] interface SystemInfoMemory : SystemInfoProperty {
    readonly attribute SystemInfoLowMemoryStatus status;

  };

Since: 2.3

Attributes

  • readonly SystemInfoLowMemoryStatus status

    Represents the low memory state.

    Since: 2.3

2.24 SystemInfoVideoSourceInfo

This property reflects each input source the current device has.
  [NoInterfaceObject] interface SystemInfoVideoSourceInfo {

    readonly attribute SystemInfoVideoSourceType type;

     readonly attribute long number;
  };

Since: 2.3

If there are 2 HDMI inputs on a device, Two SystemInfoVideoSourceInfo objects must be retreived through SystemInfoVideoSource
{type=HDMI, number=1}, {type=HDMI, number=2}

Attributes

  • readonly SystemInfoVideoSourceType type

    Represents the type of the video input source.

    Since: 2.3

  • readonly long number
    Represents the input number of the input source.

    If the source is "HDMI 2", the number is 2.

    Since: 2.3

2.25 SystemInfoVideoSource

This property reflects the video sources the device has.
  [NoInterfaceObject] interface SystemInfoVideoSource : SystemInfoProperty {

    readonly attribute SystemInfoVideoSourceInfo[] connected;

    readonly attribute SystemInfoVideoSourceInfo[] disconnected;
  };

Since: 2.3

Attributes

  • readonly SystemInfoVideoSourceInfo[] connected

    Represents a list of video sources that a device is connected with.

    Since: 2.3

  • readonly SystemInfoVideoSourceInfo[] disconnected
    Represents a list of video sources that a device is not connected with.

    Since: 2.3

2.26 SystemInfoCameraFlash

The SystemInfoCameraFlash provides the way to control the attached the camera flash.
  [NoInterfaceObject] interface SystemInfoCameraFlash : SystemInfoProperty {
    readonly attribute double brightness raises(WebAPIException);

    readonly attribute DOMString camera;

    readonly attribute long levels raises(WebAPIException);

    void setBrightness(double brightness) raises(WebAPIException);
  };

Attributes

  • readonly double brightness

    Brightness level of the camera flash (0~1)

    Since: 2.4

    Privilege level: public

    Privilege: http://tizen.org/privilege/led

    Exceptions:

    • WebAPIException

      • with error type SecurityError, if this attribute is not allowed.

    Code example:

     tizen.systeminfo.getPropertyValue("CAMERA_FLASH",
    function (flash) {
        console.log("Flash brightness is set to: " + (flash.brightness * 100).toFixed(0) + "%");
    },
    function (error) {
        console.log("Error, name: " + error.name + ", message: " + error.message);
    }
 );
  • readonly DOMString camera
    Specifies camera to which this flash belongs
    • BACK - back camera flash
    • FRONT - front camera flash
    • EXTERNAL - external camera flash
    • OTHER - a flash attached to any other camera

    The getPropertyValue() method retrieves the SystemInfoCameraFlash for BACK camera.

    Since: 2.4

  • readonly long levels
    Number of brightness levels supported by the flash (other than 0 brightness)

    Since: 2.4

    Privilege level: public

    Privilege: http://tizen.org/privilege/led

    Exceptions:

    • WebAPIException

      • with error type SecurityError, if this attribute is not allowed.

Methods

setBrightness
Sets the brightness value of the flash that is located next to the camera.
void setBrightness(double brightness);

Since: 2.4

If the specified brightness value is not supported by the device, the brightness is rounded down to the nearest supported brightness value.

Privilege level: public

Privilege: http://tizen.org/privilege/led

Parameters:

  • brightness: The brightness value of LED (0~1)

Exceptions:

  • WebAPIException

    • with error type InvalidValuesError, if any of the input parameters contain an invalid value.

    • with error type SecurityError, if the application does not have the privilege to call this method or if the author signature does not match that of the designated application.

    • with error type UnknownError, if the method cannot be completed because of an unknown error.

Code example:

 tizen.systeminfo.getPropertyValue("CAMERA_FLASH",
    function (flash) {
        try {
            flash.setBrightness(1);
        } catch (error) {
            console.log("Setting flash brightness failed: " + error.message);
        }
    },
    function (error) {
        console.log("Error, name: " + error.name + ", message: " + error.message);
    }
 );

2.27 SystemInfoADS

This property represents information about advertisement service - ADS.
  [NoInterfaceObject] interface SystemInfoADS : SystemInfoProperty {
    readonly attribute DOMString id;
  };

Since: 3.0

Attributes

  • readonly DOMString id

    Represents the unique id of advertisement service. It is used to distinguish each device.

    Since: 3.0

3 Related Feature

You can check if this API is supported with tizen.systeminfo.getCapability() and decide enable/disable codes that need this API.

 

To guarantee the running of the application on a device which has camera back flash and control it, declare the following feature requirements in the config file:

 

 

To guarantee the running of the application(e.g. track the battery usage) on a device which has a battery, declare the following feature requirements in the config file:

 

 

To guarantee the running of the application on a device which supports ethernet network feature, declare the following feature requirements in the config file:

 

 

To guarantee the running of the application on a device which supports telephony feature, declare the following feature requirements in the config file:

 

 

To guarantee the running of the application on a device which supports Wi-Fi, declare the following feature requirements in the config file:

 

 

To guarantee the running of the application on a device which supports network proxy for internet connection, declare the following feature requirements in the config file:

 

 

For more information, see Application Filtering.

4 Full WebIDL

module SystemInfo {

  enum SystemInfoPropertyId { "BATTERY", "CPU", "STORAGE", "DISPLAY", "DEVICE_ORIENTATION", "BUILD", "LOCALE", "NETWORK", "WIFI_NETWORK",
                               "ETHERNET_NETWORK", "CELLULAR_NETWORK", "NET_PROXY_NETWORK", "SIM", "PERIPHERAL", "MEMORY", "VIDEOSOURCE", "CAMERA_FLASH", "ADS" };

  enum SystemInfoNetworkType { "NONE", "2G", "2.5G", "3G", "4G", "WIFI", "ETHERNET", "NET_PROXY", "UNKNOWN" };

  enum SystemInfoWifiSecurityMode { "NONE", "WEP", "WPA_PSK", "WPA2_PSK", "EAP" };

  enum SystemInfoWifiEncryptionType { "NONE", "WEP", "TKIP", "AES", "TKIP_AES_MIXED" };

  enum SystemInfoNetworkIpMode { "NONE", "STATIC", "DYNAMIC", "AUTO", "FIXED" };

  enum SystemInfoDeviceOrientationStatus { "PORTRAIT_PRIMARY", "PORTRAIT_SECONDARY", "LANDSCAPE_PRIMARY", "LANDSCAPE_SECONDARY" };

  enum SystemInfoSimState { "ABSENT", "INITIALIZING", "READY", "PIN_REQUIRED", "PUK_REQUIRED", "NETWORK_LOCKED", "SIM_LOCKED", "UNKNOWN" };

  enum SystemInfoProfile { "MOBILE_FULL", "MOBILE_WEB", "MOBILE", "WEARABLE", "TV" };

  enum SystemInfoLowMemoryStatus { "NORMAL", "WARNING" };

  enum SystemInfoVideoSourceType {
      "TV",
      "AV",
      "SVIDEO",
      "COMP",
      "PC",
      "HDMI",
      "SCART",
      "DVI",
      "MEDIA"
  };

  [NoInterfaceObject] interface SystemInfoObject {
    readonly attribute SystemInfo systeminfo;
  };
  Tizen implements SystemInfoObject;

  [NoInterfaceObject] interface SystemInfo {
    long long getTotalMemory() raises(WebAPIException);

    long long getAvailableMemory() raises(WebAPIException);

    SystemInfoDeviceCapability getCapabilities() raises(WebAPIException);

    any getCapability(DOMString key) raises(WebAPIException);

    long getCount(SystemInfoPropertyId property) raises(WebAPIException);

    void getPropertyValue(SystemInfoPropertyId property,
                          SystemInfoPropertySuccessCallback successCallback,
                          optional ErrorCallback? errorCallback) raises(WebAPIException);

    void getPropertyValueArray(SystemInfoPropertyId property,
                          SystemInfoPropertyArraySuccessCallback successCallback,
                          optional ErrorCallback? errorCallback) raises(WebAPIException);

    unsigned long addPropertyValueChangeListener(SystemInfoPropertyId property,
                                        SystemInfoPropertySuccessCallback successCallback,
                                        optional SystemInfoOptions? options,
                                        optional ErrorCallback? errorCallback) raises(WebAPIException);

    unsigned long addPropertyValueArrayChangeListener(SystemInfoPropertyId property,
                                        SystemInfoPropertyArraySuccessCallback successCallback,
                                        optional SystemInfoOptions? options,
                                        optional ErrorCallback? errorCallback) raises(WebAPIException);

    void removePropertyValueChangeListener(unsigned long listenerId) raises(WebAPIException);
  };

  [NoInterfaceObject] interface SystemInfoDeviceCapability {
    readonly attribute boolean bluetooth;

    readonly attribute boolean nfc;

    readonly attribute boolean nfcReservedPush ;

    readonly attribute unsigned short multiTouchCount;

    readonly attribute boolean inputKeyboard;

    readonly attribute boolean inputKeyboardLayout;

    readonly attribute boolean wifi;

    readonly attribute boolean wifiDirect;

    readonly attribute boolean opengles;

    readonly attribute DOMString openglestextureFormat;

    readonly attribute boolean openglesVersion1_1;

    readonly attribute boolean openglesVersion2_0;

    readonly attribute boolean fmRadio;

    readonly attribute DOMString platformVersion raises(WebAPIException);

    readonly attribute DOMString webApiVersion raises(WebAPIException);

    readonly attribute DOMString nativeApiVersion raises(WebAPIException);

    readonly attribute DOMString platformName;

    readonly attribute boolean camera;

    readonly attribute boolean cameraFront;

    readonly attribute boolean cameraFrontFlash;

    readonly attribute boolean cameraBack;

    readonly attribute boolean cameraBackFlash;

    readonly attribute boolean location;

    readonly attribute boolean locationGps;

    readonly attribute boolean locationWps;

    readonly attribute boolean microphone;

    readonly attribute boolean usbHost;

    readonly attribute boolean usbAccessory;

    readonly attribute boolean screenOutputRca;

    readonly attribute boolean screenOutputHdmi;

    readonly attribute DOMString platformCoreCpuArch;

    readonly attribute DOMString platformCoreFpuArch;

    readonly attribute boolean sipVoip;

    readonly attribute DOMString duid;

    readonly attribute boolean speechRecognition;

    readonly attribute boolean speechSynthesis;

    readonly attribute boolean accelerometer;

    readonly attribute boolean accelerometerWakeup;

    readonly attribute boolean barometer;

    readonly attribute boolean barometerWakeup;

    readonly attribute boolean gyroscope;

    readonly attribute boolean gyroscopeWakeup;

    readonly attribute boolean magnetometer;

    readonly attribute boolean magnetometerWakeup;

    readonly attribute boolean photometer;

    readonly attribute boolean photometerWakeup;

    readonly attribute boolean proximity;

    readonly attribute boolean proximityWakeup;

    readonly attribute boolean tiltmeter;

    readonly attribute boolean tiltmeterWakeup;

    readonly attribute boolean dataEncryption;

    readonly attribute boolean graphicsAcceleration;

    readonly attribute boolean push;

    readonly attribute boolean telephony;

    readonly attribute boolean telephonyMms;

    readonly attribute boolean telephonySms;

    readonly attribute boolean screenSizeNormal;

    readonly attribute boolean screenSize480_800;

    readonly attribute boolean screenSize720_1280;

    readonly attribute boolean autoRotation;

    readonly attribute boolean shellAppWidget;

    readonly attribute boolean visionImageRecognition;

    readonly attribute boolean visionQrcodeGeneration;

    readonly attribute boolean visionQrcodeRecognition;

    readonly attribute boolean visionFaceRecognition;

    readonly attribute boolean secureElement;

    readonly attribute boolean nativeOspCompatible;

    readonly attribute SystemInfoProfile profile;
  };

  dictionary SystemInfoOptions {
    unsigned long timeout;

    double highThreshold;

    double lowThreshold;
  };

  [Callback=FunctionOnly, NoInterfaceObject] interface SystemInfoPropertySuccessCallback {
    void onsuccess(SystemInfoProperty property);
  };

  [Callback=FunctionOnly, NoInterfaceObject] interface SystemInfoPropertyArraySuccessCallback {
    void onsuccess(SystemInfoProperty[] properties);
  };

  [NoInterfaceObject] interface SystemInfoProperty {
  };

  [NoInterfaceObject] interface SystemInfoBattery : SystemInfoProperty {
    readonly attribute double level;

    readonly attribute boolean isCharging;
  };

  [NoInterfaceObject] interface SystemInfoCpu : SystemInfoProperty {
    readonly attribute double load;
  };

  [NoInterfaceObject] interface SystemInfoStorage : SystemInfoProperty {
    readonly attribute SystemInfoStorageUnit[] units;
  };

  [NoInterfaceObject] interface SystemInfoStorageUnit : SystemInfoProperty {
    readonly attribute DOMString type;

    readonly attribute unsigned long long capacity;

    readonly attribute unsigned long long availableCapacity;

    readonly attribute boolean isRemovable;

    readonly attribute boolean isRemoveable;
  };

  [NoInterfaceObject] interface SystemInfoDisplay : SystemInfoProperty {
    readonly attribute unsigned long resolutionWidth;

    readonly attribute unsigned long resolutionHeight;

    readonly attribute unsigned long dotsPerInchWidth;

    readonly attribute unsigned long dotsPerInchHeight;

    readonly attribute double physicalWidth;

    readonly attribute double physicalHeight;

    readonly attribute double brightness;
  };

  [NoInterfaceObject] interface SystemInfoDeviceOrientation : SystemInfoProperty {
    readonly attribute SystemInfoDeviceOrientationStatus status;

    readonly attribute boolean isAutoRotation;
  };

  [NoInterfaceObject] interface SystemInfoBuild : SystemInfoProperty {
    readonly attribute DOMString model;

    readonly attribute DOMString manufacturer;

    readonly attribute DOMString buildVersion;
  };

  [NoInterfaceObject] interface SystemInfoLocale : SystemInfoProperty {
    readonly attribute DOMString language;

    readonly attribute DOMString country;
  };

  [NoInterfaceObject] interface SystemInfoNetwork : SystemInfoProperty {
    readonly attribute SystemInfoNetworkType networkType;
  };

   [NoInterfaceObject] interface SystemInfoWifiNetwork : SystemInfoProperty {
    readonly attribute DOMString status;

    readonly attribute DOMString ssid;

    readonly attribute DOMString ipAddress;

    readonly attribute DOMString ipv6Address;

    readonly attribute DOMString macAddress;

    readonly attribute double signalStrength;

    readonly attribute SystemInfoWifiSecurityMode securityMode;

    readonly attribute SystemInfoWifiEncryptionType encryptionType;

    readonly attribute SystemInfoNetworkIpMode ipMode;

    readonly attribute DOMString subnetMask;

    readonly attribute DOMString gateway;

    readonly attribute DOMString dns;
  };

   [NoInterfaceObject] interface SystemInfoEthernetNetwork : SystemInfoProperty {
    readonly attribute DOMString cable;

    readonly attribute DOMString status;

    readonly attribute DOMString ipAddress;

    readonly attribute DOMString ipv6Address;

    readonly attribute DOMString macAddress;

    readonly attribute SystemInfoNetworkIpMode ipMode;

    readonly attribute DOMString subnetMask;

    readonly attribute DOMString gateway;

    readonly attribute DOMString dns;
  };

  [NoInterfaceObject] interface SystemInfoCellularNetwork : SystemInfoProperty {

    readonly attribute DOMString status;

    readonly attribute DOMString apn;

    readonly attribute DOMString ipAddress;

    readonly attribute DOMString ipv6Address;

    readonly attribute unsigned short mcc;

    readonly attribute unsigned short mnc;

    readonly attribute unsigned short cellId;

    readonly attribute unsigned short lac;

    readonly attribute boolean isRoaming;

    readonly attribute boolean isFlightMode;

    readonly attribute DOMString imei raises(WebAPIException);

    readonly attribute SystemInfoNetworkIpMode ipMode;

    readonly attribute DOMString subnetMask;

    readonly attribute DOMString gateway;

    readonly attribute DOMString dns;
  };

  [NoInterfaceObject] interface SystemInfoNetProxyNetwork : SystemInfoProperty {
    readonly attribute DOMString status;
  };

  [NoInterfaceObject] interface SystemInfoSIM : SystemInfoProperty {
    readonly attribute SystemInfoSimState state raises(WebAPIException);

    readonly attribute DOMString operatorName raises(WebAPIException);

    readonly attribute DOMString msisdn raises(WebAPIException);

    readonly attribute DOMString iccid raises(WebAPIException);

    readonly attribute unsigned short mcc raises(WebAPIException);

    readonly attribute unsigned short mnc raises(WebAPIException);

    readonly attribute DOMString msin raises(WebAPIException);

    readonly attribute DOMString spn raises(WebAPIException);
  };

  [NoInterfaceObject] interface SystemInfoPeripheral : SystemInfoProperty  {
    readonly attribute boolean isVideoOutputOn;
  };

  [NoInterfaceObject] interface SystemInfoMemory : SystemInfoProperty  {
    readonly attribute SystemInfoLowMemoryStatus status;

  };

  [NoInterfaceObject] interface SystemInfoVideoSourceInfo {

    readonly attribute SystemInfoVideoSourceType type;

     readonly attribute long number;
  };

  [NoInterfaceObject] interface SystemInfoVideoSource : SystemInfoProperty {

    readonly attribute SystemInfoVideoSourceInfo[] connected;

    readonly attribute SystemInfoVideoSourceInfo[] disconnected;
  };

  [NoInterfaceObject] interface SystemInfoCameraFlash : SystemInfoProperty {
    readonly attribute double brightness raises(WebAPIException);

    readonly attribute DOMString camera;

    readonly attribute long levels raises(WebAPIException);

    void setBrightness(double brightness) raises(WebAPIException);
  };

  [NoInterfaceObject] interface SystemInfoADS : SystemInfoProperty {
    readonly attribute DOMString id;
  };
};
Except as noted, this content - excluding the Code Examples - is licensed under Creative Commons Attribution 3.0 and all of the Code Examples contained herein are licensed under BSD-3-Clause.
For details, see the Content License.