~ [ source navigation ] ~ [ diff markup ] ~ [ identifier search ] ~

TOMOYO Linux Cross Reference
Linux/include/linux/regmap.h

Version: ~ [ linux-5.15-rc5 ] ~ [ linux-5.14.11 ] ~ [ linux-5.13.19 ] ~ [ linux-5.12.19 ] ~ [ linux-5.11.22 ] ~ [ linux-5.10.72 ] ~ [ linux-5.9.16 ] ~ [ linux-5.8.18 ] ~ [ linux-5.7.19 ] ~ [ linux-5.6.19 ] ~ [ linux-5.5.19 ] ~ [ linux-5.4.152 ] ~ [ linux-5.3.18 ] ~ [ linux-5.2.21 ] ~ [ linux-5.1.21 ] ~ [ linux-5.0.21 ] ~ [ linux-4.20.17 ] ~ [ linux-4.19.210 ] ~ [ linux-4.18.20 ] ~ [ linux-4.17.19 ] ~ [ linux-4.16.18 ] ~ [ linux-4.15.18 ] ~ [ linux-4.14.250 ] ~ [ linux-4.13.16 ] ~ [ linux-4.12.14 ] ~ [ linux-4.11.12 ] ~ [ linux-4.10.17 ] ~ [ linux-4.9.286 ] ~ [ linux-4.8.17 ] ~ [ linux-4.7.10 ] ~ [ linux-4.6.7 ] ~ [ linux-4.5.7 ] ~ [ linux-4.4.288 ] ~ [ linux-4.3.6 ] ~ [ linux-4.2.8 ] ~ [ linux-4.1.52 ] ~ [ linux-4.0.9 ] ~ [ linux-3.18.140 ] ~ [ linux-3.16.85 ] ~ [ linux-3.14.79 ] ~ [ linux-3.12.74 ] ~ [ linux-3.10.108 ] ~ [ linux-2.6.32.71 ] ~ [ linux-2.6.0 ] ~ [ linux-2.4.37.11 ] ~ [ unix-v6-master ] ~ [ ccs-tools-1.8.5 ] ~ [ policy-sample ] ~
Architecture: ~ [ i386 ] ~ [ alpha ] ~ [ m68k ] ~ [ mips ] ~ [ ppc ] ~ [ sparc ] ~ [ sparc64 ] ~

  1 #ifndef __LINUX_REGMAP_H
  2 #define __LINUX_REGMAP_H
  3 
  4 /*
  5  * Register map access API
  6  *
  7  * Copyright 2011 Wolfson Microelectronics plc
  8  *
  9  * Author: Mark Brown <broonie@opensource.wolfsonmicro.com>
 10  *
 11  * This program is free software; you can redistribute it and/or modify
 12  * it under the terms of the GNU General Public License version 2 as
 13  * published by the Free Software Foundation.
 14  */
 15 
 16 #include <linux/list.h>
 17 #include <linux/rbtree.h>
 18 #include <linux/err.h>
 19 #include <linux/bug.h>
 20 
 21 struct module;
 22 struct device;
 23 struct i2c_client;
 24 struct irq_domain;
 25 struct spi_device;
 26 struct spmi_device;
 27 struct regmap;
 28 struct regmap_range_cfg;
 29 struct regmap_field;
 30 
 31 /* An enum of all the supported cache types */
 32 enum regcache_type {
 33         REGCACHE_NONE,
 34         REGCACHE_RBTREE,
 35         REGCACHE_COMPRESSED,
 36         REGCACHE_FLAT,
 37 };
 38 
 39 /**
 40  * Default value for a register.  We use an array of structs rather
 41  * than a simple array as many modern devices have very sparse
 42  * register maps.
 43  *
 44  * @reg: Register address.
 45  * @def: Register default value.
 46  */
 47 struct reg_default {
 48         unsigned int reg;
 49         unsigned int def;
 50 };
 51 
 52 #ifdef CONFIG_REGMAP
 53 
 54 enum regmap_endian {
 55         /* Unspecified -> 0 -> Backwards compatible default */
 56         REGMAP_ENDIAN_DEFAULT = 0,
 57         REGMAP_ENDIAN_BIG,
 58         REGMAP_ENDIAN_LITTLE,
 59         REGMAP_ENDIAN_NATIVE,
 60 };
 61 
 62 /**
 63  * A register range, used for access related checks
 64  * (readable/writeable/volatile/precious checks)
 65  *
 66  * @range_min: address of first register
 67  * @range_max: address of last register
 68  */
 69 struct regmap_range {
 70         unsigned int range_min;
 71         unsigned int range_max;
 72 };
 73 
 74 #define regmap_reg_range(low, high) { .range_min = low, .range_max = high, }
 75 
 76 /*
 77  * A table of ranges including some yes ranges and some no ranges.
 78  * If a register belongs to a no_range, the corresponding check function
 79  * will return false. If a register belongs to a yes range, the corresponding
 80  * check function will return true. "no_ranges" are searched first.
 81  *
 82  * @yes_ranges : pointer to an array of regmap ranges used as "yes ranges"
 83  * @n_yes_ranges: size of the above array
 84  * @no_ranges: pointer to an array of regmap ranges used as "no ranges"
 85  * @n_no_ranges: size of the above array
 86  */
 87 struct regmap_access_table {
 88         const struct regmap_range *yes_ranges;
 89         unsigned int n_yes_ranges;
 90         const struct regmap_range *no_ranges;
 91         unsigned int n_no_ranges;
 92 };
 93 
 94 typedef void (*regmap_lock)(void *);
 95 typedef void (*regmap_unlock)(void *);
 96 
 97 /**
 98  * Configuration for the register map of a device.
 99  *
100  * @name: Optional name of the regmap. Useful when a device has multiple
101  *        register regions.
102  *
103  * @reg_bits: Number of bits in a register address, mandatory.
104  * @reg_stride: The register address stride. Valid register addresses are a
105  *              multiple of this value. If set to 0, a value of 1 will be
106  *              used.
107  * @pad_bits: Number of bits of padding between register and value.
108  * @val_bits: Number of bits in a register value, mandatory.
109  *
110  * @writeable_reg: Optional callback returning true if the register
111  *                 can be written to. If this field is NULL but wr_table
112  *                 (see below) is not, the check is performed on such table
113  *                 (a register is writeable if it belongs to one of the ranges
114  *                  specified by wr_table).
115  * @readable_reg: Optional callback returning true if the register
116  *                can be read from. If this field is NULL but rd_table
117  *                 (see below) is not, the check is performed on such table
118  *                 (a register is readable if it belongs to one of the ranges
119  *                  specified by rd_table).
120  * @volatile_reg: Optional callback returning true if the register
121  *                value can't be cached. If this field is NULL but
122  *                volatile_table (see below) is not, the check is performed on
123  *                such table (a register is volatile if it belongs to one of
124  *                the ranges specified by volatile_table).
125  * @precious_reg: Optional callback returning true if the register
126  *                should not be read outside of a call from the driver
127  *                (e.g., a clear on read interrupt status register). If this
128  *                field is NULL but precious_table (see below) is not, the
129  *                check is performed on such table (a register is precious if
130  *                it belongs to one of the ranges specified by precious_table).
131  * @lock:         Optional lock callback (overrides regmap's default lock
132  *                function, based on spinlock or mutex).
133  * @unlock:       As above for unlocking.
134  * @lock_arg:     this field is passed as the only argument of lock/unlock
135  *                functions (ignored in case regular lock/unlock functions
136  *                are not overridden).
137  * @reg_read:     Optional callback that if filled will be used to perform
138  *                all the reads from the registers. Should only be provided for
139  *                devices whose read operation cannot be represented as a simple
140  *                read operation on a bus such as SPI, I2C, etc. Most of the
141  *                devices do not need this.
142  * @reg_write:    Same as above for writing.
143  * @fast_io:      Register IO is fast. Use a spinlock instead of a mutex
144  *                to perform locking. This field is ignored if custom lock/unlock
145  *                functions are used (see fields lock/unlock of struct regmap_config).
146  *                This field is a duplicate of a similar file in
147  *                'struct regmap_bus' and serves exact same purpose.
148  *                 Use it only for "no-bus" cases.
149  * @max_register: Optional, specifies the maximum valid register index.
150  * @wr_table:     Optional, points to a struct regmap_access_table specifying
151  *                valid ranges for write access.
152  * @rd_table:     As above, for read access.
153  * @volatile_table: As above, for volatile registers.
154  * @precious_table: As above, for precious registers.
155  * @reg_defaults: Power on reset values for registers (for use with
156  *                register cache support).
157  * @num_reg_defaults: Number of elements in reg_defaults.
158  *
159  * @read_flag_mask: Mask to be set in the top byte of the register when doing
160  *                  a read.
161  * @write_flag_mask: Mask to be set in the top byte of the register when doing
162  *                   a write. If both read_flag_mask and write_flag_mask are
163  *                   empty the regmap_bus default masks are used.
164  * @use_single_rw: If set, converts the bulk read and write operations into
165  *                  a series of single read and write operations. This is useful
166  *                  for device that does not support bulk read and write.
167  * @can_multi_write: If set, the device supports the multi write mode of bulk
168  *                   write operations, if clear multi write requests will be
169  *                   split into individual write operations
170  *
171  * @cache_type: The actual cache type.
172  * @reg_defaults_raw: Power on reset values for registers (for use with
173  *                    register cache support).
174  * @num_reg_defaults_raw: Number of elements in reg_defaults_raw.
175  * @reg_format_endian: Endianness for formatted register addresses. If this is
176  *                     DEFAULT, the @reg_format_endian_default value from the
177  *                     regmap bus is used.
178  * @val_format_endian: Endianness for formatted register values. If this is
179  *                     DEFAULT, the @reg_format_endian_default value from the
180  *                     regmap bus is used.
181  *
182  * @ranges: Array of configuration entries for virtual address ranges.
183  * @num_ranges: Number of range configuration entries.
184  */
185 struct regmap_config {
186         const char *name;
187 
188         int reg_bits;
189         int reg_stride;
190         int pad_bits;
191         int val_bits;
192 
193         bool (*writeable_reg)(struct device *dev, unsigned int reg);
194         bool (*readable_reg)(struct device *dev, unsigned int reg);
195         bool (*volatile_reg)(struct device *dev, unsigned int reg);
196         bool (*precious_reg)(struct device *dev, unsigned int reg);
197         regmap_lock lock;
198         regmap_unlock unlock;
199         void *lock_arg;
200 
201         int (*reg_read)(void *context, unsigned int reg, unsigned int *val);
202         int (*reg_write)(void *context, unsigned int reg, unsigned int val);
203 
204         bool fast_io;
205 
206         unsigned int max_register;
207         const struct regmap_access_table *wr_table;
208         const struct regmap_access_table *rd_table;
209         const struct regmap_access_table *volatile_table;
210         const struct regmap_access_table *precious_table;
211         const struct reg_default *reg_defaults;
212         unsigned int num_reg_defaults;
213         enum regcache_type cache_type;
214         const void *reg_defaults_raw;
215         unsigned int num_reg_defaults_raw;
216 
217         u8 read_flag_mask;
218         u8 write_flag_mask;
219 
220         bool use_single_rw;
221         bool can_multi_write;
222 
223         enum regmap_endian reg_format_endian;
224         enum regmap_endian val_format_endian;
225 
226         const struct regmap_range_cfg *ranges;
227         unsigned int num_ranges;
228 };
229 
230 /**
231  * Configuration for indirectly accessed or paged registers.
232  * Registers, mapped to this virtual range, are accessed in two steps:
233  *     1. page selector register update;
234  *     2. access through data window registers.
235  *
236  * @name: Descriptive name for diagnostics
237  *
238  * @range_min: Address of the lowest register address in virtual range.
239  * @range_max: Address of the highest register in virtual range.
240  *
241  * @page_sel_reg: Register with selector field.
242  * @page_sel_mask: Bit shift for selector value.
243  * @page_sel_shift: Bit mask for selector value.
244  *
245  * @window_start: Address of first (lowest) register in data window.
246  * @window_len: Number of registers in data window.
247  */
248 struct regmap_range_cfg {
249         const char *name;
250 
251         /* Registers of virtual address range */
252         unsigned int range_min;
253         unsigned int range_max;
254 
255         /* Page selector for indirect addressing */
256         unsigned int selector_reg;
257         unsigned int selector_mask;
258         int selector_shift;
259 
260         /* Data window (per each page) */
261         unsigned int window_start;
262         unsigned int window_len;
263 };
264 
265 struct regmap_async;
266 
267 typedef int (*regmap_hw_write)(void *context, const void *data,
268                                size_t count);
269 typedef int (*regmap_hw_gather_write)(void *context,
270                                       const void *reg, size_t reg_len,
271                                       const void *val, size_t val_len);
272 typedef int (*regmap_hw_async_write)(void *context,
273                                      const void *reg, size_t reg_len,
274                                      const void *val, size_t val_len,
275                                      struct regmap_async *async);
276 typedef int (*regmap_hw_read)(void *context,
277                               const void *reg_buf, size_t reg_size,
278                               void *val_buf, size_t val_size);
279 typedef int (*regmap_hw_reg_read)(void *context, unsigned int reg,
280                                   unsigned int *val);
281 typedef int (*regmap_hw_reg_write)(void *context, unsigned int reg,
282                                    unsigned int val);
283 typedef struct regmap_async *(*regmap_hw_async_alloc)(void);
284 typedef void (*regmap_hw_free_context)(void *context);
285 
286 /**
287  * Description of a hardware bus for the register map infrastructure.
288  *
289  * @fast_io: Register IO is fast. Use a spinlock instead of a mutex
290  *           to perform locking. This field is ignored if custom lock/unlock
291  *           functions are used (see fields lock/unlock of
292  *           struct regmap_config).
293  * @write: Write operation.
294  * @gather_write: Write operation with split register/value, return -ENOTSUPP
295  *                if not implemented  on a given device.
296  * @async_write: Write operation which completes asynchronously, optional and
297  *               must serialise with respect to non-async I/O.
298  * @read: Read operation.  Data is returned in the buffer used to transmit
299  *         data.
300  * @async_alloc: Allocate a regmap_async() structure.
301  * @read_flag_mask: Mask to be set in the top byte of the register when doing
302  *                  a read.
303  * @reg_format_endian_default: Default endianness for formatted register
304  *     addresses. Used when the regmap_config specifies DEFAULT. If this is
305  *     DEFAULT, BIG is assumed.
306  * @val_format_endian_default: Default endianness for formatted register
307  *     values. Used when the regmap_config specifies DEFAULT. If this is
308  *     DEFAULT, BIG is assumed.
309  * @async_size: Size of struct used for async work.
310  */
311 struct regmap_bus {
312         bool fast_io;
313         regmap_hw_write write;
314         regmap_hw_gather_write gather_write;
315         regmap_hw_async_write async_write;
316         regmap_hw_reg_write reg_write;
317         regmap_hw_read read;
318         regmap_hw_reg_read reg_read;
319         regmap_hw_free_context free_context;
320         regmap_hw_async_alloc async_alloc;
321         u8 read_flag_mask;
322         enum regmap_endian reg_format_endian_default;
323         enum regmap_endian val_format_endian_default;
324 };
325 
326 struct regmap *regmap_init(struct device *dev,
327                            const struct regmap_bus *bus,
328                            void *bus_context,
329                            const struct regmap_config *config);
330 int regmap_attach_dev(struct device *dev, struct regmap *map,
331                                  const struct regmap_config *config);
332 struct regmap *regmap_init_i2c(struct i2c_client *i2c,
333                                const struct regmap_config *config);
334 struct regmap *regmap_init_spi(struct spi_device *dev,
335                                const struct regmap_config *config);
336 struct regmap *regmap_init_spmi_base(struct spmi_device *dev,
337                                      const struct regmap_config *config);
338 struct regmap *regmap_init_spmi_ext(struct spmi_device *dev,
339                                     const struct regmap_config *config);
340 struct regmap *regmap_init_mmio_clk(struct device *dev, const char *clk_id,
341                                     void __iomem *regs,
342                                     const struct regmap_config *config);
343 
344 struct regmap *devm_regmap_init(struct device *dev,
345                                 const struct regmap_bus *bus,
346                                 void *bus_context,
347                                 const struct regmap_config *config);
348 struct regmap *devm_regmap_init_i2c(struct i2c_client *i2c,
349                                     const struct regmap_config *config);
350 struct regmap *devm_regmap_init_spi(struct spi_device *dev,
351                                     const struct regmap_config *config);
352 struct regmap *devm_regmap_init_spmi_base(struct spmi_device *dev,
353                                           const struct regmap_config *config);
354 struct regmap *devm_regmap_init_spmi_ext(struct spmi_device *dev,
355                                          const struct regmap_config *config);
356 struct regmap *devm_regmap_init_mmio_clk(struct device *dev, const char *clk_id,
357                                          void __iomem *regs,
358                                          const struct regmap_config *config);
359 
360 /**
361  * regmap_init_mmio(): Initialise register map
362  *
363  * @dev: Device that will be interacted with
364  * @regs: Pointer to memory-mapped IO region
365  * @config: Configuration for register map
366  *
367  * The return value will be an ERR_PTR() on error or a valid pointer to
368  * a struct regmap.
369  */
370 static inline struct regmap *regmap_init_mmio(struct device *dev,
371                                         void __iomem *regs,
372                                         const struct regmap_config *config)
373 {
374         return regmap_init_mmio_clk(dev, NULL, regs, config);
375 }
376 
377 /**
378  * devm_regmap_init_mmio(): Initialise managed register map
379  *
380  * @dev: Device that will be interacted with
381  * @regs: Pointer to memory-mapped IO region
382  * @config: Configuration for register map
383  *
384  * The return value will be an ERR_PTR() on error or a valid pointer
385  * to a struct regmap.  The regmap will be automatically freed by the
386  * device management code.
387  */
388 static inline struct regmap *devm_regmap_init_mmio(struct device *dev,
389                                         void __iomem *regs,
390                                         const struct regmap_config *config)
391 {
392         return devm_regmap_init_mmio_clk(dev, NULL, regs, config);
393 }
394 
395 void regmap_exit(struct regmap *map);
396 int regmap_reinit_cache(struct regmap *map,
397                         const struct regmap_config *config);
398 struct regmap *dev_get_regmap(struct device *dev, const char *name);
399 int regmap_write(struct regmap *map, unsigned int reg, unsigned int val);
400 int regmap_write_async(struct regmap *map, unsigned int reg, unsigned int val);
401 int regmap_raw_write(struct regmap *map, unsigned int reg,
402                      const void *val, size_t val_len);
403 int regmap_bulk_write(struct regmap *map, unsigned int reg, const void *val,
404                         size_t val_count);
405 int regmap_multi_reg_write(struct regmap *map, const struct reg_default *regs,
406                         int num_regs);
407 int regmap_multi_reg_write_bypassed(struct regmap *map,
408                                     const struct reg_default *regs,
409                                     int num_regs);
410 int regmap_raw_write_async(struct regmap *map, unsigned int reg,
411                            const void *val, size_t val_len);
412 int regmap_read(struct regmap *map, unsigned int reg, unsigned int *val);
413 int regmap_raw_read(struct regmap *map, unsigned int reg,
414                     void *val, size_t val_len);
415 int regmap_bulk_read(struct regmap *map, unsigned int reg, void *val,
416                      size_t val_count);
417 int regmap_update_bits(struct regmap *map, unsigned int reg,
418                        unsigned int mask, unsigned int val);
419 int regmap_update_bits_async(struct regmap *map, unsigned int reg,
420                              unsigned int mask, unsigned int val);
421 int regmap_update_bits_check(struct regmap *map, unsigned int reg,
422                              unsigned int mask, unsigned int val,
423                              bool *change);
424 int regmap_update_bits_check_async(struct regmap *map, unsigned int reg,
425                                    unsigned int mask, unsigned int val,
426                                    bool *change);
427 int regmap_get_val_bytes(struct regmap *map);
428 int regmap_async_complete(struct regmap *map);
429 bool regmap_can_raw_write(struct regmap *map);
430 
431 int regcache_sync(struct regmap *map);
432 int regcache_sync_region(struct regmap *map, unsigned int min,
433                          unsigned int max);
434 int regcache_drop_region(struct regmap *map, unsigned int min,
435                          unsigned int max);
436 void regcache_cache_only(struct regmap *map, bool enable);
437 void regcache_cache_bypass(struct regmap *map, bool enable);
438 void regcache_mark_dirty(struct regmap *map);
439 
440 bool regmap_check_range_table(struct regmap *map, unsigned int reg,
441                               const struct regmap_access_table *table);
442 
443 int regmap_register_patch(struct regmap *map, const struct reg_default *regs,
444                           int num_regs);
445 int regmap_parse_val(struct regmap *map, const void *buf,
446                                 unsigned int *val);
447 
448 static inline bool regmap_reg_in_range(unsigned int reg,
449                                        const struct regmap_range *range)
450 {
451         return reg >= range->range_min && reg <= range->range_max;
452 }
453 
454 bool regmap_reg_in_ranges(unsigned int reg,
455                           const struct regmap_range *ranges,
456                           unsigned int nranges);
457 
458 /**
459  * Description of an register field
460  *
461  * @reg: Offset of the register within the regmap bank
462  * @lsb: lsb of the register field.
463  * @reg: msb of the register field.
464  * @id_size: port size if it has some ports
465  * @id_offset: address offset for each ports
466  */
467 struct reg_field {
468         unsigned int reg;
469         unsigned int lsb;
470         unsigned int msb;
471         unsigned int id_size;
472         unsigned int id_offset;
473 };
474 
475 #define REG_FIELD(_reg, _lsb, _msb) {           \
476                                 .reg = _reg,    \
477                                 .lsb = _lsb,    \
478                                 .msb = _msb,    \
479                                 }
480 
481 struct regmap_field *regmap_field_alloc(struct regmap *regmap,
482                 struct reg_field reg_field);
483 void regmap_field_free(struct regmap_field *field);
484 
485 struct regmap_field *devm_regmap_field_alloc(struct device *dev,
486                 struct regmap *regmap, struct reg_field reg_field);
487 void devm_regmap_field_free(struct device *dev, struct regmap_field *field);
488 
489 int regmap_field_read(struct regmap_field *field, unsigned int *val);
490 int regmap_field_write(struct regmap_field *field, unsigned int val);
491 int regmap_field_update_bits(struct regmap_field *field,
492                              unsigned int mask, unsigned int val);
493 
494 int regmap_fields_write(struct regmap_field *field, unsigned int id,
495                         unsigned int val);
496 int regmap_fields_read(struct regmap_field *field, unsigned int id,
497                        unsigned int *val);
498 int regmap_fields_update_bits(struct regmap_field *field,  unsigned int id,
499                               unsigned int mask, unsigned int val);
500 
501 /**
502  * Description of an IRQ for the generic regmap irq_chip.
503  *
504  * @reg_offset: Offset of the status/mask register within the bank
505  * @mask:       Mask used to flag/control the register.
506  */
507 struct regmap_irq {
508         unsigned int reg_offset;
509         unsigned int mask;
510 };
511 
512 /**
513  * Description of a generic regmap irq_chip.  This is not intended to
514  * handle every possible interrupt controller, but it should handle a
515  * substantial proportion of those that are found in the wild.
516  *
517  * @name:        Descriptive name for IRQ controller.
518  *
519  * @status_base: Base status register address.
520  * @mask_base:   Base mask register address.
521  * @ack_base:    Base ack address. If zero then the chip is clear on read.
522  *               Using zero value is possible with @use_ack bit.
523  * @wake_base:   Base address for wake enables.  If zero unsupported.
524  * @irq_reg_stride:  Stride to use for chips where registers are not contiguous.
525  * @init_ack_masked: Ack all masked interrupts once during initalization.
526  * @mask_invert: Inverted mask register: cleared bits are masked out.
527  * @use_ack:     Use @ack register even if it is zero.
528  * @wake_invert: Inverted wake register: cleared bits are wake enabled.
529  * @runtime_pm:  Hold a runtime PM lock on the device when accessing it.
530  *
531  * @num_regs:    Number of registers in each control bank.
532  * @irqs:        Descriptors for individual IRQs.  Interrupt numbers are
533  *               assigned based on the index in the array of the interrupt.
534  * @num_irqs:    Number of descriptors.
535  */
536 struct regmap_irq_chip {
537         const char *name;
538 
539         unsigned int status_base;
540         unsigned int mask_base;
541         unsigned int ack_base;
542         unsigned int wake_base;
543         unsigned int irq_reg_stride;
544         bool init_ack_masked:1;
545         bool mask_invert:1;
546         bool use_ack:1;
547         bool wake_invert:1;
548         bool runtime_pm:1;
549 
550         int num_regs;
551 
552         const struct regmap_irq *irqs;
553         int num_irqs;
554 };
555 
556 struct regmap_irq_chip_data;
557 
558 int regmap_add_irq_chip(struct regmap *map, int irq, int irq_flags,
559                         int irq_base, const struct regmap_irq_chip *chip,
560                         struct regmap_irq_chip_data **data);
561 void regmap_del_irq_chip(int irq, struct regmap_irq_chip_data *data);
562 int regmap_irq_chip_get_base(struct regmap_irq_chip_data *data);
563 int regmap_irq_get_virq(struct regmap_irq_chip_data *data, int irq);
564 struct irq_domain *regmap_irq_get_domain(struct regmap_irq_chip_data *data);
565 
566 #else
567 
568 /*
569  * These stubs should only ever be called by generic code which has
570  * regmap based facilities, if they ever get called at runtime
571  * something is going wrong and something probably needs to select
572  * REGMAP.
573  */
574 
575 static inline int regmap_write(struct regmap *map, unsigned int reg,
576                                unsigned int val)
577 {
578         WARN_ONCE(1, "regmap API is disabled");
579         return -EINVAL;
580 }
581 
582 static inline int regmap_write_async(struct regmap *map, unsigned int reg,
583                                      unsigned int val)
584 {
585         WARN_ONCE(1, "regmap API is disabled");
586         return -EINVAL;
587 }
588 
589 static inline int regmap_raw_write(struct regmap *map, unsigned int reg,
590                                    const void *val, size_t val_len)
591 {
592         WARN_ONCE(1, "regmap API is disabled");
593         return -EINVAL;
594 }
595 
596 static inline int regmap_raw_write_async(struct regmap *map, unsigned int reg,
597                                          const void *val, size_t val_len)
598 {
599         WARN_ONCE(1, "regmap API is disabled");
600         return -EINVAL;
601 }
602 
603 static inline int regmap_bulk_write(struct regmap *map, unsigned int reg,
604                                     const void *val, size_t val_count)
605 {
606         WARN_ONCE(1, "regmap API is disabled");
607         return -EINVAL;
608 }
609 
610 static inline int regmap_read(struct regmap *map, unsigned int reg,
611                               unsigned int *val)
612 {
613         WARN_ONCE(1, "regmap API is disabled");
614         return -EINVAL;
615 }
616 
617 static inline int regmap_raw_read(struct regmap *map, unsigned int reg,
618                                   void *val, size_t val_len)
619 {
620         WARN_ONCE(1, "regmap API is disabled");
621         return -EINVAL;
622 }
623 
624 static inline int regmap_bulk_read(struct regmap *map, unsigned int reg,
625                                    void *val, size_t val_count)
626 {
627         WARN_ONCE(1, "regmap API is disabled");
628         return -EINVAL;
629 }
630 
631 static inline int regmap_update_bits(struct regmap *map, unsigned int reg,
632                                      unsigned int mask, unsigned int val)
633 {
634         WARN_ONCE(1, "regmap API is disabled");
635         return -EINVAL;
636 }
637 
638 static inline int regmap_update_bits_async(struct regmap *map,
639                                            unsigned int reg,
640                                            unsigned int mask, unsigned int val)
641 {
642         WARN_ONCE(1, "regmap API is disabled");
643         return -EINVAL;
644 }
645 
646 static inline int regmap_update_bits_check(struct regmap *map,
647                                            unsigned int reg,
648                                            unsigned int mask, unsigned int val,
649                                            bool *change)
650 {
651         WARN_ONCE(1, "regmap API is disabled");
652         return -EINVAL;
653 }
654 
655 static inline int regmap_update_bits_check_async(struct regmap *map,
656                                                  unsigned int reg,
657                                                  unsigned int mask,
658                                                  unsigned int val,
659                                                  bool *change)
660 {
661         WARN_ONCE(1, "regmap API is disabled");
662         return -EINVAL;
663 }
664 
665 static inline int regmap_get_val_bytes(struct regmap *map)
666 {
667         WARN_ONCE(1, "regmap API is disabled");
668         return -EINVAL;
669 }
670 
671 static inline int regcache_sync(struct regmap *map)
672 {
673         WARN_ONCE(1, "regmap API is disabled");
674         return -EINVAL;
675 }
676 
677 static inline int regcache_sync_region(struct regmap *map, unsigned int min,
678                                        unsigned int max)
679 {
680         WARN_ONCE(1, "regmap API is disabled");
681         return -EINVAL;
682 }
683 
684 static inline int regcache_drop_region(struct regmap *map, unsigned int min,
685                                        unsigned int max)
686 {
687         WARN_ONCE(1, "regmap API is disabled");
688         return -EINVAL;
689 }
690 
691 static inline void regcache_cache_only(struct regmap *map, bool enable)
692 {
693         WARN_ONCE(1, "regmap API is disabled");
694 }
695 
696 static inline void regcache_cache_bypass(struct regmap *map, bool enable)
697 {
698         WARN_ONCE(1, "regmap API is disabled");
699 }
700 
701 static inline void regcache_mark_dirty(struct regmap *map)
702 {
703         WARN_ONCE(1, "regmap API is disabled");
704 }
705 
706 static inline void regmap_async_complete(struct regmap *map)
707 {
708         WARN_ONCE(1, "regmap API is disabled");
709 }
710 
711 static inline int regmap_register_patch(struct regmap *map,
712                                         const struct reg_default *regs,
713                                         int num_regs)
714 {
715         WARN_ONCE(1, "regmap API is disabled");
716         return -EINVAL;
717 }
718 
719 static inline int regmap_parse_val(struct regmap *map, const void *buf,
720                                 unsigned int *val)
721 {
722         WARN_ONCE(1, "regmap API is disabled");
723         return -EINVAL;
724 }
725 
726 static inline struct regmap *dev_get_regmap(struct device *dev,
727                                             const char *name)
728 {
729         return NULL;
730 }
731 
732 #endif
733 
734 #endif
735 

~ [ source navigation ] ~ [ diff markup ] ~ [ identifier search ] ~

kernel.org | git.kernel.org | LWN.net | Project Home | Wiki (Japanese) | Wiki (English) | SVN repository | Mail admin

Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.

osdn.jp