|author||android-build-team Robot <firstname.lastname@example.org>||Thu Feb 15 08:26:20 2018 +0000|
|committer||android-build-team Robot <email@example.com>||Thu Feb 15 08:26:20 2018 +0000|
Snap for 4605948 from 08808a75e6fd92995ad2be2730e9334ba8ce1c8a to pi-release Change-Id: I66b79f48ddb18bd976b567f8bdde7fea914850e1
The Behavioural Analysis and Regression Toolkit is based on TRAPpy. The primary goal is to assert behaviours using the FTrace output from the kernel.
The framework is designed to cater to a wide range of audience. Aiding developers as well as automating the testing of “difficult to test” behaviours.
Making sure that the code that you are writing is doing the right thing.
Plotting/Asserting performance behaviours between different revisions of the kernel.
Verifying behaviours when different components/patches are integrated.
The following instructions are for Ubuntu 14.04 LTS but they should also work with Debian jessie. Older versions of Ubuntu or Debian (e.g. Ubuntu 12.04 or Debian wheezy) will likely require to install more packages from pip as the ones present in Ubuntu 12.04 or Debian wheezy will probably be too old.
$ sudo apt install trace-cmd kernelshark
$ sudo apt install python-pip python-dev
$ sudo apt install libfreetype6-dev libpng12-dev python-nose $ sudo pip install numpy matplotlib pandas ipython[all] $ sudo pip install --upgrade trappy
ipython[all] will install IPython Notebook, a web based interactive python programming interface. It is required if you plan to use interactive plotting in BART.
$ sudo pip install --upgrade bart-py
Instead of installing TRAPpy and BART using
pip you should clone the repositories:
$ git clone firstname.lastname@example.org:ARM-software/bart.git $ git clone email@example.com:ARM-software/trappy.git
Add the directories to your PYTHONPATH
$ export PYTHONPATH=$BASE_DIR/bart:$BASE_DIR/trappy:$PYTHONPATH
BART also provides a generic Trace Analysis Language, which allows the user to construct complex relation statements on trace data and assert their expected behaviours. The usage of the Analyzer module can be seen for the thermal behaviours here
Enables assertion and the calculation of the following parameters:
The total time that the task spent on a CPU executing.
Assert that a task switched between CPUs/Clusters in a given window of time.
The ratio of the execution time to the total time.
The average difference between two switch-in or two switch-out events of a task.
The first CPU that a task ran on.
Calculate and assert the total residency of a task on a CPU or cluster.
The Scheduler assertions also use TRAPpy's EventPlot to provide a
kernelshark like timeline for the tasks under consideration. (in IPython notebooks).
A notebook explaining the usage of the framework for asserting the deadline scheduler behaviours can be seen here.
The API reference can be found in https://pythonhosted.org/bart-py