eGEN

eGEN Overview

Language Description

Sample Adaptation Policy

AdaptationPolicy 01 {    Condition {        BatteryState = Discharging  AND        BatteryLevel = Low AND        Threshold_High = 63 AND        Threshold_Medium = 46 AND        AppState = Background     }then    Adaptation {        SensingInterval = 250 AND        Decreasing_Factor = 20 AND        BatteryAwareFunction = Linear     }}

How to Use?

We have uploaded instructional videos on youtube.

Please watch thefirst youtube video to do the following:

Download the latestEclipse IDE Installer

Download theJava JDK 17

Please watch thesecond youtube video to do the following:

Installation and Setup

> Install the IDE for DSL developers> Create a Xtext Project> Write DSL grammar > Write the necessary Xtend code

Use the framework to generate code

> Launch Eclipse Application to test the framework> Create a sample project> Write a sample adaptation policy > Generate Java templates containing code for self-adaptive location-sensing

Exact Adaptation Policy Instrumented for Subject Applications

AdaptationPolicy 01 {    Condition {        BatteryState = Discharging  AND        BatteryLevel =  High AND        Threshold_High = 80 AND        Threshold_Medium = 50 AND        AppState = Foreground     }then    Adaptation {        SensingInterval = 3000 AND        Decreasing_Factor = 10 AND        BatteryAwareFunction = Linear     }}AdaptationPolicy 02 {    Condition {        BatteryState = Discharging  AND        BatteryLevel =  Medium AND        Threshold_High = 80 AND        Threshold_Medium = 50 AND        AppState = Foreground     }then    Adaptation {        SensingInterval = 4000 AND        Decreasing_Factor = 20 AND        BatteryAwareFunction = Linear     }}AdaptationPolicy 03 {    Condition {        BatteryState = Discharging  AND        BatteryLevel =  Low AND        Threshold_High = 80 AND        Threshold_Medium = 50 AND        AppState = Foreground     }then    Adaptation {        SensingInterval = 5000 AND        Decreasing_Factor = 30 AND        BatteryAwareFunction = Linear     }}

Design rationale behind the Adaptation Policies

Android device at any instant of time can be subjected to the following exhaustive list of cases:         Case1: Battery is discharging and the subject application is in the foreground    Case2: Battery is discharging and the subject application is in the background    Case3: Battery is charging and the subject application is in the foreground    Case4: Battery is charging and the subject application is in the background When the device is subjected to experimentation, the maximum battery consumption can be found in Case1 followed by Case2, 3 and 4. The subject application trails were executed when the battery is dischargingand the application is in the foreground (Case1). A GPS sensing interval of 1 or 2 seconds helps in producing accurate distance measurement, and increasing the value to more than 10 seconds worsens theaccuracy of the distance measurement for the length of the track we considered (3km), hence for thenon-eGEN version of the subject application we have decided to set sensing interval to 5 seconds that can help in achieving decent accuracy. For eGEN versions of subject applications, We have designed simple adaptation policies that tend to reduce the battery consumption as the battery level decreases,hence when the battery is high (greater than 80\%) the defined adaptation policy focuses more on producing accurate location than saving battery and this trend reverses as battery transitions to lower levels. The sensing interval behavior with respect to battery level of the device is plotted in the below figure. Since, we are confining to a GPS relaxation time of 5 sec (for non-eGEN) to not compromise on location accuracy, we decided to draft the adaptation policies such that the varying sensing intervalvalues when averaged for all the battery levels from zero to hundred would be close to 5000ms. The average sensing interval as calculated is 5666ms and we have shown in the below sections that savings have been reported through adaptation policies defined without losing the much of location accuracy when compared to Non-eGEN version.

Sensing interval impacted by the change in battery level

Subject Application Selection Criteria

Inclusion Criteria

1. If the app is written in Native Android code2. If GPS is primarily used for location sensing3. If the source code repository published with an open-source license 5. If the recent most commit is published less than two years6. If the repository is well documented

Exclusion Criteria

1. If the app's android support plugin is incompatible with our IntelliJ IDEA version used for instrumentation. 2. If the app has missing dependencies or other build errors 3. If it is not compatible with recent versions of Android (such as 10.0 or 9.0)4. If the app activity crashes while installing and using the Android application

Caculating battery consumption in percentage

How to Contact?

License