Skip to content

TQRG/physalia

Repository files navigation

Build Status PyPI version PyPI downloads PyPI status Code Health

Physalia

Energy measurement framework for Mobile Apps.

More info and documentation in the website.

Install

$ python3 -m venv venv
$ source venv/bin/activate
$ pip install git+https://github.com/luiscruz/PyMonsoon
$ pip install physalia

You may have to install libusb:

brew install libusb

Example

The simplest way to measure something:

from physalia.power_meters import MonsoonPowerMeter
from time import sleep

 # change voltage and serial number accordingly:
power_meter = MonsoonPowerMeter(voltage=3.8, serial=12886)
power_meter.start()
sleep(2) # some work
energy_consumption, duration, error_flag = power_meter.stop()

Physalia also features more advanced control, allowing to insall APKs, and repeat measurements:

from physalia.power_meters import MonsoonPowerMeter
from physalia.energy_profiler import AndroidUseCase
from time import sleep

 # change voltage and serial number accordingly:
power_meter = MonsoonPowerMeter(voltage=3.8, serial=12886)

def run(usecase):
	sleep(2) # some work

use_case = AndroidUseCase(
  'login',
  'path/to/apk',
  'com.test.app',
  '0.0',
  prepare=None,
  run=run,
  cleanup=None
)
measurement = use_case.run(power_meter=power_meter)
print(measurement)

Contributing

Please help us improve this library!

If you have ideas for new features or anything behaves unexpectedly please report an issue.

If you find an issue you can actually help fixing please make a pull request of your code.

Running tests

To run all tests and checks locally run:

$ detox -e py27,py36

Debugging

Unable to find device

Try executing with sudo.

Device doesn't power on

Connect device to the front of Monsoon with a USB cable.