]> git.proxmox.com Git - mirror_ubuntu-artful-kernel.git/blame - drivers/base/regmap/regmap.c
regmap: Add support for register indirect addressing.
[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>
6863ca62 18#include <linux/rbtree.h>
b83a313b 19
fb2736bb
MB
20#define CREATE_TRACE_POINTS
21#include <trace/events/regmap.h>
22
93de9124 23#include "internal.h"
b83a313b 24
6863ca62
KG
25static int _regmap_update_bits(struct regmap *map, unsigned int reg,
26 unsigned int mask, unsigned int val,
27 bool *change);
28
8de2f081
MB
29bool regmap_writeable(struct regmap *map, unsigned int reg)
30{
31 if (map->max_register && reg > map->max_register)
32 return false;
33
34 if (map->writeable_reg)
35 return map->writeable_reg(map->dev, reg);
36
37 return true;
38}
39
40bool regmap_readable(struct regmap *map, unsigned int reg)
41{
42 if (map->max_register && reg > map->max_register)
43 return false;
44
4191f197
WS
45 if (map->format.format_write)
46 return false;
47
8de2f081
MB
48 if (map->readable_reg)
49 return map->readable_reg(map->dev, reg);
50
51 return true;
52}
53
54bool regmap_volatile(struct regmap *map, unsigned int reg)
55{
4191f197 56 if (!regmap_readable(map, reg))
8de2f081
MB
57 return false;
58
59 if (map->volatile_reg)
60 return map->volatile_reg(map->dev, reg);
61
62 return true;
63}
64
65bool regmap_precious(struct regmap *map, unsigned int reg)
66{
4191f197 67 if (!regmap_readable(map, reg))
8de2f081
MB
68 return false;
69
70 if (map->precious_reg)
71 return map->precious_reg(map->dev, reg);
72
73 return false;
74}
75
82cd9965
LPC
76static bool regmap_volatile_range(struct regmap *map, unsigned int reg,
77 unsigned int num)
78{
79 unsigned int i;
80
81 for (i = 0; i < num; i++)
82 if (!regmap_volatile(map, reg + i))
83 return false;
84
85 return true;
86}
87
9aa50750
WS
88static void regmap_format_2_6_write(struct regmap *map,
89 unsigned int reg, unsigned int val)
90{
91 u8 *out = map->work_buf;
92
93 *out = (reg << 6) | val;
94}
95
b83a313b
MB
96static void regmap_format_4_12_write(struct regmap *map,
97 unsigned int reg, unsigned int val)
98{
99 __be16 *out = map->work_buf;
100 *out = cpu_to_be16((reg << 12) | val);
101}
102
103static void regmap_format_7_9_write(struct regmap *map,
104 unsigned int reg, unsigned int val)
105{
106 __be16 *out = map->work_buf;
107 *out = cpu_to_be16((reg << 9) | val);
108}
109
7e5ec63e
LPC
110static void regmap_format_10_14_write(struct regmap *map,
111 unsigned int reg, unsigned int val)
112{
113 u8 *out = map->work_buf;
114
115 out[2] = val;
116 out[1] = (val >> 8) | (reg << 6);
117 out[0] = reg >> 2;
118}
119
d939fb9a 120static void regmap_format_8(void *buf, unsigned int val, unsigned int shift)
b83a313b
MB
121{
122 u8 *b = buf;
123
d939fb9a 124 b[0] = val << shift;
b83a313b
MB
125}
126
d939fb9a 127static void regmap_format_16(void *buf, unsigned int val, unsigned int shift)
b83a313b
MB
128{
129 __be16 *b = buf;
130
d939fb9a 131 b[0] = cpu_to_be16(val << shift);
b83a313b
MB
132}
133
d939fb9a 134static void regmap_format_24(void *buf, unsigned int val, unsigned int shift)
ea279fc5
MR
135{
136 u8 *b = buf;
137
d939fb9a
MR
138 val <<= shift;
139
ea279fc5
MR
140 b[0] = val >> 16;
141 b[1] = val >> 8;
142 b[2] = val;
143}
144
d939fb9a 145static void regmap_format_32(void *buf, unsigned int val, unsigned int shift)
7d5e525b
MB
146{
147 __be32 *b = buf;
148
d939fb9a 149 b[0] = cpu_to_be32(val << shift);
7d5e525b
MB
150}
151
b83a313b
MB
152static unsigned int regmap_parse_8(void *buf)
153{
154 u8 *b = buf;
155
156 return b[0];
157}
158
159static unsigned int regmap_parse_16(void *buf)
160{
161 __be16 *b = buf;
162
163 b[0] = be16_to_cpu(b[0]);
164
165 return b[0];
166}
167
ea279fc5
MR
168static unsigned int regmap_parse_24(void *buf)
169{
170 u8 *b = buf;
171 unsigned int ret = b[2];
172 ret |= ((unsigned int)b[1]) << 8;
173 ret |= ((unsigned int)b[0]) << 16;
174
175 return ret;
176}
177
7d5e525b
MB
178static unsigned int regmap_parse_32(void *buf)
179{
180 __be32 *b = buf;
181
182 b[0] = be32_to_cpu(b[0]);
183
184 return b[0];
185}
186
bacdbe07
SW
187static void regmap_lock_mutex(struct regmap *map)
188{
189 mutex_lock(&map->mutex);
190}
191
192static void regmap_unlock_mutex(struct regmap *map)
193{
194 mutex_unlock(&map->mutex);
195}
196
197static void regmap_lock_spinlock(struct regmap *map)
198{
199 spin_lock(&map->spinlock);
200}
201
202static void regmap_unlock_spinlock(struct regmap *map)
203{
204 spin_unlock(&map->spinlock);
205}
206
72b39f6f
MB
207static void dev_get_regmap_release(struct device *dev, void *res)
208{
209 /*
210 * We don't actually have anything to do here; the goal here
211 * is not to manage the regmap but to provide a simple way to
212 * get the regmap back given a struct device.
213 */
214}
215
6863ca62
KG
216static bool _regmap_range_add(struct regmap *map,
217 struct regmap_range_node *data)
218{
219 struct rb_root *root = &map->range_tree;
220 struct rb_node **new = &(root->rb_node), *parent = NULL;
221
222 while (*new) {
223 struct regmap_range_node *this =
224 container_of(*new, struct regmap_range_node, node);
225
226 parent = *new;
227 if (data->range_max < this->range_min)
228 new = &((*new)->rb_left);
229 else if (data->range_min > this->range_max)
230 new = &((*new)->rb_right);
231 else
232 return false;
233 }
234
235 rb_link_node(&data->node, parent, new);
236 rb_insert_color(&data->node, root);
237
238 return true;
239}
240
241static struct regmap_range_node *_regmap_range_lookup(struct regmap *map,
242 unsigned int reg)
243{
244 struct rb_node *node = map->range_tree.rb_node;
245
246 while (node) {
247 struct regmap_range_node *this =
248 container_of(node, struct regmap_range_node, node);
249
250 if (reg < this->range_min)
251 node = node->rb_left;
252 else if (reg > this->range_max)
253 node = node->rb_right;
254 else
255 return this;
256 }
257
258 return NULL;
259}
260
261static void regmap_range_exit(struct regmap *map)
262{
263 struct rb_node *next;
264 struct regmap_range_node *range_node;
265
266 next = rb_first(&map->range_tree);
267 while (next) {
268 range_node = rb_entry(next, struct regmap_range_node, node);
269 next = rb_next(&range_node->node);
270 rb_erase(&range_node->node, &map->range_tree);
271 kfree(range_node);
272 }
273
274 kfree(map->selector_work_buf);
275}
276
b83a313b
MB
277/**
278 * regmap_init(): Initialise register map
279 *
280 * @dev: Device that will be interacted with
281 * @bus: Bus-specific callbacks to use with device
0135bbcc 282 * @bus_context: Data passed to bus-specific callbacks
b83a313b
MB
283 * @config: Configuration for register map
284 *
285 * The return value will be an ERR_PTR() on error or a valid pointer to
286 * a struct regmap. This function should generally not be called
287 * directly, it should be called by bus-specific init functions.
288 */
289struct regmap *regmap_init(struct device *dev,
290 const struct regmap_bus *bus,
0135bbcc 291 void *bus_context,
b83a313b
MB
292 const struct regmap_config *config)
293{
72b39f6f 294 struct regmap *map, **m;
b83a313b 295 int ret = -EINVAL;
6863ca62 296 int i, j;
b83a313b
MB
297
298 if (!bus || !config)
abbb18fb 299 goto err;
b83a313b
MB
300
301 map = kzalloc(sizeof(*map), GFP_KERNEL);
302 if (map == NULL) {
303 ret = -ENOMEM;
304 goto err;
305 }
306
bacdbe07
SW
307 if (bus->fast_io) {
308 spin_lock_init(&map->spinlock);
309 map->lock = regmap_lock_spinlock;
310 map->unlock = regmap_unlock_spinlock;
311 } else {
312 mutex_init(&map->mutex);
313 map->lock = regmap_lock_mutex;
314 map->unlock = regmap_unlock_mutex;
315 }
c212accc 316 map->format.reg_bytes = DIV_ROUND_UP(config->reg_bits, 8);
82159ba8 317 map->format.pad_bytes = config->pad_bits / 8;
c212accc 318 map->format.val_bytes = DIV_ROUND_UP(config->val_bits, 8);
5494a98f
FE
319 map->format.buf_size = DIV_ROUND_UP(config->reg_bits +
320 config->val_bits + config->pad_bits, 8);
d939fb9a 321 map->reg_shift = config->pad_bits % 8;
f01ee60f
SW
322 if (config->reg_stride)
323 map->reg_stride = config->reg_stride;
324 else
325 map->reg_stride = 1;
2e33caf1 326 map->use_single_rw = config->use_single_rw;
b83a313b
MB
327 map->dev = dev;
328 map->bus = bus;
0135bbcc 329 map->bus_context = bus_context;
2e2ae66d
MB
330 map->max_register = config->max_register;
331 map->writeable_reg = config->writeable_reg;
332 map->readable_reg = config->readable_reg;
333 map->volatile_reg = config->volatile_reg;
2efe1642 334 map->precious_reg = config->precious_reg;
5d1729e7 335 map->cache_type = config->cache_type;
72b39f6f 336 map->name = config->name;
b83a313b 337
6f306441
LPC
338 if (config->read_flag_mask || config->write_flag_mask) {
339 map->read_flag_mask = config->read_flag_mask;
340 map->write_flag_mask = config->write_flag_mask;
341 } else {
342 map->read_flag_mask = bus->read_flag_mask;
343 }
344
d939fb9a 345 switch (config->reg_bits + map->reg_shift) {
9aa50750
WS
346 case 2:
347 switch (config->val_bits) {
348 case 6:
349 map->format.format_write = regmap_format_2_6_write;
350 break;
351 default:
352 goto err_map;
353 }
354 break;
355
b83a313b
MB
356 case 4:
357 switch (config->val_bits) {
358 case 12:
359 map->format.format_write = regmap_format_4_12_write;
360 break;
361 default:
362 goto err_map;
363 }
364 break;
365
366 case 7:
367 switch (config->val_bits) {
368 case 9:
369 map->format.format_write = regmap_format_7_9_write;
370 break;
371 default:
372 goto err_map;
373 }
374 break;
375
7e5ec63e
LPC
376 case 10:
377 switch (config->val_bits) {
378 case 14:
379 map->format.format_write = regmap_format_10_14_write;
380 break;
381 default:
382 goto err_map;
383 }
384 break;
385
b83a313b
MB
386 case 8:
387 map->format.format_reg = regmap_format_8;
388 break;
389
390 case 16:
391 map->format.format_reg = regmap_format_16;
392 break;
393
7d5e525b
MB
394 case 32:
395 map->format.format_reg = regmap_format_32;
396 break;
397
b83a313b
MB
398 default:
399 goto err_map;
400 }
401
402 switch (config->val_bits) {
403 case 8:
404 map->format.format_val = regmap_format_8;
405 map->format.parse_val = regmap_parse_8;
406 break;
407 case 16:
408 map->format.format_val = regmap_format_16;
409 map->format.parse_val = regmap_parse_16;
410 break;
ea279fc5
MR
411 case 24:
412 map->format.format_val = regmap_format_24;
413 map->format.parse_val = regmap_parse_24;
414 break;
7d5e525b
MB
415 case 32:
416 map->format.format_val = regmap_format_32;
417 map->format.parse_val = regmap_parse_32;
418 break;
b83a313b
MB
419 }
420
7a647614
MB
421 if (map->format.format_write)
422 map->use_single_rw = true;
423
b83a313b
MB
424 if (!map->format.format_write &&
425 !(map->format.format_reg && map->format.format_val))
426 goto err_map;
427
82159ba8 428 map->work_buf = kzalloc(map->format.buf_size, GFP_KERNEL);
b83a313b
MB
429 if (map->work_buf == NULL) {
430 ret = -ENOMEM;
5204f5e3 431 goto err_map;
b83a313b
MB
432 }
433
6863ca62
KG
434 map->range_tree = RB_ROOT;
435 for (i = 0; i < config->n_ranges; i++) {
436 const struct regmap_range_cfg *range_cfg = &config->ranges[i];
437 struct regmap_range_node *new;
438
439 /* Sanity check */
440 if (range_cfg->range_max < range_cfg->range_min ||
441 range_cfg->range_max > map->max_register ||
442 range_cfg->selector_reg > map->max_register ||
443 range_cfg->window_len == 0)
444 goto err_range;
445
446 /* Make sure, that this register range has no selector
447 or data window within its boundary */
448 for (j = 0; j < config->n_ranges; j++) {
449 unsigned sel_reg = config->ranges[j].selector_reg;
450 unsigned win_min = config->ranges[j].window_start;
451 unsigned win_max = win_min +
452 config->ranges[j].window_len - 1;
453
454 if (range_cfg->range_min <= sel_reg &&
455 sel_reg <= range_cfg->range_max) {
456 goto err_range;
457 }
458
459 if (!(win_max < range_cfg->range_min ||
460 win_min > range_cfg->range_max)) {
461 goto err_range;
462 }
463 }
464
465 new = kzalloc(sizeof(*new), GFP_KERNEL);
466 if (new == NULL) {
467 ret = -ENOMEM;
468 goto err_range;
469 }
470
471 new->range_min = range_cfg->range_min;
472 new->range_max = range_cfg->range_max;
473 new->selector_reg = range_cfg->selector_reg;
474 new->selector_mask = range_cfg->selector_mask;
475 new->selector_shift = range_cfg->selector_shift;
476 new->window_start = range_cfg->window_start;
477 new->window_len = range_cfg->window_len;
478
479 if (_regmap_range_add(map, new) == false) {
480 kfree(new);
481 goto err_range;
482 }
483
484 if (map->selector_work_buf == NULL) {
485 map->selector_work_buf =
486 kzalloc(map->format.buf_size, GFP_KERNEL);
487 if (map->selector_work_buf == NULL) {
488 ret = -ENOMEM;
489 goto err_range;
490 }
491 }
492 }
052d2cd1 493
e5e3b8ab 494 ret = regcache_init(map, config);
5d1729e7 495 if (ret < 0)
6863ca62
KG
496 goto err_range;
497
498 regmap_debugfs_init(map, config->name);
5d1729e7 499
72b39f6f
MB
500 /* Add a devres resource for dev_get_regmap() */
501 m = devres_alloc(dev_get_regmap_release, sizeof(*m), GFP_KERNEL);
502 if (!m) {
503 ret = -ENOMEM;
6863ca62 504 goto err_debugfs;
72b39f6f
MB
505 }
506 *m = map;
507 devres_add(dev, m);
508
b83a313b
MB
509 return map;
510
bfaa25f3
SW
511err_debugfs:
512 regmap_debugfs_exit(map);
6863ca62
KG
513 regcache_exit(map);
514err_range:
515 regmap_range_exit(map);
58072cbf 516 kfree(map->work_buf);
b83a313b
MB
517err_map:
518 kfree(map);
519err:
520 return ERR_PTR(ret);
521}
522EXPORT_SYMBOL_GPL(regmap_init);
523
c0eb4676
MB
524static void devm_regmap_release(struct device *dev, void *res)
525{
526 regmap_exit(*(struct regmap **)res);
527}
528
529/**
530 * devm_regmap_init(): Initialise managed register map
531 *
532 * @dev: Device that will be interacted with
533 * @bus: Bus-specific callbacks to use with device
0135bbcc 534 * @bus_context: Data passed to bus-specific callbacks
c0eb4676
MB
535 * @config: Configuration for register map
536 *
537 * The return value will be an ERR_PTR() on error or a valid pointer
538 * to a struct regmap. This function should generally not be called
539 * directly, it should be called by bus-specific init functions. The
540 * map will be automatically freed by the device management code.
541 */
542struct regmap *devm_regmap_init(struct device *dev,
543 const struct regmap_bus *bus,
0135bbcc 544 void *bus_context,
c0eb4676
MB
545 const struct regmap_config *config)
546{
547 struct regmap **ptr, *regmap;
548
549 ptr = devres_alloc(devm_regmap_release, sizeof(*ptr), GFP_KERNEL);
550 if (!ptr)
551 return ERR_PTR(-ENOMEM);
552
0135bbcc 553 regmap = regmap_init(dev, bus, bus_context, config);
c0eb4676
MB
554 if (!IS_ERR(regmap)) {
555 *ptr = regmap;
556 devres_add(dev, ptr);
557 } else {
558 devres_free(ptr);
559 }
560
561 return regmap;
562}
563EXPORT_SYMBOL_GPL(devm_regmap_init);
564
bf315173
MB
565/**
566 * regmap_reinit_cache(): Reinitialise the current register cache
567 *
568 * @map: Register map to operate on.
569 * @config: New configuration. Only the cache data will be used.
570 *
571 * Discard any existing register cache for the map and initialize a
572 * new cache. This can be used to restore the cache to defaults or to
573 * update the cache configuration to reflect runtime discovery of the
574 * hardware.
575 */
576int regmap_reinit_cache(struct regmap *map, const struct regmap_config *config)
577{
578 int ret;
579
bacdbe07 580 map->lock(map);
bf315173
MB
581
582 regcache_exit(map);
a24f64a6 583 regmap_debugfs_exit(map);
bf315173
MB
584
585 map->max_register = config->max_register;
586 map->writeable_reg = config->writeable_reg;
587 map->readable_reg = config->readable_reg;
588 map->volatile_reg = config->volatile_reg;
589 map->precious_reg = config->precious_reg;
590 map->cache_type = config->cache_type;
591
d3c242e1 592 regmap_debugfs_init(map, config->name);
a24f64a6 593
421e8d2d
MB
594 map->cache_bypass = false;
595 map->cache_only = false;
596
bf315173
MB
597 ret = regcache_init(map, config);
598
bacdbe07 599 map->unlock(map);
bf315173
MB
600
601 return ret;
602}
752a6a5f 603EXPORT_SYMBOL_GPL(regmap_reinit_cache);
bf315173 604
b83a313b
MB
605/**
606 * regmap_exit(): Free a previously allocated register map
607 */
608void regmap_exit(struct regmap *map)
609{
5d1729e7 610 regcache_exit(map);
31244e39 611 regmap_debugfs_exit(map);
6863ca62 612 regmap_range_exit(map);
0135bbcc
SW
613 if (map->bus->free_context)
614 map->bus->free_context(map->bus_context);
b83a313b 615 kfree(map->work_buf);
b83a313b
MB
616 kfree(map);
617}
618EXPORT_SYMBOL_GPL(regmap_exit);
619
72b39f6f
MB
620static int dev_get_regmap_match(struct device *dev, void *res, void *data)
621{
622 struct regmap **r = res;
623 if (!r || !*r) {
624 WARN_ON(!r || !*r);
625 return 0;
626 }
627
628 /* If the user didn't specify a name match any */
629 if (data)
630 return (*r)->name == data;
631 else
632 return 1;
633}
634
635/**
636 * dev_get_regmap(): Obtain the regmap (if any) for a device
637 *
638 * @dev: Device to retrieve the map for
639 * @name: Optional name for the register map, usually NULL.
640 *
641 * Returns the regmap for the device if one is present, or NULL. If
642 * name is specified then it must match the name specified when
643 * registering the device, if it is NULL then the first regmap found
644 * will be used. Devices with multiple register maps are very rare,
645 * generic code should normally not need to specify a name.
646 */
647struct regmap *dev_get_regmap(struct device *dev, const char *name)
648{
649 struct regmap **r = devres_find(dev, dev_get_regmap_release,
650 dev_get_regmap_match, (void *)name);
651
652 if (!r)
653 return NULL;
654 return *r;
655}
656EXPORT_SYMBOL_GPL(dev_get_regmap);
657
6863ca62
KG
658static int _regmap_select_page(struct regmap *map, unsigned int *reg,
659 unsigned int val_num)
660{
661 struct regmap_range_node *range;
662 void *orig_work_buf;
663 unsigned int win_offset;
664 unsigned int win_page;
665 bool page_chg;
666 int ret;
667
668 range = _regmap_range_lookup(map, *reg);
669 if (range) {
670 win_offset = (*reg - range->range_min) % range->window_len;
671 win_page = (*reg - range->range_min) / range->window_len;
672
673 if (val_num > 1) {
674 /* Bulk write shouldn't cross range boundary */
675 if (*reg + val_num - 1 > range->range_max)
676 return -EINVAL;
677
678 /* ... or single page boundary */
679 if (val_num > range->window_len - win_offset)
680 return -EINVAL;
681 }
682
683 /* It is possible to have selector register inside data window.
684 In that case, selector register is located on every page and
685 it needs no page switching, when accessed alone. */
686 if (val_num > 1 ||
687 range->window_start + win_offset != range->selector_reg) {
688 /* Use separate work_buf during page switching */
689 orig_work_buf = map->work_buf;
690 map->work_buf = map->selector_work_buf;
691
692 ret = _regmap_update_bits(map, range->selector_reg,
693 range->selector_mask,
694 win_page << range->selector_shift,
695 &page_chg);
696 if (ret < 0)
697 return ret;
698
699 map->work_buf = orig_work_buf;
700 }
701
702 *reg = range->window_start + win_offset;
703 }
704
705 return 0;
706}
707
b83a313b
MB
708static int _regmap_raw_write(struct regmap *map, unsigned int reg,
709 const void *val, size_t val_len)
710{
6f306441 711 u8 *u8 = map->work_buf;
b83a313b
MB
712 void *buf;
713 int ret = -ENOTSUPP;
714 size_t len;
73304781
MB
715 int i;
716
717 /* Check for unwritable registers before we start */
718 if (map->writeable_reg)
719 for (i = 0; i < val_len / map->format.val_bytes; i++)
f01ee60f
SW
720 if (!map->writeable_reg(map->dev,
721 reg + (i * map->reg_stride)))
73304781 722 return -EINVAL;
b83a313b 723
c9157198
LD
724 if (!map->cache_bypass && map->format.parse_val) {
725 unsigned int ival;
726 int val_bytes = map->format.val_bytes;
727 for (i = 0; i < val_len / val_bytes; i++) {
728 memcpy(map->work_buf, val + (i * val_bytes), val_bytes);
729 ival = map->format.parse_val(map->work_buf);
f01ee60f
SW
730 ret = regcache_write(map, reg + (i * map->reg_stride),
731 ival);
c9157198
LD
732 if (ret) {
733 dev_err(map->dev,
734 "Error in caching of register: %u ret: %d\n",
735 reg + i, ret);
736 return ret;
737 }
738 }
739 if (map->cache_only) {
740 map->cache_dirty = true;
741 return 0;
742 }
743 }
744
6863ca62
KG
745 ret = _regmap_select_page(map, &reg, val_len / map->format.val_bytes);
746 if (ret < 0)
747 return ret;
748
d939fb9a 749 map->format.format_reg(map->work_buf, reg, map->reg_shift);
b83a313b 750
6f306441
LPC
751 u8[0] |= map->write_flag_mask;
752
fb2736bb
MB
753 trace_regmap_hw_write_start(map->dev, reg,
754 val_len / map->format.val_bytes);
755
2547e201
MB
756 /* If we're doing a single register write we can probably just
757 * send the work_buf directly, otherwise try to do a gather
758 * write.
759 */
82159ba8
MB
760 if (val == (map->work_buf + map->format.pad_bytes +
761 map->format.reg_bytes))
0135bbcc 762 ret = map->bus->write(map->bus_context, map->work_buf,
82159ba8
MB
763 map->format.reg_bytes +
764 map->format.pad_bytes +
765 val_len);
2547e201 766 else if (map->bus->gather_write)
0135bbcc 767 ret = map->bus->gather_write(map->bus_context, map->work_buf,
82159ba8
MB
768 map->format.reg_bytes +
769 map->format.pad_bytes,
b83a313b
MB
770 val, val_len);
771
2547e201 772 /* If that didn't work fall back on linearising by hand. */
b83a313b 773 if (ret == -ENOTSUPP) {
82159ba8
MB
774 len = map->format.reg_bytes + map->format.pad_bytes + val_len;
775 buf = kzalloc(len, GFP_KERNEL);
b83a313b
MB
776 if (!buf)
777 return -ENOMEM;
778
779 memcpy(buf, map->work_buf, map->format.reg_bytes);
82159ba8
MB
780 memcpy(buf + map->format.reg_bytes + map->format.pad_bytes,
781 val, val_len);
0135bbcc 782 ret = map->bus->write(map->bus_context, buf, len);
b83a313b
MB
783
784 kfree(buf);
785 }
786
fb2736bb
MB
787 trace_regmap_hw_write_done(map->dev, reg,
788 val_len / map->format.val_bytes);
789
b83a313b
MB
790 return ret;
791}
792
4d2dc095
DP
793int _regmap_write(struct regmap *map, unsigned int reg,
794 unsigned int val)
b83a313b 795{
fb2736bb 796 int ret;
b83a313b
MB
797 BUG_ON(!map->format.format_write && !map->format.format_val);
798
c9157198 799 if (!map->cache_bypass && map->format.format_write) {
5d1729e7
DP
800 ret = regcache_write(map, reg, val);
801 if (ret != 0)
802 return ret;
8ae0d7e8
MB
803 if (map->cache_only) {
804 map->cache_dirty = true;
5d1729e7 805 return 0;
8ae0d7e8 806 }
5d1729e7
DP
807 }
808
fb2736bb
MB
809 trace_regmap_reg_write(map->dev, reg, val);
810
b83a313b 811 if (map->format.format_write) {
6863ca62
KG
812 ret = _regmap_select_page(map, &reg, 1);
813 if (ret < 0)
814 return ret;
815
b83a313b
MB
816 map->format.format_write(map, reg, val);
817
fb2736bb
MB
818 trace_regmap_hw_write_start(map->dev, reg, 1);
819
0135bbcc 820 ret = map->bus->write(map->bus_context, map->work_buf,
fb2736bb
MB
821 map->format.buf_size);
822
823 trace_regmap_hw_write_done(map->dev, reg, 1);
824
825 return ret;
b83a313b 826 } else {
82159ba8 827 map->format.format_val(map->work_buf + map->format.reg_bytes
d939fb9a 828 + map->format.pad_bytes, val, 0);
b83a313b 829 return _regmap_raw_write(map, reg,
82159ba8
MB
830 map->work_buf +
831 map->format.reg_bytes +
832 map->format.pad_bytes,
b83a313b
MB
833 map->format.val_bytes);
834 }
835}
836
837/**
838 * regmap_write(): Write a value to a single register
839 *
840 * @map: Register map to write to
841 * @reg: Register to write to
842 * @val: Value to be written
843 *
844 * A value of zero will be returned on success, a negative errno will
845 * be returned in error cases.
846 */
847int regmap_write(struct regmap *map, unsigned int reg, unsigned int val)
848{
849 int ret;
850
f01ee60f
SW
851 if (reg % map->reg_stride)
852 return -EINVAL;
853
bacdbe07 854 map->lock(map);
b83a313b
MB
855
856 ret = _regmap_write(map, reg, val);
857
bacdbe07 858 map->unlock(map);
b83a313b
MB
859
860 return ret;
861}
862EXPORT_SYMBOL_GPL(regmap_write);
863
864/**
865 * regmap_raw_write(): Write raw values to one or more registers
866 *
867 * @map: Register map to write to
868 * @reg: Initial register to write to
869 * @val: Block of data to be written, laid out for direct transmission to the
870 * device
871 * @val_len: Length of data pointed to by val.
872 *
873 * This function is intended to be used for things like firmware
874 * download where a large block of data needs to be transferred to the
875 * device. No formatting will be done on the data provided.
876 *
877 * A value of zero will be returned on success, a negative errno will
878 * be returned in error cases.
879 */
880int regmap_raw_write(struct regmap *map, unsigned int reg,
881 const void *val, size_t val_len)
882{
883 int ret;
884
851960ba
SW
885 if (val_len % map->format.val_bytes)
886 return -EINVAL;
f01ee60f
SW
887 if (reg % map->reg_stride)
888 return -EINVAL;
851960ba 889
bacdbe07 890 map->lock(map);
b83a313b
MB
891
892 ret = _regmap_raw_write(map, reg, val, val_len);
893
bacdbe07 894 map->unlock(map);
b83a313b
MB
895
896 return ret;
897}
898EXPORT_SYMBOL_GPL(regmap_raw_write);
899
8eaeb219
LD
900/*
901 * regmap_bulk_write(): Write multiple registers to the device
902 *
903 * @map: Register map to write to
904 * @reg: First register to be write from
905 * @val: Block of data to be written, in native register size for device
906 * @val_count: Number of registers to write
907 *
908 * This function is intended to be used for writing a large block of
909 * data to be device either in single transfer or multiple transfer.
910 *
911 * A value of zero will be returned on success, a negative errno will
912 * be returned in error cases.
913 */
914int regmap_bulk_write(struct regmap *map, unsigned int reg, const void *val,
915 size_t val_count)
916{
917 int ret = 0, i;
918 size_t val_bytes = map->format.val_bytes;
919 void *wval;
920
921 if (!map->format.parse_val)
922 return -EINVAL;
f01ee60f
SW
923 if (reg % map->reg_stride)
924 return -EINVAL;
8eaeb219 925
bacdbe07 926 map->lock(map);
8eaeb219
LD
927
928 /* No formatting is require if val_byte is 1 */
929 if (val_bytes == 1) {
930 wval = (void *)val;
931 } else {
932 wval = kmemdup(val, val_count * val_bytes, GFP_KERNEL);
933 if (!wval) {
934 ret = -ENOMEM;
935 dev_err(map->dev, "Error in memory allocation\n");
936 goto out;
937 }
938 for (i = 0; i < val_count * val_bytes; i += val_bytes)
939 map->format.parse_val(wval + i);
940 }
2e33caf1
AJ
941 /*
942 * Some devices does not support bulk write, for
943 * them we have a series of single write operations.
944 */
945 if (map->use_single_rw) {
946 for (i = 0; i < val_count; i++) {
947 ret = regmap_raw_write(map,
948 reg + (i * map->reg_stride),
949 val + (i * val_bytes),
950 val_bytes);
951 if (ret != 0)
952 return ret;
953 }
954 } else {
955 ret = _regmap_raw_write(map, reg, wval, val_bytes * val_count);
956 }
8eaeb219
LD
957
958 if (val_bytes != 1)
959 kfree(wval);
960
961out:
bacdbe07 962 map->unlock(map);
8eaeb219
LD
963 return ret;
964}
965EXPORT_SYMBOL_GPL(regmap_bulk_write);
966
b83a313b
MB
967static int _regmap_raw_read(struct regmap *map, unsigned int reg, void *val,
968 unsigned int val_len)
969{
970 u8 *u8 = map->work_buf;
971 int ret;
972
6863ca62
KG
973 ret = _regmap_select_page(map, &reg, val_len / map->format.val_bytes);
974 if (ret < 0)
975 return ret;
976
d939fb9a 977 map->format.format_reg(map->work_buf, reg, map->reg_shift);
b83a313b
MB
978
979 /*
6f306441 980 * Some buses or devices flag reads by setting the high bits in the
b83a313b
MB
981 * register addresss; since it's always the high bits for all
982 * current formats we can do this here rather than in
983 * formatting. This may break if we get interesting formats.
984 */
6f306441 985 u8[0] |= map->read_flag_mask;
b83a313b 986
fb2736bb
MB
987 trace_regmap_hw_read_start(map->dev, reg,
988 val_len / map->format.val_bytes);
989
0135bbcc 990 ret = map->bus->read(map->bus_context, map->work_buf,
82159ba8 991 map->format.reg_bytes + map->format.pad_bytes,
40c5cc26 992 val, val_len);
b83a313b 993
fb2736bb
MB
994 trace_regmap_hw_read_done(map->dev, reg,
995 val_len / map->format.val_bytes);
996
997 return ret;
b83a313b
MB
998}
999
1000static int _regmap_read(struct regmap *map, unsigned int reg,
1001 unsigned int *val)
1002{
1003 int ret;
1004
5d1729e7
DP
1005 if (!map->cache_bypass) {
1006 ret = regcache_read(map, reg, val);
1007 if (ret == 0)
1008 return 0;
1009 }
1010
19254411
LPC
1011 if (!map->format.parse_val)
1012 return -EINVAL;
1013
5d1729e7
DP
1014 if (map->cache_only)
1015 return -EBUSY;
1016
b83a313b 1017 ret = _regmap_raw_read(map, reg, map->work_buf, map->format.val_bytes);
fb2736bb 1018 if (ret == 0) {
b83a313b 1019 *val = map->format.parse_val(map->work_buf);
fb2736bb
MB
1020 trace_regmap_reg_read(map->dev, reg, *val);
1021 }
b83a313b 1022
f2985367
MB
1023 if (ret == 0 && !map->cache_bypass)
1024 regcache_write(map, reg, *val);
1025
b83a313b
MB
1026 return ret;
1027}
1028
1029/**
1030 * regmap_read(): Read a value from a single register
1031 *
1032 * @map: Register map to write to
1033 * @reg: Register to be read from
1034 * @val: Pointer to store read value
1035 *
1036 * A value of zero will be returned on success, a negative errno will
1037 * be returned in error cases.
1038 */
1039int regmap_read(struct regmap *map, unsigned int reg, unsigned int *val)
1040{
1041 int ret;
1042
f01ee60f
SW
1043 if (reg % map->reg_stride)
1044 return -EINVAL;
1045
bacdbe07 1046 map->lock(map);
b83a313b
MB
1047
1048 ret = _regmap_read(map, reg, val);
1049
bacdbe07 1050 map->unlock(map);
b83a313b
MB
1051
1052 return ret;
1053}
1054EXPORT_SYMBOL_GPL(regmap_read);
1055
1056/**
1057 * regmap_raw_read(): Read raw data from the device
1058 *
1059 * @map: Register map to write to
1060 * @reg: First register to be read from
1061 * @val: Pointer to store read value
1062 * @val_len: Size of data to read
1063 *
1064 * A value of zero will be returned on success, a negative errno will
1065 * be returned in error cases.
1066 */
1067int regmap_raw_read(struct regmap *map, unsigned int reg, void *val,
1068 size_t val_len)
1069{
b8fb5ab1
MB
1070 size_t val_bytes = map->format.val_bytes;
1071 size_t val_count = val_len / val_bytes;
1072 unsigned int v;
1073 int ret, i;
04e016ad 1074
851960ba
SW
1075 if (val_len % map->format.val_bytes)
1076 return -EINVAL;
f01ee60f
SW
1077 if (reg % map->reg_stride)
1078 return -EINVAL;
851960ba 1079
bacdbe07 1080 map->lock(map);
b83a313b 1081
b8fb5ab1
MB
1082 if (regmap_volatile_range(map, reg, val_count) || map->cache_bypass ||
1083 map->cache_type == REGCACHE_NONE) {
1084 /* Physical block read if there's no cache involved */
1085 ret = _regmap_raw_read(map, reg, val, val_len);
1086
1087 } else {
1088 /* Otherwise go word by word for the cache; should be low
1089 * cost as we expect to hit the cache.
1090 */
1091 for (i = 0; i < val_count; i++) {
f01ee60f
SW
1092 ret = _regmap_read(map, reg + (i * map->reg_stride),
1093 &v);
b8fb5ab1
MB
1094 if (ret != 0)
1095 goto out;
1096
d939fb9a 1097 map->format.format_val(val + (i * val_bytes), v, 0);
b8fb5ab1
MB
1098 }
1099 }
b83a313b 1100
b8fb5ab1 1101 out:
bacdbe07 1102 map->unlock(map);
b83a313b
MB
1103
1104 return ret;
1105}
1106EXPORT_SYMBOL_GPL(regmap_raw_read);
1107
1108/**
1109 * regmap_bulk_read(): Read multiple registers from the device
1110 *
1111 * @map: Register map to write to
1112 * @reg: First register to be read from
1113 * @val: Pointer to store read value, in native register size for device
1114 * @val_count: Number of registers to read
1115 *
1116 * A value of zero will be returned on success, a negative errno will
1117 * be returned in error cases.
1118 */
1119int regmap_bulk_read(struct regmap *map, unsigned int reg, void *val,
1120 size_t val_count)
1121{
1122 int ret, i;
1123 size_t val_bytes = map->format.val_bytes;
82cd9965 1124 bool vol = regmap_volatile_range(map, reg, val_count);
5d1729e7 1125
b83a313b
MB
1126 if (!map->format.parse_val)
1127 return -EINVAL;
f01ee60f
SW
1128 if (reg % map->reg_stride)
1129 return -EINVAL;
b83a313b 1130
de2d808f 1131 if (vol || map->cache_type == REGCACHE_NONE) {
2e33caf1
AJ
1132 /*
1133 * Some devices does not support bulk read, for
1134 * them we have a series of single read operations.
1135 */
1136 if (map->use_single_rw) {
1137 for (i = 0; i < val_count; i++) {
1138 ret = regmap_raw_read(map,
1139 reg + (i * map->reg_stride),
1140 val + (i * val_bytes),
1141 val_bytes);
1142 if (ret != 0)
1143 return ret;
1144 }
1145 } else {
1146 ret = regmap_raw_read(map, reg, val,
1147 val_bytes * val_count);
1148 if (ret != 0)
1149 return ret;
1150 }
de2d808f
MB
1151
1152 for (i = 0; i < val_count * val_bytes; i += val_bytes)
1153 map->format.parse_val(val + i);
1154 } else {
1155 for (i = 0; i < val_count; i++) {
6560ffd1 1156 unsigned int ival;
f01ee60f 1157 ret = regmap_read(map, reg + (i * map->reg_stride),
25061d28 1158 &ival);
de2d808f
MB
1159 if (ret != 0)
1160 return ret;
6560ffd1 1161 memcpy(val + (i * val_bytes), &ival, val_bytes);
de2d808f
MB
1162 }
1163 }
b83a313b
MB
1164
1165 return 0;
1166}
1167EXPORT_SYMBOL_GPL(regmap_bulk_read);
1168
018690d3
MB
1169static int _regmap_update_bits(struct regmap *map, unsigned int reg,
1170 unsigned int mask, unsigned int val,
1171 bool *change)
b83a313b
MB
1172{
1173 int ret;
d91e8db2 1174 unsigned int tmp, orig;
b83a313b 1175
d91e8db2 1176 ret = _regmap_read(map, reg, &orig);
b83a313b 1177 if (ret != 0)
fc3ebd78 1178 return ret;
b83a313b 1179
d91e8db2 1180 tmp = orig & ~mask;
b83a313b
MB
1181 tmp |= val & mask;
1182
018690d3 1183 if (tmp != orig) {
d91e8db2 1184 ret = _regmap_write(map, reg, tmp);
018690d3
MB
1185 *change = true;
1186 } else {
1187 *change = false;
1188 }
b83a313b 1189
b83a313b
MB
1190 return ret;
1191}
018690d3
MB
1192
1193/**
1194 * regmap_update_bits: Perform a read/modify/write cycle on the register map
1195 *
1196 * @map: Register map to update
1197 * @reg: Register to update
1198 * @mask: Bitmask to change
1199 * @val: New value for bitmask
1200 *
1201 * Returns zero for success, a negative number on error.
1202 */
1203int regmap_update_bits(struct regmap *map, unsigned int reg,
1204 unsigned int mask, unsigned int val)
1205{
1206 bool change;
fc3ebd78
KG
1207 int ret;
1208
1209 map->lock(map);
1210 ret = _regmap_update_bits(map, reg, mask, val, &change);
1211 map->unlock(map);
1212
1213 return ret;
018690d3 1214}
b83a313b 1215EXPORT_SYMBOL_GPL(regmap_update_bits);
31244e39 1216
018690d3
MB
1217/**
1218 * regmap_update_bits_check: Perform a read/modify/write cycle on the
1219 * register map and report if updated
1220 *
1221 * @map: Register map to update
1222 * @reg: Register to update
1223 * @mask: Bitmask to change
1224 * @val: New value for bitmask
1225 * @change: Boolean indicating if a write was done
1226 *
1227 * Returns zero for success, a negative number on error.
1228 */
1229int regmap_update_bits_check(struct regmap *map, unsigned int reg,
1230 unsigned int mask, unsigned int val,
1231 bool *change)
1232{
fc3ebd78
KG
1233 int ret;
1234
1235 map->lock(map);
1236 ret = _regmap_update_bits(map, reg, mask, val, change);
1237 map->unlock(map);
1238 return ret;
018690d3
MB
1239}
1240EXPORT_SYMBOL_GPL(regmap_update_bits_check);
1241
22f0d90a
MB
1242/**
1243 * regmap_register_patch: Register and apply register updates to be applied
1244 * on device initialistion
1245 *
1246 * @map: Register map to apply updates to.
1247 * @regs: Values to update.
1248 * @num_regs: Number of entries in regs.
1249 *
1250 * Register a set of register updates to be applied to the device
1251 * whenever the device registers are synchronised with the cache and
1252 * apply them immediately. Typically this is used to apply
1253 * corrections to be applied to the device defaults on startup, such
1254 * as the updates some vendors provide to undocumented registers.
1255 */
1256int regmap_register_patch(struct regmap *map, const struct reg_default *regs,
1257 int num_regs)
1258{
1259 int i, ret;
1260 bool bypass;
1261
1262 /* If needed the implementation can be extended to support this */
1263 if (map->patch)
1264 return -EBUSY;
1265
bacdbe07 1266 map->lock(map);
22f0d90a
MB
1267
1268 bypass = map->cache_bypass;
1269
1270 map->cache_bypass = true;
1271
1272 /* Write out first; it's useful to apply even if we fail later. */
1273 for (i = 0; i < num_regs; i++) {
1274 ret = _regmap_write(map, regs[i].reg, regs[i].def);
1275 if (ret != 0) {
1276 dev_err(map->dev, "Failed to write %x = %x: %d\n",
1277 regs[i].reg, regs[i].def, ret);
1278 goto out;
1279 }
1280 }
1281
2a14d7d9 1282 map->patch = kcalloc(num_regs, sizeof(struct reg_default), GFP_KERNEL);
22f0d90a
MB
1283 if (map->patch != NULL) {
1284 memcpy(map->patch, regs,
1285 num_regs * sizeof(struct reg_default));
1286 map->patch_regs = num_regs;
1287 } else {
1288 ret = -ENOMEM;
1289 }
1290
1291out:
1292 map->cache_bypass = bypass;
1293
bacdbe07 1294 map->unlock(map);
22f0d90a
MB
1295
1296 return ret;
1297}
1298EXPORT_SYMBOL_GPL(regmap_register_patch);
1299
eae4b51b 1300/*
a6539c32
MB
1301 * regmap_get_val_bytes(): Report the size of a register value
1302 *
1303 * Report the size of a register value, mainly intended to for use by
1304 * generic infrastructure built on top of regmap.
1305 */
1306int regmap_get_val_bytes(struct regmap *map)
1307{
1308 if (map->format.format_write)
1309 return -EINVAL;
1310
1311 return map->format.val_bytes;
1312}
1313EXPORT_SYMBOL_GPL(regmap_get_val_bytes);
1314
31244e39
MB
1315static int __init regmap_initcall(void)
1316{
1317 regmap_debugfs_initcall();
1318
1319 return 0;
1320}
1321postcore_initcall(regmap_initcall);