mirror of
https://github.com/ARM-software/workload-automation.git
synced 2025-11-17 23:36:06 +00:00
1b0799bcc5
Ensure that the terminal window size is set to 500x200, if not long commands (prompt + command > 80 chars) will fail because the pexpect search to match the command string in order to get the result and the command is wrapped to first 80 chars. For example, when check a file and executes: ... if [ -f '/sys/kernel/debug/sched_features' ]; then echo 1; else echo 0; fi ... File \"/usr/local/lib/python2.7/dist-packages/wlauto/common/linux/device.py\", line 228, in get_properties if self.is_file(propfile): File \"/usr/local/lib/python2.7/dist-packages/wlauto/common/linux/device.py\", line 215, in is_file return boolean(output.split()[-1]) # pylint: disable=maybe-no-member IndexError(list index out of range) ... In order to fix this scenario enables checkwinsize in the shell and use stty to set the new terminal window size. Signed-off-by: Aníbal Limón <anibal.limon@linaro.org>
Workload Automation
+++++++++++++++++++
Workload Automation (WA) is a framework for executing workloads and collecting
measurements on Android and Linux devices. WA includes automation for nearly 50
workloads (mostly Android), some common instrumentation (ftrace, ARM
Streamline, hwmon). A number of output formats are supported.
Workload Automation is designed primarily as a developer tool/framework to
facilitate data driven development by providing a method of collecting
measurements from a device in a repeatable way.
Workload Automation is highly extensible. Most of the concrete functionality is
implemented via plug-ins, and it is easy to write new plug-ins to support new
device types, workloads, instrumentation or output processing.
Requirements
============
- Python 2.7
- Linux (should work on other Unixes, but untested)
- Latest Android SDK (ANDROID_HOME must be set) for Android devices, or
- SSH for Linux devices
Installation
============
To install::
python setup.py sdist
sudo pip install dist/wlauto-*.tar.gz
Please refer to the `installation section <./doc/source/installation.rst>`_
in the documentation for more details.
Basic Usage
===========
Please see the `Quickstart <./doc/source/quickstart.rst>`_ section of the
documentation.
Documentation
=============
You can view pre-built HTML documentation
`here <http://workload-automation.readthedocs.io/en/latest/>`_.
Documentation in reStructuredText format may be found under ``doc/source``. To
compile it into cross-linked HTML, make sure you have `Sphinx
<http://sphinx-doc.org/install.html>`_ installed, and then ::
cd doc
make html
License
=======
Workload Automation is distributed under `Apache v2.0 License
<http://www.apache.org/licenses/LICENSE-2.0>`_. Workload automation includes
binaries distributed under differnt licenses (see LICENSE files in specfic
directories).
Feedback, Contrubutions and Support
===================================
- Please use the GitHub Issue Tracker associated with this repository for
feedback.
- ARM licensees may contact ARM directly via their partner managers.
- We welcome code contributions via GitHub Pull requests. Please see
"Contributing Code" section of the documentation for details.