xref: /netbsd-src/sys/external/bsd/drm2/dist/drm/i915/selftests/i915_random.h (revision 41ec02673d281bbb3d38e6c78504ce6e30c228c1)
1 /*	$NetBSD: i915_random.h,v 1.2 2021/12/18 23:45:31 riastradh Exp $	*/
2 
3 /*
4  * Copyright © 2016 Intel Corporation
5  *
6  * Permission is hereby granted, free of charge, to any person obtaining a
7  * copy of this software and associated documentation files (the "Software"),
8  * to deal in the Software without restriction, including without limitation
9  * the rights to use, copy, modify, merge, publish, distribute, sublicense,
10  * and/or sell copies of the Software, and to permit persons to whom the
11  * Software is furnished to do so, subject to the following conditions:
12  *
13  * The above copyright notice and this permission notice (including the next
14  * paragraph) shall be included in all copies or substantial portions of the
15  * Software.
16  *
17  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
18  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
19  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
20  * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
21  * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
22  * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
23  * IN THE SOFTWARE.
24  *
25  */
26 
27 #ifndef __I915_SELFTESTS_RANDOM_H__
28 #define __I915_SELFTESTS_RANDOM_H__
29 
30 #include <linux/math64.h>
31 #include <linux/random.h>
32 
33 #include "../i915_selftest.h"
34 
35 #define I915_RND_STATE_INITIALIZER(x) ({				\
36 	struct rnd_state state__;					\
37 	prandom_seed_state(&state__, (x));				\
38 	state__;							\
39 })
40 
41 #define I915_RND_STATE(name__) \
42 	struct rnd_state name__ = I915_RND_STATE_INITIALIZER(i915_selftest.random_seed)
43 
44 #define I915_RND_SUBSTATE(name__, parent__) \
45 	struct rnd_state name__ = I915_RND_STATE_INITIALIZER(prandom_u32_state(&(parent__)))
46 
47 u64 i915_prandom_u64_state(struct rnd_state *rnd);
48 
i915_prandom_u32_max_state(u32 ep_ro,struct rnd_state * state)49 static inline u32 i915_prandom_u32_max_state(u32 ep_ro, struct rnd_state *state)
50 {
51 	return upper_32_bits(mul_u32_u32(prandom_u32_state(state), ep_ro));
52 }
53 
54 unsigned int *i915_random_order(unsigned int count,
55 				struct rnd_state *state);
56 void i915_random_reorder(unsigned int *order,
57 			 unsigned int count,
58 			 struct rnd_state *state);
59 
60 void i915_prandom_shuffle(void *arr, size_t elsz, size_t count,
61 			  struct rnd_state *state);
62 
63 u64 igt_random_offset(struct rnd_state *state,
64 		      u64 start, u64 end,
65 		      u64 len, u64 align);
66 
67 #endif /* !__I915_SELFTESTS_RANDOM_H__ */
68