[linux-2.6-block.git] / include / linux / linear_range.h

/* SPDX-License-Identifier: GPL-2.0 */
/* Copyright (C) 2020 ROHM Semiconductors */

#ifndef LINEAR_RANGE_H
#define LINEAR_RANGE_H

#include <linux/types.h>

/**
 * struct linear_range - table of selector - value pairs
 *
 * Define a lookup-table for range of values. Intended to help when looking
 * for a register value matching certaing physical measure (like voltage).
 * Usable when increment of one in register always results a constant increment
 * of the physical measure (like voltage).
 *
 * @min:  Lowest value in range
 * @min_sel: Lowest selector for range
 * @max_sel: Highest selector for range
 * @step: Value step size
 */
struct linear_range {
	unsigned int min;
	unsigned int min_sel;
	unsigned int max_sel;
	unsigned int step;
};

unsigned int linear_range_values_in_range(const struct linear_range *r);
unsigned int linear_range_values_in_range_array(const struct linear_range *r,
						int ranges);
unsigned int linear_range_get_max_value(const struct linear_range *r);

int linear_range_get_value(const struct linear_range *r, unsigned int selector,
			   unsigned int *val);
int linear_range_get_value_array(const struct linear_range *r, int ranges,
				 unsigned int selector, unsigned int *val);
int linear_range_get_selector_low(const struct linear_range *r,
				  unsigned int val, unsigned int *selector,
				  bool *found);
int linear_range_get_selector_high(const struct linear_range *r,
				   unsigned int val, unsigned int *selector,
				   bool *found);
void linear_range_get_selector_within(const struct linear_range *r,
				      unsigned int val, unsigned int *selector);
int linear_range_get_selector_low_array(const struct linear_range *r,
					int ranges, unsigned int val,
					unsigned int *selector, bool *found);

#endif
Commit	Line	Data
d2218d4e MV	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	*/
	22	struct linear_range {
	23	unsigned int min;
	24	unsigned int min_sel;
	25	unsigned int max_sel;
	26	unsigned int step;
	27	};
	28
	29	unsigned int linear_range_values_in_range(const struct linear_range *r);
	30	unsigned int linear_range_values_in_range_array(const struct linear_range *r,
	31	int ranges);
	32	unsigned int linear_range_get_max_value(const struct linear_range *r);
	33
	34	int linear_range_get_value(const struct linear_range *r, unsigned int selector,
	35	unsigned int *val);
	36	int linear_range_get_value_array(const struct linear_range *r, int ranges,
	37	unsigned int selector, unsigned int *val);
	38	int linear_range_get_selector_low(const struct linear_range *r,
	39	unsigned int val, unsigned int *selector,
	40	bool *found);
	41	int linear_range_get_selector_high(const struct linear_range *r,
	42	unsigned int val, unsigned int *selector,
	43	bool *found);
e12ef7bf GC	44	void linear_range_get_selector_within(const struct linear_range *r,
e12ef7bf GC	45	unsigned int val, unsigned int *selector);
d2218d4e MV	46	int linear_range_get_selector_low_array(const struct linear_range *r,
	47	int ranges, unsigned int val,
	48	unsigned int selector, bool found);
	49
	50	#endif