2 * Register map access API
4 * Copyright 2011 Wolfson Microelectronics plc
6 * Author: Mark Brown <broonie@opensource.wolfsonmicro.com>
8 * This program is free software; you can redistribute it and/or modify
9 * it under the terms of the GNU General Public License version 2 as
10 * published by the Free Software Foundation.
13 #include <linux/device.h>
14 #include <linux/slab.h>
15 #include <linux/export.h>
16 #include <linux/mutex.h>
17 #include <linux/err.h>
19 #define CREATE_TRACE_POINTS
20 #include <trace/events/regmap.h>
24 bool regmap_writeable(struct regmap
*map
, unsigned int reg
)
26 if (map
->max_register
&& reg
> map
->max_register
)
29 if (map
->writeable_reg
)
30 return map
->writeable_reg(map
->dev
, reg
);
35 bool regmap_readable(struct regmap
*map
, unsigned int reg
)
37 if (map
->max_register
&& reg
> map
->max_register
)
40 if (map
->format
.format_write
)
43 if (map
->readable_reg
)
44 return map
->readable_reg(map
->dev
, reg
);
49 bool regmap_volatile(struct regmap
*map
, unsigned int reg
)
51 if (!regmap_readable(map
, reg
))
54 if (map
->volatile_reg
)
55 return map
->volatile_reg(map
->dev
, reg
);
60 bool regmap_precious(struct regmap
*map
, unsigned int reg
)
62 if (!regmap_readable(map
, reg
))
65 if (map
->precious_reg
)
66 return map
->precious_reg(map
->dev
, reg
);
71 static bool regmap_volatile_range(struct regmap
*map
, unsigned int reg
,
76 for (i
= 0; i
< num
; i
++)
77 if (!regmap_volatile(map
, reg
+ i
))
83 static void regmap_format_2_6_write(struct regmap
*map
,
84 unsigned int reg
, unsigned int val
)
86 u8
*out
= map
->work_buf
;
88 *out
= (reg
<< 6) | val
;
91 static void regmap_format_4_12_write(struct regmap
*map
,
92 unsigned int reg
, unsigned int val
)
94 __be16
*out
= map
->work_buf
;
95 *out
= cpu_to_be16((reg
<< 12) | val
);
98 static void regmap_format_7_9_write(struct regmap
*map
,
99 unsigned int reg
, unsigned int val
)
101 __be16
*out
= map
->work_buf
;
102 *out
= cpu_to_be16((reg
<< 9) | val
);
105 static void regmap_format_10_14_write(struct regmap
*map
,
106 unsigned int reg
, unsigned int val
)
108 u8
*out
= map
->work_buf
;
111 out
[1] = (val
>> 8) | (reg
<< 6);
115 static void regmap_format_8(void *buf
, unsigned int val
, unsigned int shift
)
122 static void regmap_format_16(void *buf
, unsigned int val
, unsigned int shift
)
126 b
[0] = cpu_to_be16(val
<< shift
);
129 static void regmap_format_24(void *buf
, unsigned int val
, unsigned int shift
)
140 static void regmap_format_32(void *buf
, unsigned int val
, unsigned int shift
)
144 b
[0] = cpu_to_be32(val
<< shift
);
147 static unsigned int regmap_parse_8(void *buf
)
154 static unsigned int regmap_parse_16(void *buf
)
158 b
[0] = be16_to_cpu(b
[0]);
163 static unsigned int regmap_parse_24(void *buf
)
166 unsigned int ret
= b
[2];
167 ret
|= ((unsigned int)b
[1]) << 8;
168 ret
|= ((unsigned int)b
[0]) << 16;
173 static unsigned int regmap_parse_32(void *buf
)
177 b
[0] = be32_to_cpu(b
[0]);
182 static void regmap_lock_mutex(struct regmap
*map
)
184 mutex_lock(&map
->mutex
);
187 static void regmap_unlock_mutex(struct regmap
*map
)
189 mutex_unlock(&map
->mutex
);
192 static void regmap_lock_spinlock(struct regmap
*map
)
194 spin_lock(&map
->spinlock
);
197 static void regmap_unlock_spinlock(struct regmap
*map
)
199 spin_unlock(&map
->spinlock
);
202 static void dev_get_regmap_release(struct device
*dev
, void *res
)
205 * We don't actually have anything to do here; the goal here
206 * is not to manage the regmap but to provide a simple way to
207 * get the regmap back given a struct device.
212 * regmap_init(): Initialise register map
214 * @dev: Device that will be interacted with
215 * @bus: Bus-specific callbacks to use with device
216 * @bus_context: Data passed to bus-specific callbacks
217 * @config: Configuration for register map
219 * The return value will be an ERR_PTR() on error or a valid pointer to
220 * a struct regmap. This function should generally not be called
221 * directly, it should be called by bus-specific init functions.
223 struct regmap
*regmap_init(struct device
*dev
,
224 const struct regmap_bus
*bus
,
226 const struct regmap_config
*config
)
228 struct regmap
*map
, **m
;
234 map
= kzalloc(sizeof(*map
), GFP_KERNEL
);
241 spin_lock_init(&map
->spinlock
);
242 map
->lock
= regmap_lock_spinlock
;
243 map
->unlock
= regmap_unlock_spinlock
;
245 mutex_init(&map
->mutex
);
246 map
->lock
= regmap_lock_mutex
;
247 map
->unlock
= regmap_unlock_mutex
;
249 map
->format
.reg_bytes
= DIV_ROUND_UP(config
->reg_bits
, 8);
250 map
->format
.pad_bytes
= config
->pad_bits
/ 8;
251 map
->format
.val_bytes
= DIV_ROUND_UP(config
->val_bits
, 8);
252 map
->format
.buf_size
= DIV_ROUND_UP(config
->reg_bits
+
253 config
->val_bits
+ config
->pad_bits
, 8);
254 map
->reg_shift
= config
->pad_bits
% 8;
255 if (config
->reg_stride
)
256 map
->reg_stride
= config
->reg_stride
;
259 map
->use_single_rw
= config
->use_single_rw
;
262 map
->bus_context
= bus_context
;
263 map
->max_register
= config
->max_register
;
264 map
->writeable_reg
= config
->writeable_reg
;
265 map
->readable_reg
= config
->readable_reg
;
266 map
->volatile_reg
= config
->volatile_reg
;
267 map
->precious_reg
= config
->precious_reg
;
268 map
->cache_type
= config
->cache_type
;
269 map
->name
= config
->name
;
271 if (config
->read_flag_mask
|| config
->write_flag_mask
) {
272 map
->read_flag_mask
= config
->read_flag_mask
;
273 map
->write_flag_mask
= config
->write_flag_mask
;
275 map
->read_flag_mask
= bus
->read_flag_mask
;
278 switch (config
->reg_bits
+ map
->reg_shift
) {
280 switch (config
->val_bits
) {
282 map
->format
.format_write
= regmap_format_2_6_write
;
290 switch (config
->val_bits
) {
292 map
->format
.format_write
= regmap_format_4_12_write
;
300 switch (config
->val_bits
) {
302 map
->format
.format_write
= regmap_format_7_9_write
;
310 switch (config
->val_bits
) {
312 map
->format
.format_write
= regmap_format_10_14_write
;
320 map
->format
.format_reg
= regmap_format_8
;
324 map
->format
.format_reg
= regmap_format_16
;
328 map
->format
.format_reg
= regmap_format_32
;
335 switch (config
->val_bits
) {
337 map
->format
.format_val
= regmap_format_8
;
338 map
->format
.parse_val
= regmap_parse_8
;
341 map
->format
.format_val
= regmap_format_16
;
342 map
->format
.parse_val
= regmap_parse_16
;
345 map
->format
.format_val
= regmap_format_24
;
346 map
->format
.parse_val
= regmap_parse_24
;
349 map
->format
.format_val
= regmap_format_32
;
350 map
->format
.parse_val
= regmap_parse_32
;
354 if (map
->format
.format_write
)
355 map
->use_single_rw
= true;
357 if (!map
->format
.format_write
&&
358 !(map
->format
.format_reg
&& map
->format
.format_val
))
361 map
->work_buf
= kzalloc(map
->format
.buf_size
, GFP_KERNEL
);
362 if (map
->work_buf
== NULL
) {
367 regmap_debugfs_init(map
, config
->name
);
369 ret
= regcache_init(map
, config
);
373 /* Add a devres resource for dev_get_regmap() */
374 m
= devres_alloc(dev_get_regmap_release
, sizeof(*m
), GFP_KERNEL
);
387 regmap_debugfs_exit(map
);
388 kfree(map
->work_buf
);
394 EXPORT_SYMBOL_GPL(regmap_init
);
396 static void devm_regmap_release(struct device
*dev
, void *res
)
398 regmap_exit(*(struct regmap
**)res
);
402 * devm_regmap_init(): Initialise managed register map
404 * @dev: Device that will be interacted with
405 * @bus: Bus-specific callbacks to use with device
406 * @bus_context: Data passed to bus-specific callbacks
407 * @config: Configuration for register map
409 * The return value will be an ERR_PTR() on error or a valid pointer
410 * to a struct regmap. This function should generally not be called
411 * directly, it should be called by bus-specific init functions. The
412 * map will be automatically freed by the device management code.
414 struct regmap
*devm_regmap_init(struct device
*dev
,
415 const struct regmap_bus
*bus
,
417 const struct regmap_config
*config
)
419 struct regmap
**ptr
, *regmap
;
421 ptr
= devres_alloc(devm_regmap_release
, sizeof(*ptr
), GFP_KERNEL
);
423 return ERR_PTR(-ENOMEM
);
425 regmap
= regmap_init(dev
, bus
, bus_context
, config
);
426 if (!IS_ERR(regmap
)) {
428 devres_add(dev
, ptr
);
435 EXPORT_SYMBOL_GPL(devm_regmap_init
);
438 * regmap_reinit_cache(): Reinitialise the current register cache
440 * @map: Register map to operate on.
441 * @config: New configuration. Only the cache data will be used.
443 * Discard any existing register cache for the map and initialize a
444 * new cache. This can be used to restore the cache to defaults or to
445 * update the cache configuration to reflect runtime discovery of the
448 int regmap_reinit_cache(struct regmap
*map
, const struct regmap_config
*config
)
455 regmap_debugfs_exit(map
);
457 map
->max_register
= config
->max_register
;
458 map
->writeable_reg
= config
->writeable_reg
;
459 map
->readable_reg
= config
->readable_reg
;
460 map
->volatile_reg
= config
->volatile_reg
;
461 map
->precious_reg
= config
->precious_reg
;
462 map
->cache_type
= config
->cache_type
;
464 regmap_debugfs_init(map
, config
->name
);
466 map
->cache_bypass
= false;
467 map
->cache_only
= false;
469 ret
= regcache_init(map
, config
);
477 * regmap_exit(): Free a previously allocated register map
479 void regmap_exit(struct regmap
*map
)
482 regmap_debugfs_exit(map
);
483 if (map
->bus
->free_context
)
484 map
->bus
->free_context(map
->bus_context
);
485 kfree(map
->work_buf
);
488 EXPORT_SYMBOL_GPL(regmap_exit
);
490 static int dev_get_regmap_match(struct device
*dev
, void *res
, void *data
)
492 struct regmap
**r
= res
;
498 /* If the user didn't specify a name match any */
500 return (*r
)->name
== data
;
506 * dev_get_regmap(): Obtain the regmap (if any) for a device
508 * @dev: Device to retrieve the map for
509 * @name: Optional name for the register map, usually NULL.
511 * Returns the regmap for the device if one is present, or NULL. If
512 * name is specified then it must match the name specified when
513 * registering the device, if it is NULL then the first regmap found
514 * will be used. Devices with multiple register maps are very rare,
515 * generic code should normally not need to specify a name.
517 struct regmap
*dev_get_regmap(struct device
*dev
, const char *name
)
519 struct regmap
**r
= devres_find(dev
, dev_get_regmap_release
,
520 dev_get_regmap_match
, (void *)name
);
526 EXPORT_SYMBOL_GPL(dev_get_regmap
);
528 static int _regmap_raw_write(struct regmap
*map
, unsigned int reg
,
529 const void *val
, size_t val_len
)
531 u8
*u8
= map
->work_buf
;
537 /* Check for unwritable registers before we start */
538 if (map
->writeable_reg
)
539 for (i
= 0; i
< val_len
/ map
->format
.val_bytes
; i
++)
540 if (!map
->writeable_reg(map
->dev
,
541 reg
+ (i
* map
->reg_stride
)))
544 if (!map
->cache_bypass
&& map
->format
.parse_val
) {
546 int val_bytes
= map
->format
.val_bytes
;
547 for (i
= 0; i
< val_len
/ val_bytes
; i
++) {
548 memcpy(map
->work_buf
, val
+ (i
* val_bytes
), val_bytes
);
549 ival
= map
->format
.parse_val(map
->work_buf
);
550 ret
= regcache_write(map
, reg
+ (i
* map
->reg_stride
),
554 "Error in caching of register: %u ret: %d\n",
559 if (map
->cache_only
) {
560 map
->cache_dirty
= true;
565 map
->format
.format_reg(map
->work_buf
, reg
, map
->reg_shift
);
567 u8
[0] |= map
->write_flag_mask
;
569 trace_regmap_hw_write_start(map
->dev
, reg
,
570 val_len
/ map
->format
.val_bytes
);
572 /* If we're doing a single register write we can probably just
573 * send the work_buf directly, otherwise try to do a gather
576 if (val
== (map
->work_buf
+ map
->format
.pad_bytes
+
577 map
->format
.reg_bytes
))
578 ret
= map
->bus
->write(map
->bus_context
, map
->work_buf
,
579 map
->format
.reg_bytes
+
580 map
->format
.pad_bytes
+
582 else if (map
->bus
->gather_write
)
583 ret
= map
->bus
->gather_write(map
->bus_context
, map
->work_buf
,
584 map
->format
.reg_bytes
+
585 map
->format
.pad_bytes
,
588 /* If that didn't work fall back on linearising by hand. */
589 if (ret
== -ENOTSUPP
) {
590 len
= map
->format
.reg_bytes
+ map
->format
.pad_bytes
+ val_len
;
591 buf
= kzalloc(len
, GFP_KERNEL
);
595 memcpy(buf
, map
->work_buf
, map
->format
.reg_bytes
);
596 memcpy(buf
+ map
->format
.reg_bytes
+ map
->format
.pad_bytes
,
598 ret
= map
->bus
->write(map
->bus_context
, buf
, len
);
603 trace_regmap_hw_write_done(map
->dev
, reg
,
604 val_len
/ map
->format
.val_bytes
);
609 int _regmap_write(struct regmap
*map
, unsigned int reg
,
613 BUG_ON(!map
->format
.format_write
&& !map
->format
.format_val
);
615 if (!map
->cache_bypass
&& map
->format
.format_write
) {
616 ret
= regcache_write(map
, reg
, val
);
619 if (map
->cache_only
) {
620 map
->cache_dirty
= true;
625 trace_regmap_reg_write(map
->dev
, reg
, val
);
627 if (map
->format
.format_write
) {
628 map
->format
.format_write(map
, reg
, val
);
630 trace_regmap_hw_write_start(map
->dev
, reg
, 1);
632 ret
= map
->bus
->write(map
->bus_context
, map
->work_buf
,
633 map
->format
.buf_size
);
635 trace_regmap_hw_write_done(map
->dev
, reg
, 1);
639 map
->format
.format_val(map
->work_buf
+ map
->format
.reg_bytes
640 + map
->format
.pad_bytes
, val
, 0);
641 return _regmap_raw_write(map
, reg
,
643 map
->format
.reg_bytes
+
644 map
->format
.pad_bytes
,
645 map
->format
.val_bytes
);
650 * regmap_write(): Write a value to a single register
652 * @map: Register map to write to
653 * @reg: Register to write to
654 * @val: Value to be written
656 * A value of zero will be returned on success, a negative errno will
657 * be returned in error cases.
659 int regmap_write(struct regmap
*map
, unsigned int reg
, unsigned int val
)
663 if (reg
% map
->reg_stride
)
668 ret
= _regmap_write(map
, reg
, val
);
674 EXPORT_SYMBOL_GPL(regmap_write
);
677 * regmap_raw_write(): Write raw values to one or more registers
679 * @map: Register map to write to
680 * @reg: Initial register to write to
681 * @val: Block of data to be written, laid out for direct transmission to the
683 * @val_len: Length of data pointed to by val.
685 * This function is intended to be used for things like firmware
686 * download where a large block of data needs to be transferred to the
687 * device. No formatting will be done on the data provided.
689 * A value of zero will be returned on success, a negative errno will
690 * be returned in error cases.
692 int regmap_raw_write(struct regmap
*map
, unsigned int reg
,
693 const void *val
, size_t val_len
)
697 if (val_len
% map
->format
.val_bytes
)
699 if (reg
% map
->reg_stride
)
704 ret
= _regmap_raw_write(map
, reg
, val
, val_len
);
710 EXPORT_SYMBOL_GPL(regmap_raw_write
);
713 * regmap_bulk_write(): Write multiple registers to the device
715 * @map: Register map to write to
716 * @reg: First register to be write from
717 * @val: Block of data to be written, in native register size for device
718 * @val_count: Number of registers to write
720 * This function is intended to be used for writing a large block of
721 * data to be device either in single transfer or multiple transfer.
723 * A value of zero will be returned on success, a negative errno will
724 * be returned in error cases.
726 int regmap_bulk_write(struct regmap
*map
, unsigned int reg
, const void *val
,
730 size_t val_bytes
= map
->format
.val_bytes
;
733 if (!map
->format
.parse_val
)
735 if (reg
% map
->reg_stride
)
740 /* No formatting is require if val_byte is 1 */
741 if (val_bytes
== 1) {
744 wval
= kmemdup(val
, val_count
* val_bytes
, GFP_KERNEL
);
747 dev_err(map
->dev
, "Error in memory allocation\n");
750 for (i
= 0; i
< val_count
* val_bytes
; i
+= val_bytes
)
751 map
->format
.parse_val(wval
+ i
);
754 * Some devices does not support bulk write, for
755 * them we have a series of single write operations.
757 if (map
->use_single_rw
) {
758 for (i
= 0; i
< val_count
; i
++) {
759 ret
= regmap_raw_write(map
,
760 reg
+ (i
* map
->reg_stride
),
761 val
+ (i
* val_bytes
),
767 ret
= _regmap_raw_write(map
, reg
, wval
, val_bytes
* val_count
);
777 EXPORT_SYMBOL_GPL(regmap_bulk_write
);
779 static int _regmap_raw_read(struct regmap
*map
, unsigned int reg
, void *val
,
780 unsigned int val_len
)
782 u8
*u8
= map
->work_buf
;
785 map
->format
.format_reg(map
->work_buf
, reg
, map
->reg_shift
);
788 * Some buses or devices flag reads by setting the high bits in the
789 * register addresss; since it's always the high bits for all
790 * current formats we can do this here rather than in
791 * formatting. This may break if we get interesting formats.
793 u8
[0] |= map
->read_flag_mask
;
795 trace_regmap_hw_read_start(map
->dev
, reg
,
796 val_len
/ map
->format
.val_bytes
);
798 ret
= map
->bus
->read(map
->bus_context
, map
->work_buf
,
799 map
->format
.reg_bytes
+ map
->format
.pad_bytes
,
802 trace_regmap_hw_read_done(map
->dev
, reg
,
803 val_len
/ map
->format
.val_bytes
);
808 static int _regmap_read(struct regmap
*map
, unsigned int reg
,
813 if (!map
->cache_bypass
) {
814 ret
= regcache_read(map
, reg
, val
);
819 if (!map
->format
.parse_val
)
825 ret
= _regmap_raw_read(map
, reg
, map
->work_buf
, map
->format
.val_bytes
);
827 *val
= map
->format
.parse_val(map
->work_buf
);
828 trace_regmap_reg_read(map
->dev
, reg
, *val
);
831 if (ret
== 0 && !map
->cache_bypass
)
832 regcache_write(map
, reg
, *val
);
838 * regmap_read(): Read a value from a single register
840 * @map: Register map to write to
841 * @reg: Register to be read from
842 * @val: Pointer to store read value
844 * A value of zero will be returned on success, a negative errno will
845 * be returned in error cases.
847 int regmap_read(struct regmap
*map
, unsigned int reg
, unsigned int *val
)
851 if (reg
% map
->reg_stride
)
856 ret
= _regmap_read(map
, reg
, val
);
862 EXPORT_SYMBOL_GPL(regmap_read
);
865 * regmap_raw_read(): Read raw data from the device
867 * @map: Register map to write to
868 * @reg: First register to be read from
869 * @val: Pointer to store read value
870 * @val_len: Size of data to read
872 * A value of zero will be returned on success, a negative errno will
873 * be returned in error cases.
875 int regmap_raw_read(struct regmap
*map
, unsigned int reg
, void *val
,
878 size_t val_bytes
= map
->format
.val_bytes
;
879 size_t val_count
= val_len
/ val_bytes
;
883 if (val_len
% map
->format
.val_bytes
)
885 if (reg
% map
->reg_stride
)
890 if (regmap_volatile_range(map
, reg
, val_count
) || map
->cache_bypass
||
891 map
->cache_type
== REGCACHE_NONE
) {
892 /* Physical block read if there's no cache involved */
893 ret
= _regmap_raw_read(map
, reg
, val
, val_len
);
896 /* Otherwise go word by word for the cache; should be low
897 * cost as we expect to hit the cache.
899 for (i
= 0; i
< val_count
; i
++) {
900 ret
= _regmap_read(map
, reg
+ (i
* map
->reg_stride
),
905 map
->format
.format_val(val
+ (i
* val_bytes
), v
, 0);
914 EXPORT_SYMBOL_GPL(regmap_raw_read
);
917 * regmap_bulk_read(): Read multiple registers from the device
919 * @map: Register map to write to
920 * @reg: First register to be read from
921 * @val: Pointer to store read value, in native register size for device
922 * @val_count: Number of registers to read
924 * A value of zero will be returned on success, a negative errno will
925 * be returned in error cases.
927 int regmap_bulk_read(struct regmap
*map
, unsigned int reg
, void *val
,
931 size_t val_bytes
= map
->format
.val_bytes
;
932 bool vol
= regmap_volatile_range(map
, reg
, val_count
);
934 if (!map
->format
.parse_val
)
936 if (reg
% map
->reg_stride
)
939 if (vol
|| map
->cache_type
== REGCACHE_NONE
) {
941 * Some devices does not support bulk read, for
942 * them we have a series of single read operations.
944 if (map
->use_single_rw
) {
945 for (i
= 0; i
< val_count
; i
++) {
946 ret
= regmap_raw_read(map
,
947 reg
+ (i
* map
->reg_stride
),
948 val
+ (i
* val_bytes
),
954 ret
= regmap_raw_read(map
, reg
, val
,
955 val_bytes
* val_count
);
960 for (i
= 0; i
< val_count
* val_bytes
; i
+= val_bytes
)
961 map
->format
.parse_val(val
+ i
);
963 for (i
= 0; i
< val_count
; i
++) {
965 ret
= regmap_read(map
, reg
+ (i
* map
->reg_stride
),
969 memcpy(val
+ (i
* val_bytes
), &ival
, val_bytes
);
975 EXPORT_SYMBOL_GPL(regmap_bulk_read
);
977 static int _regmap_update_bits(struct regmap
*map
, unsigned int reg
,
978 unsigned int mask
, unsigned int val
,
982 unsigned int tmp
, orig
;
986 ret
= _regmap_read(map
, reg
, &orig
);
994 ret
= _regmap_write(map
, reg
, tmp
);
1007 * regmap_update_bits: Perform a read/modify/write cycle on the register map
1009 * @map: Register map to update
1010 * @reg: Register to update
1011 * @mask: Bitmask to change
1012 * @val: New value for bitmask
1014 * Returns zero for success, a negative number on error.
1016 int regmap_update_bits(struct regmap
*map
, unsigned int reg
,
1017 unsigned int mask
, unsigned int val
)
1020 return _regmap_update_bits(map
, reg
, mask
, val
, &change
);
1022 EXPORT_SYMBOL_GPL(regmap_update_bits
);
1025 * regmap_update_bits_check: Perform a read/modify/write cycle on the
1026 * register map and report if updated
1028 * @map: Register map to update
1029 * @reg: Register to update
1030 * @mask: Bitmask to change
1031 * @val: New value for bitmask
1032 * @change: Boolean indicating if a write was done
1034 * Returns zero for success, a negative number on error.
1036 int regmap_update_bits_check(struct regmap
*map
, unsigned int reg
,
1037 unsigned int mask
, unsigned int val
,
1040 return _regmap_update_bits(map
, reg
, mask
, val
, change
);
1042 EXPORT_SYMBOL_GPL(regmap_update_bits_check
);
1045 * regmap_register_patch: Register and apply register updates to be applied
1046 * on device initialistion
1048 * @map: Register map to apply updates to.
1049 * @regs: Values to update.
1050 * @num_regs: Number of entries in regs.
1052 * Register a set of register updates to be applied to the device
1053 * whenever the device registers are synchronised with the cache and
1054 * apply them immediately. Typically this is used to apply
1055 * corrections to be applied to the device defaults on startup, such
1056 * as the updates some vendors provide to undocumented registers.
1058 int regmap_register_patch(struct regmap
*map
, const struct reg_default
*regs
,
1064 /* If needed the implementation can be extended to support this */
1070 bypass
= map
->cache_bypass
;
1072 map
->cache_bypass
= true;
1074 /* Write out first; it's useful to apply even if we fail later. */
1075 for (i
= 0; i
< num_regs
; i
++) {
1076 ret
= _regmap_write(map
, regs
[i
].reg
, regs
[i
].def
);
1078 dev_err(map
->dev
, "Failed to write %x = %x: %d\n",
1079 regs
[i
].reg
, regs
[i
].def
, ret
);
1084 map
->patch
= kcalloc(num_regs
, sizeof(struct reg_default
), GFP_KERNEL
);
1085 if (map
->patch
!= NULL
) {
1086 memcpy(map
->patch
, regs
,
1087 num_regs
* sizeof(struct reg_default
));
1088 map
->patch_regs
= num_regs
;
1094 map
->cache_bypass
= bypass
;
1100 EXPORT_SYMBOL_GPL(regmap_register_patch
);
1103 * regmap_get_val_bytes(): Report the size of a register value
1105 * Report the size of a register value, mainly intended to for use by
1106 * generic infrastructure built on top of regmap.
1108 int regmap_get_val_bytes(struct regmap
*map
)
1110 if (map
->format
.format_write
)
1113 return map
->format
.val_bytes
;
1115 EXPORT_SYMBOL_GPL(regmap_get_val_bytes
);
1117 static int __init
regmap_initcall(void)
1119 regmap_debugfs_initcall();
1123 postcore_initcall(regmap_initcall
);