manafa 0.3.2

E-MANAFA: Energy Monitor and ANAlyzer For Android

E-MANAFA: Energy Monitor and ANAlyzer For Android

E-MANAFA is a software model-based tool for performing fine-grained estimates of energy consumption on Android devices. For this purpose, it uses values from power_profile.xml and from the BatteryStats and Perfetto services to estimate the energy consumption of each resource / component of the device.

SETUP

In order to run this tool, the following resources are required:

• rooted Android device (running Android 9 or above);
• *nix-based environment (MAC OS , Linux);
• Python 3.6 or above;
• Android Sdk tools (https://developer.android.com/studio/releases/platform-tools)

Installation

1. Via python-pip

pip install manafa

1.1 define environment variables

In order to run this tool, there are at least 2 env. variables that need to be defined in the shell startup script (e.g .bashrc or .bash_profile file)

export ANDROID_HOME=$HOME/<your-android-instalation-folder>/ 
export PATH=$ANDROID_HOME/platform-tools:$PATH

2. From sources

2.1 Clone repo

$ git clone https://github.com/RRua/e-manafa.git

2.2 Replicate the environment

Install virtual virtualenv enviroment (via python-pip):

$ python -m pip install --user virtualenv

2.3 Replicate locally the dev virtualenv

$ virtualenv env/

2.4 Activate the virtual environment

$ source env/bin/activate

2.6 Install required packages

$ pip install -r requirements.txt

2.6 define environment variables

In order to run this tool, there are at least 2 env. variables that need to be defined in the shell startup script (e.g .bashrc or .bash_profile file)

export ANDROID_HOME=$HOME/<your-android-instalation-folder>/ 
export PATH=$ANDROID_HOME/platform-tools:$PATH

Usage

Command line

$ python emanafa.py [-p|--profile <prof>] 
            [-t|--timezone <tz>] 
            [-pft|--perfettofile <pf>] 
            [-bts|--batstatsfile <bf>] 

Source

m = EManafa()
m.init()
m.start()
do_work_to_profile() # replace by procedure to be measured 
b_file, p_file = m.stop()
m.parseResults(b_file, p_file)
begin = m.bat_events.events[0].time # first collected sample from batterystats
end = m.bat_events.events[-1].time # last collected sample from batterystats
global_consumption, per_component_consumption = m.getConsumptionInBetween(begin, end) # returns consumption between two instants of time between the profiling time
print(per_component_consumption)
print(global_consumption)

Supported devices:

This tool can be used with any Android device able to run Perfetto, available since Android 9 (P). The tool so far was successfuly executed on the following devices:

• Pixel 3a
• Pixel 4a 5G
• Xiaomi Mi 9 Lite

TODO

• calibrate the model
• test using flashlight