1 From 3f935fd9776cace286d40ab37726f80c8d2ed8b1 Mon Sep 17 00:00:00 2001
2 From: Maxime Ripard <maxime@cerno.tech>
3 Date: Fri, 1 Apr 2022 17:08:26 +0200
4 Subject: [PATCH] clk: tests: Add test suites description
6 We start to have a few test suites, and we'll add more, so it will get
7 pretty confusing to figure out what is supposed to be tested in what
10 Let's add some comments to explain what setup they create, and what we
11 should be testing in every suite.
13 Tested-by: Alexander Stein <alexander.stein@ew.tq-group.com> # imx8mp
14 Tested-by: Marek Szyprowski <m.szyprowski@samsung.com> # exynos4210, meson g12b
15 Signed-off-by: Maxime Ripard <maxime@cerno.tech>
17 drivers/clk/clk_test.c | 36 ++++++++++++++++++++++++++++++++++++
18 1 file changed, 36 insertions(+)
20 --- a/drivers/clk/clk_test.c
21 +++ b/drivers/clk/clk_test.c
22 @@ -250,6 +250,11 @@ static struct kunit_case clk_test_cases[
27 + * Test suite for a basic rate clock, without any parent.
29 + * These tests are supposed to exercise the rate API with simple scenarios
31 static struct kunit_suite clk_test_suite = {
33 .init = clk_test_init,
34 @@ -336,6 +341,14 @@ static struct kunit_case clk_orphan_tran
39 + * Test suite for a basic mux clock with one parent. The parent is
40 + * registered after its child. The clock will thus be orphan when
41 + * registered, but will no longer be when the tests run.
43 + * These tests are supposed to make sure a clock that used to be orphan
44 + * has a sane, consistent, behaviour.
46 static struct kunit_suite clk_orphan_transparent_single_parent_test_suite = {
47 .name = "clk-orphan-transparent-single-parent-test",
48 .init = clk_orphan_transparent_single_parent_mux_test_init,
49 @@ -645,6 +658,13 @@ static struct kunit_case clk_range_test_
54 + * Test suite for a basic rate clock, without any parent.
56 + * These tests are supposed to exercise the rate range API
57 + * (clk_set_rate_range, clk_set_min_rate, clk_set_max_rate,
60 static struct kunit_suite clk_range_test_suite = {
61 .name = "clk-range-test",
62 .init = clk_test_init,
63 @@ -822,6 +842,14 @@ static struct kunit_case clk_range_maxim
68 + * Test suite for a basic rate clock, without any parent.
70 + * These tests are supposed to exercise the rate range API
71 + * (clk_set_rate_range, clk_set_min_rate, clk_set_max_rate,
72 + * clk_drop_range), with a driver that will always try to run at the
73 + * highest possible rate.
75 static struct kunit_suite clk_range_maximize_test_suite = {
76 .name = "clk-range-maximize-test",
77 .init = clk_maximize_test_init,
78 @@ -991,6 +1019,14 @@ static struct kunit_case clk_range_minim
83 + * Test suite for a basic rate clock, without any parent.
85 + * These tests are supposed to exercise the rate range API
86 + * (clk_set_rate_range, clk_set_min_rate, clk_set_max_rate,
87 + * clk_drop_range), with a driver that will always try to run at the
88 + * lowest possible rate.
90 static struct kunit_suite clk_range_minimize_test_suite = {
91 .name = "clk-range-minimize-test",
92 .init = clk_minimize_test_init,