Runtime Information

You can access various runtime information and monitor changes in it.

The main features of the Runtime Information API include:

Getting runtime information with a key-value pair

You can retrieve a runtime information value using its key.
Getting runtime information with a function

You can retrieve runtime information using a function specific to a certain information.
Getting application runtime information

You can retrieve runtime information about running applications.
Monitoring runtime information changes

You can register a callback function to monitor specific changes in the runtime information.

Prerequisites

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

#include <runtime_info.h>

Getting Runtime Information with a Key-Value Pair

Some runtime information consists of key and value pairs.

To get information on, for example, whether Bluetooth is enabled or an audio jack connected:

Check whether Bluetooth is enabled.

Use the RUNTIME_INFO_KEY_BLUETOOTH_ENABLED key with the data type-specific get function.

The Bluetooth enabled key data type is bool, which means that you need to use the runtime_info_get_value_bool() function.

#include <stdbool.h>

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

    ret = runtime_info_get_value_bool(RUNTIME_INFO_KEY_BLUETOOTH_ENABLED, &value);
    if (ret != RUNTIME_INFO_ERROR_NONE) {
        /* Error handling */
        return;
    }
    dlog_print(DLOG_INFO, LOG_TAG, "Bluetooth: %s", value ? "Enabled" : "Disabled");
}

Get the audio jack connection status.

Use the RUNTIME_INFO_KEY_AUDIO_JACK_STATUS key with the data type-specific get function.

The audio jack status key data type is integer, which means that you need to use the runtime_info_get_value_int() function.

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

    ret = runtime_info_get_value_int(RUNTIME_INFO_KEY_AUDIO_JACK_STATUS, &value);
    if (ret != RUNTIME_INFO_ERROR_NONE) {
        /* Error handling */
        return;
    }

    dlog_print(DLOG_INFO, LOG_TAG, "Audio jack status: %d", value);
    switch (value) {
    case RUNTIME_INFO_AUDIO_JACK_STATUS_UNCONNECTED:
        /* Audio jack is disconnected */
        break;
    case RUNTIME_INFO_AUDIO_JACK_STATUS_CONNECTED_3WIRE:
        /* 3-conductor wire is connected */
        break;
    case RUNTIME_INFO_AUDIO_JACK_STATUS_CONNECTED_4WIRE:
        /* 4-conductor wire is connected */
        break;
    }
}

Getting Runtime Information with a Function

Some runtime information can be retrieved by using a function.

To get information on, for example, the current frequency of the CPU core 0, retrieve the CPU core frequency with the runtime_info_get_processor_current_frequency() function:

void
func(void)
{
    int core_idx = 0;
    int freq;
    int ret;

    ret = runtime_info_get_processor_current_frequency(core_idx, &freq);
    if (ret != RUNTIME_INFO_ERROR_NONE) {
        /* Error handling */

        return;
    }
    dlog_print(DLOG_INFO, LOG_TAG, "The frequency of CPU core 0: %d", freq);
}

Getting Application Runtime Information

You can get runtime information on running applications.

To get information on, for example, the memory usage for each application:

void
print_memory_usage(void)
{
    int ret;
    int i;
    int count;
    app_usage_h mem_usage_handle;
    char *appid;
    unsigned int usage;

    ret = runtime_info_get_all_apps_memory_usage(&mem_usage_handle);
    if (ret != RUNTIME_INFO_ERROR_NONE)
        /* Error handling */


    ret = runtime_info_app_usage_get_count(mem_usage_handle, &count);
    if (ret != RUNTIME_INFO_ERROR_NONE)
        /* Error handling */


    for (i = 0; i < count; i++) {
        ret = runtime_info_app_usage_get_appid(mem_usage_handle, i, &appid);
        if (ret != RUNTIME_INFO_ERROR_NONE)
            /* Error handling */


        ret = runtime_info_app_usage_get_usage(mem_usage_handle, i, &usage);
        if (ret != RUNTIME_INFO_ERROR_NONE)
            /* Error handling */


        dlog_print(DLOG_INFO, LOG_TAG, "appid = %s, usage = %u KB\n", appid, usage);
        free(appid);
    }

    ret = runtime_info_app_usage_destroy(mem_usage_handle);
    if (ret != RUNTIME_INFO_ERROR_NONE)
        /* Error handling */

}

Monitoring Runtime Information Changes

Applications can be notified about changes in the runtime information.

To monitor, for example, the connection state of the USB cable:

Use the runtime_info_set_changed_cb() function with the RUNTIME_INFO_KEY_USB_CONNECTED key to register a callback that is triggered each time the USB cable connection state changes:

#include <stdbool.h>

/* Callback */
void
usb_connection_changed(runtime_info_key_e key, void *user_data)
{
    bool value;
    int ret;

    if (key != RUNTIME_INFO_KEY_USB_CONNECTED)
        return;

    ret = runtime_info_get_value_bool(key, &value);
    if (ret != RUNTIME_INFO_ERROR_NONE) {
        /* Error handling */
        return;
    }

    dlog_print(DLOG_INFO, LOG_TAG, "USB status: %s", value ? "Connected" : "Disconnected");
}

/* Register and deregister */
void
func(void)
{
    int ret;
    void *data;

    ret = runtime_info_set_changed_cb(RUNTIME_INFO_KEY_USB_CONNECTED, usb_connection_changed, data);
    if (ret != RUNTIME_INFO_ERROR_NONE) {
        /* Error handling */
        return;
    }

When no longer needed, deregister the callback with the runtime_info_unset_changed_cb() function:

    ret = runtime_info_unset_changed_cb(RUNTIME_INFO_KEY_USB_CONNECTED);
    if (ret != RUNTIME_INFO_ERROR_NONE) {
        /* Error handling */
        return;
    }
}