linux/drivers/gpu/drm/i915/selftests/i915_selftest.c
<<
>>
Prefs
   1/*
   2 * Copyright © 2016 Intel Corporation
   3 *
   4 * Permission is hereby granted, free of charge, to any person obtaining a
   5 * copy of this software and associated documentation files (the "Software"),
   6 * to deal in the Software without restriction, including without limitation
   7 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
   8 * and/or sell copies of the Software, and to permit persons to whom the
   9 * Software is furnished to do so, subject to the following conditions:
  10 *
  11 * The above copyright notice and this permission notice (including the next
  12 * paragraph) shall be included in all copies or substantial portions of the
  13 * Software.
  14 *
  15 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  16 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  17 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
  18 * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
  19 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
  20 * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
  21 * IN THE SOFTWARE.
  22 */
  23
  24#include <linux/random.h>
  25
  26#include "../i915_drv.h"
  27#include "../i915_selftest.h"
  28
  29struct i915_selftest i915_selftest __read_mostly = {
  30        .timeout_ms = 1000,
  31};
  32
  33int i915_mock_sanitycheck(void)
  34{
  35        pr_info(DRIVER_NAME ": %s() - ok!\n", __func__);
  36        return 0;
  37}
  38
  39int i915_live_sanitycheck(struct drm_i915_private *i915)
  40{
  41        pr_info("%s: %s() - ok!\n", i915->drm.driver->name, __func__);
  42        return 0;
  43}
  44
  45enum {
  46#define selftest(name, func) mock_##name,
  47#include "i915_mock_selftests.h"
  48#undef selftest
  49};
  50
  51enum {
  52#define selftest(name, func) live_##name,
  53#include "i915_live_selftests.h"
  54#undef selftest
  55};
  56
  57struct selftest {
  58        bool enabled;
  59        const char *name;
  60        union {
  61                int (*mock)(void);
  62                int (*live)(struct drm_i915_private *);
  63        };
  64};
  65
  66#define selftest(n, f) [mock_##n] = { .name = #n, { .mock = f } },
  67static struct selftest mock_selftests[] = {
  68#include "i915_mock_selftests.h"
  69};
  70#undef selftest
  71
  72#define selftest(n, f) [live_##n] = { .name = #n, { .live = f } },
  73static struct selftest live_selftests[] = {
  74#include "i915_live_selftests.h"
  75};
  76#undef selftest
  77
  78/* Embed the line number into the parameter name so that we can order tests */
  79#define selftest(n, func) selftest_0(n, func, param(n))
  80#define param(n) __PASTE(igt__, __PASTE(__LINE__, __mock_##n))
  81#define selftest_0(n, func, id) \
  82module_param_named(id, mock_selftests[mock_##n].enabled, bool, 0400);
  83#include "i915_mock_selftests.h"
  84#undef selftest_0
  85#undef param
  86
  87#define param(n) __PASTE(igt__, __PASTE(__LINE__, __live_##n))
  88#define selftest_0(n, func, id) \
  89module_param_named(id, live_selftests[live_##n].enabled, bool, 0400);
  90#include "i915_live_selftests.h"
  91#undef selftest_0
  92#undef param
  93#undef selftest
  94
  95static void set_default_test_all(struct selftest *st, unsigned int count)
  96{
  97        unsigned int i;
  98
  99        for (i = 0; i < count; i++)
 100                if (st[i].enabled)
 101                        return;
 102
 103        for (i = 0; i < count; i++)
 104                st[i].enabled = true;
 105}
 106
 107static int __run_selftests(const char *name,
 108                           struct selftest *st,
 109                           unsigned int count,
 110                           void *data)
 111{
 112        int err = 0;
 113
 114        while (!i915_selftest.random_seed)
 115                i915_selftest.random_seed = get_random_int();
 116
 117        i915_selftest.timeout_jiffies =
 118                i915_selftest.timeout_ms ?
 119                msecs_to_jiffies_timeout(i915_selftest.timeout_ms) :
 120                MAX_SCHEDULE_TIMEOUT;
 121
 122        set_default_test_all(st, count);
 123
 124        pr_info(DRIVER_NAME ": Performing %s selftests with st_random_seed=0x%x st_timeout=%u\n",
 125                name, i915_selftest.random_seed, i915_selftest.timeout_ms);
 126
 127        /* Tests are listed in order in i915_*_selftests.h */
 128        for (; count--; st++) {
 129                if (!st->enabled)
 130                        continue;
 131
 132                cond_resched();
 133                if (signal_pending(current))
 134                        return -EINTR;
 135
 136                pr_debug(DRIVER_NAME ": Running %s\n", st->name);
 137                if (data)
 138                        err = st->live(data);
 139                else
 140                        err = st->mock();
 141                if (err == -EINTR && !signal_pending(current))
 142                        err = 0;
 143                if (err)
 144                        break;
 145        }
 146
 147        if (WARN(err > 0 || err == -ENOTTY,
 148                 "%s returned %d, conflicting with selftest's magic values!\n",
 149                 st->name, err))
 150                err = -1;
 151
 152        return err;
 153}
 154
 155#define run_selftests(x, data) \
 156        __run_selftests(#x, x##_selftests, ARRAY_SIZE(x##_selftests), data)
 157
 158int i915_mock_selftests(void)
 159{
 160        int err;
 161
 162        if (!i915_selftest.mock)
 163                return 0;
 164
 165        err = run_selftests(mock, NULL);
 166        if (err) {
 167                i915_selftest.mock = err;
 168                return err;
 169        }
 170
 171        if (i915_selftest.mock < 0) {
 172                i915_selftest.mock = -ENOTTY;
 173                return 1;
 174        }
 175
 176        return 0;
 177}
 178
 179int i915_live_selftests(struct pci_dev *pdev)
 180{
 181        int err;
 182
 183        if (!i915_selftest.live)
 184                return 0;
 185
 186        err = run_selftests(live, to_i915(pci_get_drvdata(pdev)));
 187        if (err) {
 188                i915_selftest.live = err;
 189                return err;
 190        }
 191
 192        if (i915_selftest.live < 0) {
 193                i915_selftest.live = -ENOTTY;
 194                return 1;
 195        }
 196
 197        return 0;
 198}
 199
 200int __i915_subtests(const char *caller,
 201                    const struct i915_subtest *st,
 202                    unsigned int count,
 203                    void *data)
 204{
 205        int err;
 206
 207        for (; count--; st++) {
 208                cond_resched();
 209                if (signal_pending(current))
 210                        return -EINTR;
 211
 212                pr_debug(DRIVER_NAME ": Running %s/%s\n", caller, st->name);
 213                err = st->func(data);
 214                if (err && err != -EINTR) {
 215                        pr_err(DRIVER_NAME "/%s: %s failed with error %d\n",
 216                               caller, st->name, err);
 217                        return err;
 218                }
 219        }
 220
 221        return 0;
 222}
 223
 224bool __igt_timeout(unsigned long timeout, const char *fmt, ...)
 225{
 226        va_list va;
 227
 228        if (!signal_pending(current)) {
 229                cond_resched();
 230                if (time_before(jiffies, timeout))
 231                        return false;
 232        }
 233
 234        if (fmt) {
 235                va_start(va, fmt);
 236                vprintk(fmt, va);
 237                va_end(va);
 238        }
 239
 240        return true;
 241}
 242
 243module_param_named(st_random_seed, i915_selftest.random_seed, uint, 0400);
 244module_param_named(st_timeout, i915_selftest.timeout_ms, uint, 0400);
 245
 246module_param_named_unsafe(mock_selftests, i915_selftest.mock, int, 0400);
 247MODULE_PARM_DESC(mock_selftests, "Run selftests before loading, using mock hardware (0:disabled [default], 1:run tests then load driver, -1:run tests then exit module)");
 248
 249module_param_named_unsafe(live_selftests, i915_selftest.live, int, 0400);
 250MODULE_PARM_DESC(live_selftests, "Run selftests after driver initialisation on the live system (0:disabled [default], 1:run tests then continue, -1:run tests then exit module)");
 251