]> git.proxmox.com Git - mirror_ubuntu-artful-kernel.git/blame - drivers/base/regmap/regmap.c
regmap: mmio: remove some error checks now in the core
[mirror_ubuntu-artful-kernel.git] / drivers / base / regmap / regmap.c
CommitLineData
b83a313b
MB
1/*
2 * Register map access API
3 *
4 * Copyright 2011 Wolfson Microelectronics plc
5 *
6 * Author: Mark Brown <broonie@opensource.wolfsonmicro.com>
7 *
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.
11 */
12
f5d6eba7 13#include <linux/device.h>
b83a313b 14#include <linux/slab.h>
19694b5e 15#include <linux/export.h>
b83a313b
MB
16#include <linux/mutex.h>
17#include <linux/err.h>
18
fb2736bb
MB
19#define CREATE_TRACE_POINTS
20#include <trace/events/regmap.h>
21
93de9124 22#include "internal.h"
b83a313b 23
8de2f081
MB
24bool regmap_writeable(struct regmap *map, unsigned int reg)
25{
26 if (map->max_register && reg > map->max_register)
27 return false;
28
29 if (map->writeable_reg)
30 return map->writeable_reg(map->dev, reg);
31
32 return true;
33}
34
35bool regmap_readable(struct regmap *map, unsigned int reg)
36{
37 if (map->max_register && reg > map->max_register)
38 return false;
39
4191f197
WS
40 if (map->format.format_write)
41 return false;
42
8de2f081
MB
43 if (map->readable_reg)
44 return map->readable_reg(map->dev, reg);
45
46 return true;
47}
48
49bool regmap_volatile(struct regmap *map, unsigned int reg)
50{
4191f197 51 if (!regmap_readable(map, reg))
8de2f081
MB
52 return false;
53
54 if (map->volatile_reg)
55 return map->volatile_reg(map->dev, reg);
56
57 return true;
58}
59
60bool regmap_precious(struct regmap *map, unsigned int reg)
61{
4191f197 62 if (!regmap_readable(map, reg))
8de2f081
MB
63 return false;
64
65 if (map->precious_reg)
66 return map->precious_reg(map->dev, reg);
67
68 return false;
69}
70
82cd9965
LPC
71static bool regmap_volatile_range(struct regmap *map, unsigned int reg,
72 unsigned int num)
73{
74 unsigned int i;
75
76 for (i = 0; i < num; i++)
77 if (!regmap_volatile(map, reg + i))
78 return false;
79
80 return true;
81}
82
9aa50750
WS
83static void regmap_format_2_6_write(struct regmap *map,
84 unsigned int reg, unsigned int val)
85{
86 u8 *out = map->work_buf;
87
88 *out = (reg << 6) | val;
89}
90
b83a313b
MB
91static void regmap_format_4_12_write(struct regmap *map,
92 unsigned int reg, unsigned int val)
93{
94 __be16 *out = map->work_buf;
95 *out = cpu_to_be16((reg << 12) | val);
96}
97
98static void regmap_format_7_9_write(struct regmap *map,
99 unsigned int reg, unsigned int val)
100{
101 __be16 *out = map->work_buf;
102 *out = cpu_to_be16((reg << 9) | val);
103}
104
7e5ec63e
LPC
105static void regmap_format_10_14_write(struct regmap *map,
106 unsigned int reg, unsigned int val)
107{
108 u8 *out = map->work_buf;
109
110 out[2] = val;
111 out[1] = (val >> 8) | (reg << 6);
112 out[0] = reg >> 2;
113}
114
b83a313b
MB
115static void regmap_format_8(void *buf, unsigned int val)
116{
117 u8 *b = buf;
118
119 b[0] = val;
120}
121
122static void regmap_format_16(void *buf, unsigned int val)
123{
124 __be16 *b = buf;
125
126 b[0] = cpu_to_be16(val);
127}
128
7d5e525b
MB
129static void regmap_format_32(void *buf, unsigned int val)
130{
131 __be32 *b = buf;
132
133 b[0] = cpu_to_be32(val);
134}
135
b83a313b
MB
136static unsigned int regmap_parse_8(void *buf)
137{
138 u8 *b = buf;
139
140 return b[0];
141}
142
143static unsigned int regmap_parse_16(void *buf)
144{
145 __be16 *b = buf;
146
147 b[0] = be16_to_cpu(b[0]);
148
149 return b[0];
150}
151
7d5e525b
MB
152static unsigned int regmap_parse_32(void *buf)
153{
154 __be32 *b = buf;
155
156 b[0] = be32_to_cpu(b[0]);
157
158 return b[0];
159}
160
bacdbe07
SW
161static void regmap_lock_mutex(struct regmap *map)
162{
163 mutex_lock(&map->mutex);
164}
165
166static void regmap_unlock_mutex(struct regmap *map)
167{
168 mutex_unlock(&map->mutex);
169}
170
171static void regmap_lock_spinlock(struct regmap *map)
172{
173 spin_lock(&map->spinlock);
174}
175
176static void regmap_unlock_spinlock(struct regmap *map)
177{
178 spin_unlock(&map->spinlock);
179}
180
b83a313b
MB
181/**
182 * regmap_init(): Initialise register map
183 *
184 * @dev: Device that will be interacted with
185 * @bus: Bus-specific callbacks to use with device
0135bbcc 186 * @bus_context: Data passed to bus-specific callbacks
b83a313b
MB
187 * @config: Configuration for register map
188 *
189 * The return value will be an ERR_PTR() on error or a valid pointer to
190 * a struct regmap. This function should generally not be called
191 * directly, it should be called by bus-specific init functions.
192 */
193struct regmap *regmap_init(struct device *dev,
194 const struct regmap_bus *bus,
0135bbcc 195 void *bus_context,
b83a313b
MB
196 const struct regmap_config *config)
197{
198 struct regmap *map;
199 int ret = -EINVAL;
200
201 if (!bus || !config)
abbb18fb 202 goto err;
b83a313b
MB
203
204 map = kzalloc(sizeof(*map), GFP_KERNEL);
205 if (map == NULL) {
206 ret = -ENOMEM;
207 goto err;
208 }
209
bacdbe07
SW
210 if (bus->fast_io) {
211 spin_lock_init(&map->spinlock);
212 map->lock = regmap_lock_spinlock;
213 map->unlock = regmap_unlock_spinlock;
214 } else {
215 mutex_init(&map->mutex);
216 map->lock = regmap_lock_mutex;
217 map->unlock = regmap_unlock_mutex;
218 }
b83a313b 219 map->format.buf_size = (config->reg_bits + config->val_bits) / 8;
c212accc 220 map->format.reg_bytes = DIV_ROUND_UP(config->reg_bits, 8);
82159ba8 221 map->format.pad_bytes = config->pad_bits / 8;
c212accc 222 map->format.val_bytes = DIV_ROUND_UP(config->val_bits, 8);
82159ba8 223 map->format.buf_size += map->format.pad_bytes;
b83a313b
MB
224 map->dev = dev;
225 map->bus = bus;
0135bbcc 226 map->bus_context = bus_context;
2e2ae66d
MB
227 map->max_register = config->max_register;
228 map->writeable_reg = config->writeable_reg;
229 map->readable_reg = config->readable_reg;
230 map->volatile_reg = config->volatile_reg;
2efe1642 231 map->precious_reg = config->precious_reg;
5d1729e7 232 map->cache_type = config->cache_type;
b83a313b 233
6f306441
LPC
234 if (config->read_flag_mask || config->write_flag_mask) {
235 map->read_flag_mask = config->read_flag_mask;
236 map->write_flag_mask = config->write_flag_mask;
237 } else {
238 map->read_flag_mask = bus->read_flag_mask;
239 }
240
b83a313b 241 switch (config->reg_bits) {
9aa50750
WS
242 case 2:
243 switch (config->val_bits) {
244 case 6:
245 map->format.format_write = regmap_format_2_6_write;
246 break;
247 default:
248 goto err_map;
249 }
250 break;
251
b83a313b
MB
252 case 4:
253 switch (config->val_bits) {
254 case 12:
255 map->format.format_write = regmap_format_4_12_write;
256 break;
257 default:
258 goto err_map;
259 }
260 break;
261
262 case 7:
263 switch (config->val_bits) {
264 case 9:
265 map->format.format_write = regmap_format_7_9_write;
266 break;
267 default:
268 goto err_map;
269 }
270 break;
271
7e5ec63e
LPC
272 case 10:
273 switch (config->val_bits) {
274 case 14:
275 map->format.format_write = regmap_format_10_14_write;
276 break;
277 default:
278 goto err_map;
279 }
280 break;
281
b83a313b
MB
282 case 8:
283 map->format.format_reg = regmap_format_8;
284 break;
285
286 case 16:
287 map->format.format_reg = regmap_format_16;
288 break;
289
7d5e525b
MB
290 case 32:
291 map->format.format_reg = regmap_format_32;
292 break;
293
b83a313b
MB
294 default:
295 goto err_map;
296 }
297
298 switch (config->val_bits) {
299 case 8:
300 map->format.format_val = regmap_format_8;
301 map->format.parse_val = regmap_parse_8;
302 break;
303 case 16:
304 map->format.format_val = regmap_format_16;
305 map->format.parse_val = regmap_parse_16;
306 break;
7d5e525b
MB
307 case 32:
308 map->format.format_val = regmap_format_32;
309 map->format.parse_val = regmap_parse_32;
310 break;
b83a313b
MB
311 }
312
313 if (!map->format.format_write &&
314 !(map->format.format_reg && map->format.format_val))
315 goto err_map;
316
82159ba8 317 map->work_buf = kzalloc(map->format.buf_size, GFP_KERNEL);
b83a313b
MB
318 if (map->work_buf == NULL) {
319 ret = -ENOMEM;
5204f5e3 320 goto err_map;
b83a313b
MB
321 }
322
052d2cd1
MB
323 regmap_debugfs_init(map);
324
e5e3b8ab 325 ret = regcache_init(map, config);
5d1729e7 326 if (ret < 0)
58072cbf 327 goto err_free_workbuf;
5d1729e7 328
b83a313b
MB
329 return map;
330
58072cbf
LPC
331err_free_workbuf:
332 kfree(map->work_buf);
b83a313b
MB
333err_map:
334 kfree(map);
335err:
336 return ERR_PTR(ret);
337}
338EXPORT_SYMBOL_GPL(regmap_init);
339
c0eb4676
MB
340static void devm_regmap_release(struct device *dev, void *res)
341{
342 regmap_exit(*(struct regmap **)res);
343}
344
345/**
346 * devm_regmap_init(): Initialise managed register map
347 *
348 * @dev: Device that will be interacted with
349 * @bus: Bus-specific callbacks to use with device
0135bbcc 350 * @bus_context: Data passed to bus-specific callbacks
c0eb4676
MB
351 * @config: Configuration for register map
352 *
353 * The return value will be an ERR_PTR() on error or a valid pointer
354 * to a struct regmap. This function should generally not be called
355 * directly, it should be called by bus-specific init functions. The
356 * map will be automatically freed by the device management code.
357 */
358struct regmap *devm_regmap_init(struct device *dev,
359 const struct regmap_bus *bus,
0135bbcc 360 void *bus_context,
c0eb4676
MB
361 const struct regmap_config *config)
362{
363 struct regmap **ptr, *regmap;
364
365 ptr = devres_alloc(devm_regmap_release, sizeof(*ptr), GFP_KERNEL);
366 if (!ptr)
367 return ERR_PTR(-ENOMEM);
368
0135bbcc 369 regmap = regmap_init(dev, bus, bus_context, config);
c0eb4676
MB
370 if (!IS_ERR(regmap)) {
371 *ptr = regmap;
372 devres_add(dev, ptr);
373 } else {
374 devres_free(ptr);
375 }
376
377 return regmap;
378}
379EXPORT_SYMBOL_GPL(devm_regmap_init);
380
bf315173
MB
381/**
382 * regmap_reinit_cache(): Reinitialise the current register cache
383 *
384 * @map: Register map to operate on.
385 * @config: New configuration. Only the cache data will be used.
386 *
387 * Discard any existing register cache for the map and initialize a
388 * new cache. This can be used to restore the cache to defaults or to
389 * update the cache configuration to reflect runtime discovery of the
390 * hardware.
391 */
392int regmap_reinit_cache(struct regmap *map, const struct regmap_config *config)
393{
394 int ret;
395
bacdbe07 396 map->lock(map);
bf315173
MB
397
398 regcache_exit(map);
a24f64a6 399 regmap_debugfs_exit(map);
bf315173
MB
400
401 map->max_register = config->max_register;
402 map->writeable_reg = config->writeable_reg;
403 map->readable_reg = config->readable_reg;
404 map->volatile_reg = config->volatile_reg;
405 map->precious_reg = config->precious_reg;
406 map->cache_type = config->cache_type;
407
a24f64a6
MB
408 regmap_debugfs_init(map);
409
421e8d2d
MB
410 map->cache_bypass = false;
411 map->cache_only = false;
412
bf315173
MB
413 ret = regcache_init(map, config);
414
bacdbe07 415 map->unlock(map);
bf315173
MB
416
417 return ret;
418}
419
b83a313b
MB
420/**
421 * regmap_exit(): Free a previously allocated register map
422 */
423void regmap_exit(struct regmap *map)
424{
5d1729e7 425 regcache_exit(map);
31244e39 426 regmap_debugfs_exit(map);
0135bbcc
SW
427 if (map->bus->free_context)
428 map->bus->free_context(map->bus_context);
b83a313b 429 kfree(map->work_buf);
b83a313b
MB
430 kfree(map);
431}
432EXPORT_SYMBOL_GPL(regmap_exit);
433
434static int _regmap_raw_write(struct regmap *map, unsigned int reg,
435 const void *val, size_t val_len)
436{
6f306441 437 u8 *u8 = map->work_buf;
b83a313b
MB
438 void *buf;
439 int ret = -ENOTSUPP;
440 size_t len;
73304781
MB
441 int i;
442
443 /* Check for unwritable registers before we start */
444 if (map->writeable_reg)
445 for (i = 0; i < val_len / map->format.val_bytes; i++)
446 if (!map->writeable_reg(map->dev, reg + i))
447 return -EINVAL;
b83a313b 448
c9157198
LD
449 if (!map->cache_bypass && map->format.parse_val) {
450 unsigned int ival;
451 int val_bytes = map->format.val_bytes;
452 for (i = 0; i < val_len / val_bytes; i++) {
453 memcpy(map->work_buf, val + (i * val_bytes), val_bytes);
454 ival = map->format.parse_val(map->work_buf);
455 ret = regcache_write(map, reg + i, ival);
456 if (ret) {
457 dev_err(map->dev,
458 "Error in caching of register: %u ret: %d\n",
459 reg + i, ret);
460 return ret;
461 }
462 }
463 if (map->cache_only) {
464 map->cache_dirty = true;
465 return 0;
466 }
467 }
468
b83a313b
MB
469 map->format.format_reg(map->work_buf, reg);
470
6f306441
LPC
471 u8[0] |= map->write_flag_mask;
472
fb2736bb
MB
473 trace_regmap_hw_write_start(map->dev, reg,
474 val_len / map->format.val_bytes);
475
2547e201
MB
476 /* If we're doing a single register write we can probably just
477 * send the work_buf directly, otherwise try to do a gather
478 * write.
479 */
82159ba8
MB
480 if (val == (map->work_buf + map->format.pad_bytes +
481 map->format.reg_bytes))
0135bbcc 482 ret = map->bus->write(map->bus_context, map->work_buf,
82159ba8
MB
483 map->format.reg_bytes +
484 map->format.pad_bytes +
485 val_len);
2547e201 486 else if (map->bus->gather_write)
0135bbcc 487 ret = map->bus->gather_write(map->bus_context, map->work_buf,
82159ba8
MB
488 map->format.reg_bytes +
489 map->format.pad_bytes,
b83a313b
MB
490 val, val_len);
491
2547e201 492 /* If that didn't work fall back on linearising by hand. */
b83a313b 493 if (ret == -ENOTSUPP) {
82159ba8
MB
494 len = map->format.reg_bytes + map->format.pad_bytes + val_len;
495 buf = kzalloc(len, GFP_KERNEL);
b83a313b
MB
496 if (!buf)
497 return -ENOMEM;
498
499 memcpy(buf, map->work_buf, map->format.reg_bytes);
82159ba8
MB
500 memcpy(buf + map->format.reg_bytes + map->format.pad_bytes,
501 val, val_len);
0135bbcc 502 ret = map->bus->write(map->bus_context, buf, len);
b83a313b
MB
503
504 kfree(buf);
505 }
506
fb2736bb
MB
507 trace_regmap_hw_write_done(map->dev, reg,
508 val_len / map->format.val_bytes);
509
b83a313b
MB
510 return ret;
511}
512
4d2dc095
DP
513int _regmap_write(struct regmap *map, unsigned int reg,
514 unsigned int val)
b83a313b 515{
fb2736bb 516 int ret;
b83a313b
MB
517 BUG_ON(!map->format.format_write && !map->format.format_val);
518
c9157198 519 if (!map->cache_bypass && map->format.format_write) {
5d1729e7
DP
520 ret = regcache_write(map, reg, val);
521 if (ret != 0)
522 return ret;
8ae0d7e8
MB
523 if (map->cache_only) {
524 map->cache_dirty = true;
5d1729e7 525 return 0;
8ae0d7e8 526 }
5d1729e7
DP
527 }
528
fb2736bb
MB
529 trace_regmap_reg_write(map->dev, reg, val);
530
b83a313b
MB
531 if (map->format.format_write) {
532 map->format.format_write(map, reg, val);
533
fb2736bb
MB
534 trace_regmap_hw_write_start(map->dev, reg, 1);
535
0135bbcc 536 ret = map->bus->write(map->bus_context, map->work_buf,
fb2736bb
MB
537 map->format.buf_size);
538
539 trace_regmap_hw_write_done(map->dev, reg, 1);
540
541 return ret;
b83a313b 542 } else {
82159ba8
MB
543 map->format.format_val(map->work_buf + map->format.reg_bytes
544 + map->format.pad_bytes, val);
b83a313b 545 return _regmap_raw_write(map, reg,
82159ba8
MB
546 map->work_buf +
547 map->format.reg_bytes +
548 map->format.pad_bytes,
b83a313b
MB
549 map->format.val_bytes);
550 }
551}
552
553/**
554 * regmap_write(): Write a value to a single register
555 *
556 * @map: Register map to write to
557 * @reg: Register to write to
558 * @val: Value to be written
559 *
560 * A value of zero will be returned on success, a negative errno will
561 * be returned in error cases.
562 */
563int regmap_write(struct regmap *map, unsigned int reg, unsigned int val)
564{
565 int ret;
566
bacdbe07 567 map->lock(map);
b83a313b
MB
568
569 ret = _regmap_write(map, reg, val);
570
bacdbe07 571 map->unlock(map);
b83a313b
MB
572
573 return ret;
574}
575EXPORT_SYMBOL_GPL(regmap_write);
576
577/**
578 * regmap_raw_write(): Write raw values to one or more registers
579 *
580 * @map: Register map to write to
581 * @reg: Initial register to write to
582 * @val: Block of data to be written, laid out for direct transmission to the
583 * device
584 * @val_len: Length of data pointed to by val.
585 *
586 * This function is intended to be used for things like firmware
587 * download where a large block of data needs to be transferred to the
588 * device. No formatting will be done on the data provided.
589 *
590 * A value of zero will be returned on success, a negative errno will
591 * be returned in error cases.
592 */
593int regmap_raw_write(struct regmap *map, unsigned int reg,
594 const void *val, size_t val_len)
595{
596 int ret;
597
bacdbe07 598 map->lock(map);
b83a313b
MB
599
600 ret = _regmap_raw_write(map, reg, val, val_len);
601
bacdbe07 602 map->unlock(map);
b83a313b
MB
603
604 return ret;
605}
606EXPORT_SYMBOL_GPL(regmap_raw_write);
607
8eaeb219
LD
608/*
609 * regmap_bulk_write(): Write multiple registers to the device
610 *
611 * @map: Register map to write to
612 * @reg: First register to be write from
613 * @val: Block of data to be written, in native register size for device
614 * @val_count: Number of registers to write
615 *
616 * This function is intended to be used for writing a large block of
617 * data to be device either in single transfer or multiple transfer.
618 *
619 * A value of zero will be returned on success, a negative errno will
620 * be returned in error cases.
621 */
622int regmap_bulk_write(struct regmap *map, unsigned int reg, const void *val,
623 size_t val_count)
624{
625 int ret = 0, i;
626 size_t val_bytes = map->format.val_bytes;
627 void *wval;
628
629 if (!map->format.parse_val)
630 return -EINVAL;
631
bacdbe07 632 map->lock(map);
8eaeb219
LD
633
634 /* No formatting is require if val_byte is 1 */
635 if (val_bytes == 1) {
636 wval = (void *)val;
637 } else {
638 wval = kmemdup(val, val_count * val_bytes, GFP_KERNEL);
639 if (!wval) {
640 ret = -ENOMEM;
641 dev_err(map->dev, "Error in memory allocation\n");
642 goto out;
643 }
644 for (i = 0; i < val_count * val_bytes; i += val_bytes)
645 map->format.parse_val(wval + i);
646 }
647 ret = _regmap_raw_write(map, reg, wval, val_bytes * val_count);
648
649 if (val_bytes != 1)
650 kfree(wval);
651
652out:
bacdbe07 653 map->unlock(map);
8eaeb219
LD
654 return ret;
655}
656EXPORT_SYMBOL_GPL(regmap_bulk_write);
657
b83a313b
MB
658static int _regmap_raw_read(struct regmap *map, unsigned int reg, void *val,
659 unsigned int val_len)
660{
661 u8 *u8 = map->work_buf;
662 int ret;
663
664 map->format.format_reg(map->work_buf, reg);
665
666 /*
6f306441 667 * Some buses or devices flag reads by setting the high bits in the
b83a313b
MB
668 * register addresss; since it's always the high bits for all
669 * current formats we can do this here rather than in
670 * formatting. This may break if we get interesting formats.
671 */
6f306441 672 u8[0] |= map->read_flag_mask;
b83a313b 673
fb2736bb
MB
674 trace_regmap_hw_read_start(map->dev, reg,
675 val_len / map->format.val_bytes);
676
0135bbcc 677 ret = map->bus->read(map->bus_context, map->work_buf,
82159ba8 678 map->format.reg_bytes + map->format.pad_bytes,
40c5cc26 679 val, val_len);
b83a313b 680
fb2736bb
MB
681 trace_regmap_hw_read_done(map->dev, reg,
682 val_len / map->format.val_bytes);
683
684 return ret;
b83a313b
MB
685}
686
687static int _regmap_read(struct regmap *map, unsigned int reg,
688 unsigned int *val)
689{
690 int ret;
691
5d1729e7
DP
692 if (!map->cache_bypass) {
693 ret = regcache_read(map, reg, val);
694 if (ret == 0)
695 return 0;
696 }
697
19254411
LPC
698 if (!map->format.parse_val)
699 return -EINVAL;
700
5d1729e7
DP
701 if (map->cache_only)
702 return -EBUSY;
703
b83a313b 704 ret = _regmap_raw_read(map, reg, map->work_buf, map->format.val_bytes);
fb2736bb 705 if (ret == 0) {
b83a313b 706 *val = map->format.parse_val(map->work_buf);
fb2736bb
MB
707 trace_regmap_reg_read(map->dev, reg, *val);
708 }
b83a313b
MB
709
710 return ret;
711}
712
713/**
714 * regmap_read(): Read a value from a single register
715 *
716 * @map: Register map to write to
717 * @reg: Register to be read from
718 * @val: Pointer to store read value
719 *
720 * A value of zero will be returned on success, a negative errno will
721 * be returned in error cases.
722 */
723int regmap_read(struct regmap *map, unsigned int reg, unsigned int *val)
724{
725 int ret;
726
bacdbe07 727 map->lock(map);
b83a313b
MB
728
729 ret = _regmap_read(map, reg, val);
730
bacdbe07 731 map->unlock(map);
b83a313b
MB
732
733 return ret;
734}
735EXPORT_SYMBOL_GPL(regmap_read);
736
737/**
738 * regmap_raw_read(): Read raw data from the device
739 *
740 * @map: Register map to write to
741 * @reg: First register to be read from
742 * @val: Pointer to store read value
743 * @val_len: Size of data to read
744 *
745 * A value of zero will be returned on success, a negative errno will
746 * be returned in error cases.
747 */
748int regmap_raw_read(struct regmap *map, unsigned int reg, void *val,
749 size_t val_len)
750{
b8fb5ab1
MB
751 size_t val_bytes = map->format.val_bytes;
752 size_t val_count = val_len / val_bytes;
753 unsigned int v;
754 int ret, i;
04e016ad 755
bacdbe07 756 map->lock(map);
b83a313b 757
b8fb5ab1
MB
758 if (regmap_volatile_range(map, reg, val_count) || map->cache_bypass ||
759 map->cache_type == REGCACHE_NONE) {
760 /* Physical block read if there's no cache involved */
761 ret = _regmap_raw_read(map, reg, val, val_len);
762
763 } else {
764 /* Otherwise go word by word for the cache; should be low
765 * cost as we expect to hit the cache.
766 */
767 for (i = 0; i < val_count; i++) {
768 ret = _regmap_read(map, reg + i, &v);
769 if (ret != 0)
770 goto out;
771
772 map->format.format_val(val + (i * val_bytes), v);
773 }
774 }
b83a313b 775
b8fb5ab1 776 out:
bacdbe07 777 map->unlock(map);
b83a313b
MB
778
779 return ret;
780}
781EXPORT_SYMBOL_GPL(regmap_raw_read);
782
783/**
784 * regmap_bulk_read(): Read multiple registers from the device
785 *
786 * @map: Register map to write to
787 * @reg: First register to be read from
788 * @val: Pointer to store read value, in native register size for device
789 * @val_count: Number of registers to read
790 *
791 * A value of zero will be returned on success, a negative errno will
792 * be returned in error cases.
793 */
794int regmap_bulk_read(struct regmap *map, unsigned int reg, void *val,
795 size_t val_count)
796{
797 int ret, i;
798 size_t val_bytes = map->format.val_bytes;
82cd9965 799 bool vol = regmap_volatile_range(map, reg, val_count);
5d1729e7 800
b83a313b
MB
801 if (!map->format.parse_val)
802 return -EINVAL;
803
de2d808f
MB
804 if (vol || map->cache_type == REGCACHE_NONE) {
805 ret = regmap_raw_read(map, reg, val, val_bytes * val_count);
806 if (ret != 0)
807 return ret;
808
809 for (i = 0; i < val_count * val_bytes; i += val_bytes)
810 map->format.parse_val(val + i);
811 } else {
812 for (i = 0; i < val_count; i++) {
813 ret = regmap_read(map, reg + i, val + (i * val_bytes));
814 if (ret != 0)
815 return ret;
816 }
817 }
b83a313b
MB
818
819 return 0;
820}
821EXPORT_SYMBOL_GPL(regmap_bulk_read);
822
018690d3
MB
823static int _regmap_update_bits(struct regmap *map, unsigned int reg,
824 unsigned int mask, unsigned int val,
825 bool *change)
b83a313b
MB
826{
827 int ret;
d91e8db2 828 unsigned int tmp, orig;
b83a313b 829
bacdbe07 830 map->lock(map);
b83a313b 831
d91e8db2 832 ret = _regmap_read(map, reg, &orig);
b83a313b
MB
833 if (ret != 0)
834 goto out;
835
d91e8db2 836 tmp = orig & ~mask;
b83a313b
MB
837 tmp |= val & mask;
838
018690d3 839 if (tmp != orig) {
d91e8db2 840 ret = _regmap_write(map, reg, tmp);
018690d3
MB
841 *change = true;
842 } else {
843 *change = false;
844 }
b83a313b
MB
845
846out:
bacdbe07 847 map->unlock(map);
b83a313b
MB
848
849 return ret;
850}
018690d3
MB
851
852/**
853 * regmap_update_bits: Perform a read/modify/write cycle on the register map
854 *
855 * @map: Register map to update
856 * @reg: Register to update
857 * @mask: Bitmask to change
858 * @val: New value for bitmask
859 *
860 * Returns zero for success, a negative number on error.
861 */
862int regmap_update_bits(struct regmap *map, unsigned int reg,
863 unsigned int mask, unsigned int val)
864{
865 bool change;
866 return _regmap_update_bits(map, reg, mask, val, &change);
867}
b83a313b 868EXPORT_SYMBOL_GPL(regmap_update_bits);
31244e39 869
018690d3
MB
870/**
871 * regmap_update_bits_check: Perform a read/modify/write cycle on the
872 * register map and report if updated
873 *
874 * @map: Register map to update
875 * @reg: Register to update
876 * @mask: Bitmask to change
877 * @val: New value for bitmask
878 * @change: Boolean indicating if a write was done
879 *
880 * Returns zero for success, a negative number on error.
881 */
882int regmap_update_bits_check(struct regmap *map, unsigned int reg,
883 unsigned int mask, unsigned int val,
884 bool *change)
885{
886 return _regmap_update_bits(map, reg, mask, val, change);
887}
888EXPORT_SYMBOL_GPL(regmap_update_bits_check);
889
22f0d90a
MB
890/**
891 * regmap_register_patch: Register and apply register updates to be applied
892 * on device initialistion
893 *
894 * @map: Register map to apply updates to.
895 * @regs: Values to update.
896 * @num_regs: Number of entries in regs.
897 *
898 * Register a set of register updates to be applied to the device
899 * whenever the device registers are synchronised with the cache and
900 * apply them immediately. Typically this is used to apply
901 * corrections to be applied to the device defaults on startup, such
902 * as the updates some vendors provide to undocumented registers.
903 */
904int regmap_register_patch(struct regmap *map, const struct reg_default *regs,
905 int num_regs)
906{
907 int i, ret;
908 bool bypass;
909
910 /* If needed the implementation can be extended to support this */
911 if (map->patch)
912 return -EBUSY;
913
bacdbe07 914 map->lock(map);
22f0d90a
MB
915
916 bypass = map->cache_bypass;
917
918 map->cache_bypass = true;
919
920 /* Write out first; it's useful to apply even if we fail later. */
921 for (i = 0; i < num_regs; i++) {
922 ret = _regmap_write(map, regs[i].reg, regs[i].def);
923 if (ret != 0) {
924 dev_err(map->dev, "Failed to write %x = %x: %d\n",
925 regs[i].reg, regs[i].def, ret);
926 goto out;
927 }
928 }
929
2a14d7d9 930 map->patch = kcalloc(num_regs, sizeof(struct reg_default), GFP_KERNEL);
22f0d90a
MB
931 if (map->patch != NULL) {
932 memcpy(map->patch, regs,
933 num_regs * sizeof(struct reg_default));
934 map->patch_regs = num_regs;
935 } else {
936 ret = -ENOMEM;
937 }
938
939out:
940 map->cache_bypass = bypass;
941
bacdbe07 942 map->unlock(map);
22f0d90a
MB
943
944 return ret;
945}
946EXPORT_SYMBOL_GPL(regmap_register_patch);
947
eae4b51b 948/*
a6539c32
MB
949 * regmap_get_val_bytes(): Report the size of a register value
950 *
951 * Report the size of a register value, mainly intended to for use by
952 * generic infrastructure built on top of regmap.
953 */
954int regmap_get_val_bytes(struct regmap *map)
955{
956 if (map->format.format_write)
957 return -EINVAL;
958
959 return map->format.val_bytes;
960}
961EXPORT_SYMBOL_GPL(regmap_get_val_bytes);
962
31244e39
MB
963static int __init regmap_initcall(void)
964{
965 regmap_debugfs_initcall();
966
967 return 0;
968}
969postcore_initcall(regmap_initcall);