1/* SPDX-License-Identifier: GPL-2.0 */
2/* Copyright (C) 2020 ROHM Semiconductors */
3
4#ifndef LINEAR_RANGE_H
5#define LINEAR_RANGE_H
6
7#include <linux/types.h>
8
9/**
10 * struct linear_range - table of selector - value pairs
11 *
12 * Define a lookup-table for range of values. Intended to help when looking
13 * for a register value matching certaing physical measure (like voltage).
14 * Usable when increment of one in register always results a constant increment
15 * of the physical measure (like voltage).
16 *
17 * @min:  Lowest value in range
18 * @min_sel: Lowest selector for range
19 * @max_sel: Highest selector for range
20 * @step: Value step size
21 */
22struct linear_range {
23	unsigned int min;
24	unsigned int min_sel;
25	unsigned int max_sel;
26	unsigned int step;
27};
28
29#define LINEAR_RANGE(_min, _min_sel, _max_sel, _step)		\
30	{							\
31		.min = _min,					\
32		.min_sel = _min_sel,				\
33		.max_sel = _max_sel,				\
34		.step = _step,					\
35	}
36
37#define LINEAR_RANGE_IDX(_idx, _min, _min_sel, _max_sel, _step)	\
38	[_idx] = LINEAR_RANGE(_min, _min_sel, _max_sel, _step)
39
40unsigned int linear_range_values_in_range(const struct linear_range *r);
41unsigned int linear_range_values_in_range_array(const struct linear_range *r,
42						int ranges);
43unsigned int linear_range_get_max_value(const struct linear_range *r);
44
45int linear_range_get_value(const struct linear_range *r, unsigned int selector,
46			   unsigned int *val);
47int linear_range_get_value_array(const struct linear_range *r, int ranges,
48				 unsigned int selector, unsigned int *val);
49int linear_range_get_selector_low(const struct linear_range *r,
50				  unsigned int val, unsigned int *selector,
51				  bool *found);
52int linear_range_get_selector_high(const struct linear_range *r,
53				   unsigned int val, unsigned int *selector,
54				   bool *found);
55void linear_range_get_selector_within(const struct linear_range *r,
56				      unsigned int val, unsigned int *selector);
57int linear_range_get_selector_low_array(const struct linear_range *r,
58					int ranges, unsigned int val,
59					unsigned int *selector, bool *found);
60
61#endif
62