[thirdparty/u-boot.git] / include / regmap.h

/* SPDX-License-Identifier: GPL-2.0+ */
/*
 * Copyright (c) 2015 Google, Inc
 * Written by Simon Glass <sjg@chromium.org>
 */

#ifndef __REGMAP_H
#define __REGMAP_H

/**
 * DOC: Overview
 *
 * Regmaps are an abstraction mechanism that allows device drivers to access
 * register maps irrespective of the underlying bus architecture. This entails
 * that for devices that support multiple busses (e.g. I2C and SPI for a GPIO
 * expander chip) only one driver has to be written. This driver will
 * instantiate a regmap with a backend depending on the bus the device is
 * attached to, and use the regmap API to access the register map through that
 * bus transparently.
 *
 * Read and write functions are supplied, which can read/write data of
 * arbitrary length from/to the regmap.
 *
 * The endianness of regmap accesses is selectable for each map through device
 * tree settings via the boolean "little-endian", "big-endian", and
 * "native-endian" properties.
 *
 * Furthermore, the register map described by a regmap can be split into
 * multiple disjoint areas called ranges. In this way, register maps with
 * "holes", i.e. areas of addressable memory that are not part of the register
 * map, can be accessed in a concise manner.
 *
 * Currently, only a bare "mem" backend for regmaps is supported, which
 * accesses the register map as regular IO-mapped memory.
 */

/**
 * enum regmap_size_t - Access sizes for regmap reads and writes
 *
 * @REGMAP_SIZE_8: 8-bit read/write access size
 * @REGMAP_SIZE_16: 16-bit read/write access size
 * @REGMAP_SIZE_32: 32-bit read/write access size
 * @REGMAP_SIZE_64: 64-bit read/write access size
 */
enum regmap_size_t {
	REGMAP_SIZE_8 = 1,
	REGMAP_SIZE_16 = 2,
	REGMAP_SIZE_32 = 4,
	REGMAP_SIZE_64 = 8,
};

/**
 * enum regmap_endianness_t - Endianness for regmap reads and writes
 *
 * @REGMAP_NATIVE_ENDIAN: Native endian read/write accesses
 * @REGMAP_LITTLE_ENDIAN: Little endian read/write accesses
 * @REGMAP_BIG_ENDIAN: Big endian read/write accesses
 */
enum regmap_endianness_t {
	REGMAP_NATIVE_ENDIAN,
	REGMAP_LITTLE_ENDIAN,
	REGMAP_BIG_ENDIAN,
};

/**
 * struct regmap_range - a register map range
 *
 * @start:	Start address
 * @size:	Size in bytes
 */
struct regmap_range {
	ulong start;
	ulong size;
};

/**
 * struct regmap - a way of accessing hardware/bus registers
 *
 * @range_count:	Number of ranges available within the map
 * @ranges:		Array of ranges
 */
struct regmap {
	enum regmap_endianness_t endianness;
	int range_count;
	struct regmap_range ranges[0];
};

/*
 * Interface to provide access to registers either through a direct memory
 * bus or through a peripheral bus like I2C, SPI.
 */

/**
 * regmap_write() - Write a 32-bit value to a regmap
 *
 * @map:	Regmap to write to
 * @offset:	Offset in the regmap to write to
 * @val:	Data to write to the regmap at the specified offset
 *
 * Note that this function will only write values of 32 bit width to the
 * regmap; if the size of data to be read is different, the regmap_raw_write
 * function can be used.
 *
 * Return: 0 if OK, -ve on error
 */
int regmap_write(struct regmap *map, uint offset, uint val);

/**
 * regmap_read() - Read a 32-bit value from a regmap
 *
 * @map:	Regmap to read from
 * @offset:	Offset in the regmap to read from
 * @valp:	Pointer to the buffer to receive the data read from the regmap
 *		at the specified offset
 *
 * Note that this function will only read values of 32 bit width from the
 * regmap; if the size of data to be read is different, the regmap_raw_read
 * function can be used.
 *
 * Return: 0 if OK, -ve on error
 */
int regmap_read(struct regmap *map, uint offset, uint *valp);

/**
 * regmap_raw_write() - Write a value of specified length to a regmap
 *
 * @map:	Regmap to write to
 * @offset:	Offset in the regmap to write to
 * @val:	Value to write to the regmap at the specified offset
 * @val_len:	Length of the data to be written to the regmap
 *
 * Note that this function will, as opposed to regmap_write, write data of
 * arbitrary length to the regmap, and not just 32-bit values, and is thus a
 * generalized version of regmap_write.
 *
 * Return: 0 if OK, -ve on error
 */
int regmap_raw_write(struct regmap *map, uint offset, const void *val,
		     size_t val_len);

/**
 * regmap_raw_read() - Read a value of specified length from a regmap
 *
 * @map:	Regmap to read from
 * @offset:	Offset in the regmap to read from
 * @valp:	Pointer to the buffer to receive the data read from the regmap
 *		at the specified offset
 * @val_len:	Length of the data to be read from the regmap
 *
 * Note that this function will, as opposed to regmap_read, read data of
 * arbitrary length from the regmap, and not just 32-bit values, and is thus a
 * generalized version of regmap_read.
 *
 * Return: 0 if OK, -ve on error
 */
int regmap_raw_read(struct regmap *map, uint offset, void *valp,
		    size_t val_len);

/**
 * regmap_raw_write_range() - Write a value of specified length to a range of a
 *			      regmap
 *
 * @map:	Regmap to write to
 * @range_num:	Number of the range in the regmap to write to
 * @offset:	Offset in the regmap to write to
 * @val:	Value to write to the regmap at the specified offset
 * @val_len:	Length of the data to be written to the regmap
 *
 * Return: 0 if OK, -ve on error
 */
int regmap_raw_write_range(struct regmap *map, uint range_num, uint offset,
			   const void *val, size_t val_len);

/**
 * regmap_raw_read_range() - Read a value of specified length from a range of a
 *			     regmap
 *
 * @map:	Regmap to read from
 * @range_num:	Number of the range in the regmap to write to
 * @offset:	Offset in the regmap to read from
 * @valp:	Pointer to the buffer to receive the data read from the regmap
 *		at the specified offset
 * @val_len:	Length of the data to be read from the regmap
 *
 * Return: 0 if OK, -ve on error
 */
int regmap_raw_read_range(struct regmap *map, uint range_num, uint offset,
			  void *valp, size_t val_len);

/**
 * regmap_range_set() - Set a value in a regmap range described by a struct
 * @map:    Regmap in which a value should be set
 * @range:  Range of the regmap in which a value should be set
 * @type:   Structure type that describes the memory layout of the regmap range
 * @member: Member of the describing structure that should be set in the regmap
 *          range
 * @val:    Value which should be written to the regmap range
 */
#define regmap_range_set(map, range, type, member, val) \
	do { \
		typeof(((type *)0)->member) __tmp = val; \
		regmap_raw_write_range(map, range, offsetof(type, member), \
				       &__tmp, sizeof(((type *)0)->member)); \
	} while (0)

/**
 * regmap_set() - Set a value in a regmap described by a struct
 * @map:    Regmap in which a value should be set
 * @type:   Structure type that describes the memory layout of the regmap
 * @member: Member of the describing structure that should be set in the regmap
 * @val:    Value which should be written to the regmap
 */
#define regmap_set(map, type, member, val) \
	regmap_range_set(map, 0, type, member, val)

/**
 * regmap_range_get() - Get a value from a regmap range described by a struct
 * @map:    Regmap from which a value should be read
 * @range:  Range of the regmap from which a value should be read
 * @type:   Structure type that describes the memory layout of the regmap
 *          range
 * @member: Member of the describing structure that should be read in the
 *          regmap range
 * @valp:   Variable that receives the value read from the regmap range
 */
#define regmap_range_get(map, range, type, member, valp) \
	regmap_raw_read_range(map, range, offsetof(type, member), \
			      (void *)valp, sizeof(((type *)0)->member))

/**
 * regmap_get() - Get a value from a regmap described by a struct
 * @map:    Regmap from which a value should be read
 * @type:   Structure type that describes the memory layout of the regmap
 *          range
 * @member: Member of the describing structure that should be read in the
 *          regmap
 * @valp:   Variable that receives the value read from the regmap
 */
#define regmap_get(map, type, member, valp) \
	regmap_range_get(map, 0, type, member, valp)

/**
 * regmap_read_poll_timeout - Poll until a condition is met or a timeout occurs
 *
 * @map:	Regmap to read from
 * @addr:	Offset to poll
 * @val:	Unsigned integer variable to read the value into
 * @cond:	Break condition (usually involving @val)
 * @sleep_us:	Maximum time to sleep between reads in us (0 tight-loops).
 * @timeout_ms:	Timeout in ms, 0 means never timeout
 *
 * Returns 0 on success and -ETIMEDOUT upon a timeout or the regmap_read
 * error return value in case of a error read. In the two former cases,
 * the last read value at @addr is stored in @val. Must not be called
 * from atomic context if sleep_us or timeout_us are used.
 *
 * This is modelled after the regmap_read_poll_timeout macros in linux but
 * with millisecond timeout.
 */
#define regmap_read_poll_timeout(map, addr, val, cond, sleep_us, timeout_ms) \
({ \
	unsigned long __start = get_timer(0); \
	int __ret; \
	for (;;) { \
		__ret = regmap_read((map), (addr), &(val)); \
		if (__ret) \
			break; \
		if (cond) \
			break; \
		if ((timeout_ms) && get_timer(__start) > (timeout_ms)) { \
			__ret = regmap_read((map), (addr), &(val)); \
			break; \
		} \
		if ((sleep_us)) \
			udelay((sleep_us)); \
	} \
	__ret ?: ((cond) ? 0 : -ETIMEDOUT); \
})

/**
 * regmap_update_bits() - Perform a read/modify/write using a mask
 *
 * @map:	The map returned by regmap_init_mem*()
 * @offset:	Offset of the memory
 * @mask:	Mask to apply to the read value
 * @val:	Value to apply to the value to write
 * Return: 0 if OK, -ve on error
 */
int regmap_update_bits(struct regmap *map, uint offset, uint mask, uint val);

/**
 * regmap_init_mem() - Set up a new register map that uses memory access
 *
 * @node:	Device node that uses this map
 * @mapp:	Returns allocated map
 * Return: 0 if OK, -ve on error
 *
 * Use regmap_uninit() to free it.
 */
int regmap_init_mem(ofnode node, struct regmap **mapp);

/**
 * regmap_init_mem_platdata() - Set up a new memory register map for
 *				of-platdata
 *
 * @dev:	Device that uses this map
 * @reg:	List of address, size pairs
 * @count:	Number of pairs (e.g. 1 if the regmap has a single entry)
 * @mapp:	Returns allocated map
 * Return: 0 if OK, -ve on error
 *
 * This creates a new regmap with a list of regions passed in, rather than
 * using the device tree. It only supports 32-bit machines.
 *
 * Use regmap_uninit() to free it.
 *
 */
int regmap_init_mem_platdata(struct udevice *dev, fdt_val_t *reg, int count,
			     struct regmap **mapp);

/**
 * regmap_get_range() - Obtain the base memory address of a regmap range
 *
 * @map:	Regmap to query
 * @range_num:	Range to look up
 * Return: Pointer to the range in question if OK, NULL on error
 */
void *regmap_get_range(struct regmap *map, unsigned int range_num);

/**
 * regmap_uninit() - free a previously inited regmap
 *
 * @map:	Regmap to free
 * Return: 0 if OK, -ve on error
 */
int regmap_uninit(struct regmap *map);

#endif
Commit	Line	Data
83d290c5	1	/* SPDX-License-Identifier: GPL-2.0+ */
6f98b750 SG	2	/*
	3	* Copyright (c) 2015 Google, Inc
	4	* Written by Simon Glass <sjg@chromium.org>
6f98b750 SG	5	*/
	6
	7	#ifndef __REGMAP_H
	8	#define __REGMAP_H
	9
a6d4b060 MS	10	/**
	11	* DOC: Overview
	12	*
	13	* Regmaps are an abstraction mechanism that allows device drivers to access
	14	* register maps irrespective of the underlying bus architecture. This entails
	15	* that for devices that support multiple busses (e.g. I2C and SPI for a GPIO
	16	* expander chip) only one driver has to be written. This driver will
	17	* instantiate a regmap with a backend depending on the bus the device is
	18	* attached to, and use the regmap API to access the register map through that
	19	* bus transparently.
	20	*
	21	* Read and write functions are supplied, which can read/write data of
	22	* arbitrary length from/to the regmap.
	23	*
	24	* The endianness of regmap accesses is selectable for each map through device
	25	* tree settings via the boolean "little-endian", "big-endian", and
	26	* "native-endian" properties.
	27	*
	28	* Furthermore, the register map described by a regmap can be split into
	29	* multiple disjoint areas called ranges. In this way, register maps with
	30	* "holes", i.e. areas of addressable memory that are not part of the register
	31	* map, can be accessed in a concise manner.
	32	*
	33	* Currently, only a bare "mem" backend for regmaps is supported, which
	34	* accesses the register map as regular IO-mapped memory.
	35	*/
	36
84ff8f62 MS	37	/**
	38	* enum regmap_size_t - Access sizes for regmap reads and writes
	39	*
	40	* @REGMAP_SIZE_8: 8-bit read/write access size
	41	* @REGMAP_SIZE_16: 16-bit read/write access size
	42	* @REGMAP_SIZE_32: 32-bit read/write access size
	43	* @REGMAP_SIZE_64: 64-bit read/write access size
	44	*/
	45	enum regmap_size_t {
	46	REGMAP_SIZE_8 = 1,
	47	REGMAP_SIZE_16 = 2,
	48	REGMAP_SIZE_32 = 4,
	49	REGMAP_SIZE_64 = 8,
	50	};
	51
9b77fe3b MS	52	/**
	53	* enum regmap_endianness_t - Endianness for regmap reads and writes
	54	*
	55	* @REGMAP_NATIVE_ENDIAN: Native endian read/write accesses
	56	* @REGMAP_LITTLE_ENDIAN: Little endian read/write accesses
	57	* @REGMAP_BIG_ENDIAN: Big endian read/write accesses
	58	*/
	59	enum regmap_endianness_t {
	60	REGMAP_NATIVE_ENDIAN,
	61	REGMAP_LITTLE_ENDIAN,
	62	REGMAP_BIG_ENDIAN,
	63	};
	64
6f98b750 SG	65	/**
	66	* struct regmap_range - a register map range
	67	*
	68	* @start: Start address
	69	* @size: Size in bytes
	70	*/
	71	struct regmap_range {
	72	ulong start;
	73	ulong size;
	74	};
	75
	76	/**
	77	* struct regmap - a way of accessing hardware/bus registers
	78	*
604b6696 MS	79	* @range_count: Number of ranges available within the map
604b6696 MS	80	* @ranges: Array of ranges
6f98b750 SG	81	*/
6f98b750 SG	82	struct regmap {
9b77fe3b	83	enum regmap_endianness_t endianness;
6f98b750	84	int range_count;
8c1de5e0	85	struct regmap_range ranges[0];
6f98b750 SG	86	};
	87
	88	/*
	89	* Interface to provide access to registers either through a direct memory
	90	* bus or through a peripheral bus like I2C, SPI.
	91	*/
604b6696 MS	92
	93	/**
	94	* regmap_write() - Write a 32-bit value to a regmap
	95	*
	96	* @map: Regmap to write to
	97	* @offset: Offset in the regmap to write to
	98	* @val: Data to write to the regmap at the specified offset
	99	*
84ff8f62 MS	100	* Note that this function will only write values of 32 bit width to the
	101	* regmap; if the size of data to be read is different, the regmap_raw_write
	102	* function can be used.
	103	*
604b6696 MS	104	* Return: 0 if OK, -ve on error
604b6696 MS	105	*/
6f98b750	106	int regmap_write(struct regmap *map, uint offset, uint val);
604b6696 MS	107
	108	/**
	109	* regmap_read() - Read a 32-bit value from a regmap
	110	*
	111	* @map: Regmap to read from
	112	* @offset: Offset in the regmap to read from
	113	* @valp: Pointer to the buffer to receive the data read from the regmap
	114	* at the specified offset
	115	*
84ff8f62 MS	116	* Note that this function will only read values of 32 bit width from the
	117	* regmap; if the size of data to be read is different, the regmap_raw_read
	118	* function can be used.
	119	*
604b6696 MS	120	* Return: 0 if OK, -ve on error
604b6696 MS	121	*/
6f98b750 SG	122	int regmap_read(struct regmap map, uint offset, uint valp);
6f98b750 SG	123
84ff8f62 MS	124	/**
	125	* regmap_raw_write() - Write a value of specified length to a regmap
	126	*
	127	* @map: Regmap to write to
	128	* @offset: Offset in the regmap to write to
	129	* @val: Value to write to the regmap at the specified offset
	130	* @val_len: Length of the data to be written to the regmap
	131	*
	132	* Note that this function will, as opposed to regmap_write, write data of
	133	* arbitrary length to the regmap, and not just 32-bit values, and is thus a
	134	* generalized version of regmap_write.
	135	*
	136	* Return: 0 if OK, -ve on error
	137	*/
	138	int regmap_raw_write(struct regmap map, uint offset, const void val,
	139	size_t val_len);
	140
	141	/**
	142	* regmap_raw_read() - Read a value of specified length from a regmap
	143	*
	144	* @map: Regmap to read from
	145	* @offset: Offset in the regmap to read from
	146	* @valp: Pointer to the buffer to receive the data read from the regmap
	147	* at the specified offset
	148	* @val_len: Length of the data to be read from the regmap
	149	*
	150	* Note that this function will, as opposed to regmap_read, read data of
	151	* arbitrary length from the regmap, and not just 32-bit values, and is thus a
	152	* generalized version of regmap_read.
	153	*
	154	* Return: 0 if OK, -ve on error
	155	*/
	156	int regmap_raw_read(struct regmap map, uint offset, void valp,
	157	size_t val_len);
	158
d5c7bd98 MS	159	/**
	160	* regmap_raw_write_range() - Write a value of specified length to a range of a
	161	* regmap
	162	*
	163	* @map: Regmap to write to
	164	* @range_num: Number of the range in the regmap to write to
	165	* @offset: Offset in the regmap to write to
	166	* @val: Value to write to the regmap at the specified offset
	167	* @val_len: Length of the data to be written to the regmap
	168	*
	169	* Return: 0 if OK, -ve on error
	170	*/
	171	int regmap_raw_write_range(struct regmap *map, uint range_num, uint offset,
	172	const void *val, size_t val_len);
	173
	174	/**
	175	* regmap_raw_read_range() - Read a value of specified length from a range of a
	176	* regmap
	177	*
	178	* @map: Regmap to read from
	179	* @range_num: Number of the range in the regmap to write to
	180	* @offset: Offset in the regmap to read from
	181	* @valp: Pointer to the buffer to receive the data read from the regmap
	182	* at the specified offset
	183	* @val_len: Length of the data to be read from the regmap
	184	*
	185	* Return: 0 if OK, -ve on error
	186	*/
	187	int regmap_raw_read_range(struct regmap *map, uint range_num, uint offset,
	188	void *valp, size_t val_len);
	189
e936397a MS	190	/**
	191	* regmap_range_set() - Set a value in a regmap range described by a struct
	192	* @map: Regmap in which a value should be set
	193	* @range: Range of the regmap in which a value should be set
	194	* @type: Structure type that describes the memory layout of the regmap range
	195	* @member: Member of the describing structure that should be set in the regmap
	196	* range
	197	* @val: Value which should be written to the regmap range
	198	*/
	199	#define regmap_range_set(map, range, type, member, val) \
	200	do { \
	201	typeof(((type *)0)->member) __tmp = val; \
	202	regmap_raw_write_range(map, range, offsetof(type, member), \
	203	&__tmp, sizeof(((type *)0)->member)); \
	204	} while (0)
	205
	206	/**
	207	* regmap_set() - Set a value in a regmap described by a struct
	208	* @map: Regmap in which a value should be set
	209	* @type: Structure type that describes the memory layout of the regmap
	210	* @member: Member of the describing structure that should be set in the regmap
	211	* @val: Value which should be written to the regmap
	212	*/
	213	#define regmap_set(map, type, member, val) \
	214	regmap_range_set(map, 0, type, member, val)
6f98b750	215
e936397a MS	216	/**
	217	* regmap_range_get() - Get a value from a regmap range described by a struct
	218	* @map: Regmap from which a value should be read
	219	* @range: Range of the regmap from which a value should be read
	220	* @type: Structure type that describes the memory layout of the regmap
	221	* range
	222	* @member: Member of the describing structure that should be read in the
	223	* regmap range
	224	* @valp: Variable that receives the value read from the regmap range
	225	*/
	226	#define regmap_range_get(map, range, type, member, valp) \
	227	regmap_raw_read_range(map, range, offsetof(type, member), \
	228	(void )valp, sizeof(((type )0)->member))
	229
	230	/**
	231	* regmap_get() - Get a value from a regmap described by a struct
	232	* @map: Regmap from which a value should be read
	233	* @type: Structure type that describes the memory layout of the regmap
	234	* range
	235	* @member: Member of the describing structure that should be read in the
	236	* regmap
	237	* @valp: Variable that receives the value read from the regmap
	238	*/
	239	#define regmap_get(map, type, member, valp) \
	240	regmap_range_get(map, 0, type, member, valp)
6f98b750	241
d13801ef NA	242	/**
	243	* regmap_read_poll_timeout - Poll until a condition is met or a timeout occurs
	244	*
	245	* @map: Regmap to read from
	246	* @addr: Offset to poll
	247	* @val: Unsigned integer variable to read the value into
	248	* @cond: Break condition (usually involving @val)
	249	* @sleep_us: Maximum time to sleep between reads in us (0 tight-loops).
	250	* @timeout_ms: Timeout in ms, 0 means never timeout
	251	*
	252	* Returns 0 on success and -ETIMEDOUT upon a timeout or the regmap_read
	253	* error return value in case of a error read. In the two former cases,
	254	* the last read value at @addr is stored in @val. Must not be called
	255	* from atomic context if sleep_us or timeout_us are used.
	256	*
	257	* This is modelled after the regmap_read_poll_timeout macros in linux but
	258	* with millisecond timeout.
	259	*/
	260	#define regmap_read_poll_timeout(map, addr, val, cond, sleep_us, timeout_ms) \
	261	({ \
	262	unsigned long __start = get_timer(0); \
	263	int __ret; \
	264	for (;;) { \
	265	__ret = regmap_read((map), (addr), &(val)); \
	266	if (__ret) \
	267	break; \
	268	if (cond) \
	269	break; \
	270	if ((timeout_ms) && get_timer(__start) > (timeout_ms)) { \
	271	__ret = regmap_read((map), (addr), &(val)); \
	272	break; \
	273	} \
	274	if ((sleep_us)) \
	275	udelay((sleep_us)); \
	276	} \
	277	__ret ?: ((cond) ? 0 : -ETIMEDOUT); \
	278	})
	279
285cbcf9 NA	280	/**
	281	* regmap_update_bits() - Perform a read/modify/write using a mask
	282	*
	283	* @map: The map returned by regmap_init_mem*()
	284	* @offset: Offset of the memory
	285	* @mask: Mask to apply to the read value
	286	* @val: Value to apply to the value to write
604b6696	287	* Return: 0 if OK, -ve on error
285cbcf9 NA	288	*/
	289	int regmap_update_bits(struct regmap *map, uint offset, uint mask, uint val);
	290
6f98b750 SG	291	/**
	292	* regmap_init_mem() - Set up a new register map that uses memory access
	293	*
d3581236	294	* @node: Device node that uses this map
6f98b750	295	* @mapp: Returns allocated map
604b6696 MS	296	* Return: 0 if OK, -ve on error
	297	*
	298	* Use regmap_uninit() to free it.
6f98b750	299	*/
d3581236	300	int regmap_init_mem(ofnode node, struct regmap **mapp);
6f98b750	301
1e6ca1a6	302	/**
604b6696 MS	303	* regmap_init_mem_platdata() - Set up a new memory register map for
	304	* of-platdata
	305	*
	306	* @dev: Device that uses this map
	307	* @reg: List of address, size pairs
	308	* @count: Number of pairs (e.g. 1 if the regmap has a single entry)
	309	* @mapp: Returns allocated map
	310	* Return: 0 if OK, -ve on error
1e6ca1a6 SG	311	*
	312	* This creates a new regmap with a list of regions passed in, rather than
	313	* using the device tree. It only supports 32-bit machines.
	314	*
	315	* Use regmap_uninit() to free it.
	316	*
1e6ca1a6	317	*/
c20ee0ed	318	int regmap_init_mem_platdata(struct udevice dev, fdt_val_t reg, int count,
3b2a29e0 SG	319	struct regmap **mapp);
3b2a29e0 SG	320
6f98b750 SG	321	/**
	322	* regmap_get_range() - Obtain the base memory address of a regmap range
	323	*
	324	* @map: Regmap to query
	325	* @range_num: Range to look up
604b6696	326	* Return: Pointer to the range in question if OK, NULL on error
6f98b750 SG	327	*/
	328	void regmap_get_range(struct regmap map, unsigned int range_num);
	329
	330	/**
	331	* regmap_uninit() - free a previously inited regmap
604b6696 MS	332	*
	333	* @map: Regmap to free
	334	* Return: 0 if OK, -ve on error
6f98b750 SG	335	*/
	336	int regmap_uninit(struct regmap *map);
	337
	338	#endif