[PATCH 3/3] doc: cpufreq: tests: Provide cpufreq tests README

[Lukasz Majewski <l.majewski@samsung.com>]

This commit adds README to ./tools/testing/cpufreq directory.

Signed-off-by: Lukasz Majewski <l.majewski@samsung.com>
---
 tools/testing/cpufreq/README | 53 ++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 53 insertions(+)
 create mode 100644 tools/testing/cpufreq/README

diff --git a/tools/testing/cpufreq/README b/tools/testing/cpufreq/README
new file mode 100644
index 0000000..c934016
--- /dev/null
+++ b/tools/testing/cpufreq/README
@@ -0,0 +1,53 @@
+This file contains list of cpufreq's available regression tests with a short
+usage description.
+
+1. cpufreq_freq_test.sh
+
+Description:
+------------
+This script is supposed to test if cpufreq attributes exported by sysfs are
+exposing correct values.
+
+To achieve this goal it saves the current governor and changes it to
+"performance". Afterwards, it reads the "scaling_available_frequencies"
+property. With the list of supported frequencies it is able to enforce each of
+them by writing to "scaling_max_freq" attribute. To make the test more reliable
+a superfluous load with gzip is created to be sure that we are running with
+highest possible frequency. This high load is regulated with the 'sleep'
+duration. After this time the "cpufreq_cur_freq" is read and compared with the
+original value. As the last step the original governor is restored.
+
+This script can work with or without BOOST enabled and helps in spotting errors
+related to cpufreq and common clock framework.
+
+Used attributes:
+----------------
+- "scaling_available_frequencies"
+- "cpuinfo_cur_freq"
+- "scaling_governor"
+- "scaling_max_freq"
+
+Target devices:
+---------------
+
+All devices which exports mentioned above sysfs attributes.
+
+2. governors_switch.sh
+
+Description:
+------------
+This script is supposed to test if all governors are available and possible to
+set.
+
+Moreover, it allows to test if cpufreq is able to withstand multiple accesses to
+the same sysfs attribute without crash.
+
+Used attributes:
+----------------
+- "scaling_available_governors"
+- "scaling_governor"
+
+Target devices:
+---------------
+
+All devices which exports mentioned above sysfs attributes.
-- 
2.0.0.rc2