1 /* SPDX-License-Identifier: GPL-2.0-only */
54 #define REGMAP_UPSHIFT(s)	(-(s))
66  * struct reg_default - Default value for a register.
80  * struct reg_sequence - An individual write from a sequence of writes.
103  * regmap_read_poll_timeout - Poll until a condition is met or a timeout occurs
110  *            tight-loops).  Should be less than ~20ms since usleep_range
111  *            is used (see Documentation/timers/timers-howto.rst).
114  * Returns 0 on success and -ETIMEDOUT upon a timeout or the regmap_read
130  * regmap_read_poll_timeout_atomic - Poll until a condition is met or a timeout occurs
136  * @delay_us: Time to udelay between reads in us (0 tight-loops).
138  *            (see Documentation/timers/timers-howto.rst).
141  * Returns 0 on success and -ETIMEDOUT upon a timeout or the regmap_read
148  * this macro then first setup your regmap for atomic use (flat or no cache
171 	__ret ?: ((cond) ? 0 : -ETIMEDOUT); \
175  * regmap_field_read_poll_timeout - Poll until a condition is met or timeout
181  *            tight-loops).  Should be less than ~20ms since usleep_range
182  *            is used (see Documentation/timers/timers-howto.rst).
185  * Returns 0 on success and -ETIMEDOUT upon a timeout or the regmap_field_read
203 	/* Unspecified -> 0 -> Backwards compatible default */
211  * struct regmap_range - A register range, used for access related checks
214  * @range_min: address of first register
225  * struct regmap_access_table - A table of register ranges for access checks
235  * check function will return true. "no_ranges" are searched first.
248  * struct regmap_config - Configuration for the register map of a device.
312  *		  read operation on a bus such as SPI, I2C, etc. Most of the
319  *		     update_bits operation on a bus such as SPI, I2C, etc.
331  *		   Use it only for "no-bus" cases.
461  * struct regmap_range_cfg - Configuration for indirectly accessed or paged
473  * @window_start: Address of first (lowest) register in data window.
525  * struct regmap_bus - Description of a hardware bus for the register map
534  * @gather_write: Write operation with split register/value, return -ENOTSUPP
537  *               must serialise with respect to non-async I/O.
645 struct regmap *__regmap_init_spi_avmm(struct spi_device *spi,
714 struct regmap *__devm_regmap_init_spi_avmm(struct spi_device *spi,
725  * for each call. No-op if CONFIG_LOCKDEP is not set.
738 			"(" name ")->lock");				\
746  * regmap_init() - Initialise register map
749  * @bus: Bus-specific callbacks to use with device
750  * @bus_context: Data passed to bus-specific callbacks
755  * directly, it should be called by bus-specific init functions.
764  * regmap_init_i2c() - Initialise register map
777  * regmap_init_mdio() - Initialise register map
790  * regmap_init_sccb() - Initialise register map
803  * regmap_init_slimbus() - Initialise register map
816  * regmap_init_spi() - Initialise register map
829  * regmap_init_spmi_base() - Create regmap for the Base register space
842  * regmap_init_spmi_ext() - Create regmap for Ext register space
855  * regmap_init_w1() - Initialise register map
868  * regmap_init_mmio_clk() - Initialise register map with register clock
872  * @regs: Pointer to memory-mapped IO region
883  * regmap_init_mmio() - Initialise register map
886  * @regs: Pointer to memory-mapped IO region
896  * regmap_init_ac97() - Initialise AC'97 register map
910  * regmap_init_sdw() - Initialise register map
923  * regmap_init_sdw_mbq() - Initialise register map
936  * regmap_init_spi_avmm() - Initialize register map for Intel SPI Slave
939  * @spi: Device that will be interacted with
945 #define regmap_init_spi_avmm(spi, config)					\  argument
947 				 spi, config)
950  * regmap_init_fsi() - Initialise register map
963  * devm_regmap_init() - Initialise managed register map
966  * @bus: Bus-specific callbacks to use with device
967  * @bus_context: Data passed to bus-specific callbacks
972  * directly, it should be called by bus-specific init functions.  The
980  * devm_regmap_init_i2c() - Initialise managed register map
994  * devm_regmap_init_mdio() - Initialise managed register map
1008  * devm_regmap_init_sccb() - Initialise managed register map
1022  * devm_regmap_init_spi() - Initialise register map
1036  * devm_regmap_init_spmi_base() - Create managed regmap for Base register space
1050  * devm_regmap_init_spmi_ext() - Create managed regmap for Ext register space
1064  * devm_regmap_init_w1() - Initialise managed register map
1077  * devm_regmap_init_mmio_clk() - Initialise managed register map with clock
1081  * @regs: Pointer to memory-mapped IO region
1093  * devm_regmap_init_mmio() - Initialise managed register map
1096  * @regs: Pointer to memory-mapped IO region
1107  * devm_regmap_init_ac97() - Initialise AC'97 register map
1121  * devm_regmap_init_sdw() - Initialise managed register map
1135  * devm_regmap_init_sdw_mbq() - Initialise managed register map
1149  * devm_regmap_init_slimbus() - Initialise managed register map
1163  * devm_regmap_init_i3c() - Initialise managed register map
1177  * devm_regmap_init_spi_avmm() - Initialize register map for Intel SPI Slave
1180  * @spi: Device that will be interacted with
1187 #define devm_regmap_init_spi_avmm(spi, config)				\  argument
1189 				 spi, config)
1192  * devm_regmap_init_fsi() - Initialise managed register map
1303 	return reg >= range->range_min && reg <= range->range_max;  in regmap_reg_in_range()
1326  * struct reg_field - Description of an register field
1329  * @lsb: lsb of the register field.
1336 	unsigned int lsb;  member
1344 				.lsb = _lsb,	\
1350 				.lsb = _lsb,			\
1461  * struct regmap_irq_type - IRQ type definitions.
1481  * struct regmap_irq - Description of an IRQ for the generic regmap irq_chip.
1513  * struct regmap_irq_chip - Description of a generic regmap irq_chip.
1518  *		 interrupts arranged in separate sub-irq blocks with own IRQ
1520  *		 sub-irq blocks with unhandled interrupts. For such chips fill
1521  *		 sub-irq register information in status_base, mask_base and
1526  *		     registers. First item in array describes the registers
1527  *		     for first main status bit. Second array for second bit etc.
1531  *		     1.st bit to 1.st sub-reg, 2.nd bit to 2.nd sub-reg, ...
1556  * @clear_ack:  Use this to set 1 and 0 or vice-versa to clear interrupts.
1692 	return -EINVAL;  in regmap_write()
1699 	return -EINVAL;  in regmap_write_async()
1706 	return -EINVAL;  in regmap_raw_write()
1713 	return -EINVAL;  in regmap_raw_write_async()
1720 	return -EINVAL;  in regmap_noinc_write()
1727 	return -EINVAL;  in regmap_bulk_write()
1734 	return -EINVAL;  in regmap_read()
1741 	return -EINVAL;  in regmap_raw_read()
1748 	return -EINVAL;  in regmap_noinc_read()
1755 	return -EINVAL;  in regmap_bulk_read()
1763 	return -EINVAL;  in regmap_update_bits_base()
1770 	return -EINVAL;  in regmap_set_bits()
1777 	return -EINVAL;  in regmap_clear_bits()
1784 	return -EINVAL;  in regmap_test_bits()
1792 	return -EINVAL;  in regmap_field_update_bits_base()
1801 	return -EINVAL;  in regmap_fields_update_bits_base()
1808 	return -EINVAL;  in regmap_update_bits()
1815 	return -EINVAL;  in regmap_update_bits_async()
1823 	return -EINVAL;  in regmap_update_bits_check()
1832 	return -EINVAL;  in regmap_update_bits_check_async()
1839 	return -EINVAL;  in regmap_write_bits()
1846 	return -EINVAL;  in regmap_field_write()
1853 	return -EINVAL;  in regmap_field_force_write()
1860 	return -EINVAL;  in regmap_field_update_bits()
1868 	return -EINVAL;  in regmap_field_force_update_bits()
1875 	return -EINVAL;  in regmap_field_set_bits()
1882 	return -EINVAL;  in regmap_field_clear_bits()
1889 	return -EINVAL;  in regmap_field_test_bits()
1896 	return -EINVAL;  in regmap_fields_write()
1903 	return -EINVAL;  in regmap_fields_force_write()
1911 	return -EINVAL;  in regmap_fields_update_bits()
1919 	return -EINVAL;  in regmap_fields_force_update_bits()
1925 	return -EINVAL;  in regmap_get_val_bytes()
1931 	return -EINVAL;  in regmap_get_max_register()
1937 	return -EINVAL;  in regmap_get_reg_stride()
1949 	return -EINVAL;  in regcache_sync()
1956 	return -EINVAL;  in regcache_sync_region()
1963 	return -EINVAL;  in regcache_drop_region()
1991 	return -EINVAL;  in regmap_register_patch()
1998 	return -EINVAL;  in regmap_parse_val()