Prerequisites

The SystemInfo API has different levels of access to handle system and sensitive data. You can enable permissions for the SystemInfo API in the config.xml file.

• http://tizen.org/api/setting: Privilege to allow access to features of the SystemInfo API
• http://tizen.org/api/system: Privilege to allow access to all features of the SystemInfo API
• http://tizen.org/api/systemmanager: Privilege to allow access to the imei number and SIM subscription numbers.

In order to use systemmanager privilege, you should have "partner" privilege level. You can enable it by executing

$patch.bat public

from <TIZEN_IDE_HOME>/tools/certificate-generator/patches.

It is recommended that you edit config.xml file by using the Tizen IDE interface.

Determine property support

The Tizen SystemInfo API provides the SystemInfoObject interface which allows you to obtain information about system properties. You can use the SystemInfo API to access the status of various device details.

If your application need to access the device-specific information, you must check the support for the property by using getCapabilities method. Returns true, if the property is supported.

var deviceCapabilities;
deviceCapabilities = tizen.systeminfo.getCapabilities();
if (deviceCapabilities.wifi)
{
   console.log("wifi is available");
}

The valid values for PropertyId are:

• Battery
• Cpu
• Storage
• Display
• Device Orientation
• Build
• Locale
• Network
• WifiNetwork
• CellularNetwork
• SIM
• Peripheral

Retrieve device properties

Device properties provides information about the resources available to complete a particular task or service successfully. To access the internet, you may want to know the the details of the cellular network that can be accessed by the device.

You can determine by checking the status of the respective properties.

You can check the current state of a property by using the getPropertyValue method which accepts 3 arguments: a property name, a success callback, and an error callback. Using this method, you can check the current state of all the properties supported by the device.

SystemInfoProperty

A common abstract interface used by the supported system information objects.

SystemInfoBattery

It is important to understand the power available for applications that require a considerable amount of power. You can determine whether the application can be launched or whether the user needs to be warned about the level of power available for the device.

Using SystemInfoBattery you can get the level of battery

 function onSuccessCallback(battery) {
     alert("Battery Level: " + battery.level + "\nIs Charging: "
     + battery.isCharging);
 }

  function onErrorCallback(error) {
     alert("Not supported: " + error.message);
 }
 tizen.systeminfo.getPropertyValue("BATTERY", onSuccessCallback, onErrorCallback);

The level of power available to a device is scaled from 0 to 1. Here, 0 indicates that the device doesn’t have any power while 1 indicates that the device is charged to its maximum capacity. If a threshold parameter is set, the notification for change is triggered only when the power level crosses the threshold values.

SystemInfoCpu

CPU load is an important factor for determining the efficiency of an application. Using SystemInfoCpu, you can get the current CPU load on the system.

 function onSuccessCallback(cpu) {
     alert("The Load on device is " + cpu.load);
 }

  function onErrorCallback(error) {
     alert("Not supported: " + error.message);
 }
 tizen.systeminfo.getPropertyValue("CPU", onSuccessCallback, onErrorCallback);

SystemInfoStorage

A device might have several data storage devices connected to it. Hence you might want to provide the users with an option to select any of these storage devices for data storage.

The SystemInfoStorage interface returns a collection of SystemInfoStorageUnit objects and each storage unit represents details such as capacity, free space, type, and whether or not the storage unit is removable.

 function singleStorageInfo(storageunit) {
     alert("Type: " + storageunit.type + "    Total Capacity: " + storageunit.capacity
     + "\nFree: " + storageunit.availableCapacity + "isRemovable: " + storageunit.isRemovable);
 }

 function onErrorCallback(error) {
     alert("Not supported: " + error.message);
 }

 function onSuccessCallback(storage) {
     alert("Number of storage devices connected " + storage.units.length);
     var i = 0;
     //for(i=0; i < storage.units.length; i++)
     //{
        alert("Type: " + storage.units[i].type);
        singleStorageInfo(storage.units[i]);
     //}
 }

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

SystemInfoDisplay

You might want to know the resolution of the device to layout your application on runtime. Using SystemInfoDisplay, you can get the resolution, dpi, physical dimensions and brghitness of the display.

 function onSuccessCallback(display) {
     alert("Resolution{w, h}: " + "{" + display.resolutionWidth + ", " + display.resolutionHeight
     + "}\nDPI{w, h}: " + "{" + display.dotsPerInchWidth + ", " + display.dotsPerInchHeight
     + "}\nPhysical dimensions{w, h}: " + "{" + display.physicalWidth + ", " + display.physicalHeight
     + "}\nBrightness: " + display.brightness);
 }

  function onErrorCallback(error) {
     alert("Not supported: " + error.message);
 }
 tizen.systeminfo.getPropertyValue("DISPLAY", onSuccessCallback, onErrorCallback);

SystemInfoDeviceOrientation

You might want to know the current device display orientation. Using SystemInfoDeviceOrientation, you can get the current device orientation.

 function onSuccessCallback(orientation) {
     alert("Device Orientation =" + orientation.status);
 }

  function onErrorCallback(error) {
     alert("Not supported: " + error.message);
 }
 tizen.systeminfo.getPropertyValue("DEVICE_ORIENTATION", onSuccessCallback, onErrorCallback);

SystemInfoBuild

Using SystemInfoBuild, you can get the device manufacturer and model information.

 function onSuccessCallback(device) {
     alert("Device Model =" + device.model + " Manufacturer = " + device.manufacturer);
 }

  function onErrorCallback(error) {
     alert("Not supported: " + error.message);
 }
 tizen.systeminfo.getPropertyValue("BUILD", onSuccessCallback, onErrorCallback);

SystemInfoLocale

Using SystemInfoLocale, you can get the locale information of current device.

 function onSuccessCallback(device) {
     alert("Language =" + device.language + " Country = " + device.country);
 }

  function onErrorCallback(error) {
     alert("Not supported: " + error.message);
 }
 tizen.systeminfo.getPropertyValue("LOCALE", onSuccessCallback, onErrorCallback);

SystemInfoNetwork

You might to know whether the network type provides adequate connection speeds as per the requirements of the user. Using SystemInfoNetwork, you can determine the network type.

  function onSuccessCallback(network) {
     alert(" network type: " + network.networkType);
 }

  function onErrorCallback(error) {
     alert("Not supported: " + error.message);
 }

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

SystemInfoWifiNetwork

You might want your application to access the Wi-Fi network of the device. To access this network through your application, you need certain network details. Using SystemInfoWifiNetwork, you can determine the network availability, SSID, IP address and signal strength.

 function onSuccessCallback(wifi) {
     alert("Status: " + wifi.status +  "    SSID: " + wifi.ssid
     + "\nIP Address: " + wifi.ipAddress + "\nIPV6 Address: " + wifi.ipv6Address + "    Signal Strength: " + wifi.signalStrength);
 }

  function onErrorCallback(error) {
     alert("Not supported: " + error.message);
 }
 tizen.systeminfo.getPropertyValue("WIFI_NETWORK", onSuccessCallback, onErrorCallback);

SystemInfoCellularNetwork

Most mobile devices are connected to a cellular network that enables the devices to connect to and call other devices. To access this network through your application, you need certain network details. Using SystemInfoCellularNetwork, you can determine the network status, access point, IP address, country code, cellular ID, imei, location area code and whether roaming is enabled on the device.

function onSuccessCallback(cellular) {
     alert("Status: " + cellular.status +  "    Access Point: " + cellular.apn
     + "\nIP Address: " + cellular.ipAddress + "\nIPV6 Address: " + cellular.ipv6Address + "    Country code: " + cellular.mcc
     + "\nNetwork Code: " + cellular.mnc + "    Cell ID: " + cellular.cellId
     + "\nLocation Area code: " + cellular.lac + "    Is Roaming: " + cellular.isRoaming)
     + "\nFlight Mode: " + cellular.isFlightMode + "    IMEI: " + cellular.imei);
 }

  function onErrorCallback(error) {
     alert("Not supported: " + error.message);
 }
 tizen.systeminfo.getPropertyValue("CELLULAR_NETWORK", onSuccessCallback, onErrorCallback);

SystemInfoSIM

Using SystemInfoSIM, you can get the information about device SIM card such as the operator name and mcc code.

 function onSuccessCallback(sim) {
     alert("State: " + sim.state + "Operator Name: " + sim.operatorName +  "  SIM card subscriber number: " + sim.msisdn
     + "\nIntegrated Circuit Card ID: " + sim.iccid + "   Mobile Country Code (MCC): " + sim.mcc
     + "\nMobile Network Code (MNC): " + sim.mnc + "   Mobile Subscription Identification Number (MSIN): " + sim.msin
     + "\nService Provider Name (SPN): " + sim.spn);
 }

  function onErrorCallback(error) {
     alert("Not supported: " + error.message);
 }
 tizen.systeminfo.getPropertyValue("SIM", onSuccessCallback, onErrorCallback);

SystemInfoPeripheral

Using SystemInfoPeripheral, you can get the information about device's video output status.

 function onSuccessCallback(device) {
     alert("Video out: " + device.isVideoOutputOn);
 }

  function onErrorCallback(error) {
     alert("Not supported: " + error.message);
 }
 tizen.systeminfo.getPropertyValue("PERIPHERAL", onSuccessCallback, onErrorCallback);

Trace system information

A change in the status of one or more properties of a device might affect your application. Therefore, it is important to check for updates to the properties that are critical to your application.

 function onSuccessCallback(battery) {
     console.log("Low battery:  " + battery.level);
 }

 tizen.systeminfo.addPropertyValueChangeListener("BATTERY", onSuccessCallback,
 {lowThreshold : 0.2});

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

 id = tizen.systeminfo.addPropertyValueChangeListener("BATTERY", onSuccessCallback)

var id = null;
 function onSuccessCallback(battery) {
     alert("Batter Low! Level = " + battery.level);
     if (id != null) // After receiving the first notification, we clear it
        tizen.systeminfo.removePropertyValueChangeListener(id);
 }

 id = tizen.systeminfo.addPropertyValueChangeListener("BATTERY", onSuccessCallback, {lowThreshold : 0.2});