Unverified Commit ffc72771 authored by Wolfram Sang's avatar Wolfram Sang Committed by Mark Brown
Browse files

regmap: Annotate that MMIO implies fast IO 



Document that using the MMIO helpers will automatically enable the
'fast_io' parameter. This makes the used locking scheme more transparent
and avoids superfluous setting of this parameter in drivers.

Signed-off-by: default avatarWolfram Sang <wsa+renesas@sang-engineering.com>
Link: https://patch.msgid.link/20250725110337.4303-2-wsa+renesas@sang-engineering.com


Signed-off-by: default avatarMark Brown <broonie@kernel.org>
parent 9f711c93

include/linux/regmap.h

+4 −4
Original line number Diff line number Diff line
@@ -913,7 +913,7 @@ int regmap_attach_dev(struct device *dev, struct regmap *map, 
 * @config: Configuration for register map

 *

 * The return value will be an ERR_PTR() on error or a valid pointer to

 * a struct regmap.

 * a struct regmap. Implies 'fast_io'.

 */

#define regmap_init_mmio_clk(dev, clk_id, regs, config)			\

	__regmap_lockdep_wrapper(__regmap_init_mmio_clk, #config,	\
@@ -927,7 +927,7 @@ int regmap_attach_dev(struct device *dev, struct regmap *map, 
 * @config: Configuration for register map

 *

 * The return value will be an ERR_PTR() on error or a valid pointer to

 * a struct regmap.

 * a struct regmap. Implies 'fast_io'.

 */

#define regmap_init_mmio(dev, regs, config)		\

	regmap_init_mmio_clk(dev, NULL, regs, config)
@@ -1138,7 +1138,7 @@ bool regmap_ac97_default_volatile(struct device *dev, unsigned int reg); 
 *

 * The return value will be an ERR_PTR() on error or a valid pointer

 * to a struct regmap.  The regmap will be automatically freed by the

 * device management code.

 * device management code. Implies 'fast_io'.

 */

#define devm_regmap_init_mmio_clk(dev, clk_id, regs, config)		\

	__regmap_lockdep_wrapper(__devm_regmap_init_mmio_clk, #config,	\
@@ -1153,7 +1153,7 @@ bool regmap_ac97_default_volatile(struct device *dev, unsigned int reg); 
 *

 * The return value will be an ERR_PTR() on error or a valid pointer

 * to a struct regmap.  The regmap will be automatically freed by the

 * device management code.

 * device management code. Implies 'fast_io'.

 */

#define devm_regmap_init_mmio(dev, regs, config)		\

	devm_regmap_init_mmio_clk(dev, NULL, regs, config)