System Information

You can access various information about your device system and its runtime status.

The main system information features include the following:

• Retrieving system information

  You can access system information, such as platform features or device capabilities, using the Tizen.System.Information class.

• Retrieving resource usage details

  You can retrieve the resource usage details of the device or a particular process by using the Tizen.System.ProcessCpuUsage, Tizen.System.ProcessMemoryUsage, Tizen.System.SystemCpuUsage, and Tizen.System.SystemMemoryUsage classes.

• Monitoring runtime changes

  You can register a callback with the Tizen.System.Information class to receive notifications when a specific feature changes at runtime.

System information features are classified as either static features, which are device features whose value does not change, or runtime features, whose value can change according to, for example, what peripherals are currently connected to the device. The features are identified using feature keys.

Prerequisites

To enable your application to use the system information functionality, follow these steps:

1. To access per-process resource information (to use the Tizen.System.ProcessCpuUsage and Tizen.System.ProcessMemoryUsage classes), the application has to request permission by adding the following privilege to the tizen-manifest.xml file:

   
                   
   XML
                   
   
                       
   Copy
                       
   
                   
               
   <privileges>
      <privilege>http://tizen.org/privilege/systemmonitor</privilege>
   </privileges>
   

2. To use the methods and properties of the Tizen.System.Information, Tizen.System.ProcessCpuUsage, Tizen.System.ProcessMemoryUsage, Tizen.System.SystemCpuUsage, and Tizen.System.SystemMemoryUsage classes, include the Tizen.System namespace in your application:

   
                   
   C#
                   
   
                       
   Copy
                       
   
                   
               
   using Tizen.System;
   

Retrieve system information

To retrieve system information, use the TryGetValue() method of the Tizen.System.Information class:

• To retrieve a static feature:

  
                  
  C#
                  
  
                      
  Copy
                      
  
                  
              
  /// Check whether the device has a battery
  public static bool is_battery_powered_device()
  {
      bool ret;
  
      if (Tizen.System.Information.TryGetValue<bool>("http://tizen.org/feature/battery", out ret) == false)
      {
          /// Error handling
      }
  
      return ret;
  }
  

• To retrieve the current value of a runtime feature:

  
                  
  C#
                  
  
                      
  Copy
                      
  
                  
              
  /// Check whether the battery is charging
  public static bool is_charging()
  {
      bool ret;
  
      if (Tizen.System.Information.TryGetValue<bool>("http://tizen.org/runtimefeature/battery.charging", out ret) == false)
      {
          /// Error handling
      }
  
      return ret;
  }
  

Retrieve resource usage details

To get resource usage details, use the Tizen.System.ProcessCpuUsage, Tizen.System.ProcessMemoryUsage, Tizen.System.SystemCpuUsage, and Tizen.System.SystemMemoryUsage classes. Since these classes collect information during their construction, you can simply make a new instance to access the resource usage details.

• To retrieve system memory usage details:

  
                  
  C#
                  
  
                      
  Copy
                      
  
                  
              
  public static int get_total_memory_size(void)
  {
      Tizen.System.SystemMemoryUsage usage = new Tizen.System.SystemMemoryUsage();
  
      return usage.Total;
  }
  

• To retrieve CPU usage details of a process:

  
                  
  C#
                  
  
                      
  Copy
                      
  
                  
              
  public static void print_family_cpu_usage(Familyinfo family)
  {
      IList<int> processList;
      Tizen.System.ProcessCpuUsage usage;
  
      processList = new List<int>();
      processList.Add(family.me.pid);
      processList.Add(family.father.pid);
  
      usage = new Tizen.System.ProcessCpuUsage(processList);
  
      Tizen.Log.Info("MY_HOUSE", "My CPU UTime = " + usage.GetUTime(family.me.pid));
      Tizen.Log.Info("MY_HOUSE", "Father's CPU STime = " + usage.GetSTime(family.father.pid));
  }
  

Monitor runtime changes

You can monitor the changes in the runtime feature key values by registering event handlers for the corresponding events.

For example, to monitor whether an audio jack is connected, and to turn the device volume to safe levels when it is:

                
C#
                

                    
Copy
                    

                
            
private const string RuntimeFeatureAudiojackConnected = "http://tizen.org/runtimefeature/audiojack.connected";

/// Event handler for the audio jack connection event
public static void TurnDownTheVolumeCallback(object sender, RuntimeFeatureStatusChangedEventArgs args)
{
    if (MySpeaker.GetVolume() > 10)
    {
        MySpeaker.SetVolume(10);
    }
}

/// To begin monitoring, register the event handler for the audiojack.connected event
public static void init()
{
    Tizen.System.Information.SetCallback(RuntimeFeatureAudiojackConnected, TurnDownTheVolumeCallback);
}

/// When monitoring is no longer needed, deregister the event handler
public static void deinit()
{
    Tizen.System.Information.UnsetCallback(RuntimeFeatureAudiojackConnected, TurnDownTheVolumeCallback);
}

Feature Keys

The static feature keys are identical to the ones used in Tizen native applications. For more information, see the native System Information guide.

The runtime feature keys have the runtimefeature prefix. The available runtime feature keys are listed in the following table.

Table: Runtime feature keys

Related information

• Dependencies
  • Tizen 4.0 and Higher