System Information

You can access various information about fixed platform features or device capabilities by querying system information keys. You can also check for supported features.

The main features of the System Information API include:

• Getting system information

  You can retrieve system information, such as the model name of the device.

• Checking for supported features

  You can check whether the device supports a feature, such as camera.

Table: Device-specific information categories

To obtain the information, query a feature or system key.

• Feature keys

  • Account
  • Accessibility
  • Application history
  • Attach panel
  • Battery
  • Camera
  • Consumer IR
  • Content
  • Contextual trigger
  • Database
  • Diagnostics
  • Download
  • FIDO
  • FM radio
  • Graphics
  • Human activity monitor
  • Input
  • IOT
  • LED
  • Location
  • Machine learning
  • Maps
  • Media
  • Microphone
  • Multimedia
  • Multi-point touch
  • Network
  • OAuth 2.0
  • OpenGL® ES
  • Peripheral-IO
  • Platform
  • Profile
  • Screen
  • Security
  • Sensor
  • Shell
  • Sip
  • Speech
  • Storage
  • System setting
  • Thermistor
  • UI Sticker
  • USB
  • Vibration
  • Vision
  • Web

• System keys

  • Build
  • Device type
  • Manufacturer
  • Model name
  • Platform
  • Sound
  • TizenID

Note

Some device-specific information keys look similar to feature keys for application filtering, but their usage differs. Feature keys for device-specific information are used to determine whether the feature is supported in the system. Feature keys for application filtering let the official site for Tizen applications filter applications based on features.

Prerequisites

To use the functions and data types of the System Information API (in mobile and wearable applications), include the <system_info.h> header file in your application:

#include <system_info.h>

Getting the Device Model Name

Device-specific information consists of “key, value” pairs. To get the device model name, use the http://tizen.org/system/model_name key with the data type-specific get function.

The model name key data type is string, which means that you need to use the system_info_get_platform_string() function.

When no longer needed, release the value of the key with the free() function.

void
func(void)
{
    char *value;
    int ret;

    ret = system_info_get_platform_string("http://tizen.org/system/model_name", &value);
    if (ret != SYSTEM_INFO_ERROR_NONE) {
        /* Error handling */

        return;
    }

    dlog_print(DLOG_INFO, LOG_TAG, "Model name: %s", value);

    free(value); /* Release after use */
}

Checking for Supported Features

To determine, for example, whether the device has a camera, use the http://tizen.org/feature/camera key with the data type-specific get function.

The camera key data type is bool, which means that you need to use the system_info_get_platform_bool() function.

#include <stdbool.h>

void
func(void)
{
    bool value;
    int ret;

    ret = system_info_get_platform_bool("http://tizen.org/feature/camera", &value);
    if (ret != SYSTEM_INFO_ERROR_NONE) {
        /* Error handling */

        return;
    }

    dlog_print(DLOG_INFO, LOG_TAG, "Camera: %s", value ? "Supported" : "Not supported");
}

Feature Keys

The following table lists the account feature keys:

Table: Account feature keys

The following table lists the accessibility feature keys:

Table: Accessibility feature keys

The following table lists the application history feature keys:

Table: Application history feature keys

The following table lists the attach panel feature keys:

Table: Attach panel feature keys

The following table lists the battery feature keys:

Table: Battery feature keys

The following table lists the camera feature keys:

Table: Camera feature keys

The following table lists the consumer IR feature keys:

Table: Consumer IR feature keys

The following table lists the content feature keys:

Table: Content feature keys

The following table lists the contextual trigger feature keys:

Table: Contextual trigger feature keys

The following table lists the database feature keys:

Table: Database feature keys

The following table lists the diagnostics feature keys:

Table: Diagnostics feature keys

The following table lists the download feature keys:

Table: Download feature keys

The following table lists the vibration feedback feature keys:

Table: Vibration feedback feature keys

The following table lists the FIDO feature keys:

Table: FIDO feature keys

The following table lists the FM radio feature keys:

Table: FM radio feature keys

The following table lists the graphics feature keys:

Table: Graphics feature keys

The following table lists the human activity monitor feature keys:

Table: Human activity monitor feature keys

The following table lists the input feature keys:

Table: Input feature keys

The following table lists the IOT feature keys:

Table: IOT feature keys

The following table lists the LED feature keys:

Table: LED feature keys

The following table lists the location feature keys:

Table: Location feature keys

The following table lists the machine learning feature keys:

Table: Machine Learning feature keys

The following table lists the maps feature keys:

Table: Maps feature keys

The following table lists the media feature keys:

Table: Media feature keys

The following table lists the microphone feature keys:

Table: Microphone feature keys

The following table lists the multimedia feature keys:

Table: Multimedia feature keys

The following table lists the multi-point touch feature keys:

Table: Multi-point touch feature keys

The following table lists the network feature keys:

Table: Network feature keys

The following table lists the OAuth 2.0 feature keys:

Table: OAuth 2.0 feature keys

The following table lists the OpenGL® ES feature keys:

Table: OpenGL® ES feature keys

The following table lists the Peripheral-IO feature keys:

Table: Peripheral-IO feature keys

The following table lists the platform feature keys:

Table: Platform feature keys

The following table lists the profile feature keys:

Table: Profile feature keys

The following table lists the screen feature keys:

Table: Screen feature keys

The following table lists the security feature keys:

Table: Security feature keys

The following table lists the sensor feature keys:

Table: Sensor feature keys

The following table lists the shell feature keys:

Table: Shell feature keys

The following table lists the sip feature keys:

Table: Sip feature keys

The following table lists the speech feature keys:

Table: Speech feature keys

The following table lists the external storage feature keys:

Table: External storage feature keys

The following table lists the system setting feature keys:

Table: System setting feature keys

The following table lists the thermistor feature keys:

Table: Thermistor feature keys

The following table lists the sticker feature keys:

Table: UI Sticker feature keys

The following table lists the USB feature keys:

Table: USB feature keys

The following table lists the vision feature keys:

Table: Vision feature keys

The following table lists the Web feature keys:

Table: Web feature keys

System Keys

The following table lists the build system keys:

Table: Build system keys

The following table lists the device type system keys:

Table: Device type system keys

The following table lists the manufacturer keys:

Table: Manufacturer keys

The following table lists the model name system keys:

Table: Model name system keys

The following table lists the platform system keys:

Table: Platform system keys

The following table lists the sound system keys:

Table: Sound system keys

The following table lists the TizenID system keys:

Table: TizenID system keys

Related Information

• Dependencies
  • Tizen 2.4 and Higher for Mobile
  • Tizen 2.3.1 and Higher for Wearable