Clone this repo:
  1. c881adf DO NOT MERGE by Xin Li · 6 days ago master oreo-mr1-iot-release android-o-mr1-iot-release-1.0.7
  2. 41680f3 Snap for 4605948 from 08808a75e6fd92995ad2be2730e9334ba8ce1c8a to pi-release by android-build-team Robot · 10 months ago pie-cts-release pie-gsi pie-platform-release pie-r2-release pie-r2-s1-release pie-r2-s2-release pie-release pie-release-2 pie-s2-release pie-vts-release android-9.0.0_r1 android-9.0.0_r10 android-9.0.0_r17 android-9.0.0_r18 android-9.0.0_r2 android-9.0.0_r3 android-9.0.0_r5 android-9.0.0_r6 android-9.0.0_r7 android-9.0.0_r8 android-9.0.0_r9 android-cts-9.0_r1 android-cts-9.0_r2 android-cts-9.0_r3 android-cts-9.0_r4 android-cts-9.0_r5 android-vts-9.0_r4 android-vts-9.0_r5 android-wear-9.0.0_r1 android-wear-9.0.0_r2 android-wear-9.0.0_r3
  3. 08808a7 Add metadata am: 8c0608b2d5 am: a55a504a4b am: c4f7765019 by Bill Yi · 10 months ago master-cuttlefish-testing-release oreo-mr1-1.2-iot-release pie-dev pie-dr1-dev pie-dr1-release pie-qpr1-release pie-qpr1-s1-release pie-qpr1-s2-release pie-qpr1-s3-release android-9.0.0_r11 android-9.0.0_r12 android-9.0.0_r16 android-9.0.0_r19 android-9.0.0_r20 android-9.0.0_r21 android-9.0.0_r22 android-o-mr1-iot-release-1.0.3 android-o-mr1-iot-release-1.0.4 android-o-mr1-iot-release-1.0.5 android-o-mr1-iot-release-smart-display-r3 android-o-mr1-iot-release-smart-display-r4 android-wear-8.0.0_r2
  4. c4f7765 Add metadata am: 8c0608b2d5 am: a55a504a4b by Bill Yi · 10 months ago
  5. a55a504 Add metadata am: 8c0608b2d5 by Bill Yi · 10 months ago

BART Build Status Version

The Behavioural Analysis and Regression Toolkit is based on TRAPpy. The primary goal is to assert behaviours using the FTrace output from the kernel.

Target Audience

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.

Kernel Developers

Making sure that the code that you are writing is doing the right thing.

Performance Engineers

Plotting/Asserting performance behaviours between different revisions of the kernel.

Quality Assurance/Release Engineers

Verifying behaviours when different components/patches are integrated.

Installation

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.

Required dependencies

Install additional tools required for some tests and functionalities

$ sudo apt install trace-cmd kernelshark

Install the Python package manager

$ sudo apt install python-pip python-dev

Install required python packages

$ 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.

Install BART

$ sudo pip install --upgrade bart-py

For developers

Instead of installing TRAPpy and BART using pip you should clone the repositories:

$ git clone git@github.com:ARM-software/bart.git
$ git clone git@github.com:ARM-software/trappy.git

Add the directories to your PYTHONPATH

$ export PYTHONPATH=$BASE_DIR/bart:$BASE_DIR/trappy:$PYTHONPATH

Trace Analysis Language

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

Scheduler Assertions

Enables assertion and the calculation of the following parameters:

Runtime

The total time that the task spent on a CPU executing.

Switch

Assert that a task switched between CPUs/Clusters in a given window of time.

Duty Cycle

The ratio of the execution time to the total time.

Period

The average difference between two switch-in or two switch-out events of a task.

First CPU

The first CPU that a task ran on.

Residency

Calculate and assert the total residency of a task on a CPU or cluster.

Examples

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.

API reference

The API reference can be found in https://pythonhosted.org/bart-py