blob: 6b4a775b439b1635895883cef5c291908250d2c0 [file] [log] [blame]
Mark Brownb83a3132011-05-11 19:59:58 +02001/*
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
Stephen Warrenf5d6eba2012-03-09 13:17:28 -070013#include <linux/device.h>
Mark Brownb83a3132011-05-11 19:59:58 +020014#include <linux/slab.h>
Paul Gortmaker19694b52012-02-28 19:28:02 -050015#include <linux/export.h>
Mark Brownb83a3132011-05-11 19:59:58 +020016#include <linux/mutex.h>
17#include <linux/err.h>
18
Mark Brownfb2736b2011-07-24 21:30:55 +010019#define CREATE_TRACE_POINTS
20#include <trace/events/regmap.h>
21
Mark Brown93de9122011-07-20 22:35:37 +010022#include "internal.h"
Mark Brownb83a3132011-05-11 19:59:58 +020023
Mark Brown8de2f082011-08-10 17:14:41 +090024bool 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
Wolfram Sang4191f192012-01-30 15:08:16 +010040 if (map->format.format_write)
41 return false;
42
Mark Brown8de2f082011-08-10 17:14:41 +090043 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{
Wolfram Sang4191f192012-01-30 15:08:16 +010051 if (!regmap_readable(map, reg))
Mark Brown8de2f082011-08-10 17:14:41 +090052 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{
Wolfram Sang4191f192012-01-30 15:08:16 +010062 if (!regmap_readable(map, reg))
Mark Brown8de2f082011-08-10 17:14:41 +090063 return false;
64
65 if (map->precious_reg)
66 return map->precious_reg(map->dev, reg);
67
68 return false;
69}
70
Lars-Peter Clausen82cd9962011-11-08 18:37:25 +010071static 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
Wolfram Sang9aa50752012-01-27 16:10:22 +010083static 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
Mark Brownb83a3132011-05-11 19:59:58 +020091static 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
Lars-Peter Clausen7e5ec632011-11-16 16:28:21 +0100105static 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
Mark Brownb83a3132011-05-11 19:59:58 +0200115static 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
Mark Brown7d5e5252012-02-17 15:58:25 -0800129static void regmap_format_32(void *buf, unsigned int val)
130{
131 __be32 *b = buf;
132
133 b[0] = cpu_to_be32(val);
134}
135
Mark Brownb83a3132011-05-11 19:59:58 +0200136static 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
Mark Brown7d5e5252012-02-17 15:58:25 -0800152static 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
Stephen Warrenbacdbe02012-04-04 15:48:28 -0600161static 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
Mark Brownb83a3132011-05-11 19:59:58 +0200181/**
182 * regmap_init(): Initialise register map
183 *
184 * @dev: Device that will be interacted with
185 * @bus: Bus-specific callbacks to use with device
Stephen Warren0135bbc2012-04-04 15:48:30 -0600186 * @bus_context: Data passed to bus-specific callbacks
Mark Brownb83a3132011-05-11 19:59:58 +0200187 * @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,
Stephen Warren0135bbc2012-04-04 15:48:30 -0600195 void *bus_context,
Mark Brownb83a3132011-05-11 19:59:58 +0200196 const struct regmap_config *config)
197{
198 struct regmap *map;
199 int ret = -EINVAL;
200
201 if (!bus || !config)
Lars-Peter Clausenabbb18f2011-11-14 10:40:15 +0100202 goto err;
Mark Brownb83a3132011-05-11 19:59:58 +0200203
204 map = kzalloc(sizeof(*map), GFP_KERNEL);
205 if (map == NULL) {
206 ret = -ENOMEM;
207 goto err;
208 }
209
Stephen Warrenbacdbe02012-04-04 15:48:28 -0600210 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 }
Mark Brownb83a3132011-05-11 19:59:58 +0200219 map->format.buf_size = (config->reg_bits + config->val_bits) / 8;
Wolfram Sangc212acc2012-01-28 02:16:41 +0100220 map->format.reg_bytes = DIV_ROUND_UP(config->reg_bits, 8);
Mark Brown82159ba2012-01-18 10:52:25 +0000221 map->format.pad_bytes = config->pad_bits / 8;
Wolfram Sangc212acc2012-01-28 02:16:41 +0100222 map->format.val_bytes = DIV_ROUND_UP(config->val_bits, 8);
Mark Brown82159ba2012-01-18 10:52:25 +0000223 map->format.buf_size += map->format.pad_bytes;
Mark Brownb83a3132011-05-11 19:59:58 +0200224 map->dev = dev;
225 map->bus = bus;
Stephen Warren0135bbc2012-04-04 15:48:30 -0600226 map->bus_context = bus_context;
Mark Brown2e2ae662011-07-20 22:33:39 +0100227 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;
Mark Brown2efe1642011-08-08 15:41:46 +0900231 map->precious_reg = config->precious_reg;
Dimitris Papastamos5d1729e2011-09-19 14:34:05 +0100232 map->cache_type = config->cache_type;
Mark Brownb83a3132011-05-11 19:59:58 +0200233
Lars-Peter Clausen6f306442011-09-05 20:46:32 +0200234 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
Mark Brownb83a3132011-05-11 19:59:58 +0200241 switch (config->reg_bits) {
Wolfram Sang9aa50752012-01-27 16:10:22 +0100242 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
Mark Brownb83a3132011-05-11 19:59:58 +0200252 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
Lars-Peter Clausen7e5ec632011-11-16 16:28:21 +0100272 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
Mark Brownb83a3132011-05-11 19:59:58 +0200282 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
Mark Brown7d5e5252012-02-17 15:58:25 -0800290 case 32:
291 map->format.format_reg = regmap_format_32;
292 break;
293
Mark Brownb83a3132011-05-11 19:59:58 +0200294 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;
Mark Brown7d5e5252012-02-17 15:58:25 -0800307 case 32:
308 map->format.format_val = regmap_format_32;
309 map->format.parse_val = regmap_parse_32;
310 break;
Mark Brownb83a3132011-05-11 19:59:58 +0200311 }
312
313 if (!map->format.format_write &&
314 !(map->format.format_reg && map->format.format_val))
315 goto err_map;
316
Mark Brown82159ba2012-01-18 10:52:25 +0000317 map->work_buf = kzalloc(map->format.buf_size, GFP_KERNEL);
Mark Brownb83a3132011-05-11 19:59:58 +0200318 if (map->work_buf == NULL) {
319 ret = -ENOMEM;
Mark Brown5204f5e2011-09-05 08:07:47 -0700320 goto err_map;
Mark Brownb83a3132011-05-11 19:59:58 +0200321 }
322
Mark Brown052d2cd2011-11-21 19:05:13 +0000323 regmap_debugfs_init(map);
324
Lars-Peter Clausene5e3b8a2011-11-16 16:28:16 +0100325 ret = regcache_init(map, config);
Dimitris Papastamos5d1729e2011-09-19 14:34:05 +0100326 if (ret < 0)
Lars-Peter Clausen58072cb2011-11-10 18:15:15 +0100327 goto err_free_workbuf;
Dimitris Papastamos5d1729e2011-09-19 14:34:05 +0100328
Mark Brownb83a3132011-05-11 19:59:58 +0200329 return map;
330
Lars-Peter Clausen58072cb2011-11-10 18:15:15 +0100331err_free_workbuf:
332 kfree(map->work_buf);
Mark Brownb83a3132011-05-11 19:59:58 +0200333err_map:
334 kfree(map);
335err:
336 return ERR_PTR(ret);
337}
338EXPORT_SYMBOL_GPL(regmap_init);
339
Mark Brownc0eb4672012-01-30 19:56:52 +0000340static 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
Stephen Warren0135bbc2012-04-04 15:48:30 -0600350 * @bus_context: Data passed to bus-specific callbacks
Mark Brownc0eb4672012-01-30 19:56:52 +0000351 * @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,
Stephen Warren0135bbc2012-04-04 15:48:30 -0600360 void *bus_context,
Mark Brownc0eb4672012-01-30 19:56:52 +0000361 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
Stephen Warren0135bbc2012-04-04 15:48:30 -0600369 regmap = regmap_init(dev, bus, bus_context, config);
Mark Brownc0eb4672012-01-30 19:56:52 +0000370 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
Mark Brownb83a3132011-05-11 19:59:58 +0200381/**
Mark Brownbf315172011-12-03 17:06:20 +0000382 * 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
Stephen Warrenbacdbe02012-04-04 15:48:28 -0600396 map->lock(map);
Mark Brownbf315172011-12-03 17:06:20 +0000397
398 regcache_exit(map);
Mark Browna24f64a2012-01-26 18:30:16 +0000399 regmap_debugfs_exit(map);
Mark Brownbf315172011-12-03 17:06:20 +0000400
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
Mark Browna24f64a2012-01-26 18:30:16 +0000408 regmap_debugfs_init(map);
409
Mark Brown421e8d22012-01-20 13:39:37 +0000410 map->cache_bypass = false;
411 map->cache_only = false;
412
Mark Brownbf315172011-12-03 17:06:20 +0000413 ret = regcache_init(map, config);
414
Stephen Warrenbacdbe02012-04-04 15:48:28 -0600415 map->unlock(map);
Mark Brownbf315172011-12-03 17:06:20 +0000416
417 return ret;
418}
419
420/**
Mark Brownb83a3132011-05-11 19:59:58 +0200421 * regmap_exit(): Free a previously allocated register map
422 */
423void regmap_exit(struct regmap *map)
424{
Dimitris Papastamos5d1729e2011-09-19 14:34:05 +0100425 regcache_exit(map);
Mark Brown31244e32011-07-20 22:56:53 +0100426 regmap_debugfs_exit(map);
Stephen Warren0135bbc2012-04-04 15:48:30 -0600427 if (map->bus->free_context)
428 map->bus->free_context(map->bus_context);
Mark Brownb83a3132011-05-11 19:59:58 +0200429 kfree(map->work_buf);
Mark Brownb83a3132011-05-11 19:59:58 +0200430 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{
Lars-Peter Clausen6f306442011-09-05 20:46:32 +0200437 u8 *u8 = map->work_buf;
Mark Brownb83a3132011-05-11 19:59:58 +0200438 void *buf;
439 int ret = -ENOTSUPP;
440 size_t len;
Mark Brown73304782011-07-24 11:46:20 +0100441 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;
Mark Brownb83a3132011-05-11 19:59:58 +0200448
Laxman Dewanganc9157192012-02-10 21:30:27 +0530449 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
Mark Brownb83a3132011-05-11 19:59:58 +0200469 map->format.format_reg(map->work_buf, reg);
470
Lars-Peter Clausen6f306442011-09-05 20:46:32 +0200471 u8[0] |= map->write_flag_mask;
472
Mark Brownfb2736b2011-07-24 21:30:55 +0100473 trace_regmap_hw_write_start(map->dev, reg,
474 val_len / map->format.val_bytes);
475
Mark Brown2547e202011-07-20 21:47:22 +0100476 /* 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 */
Mark Brown82159ba2012-01-18 10:52:25 +0000480 if (val == (map->work_buf + map->format.pad_bytes +
481 map->format.reg_bytes))
Stephen Warren0135bbc2012-04-04 15:48:30 -0600482 ret = map->bus->write(map->bus_context, map->work_buf,
Mark Brown82159ba2012-01-18 10:52:25 +0000483 map->format.reg_bytes +
484 map->format.pad_bytes +
485 val_len);
Mark Brown2547e202011-07-20 21:47:22 +0100486 else if (map->bus->gather_write)
Stephen Warren0135bbc2012-04-04 15:48:30 -0600487 ret = map->bus->gather_write(map->bus_context, map->work_buf,
Mark Brown82159ba2012-01-18 10:52:25 +0000488 map->format.reg_bytes +
489 map->format.pad_bytes,
Mark Brownb83a3132011-05-11 19:59:58 +0200490 val, val_len);
491
Mark Brown2547e202011-07-20 21:47:22 +0100492 /* If that didn't work fall back on linearising by hand. */
Mark Brownb83a3132011-05-11 19:59:58 +0200493 if (ret == -ENOTSUPP) {
Mark Brown82159ba2012-01-18 10:52:25 +0000494 len = map->format.reg_bytes + map->format.pad_bytes + val_len;
495 buf = kzalloc(len, GFP_KERNEL);
Mark Brownb83a3132011-05-11 19:59:58 +0200496 if (!buf)
497 return -ENOMEM;
498
499 memcpy(buf, map->work_buf, map->format.reg_bytes);
Mark Brown82159ba2012-01-18 10:52:25 +0000500 memcpy(buf + map->format.reg_bytes + map->format.pad_bytes,
501 val, val_len);
Stephen Warren0135bbc2012-04-04 15:48:30 -0600502 ret = map->bus->write(map->bus_context, buf, len);
Mark Brownb83a3132011-05-11 19:59:58 +0200503
504 kfree(buf);
505 }
506
Mark Brownfb2736b2011-07-24 21:30:55 +0100507 trace_regmap_hw_write_done(map->dev, reg,
508 val_len / map->format.val_bytes);
509
Mark Brownb83a3132011-05-11 19:59:58 +0200510 return ret;
511}
512
Dimitris Papastamos4d2dc092011-09-29 10:39:07 +0100513int _regmap_write(struct regmap *map, unsigned int reg,
514 unsigned int val)
Mark Brownb83a3132011-05-11 19:59:58 +0200515{
Mark Brownfb2736b2011-07-24 21:30:55 +0100516 int ret;
Mark Brownb83a3132011-05-11 19:59:58 +0200517 BUG_ON(!map->format.format_write && !map->format.format_val);
518
Laxman Dewanganc9157192012-02-10 21:30:27 +0530519 if (!map->cache_bypass && map->format.format_write) {
Dimitris Papastamos5d1729e2011-09-19 14:34:05 +0100520 ret = regcache_write(map, reg, val);
521 if (ret != 0)
522 return ret;
Mark Brown8ae0d7e2011-10-26 10:34:22 +0200523 if (map->cache_only) {
524 map->cache_dirty = true;
Dimitris Papastamos5d1729e2011-09-19 14:34:05 +0100525 return 0;
Mark Brown8ae0d7e2011-10-26 10:34:22 +0200526 }
Dimitris Papastamos5d1729e2011-09-19 14:34:05 +0100527 }
528
Mark Brownfb2736b2011-07-24 21:30:55 +0100529 trace_regmap_reg_write(map->dev, reg, val);
530
Mark Brownb83a3132011-05-11 19:59:58 +0200531 if (map->format.format_write) {
532 map->format.format_write(map, reg, val);
533
Mark Brownfb2736b2011-07-24 21:30:55 +0100534 trace_regmap_hw_write_start(map->dev, reg, 1);
535
Stephen Warren0135bbc2012-04-04 15:48:30 -0600536 ret = map->bus->write(map->bus_context, map->work_buf,
Mark Brownfb2736b2011-07-24 21:30:55 +0100537 map->format.buf_size);
538
539 trace_regmap_hw_write_done(map->dev, reg, 1);
540
541 return ret;
Mark Brownb83a3132011-05-11 19:59:58 +0200542 } else {
Mark Brown82159ba2012-01-18 10:52:25 +0000543 map->format.format_val(map->work_buf + map->format.reg_bytes
544 + map->format.pad_bytes, val);
Mark Brownb83a3132011-05-11 19:59:58 +0200545 return _regmap_raw_write(map, reg,
Mark Brown82159ba2012-01-18 10:52:25 +0000546 map->work_buf +
547 map->format.reg_bytes +
548 map->format.pad_bytes,
Mark Brownb83a3132011-05-11 19:59:58 +0200549 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
Stephen Warrenbacdbe02012-04-04 15:48:28 -0600567 map->lock(map);
Mark Brownb83a3132011-05-11 19:59:58 +0200568
569 ret = _regmap_write(map, reg, val);
570
Stephen Warrenbacdbe02012-04-04 15:48:28 -0600571 map->unlock(map);
Mark Brownb83a3132011-05-11 19:59:58 +0200572
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
Stephen Warrenbacdbe02012-04-04 15:48:28 -0600598 map->lock(map);
Mark Brownb83a3132011-05-11 19:59:58 +0200599
600 ret = _regmap_raw_write(map, reg, val, val_len);
601
Stephen Warrenbacdbe02012-04-04 15:48:28 -0600602 map->unlock(map);
Mark Brownb83a3132011-05-11 19:59:58 +0200603
604 return ret;
605}
606EXPORT_SYMBOL_GPL(regmap_raw_write);
607
Laxman Dewangan8eaeb212012-02-12 19:49:43 +0530608/*
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
Stephen Warrenbacdbe02012-04-04 15:48:28 -0600632 map->lock(map);
Laxman Dewangan8eaeb212012-02-12 19:49:43 +0530633
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:
Stephen Warrenbacdbe02012-04-04 15:48:28 -0600653 map->unlock(map);
Laxman Dewangan8eaeb212012-02-12 19:49:43 +0530654 return ret;
655}
656EXPORT_SYMBOL_GPL(regmap_bulk_write);
657
Mark Brownb83a3132011-05-11 19:59:58 +0200658static 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 /*
Lars-Peter Clausen6f306442011-09-05 20:46:32 +0200667 * Some buses or devices flag reads by setting the high bits in the
Mark Brownb83a3132011-05-11 19:59:58 +0200668 * 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 */
Lars-Peter Clausen6f306442011-09-05 20:46:32 +0200672 u8[0] |= map->read_flag_mask;
Mark Brownb83a3132011-05-11 19:59:58 +0200673
Mark Brownfb2736b2011-07-24 21:30:55 +0100674 trace_regmap_hw_read_start(map->dev, reg,
675 val_len / map->format.val_bytes);
676
Stephen Warren0135bbc2012-04-04 15:48:30 -0600677 ret = map->bus->read(map->bus_context, map->work_buf,
Mark Brown82159ba2012-01-18 10:52:25 +0000678 map->format.reg_bytes + map->format.pad_bytes,
Mark Brown40c5cc22011-07-24 22:39:12 +0100679 val, val_len);
Mark Brownb83a3132011-05-11 19:59:58 +0200680
Mark Brownfb2736b2011-07-24 21:30:55 +0100681 trace_regmap_hw_read_done(map->dev, reg,
682 val_len / map->format.val_bytes);
683
684 return ret;
Mark Brownb83a3132011-05-11 19:59:58 +0200685}
686
687static int _regmap_read(struct regmap *map, unsigned int reg,
688 unsigned int *val)
689{
690 int ret;
691
Dimitris Papastamos5d1729e2011-09-19 14:34:05 +0100692 if (!map->cache_bypass) {
693 ret = regcache_read(map, reg, val);
694 if (ret == 0)
695 return 0;
696 }
697
Lars-Peter Clausen19254412011-11-16 16:28:19 +0100698 if (!map->format.parse_val)
699 return -EINVAL;
700
Dimitris Papastamos5d1729e2011-09-19 14:34:05 +0100701 if (map->cache_only)
702 return -EBUSY;
703
Mark Brownb83a3132011-05-11 19:59:58 +0200704 ret = _regmap_raw_read(map, reg, map->work_buf, map->format.val_bytes);
Mark Brownfb2736b2011-07-24 21:30:55 +0100705 if (ret == 0) {
Mark Brownb83a3132011-05-11 19:59:58 +0200706 *val = map->format.parse_val(map->work_buf);
Mark Brownfb2736b2011-07-24 21:30:55 +0100707 trace_regmap_reg_read(map->dev, reg, *val);
708 }
Mark Brownb83a3132011-05-11 19:59:58 +0200709
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
Stephen Warrenbacdbe02012-04-04 15:48:28 -0600727 map->lock(map);
Mark Brownb83a3132011-05-11 19:59:58 +0200728
729 ret = _regmap_read(map, reg, val);
730
Stephen Warrenbacdbe02012-04-04 15:48:28 -0600731 map->unlock(map);
Mark Brownb83a3132011-05-11 19:59:58 +0200732
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{
Mark Brownb8fb5ab2012-02-21 19:12:47 +0000751 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;
Mark Brown04e016a2011-10-09 13:35:43 +0100755
Stephen Warrenbacdbe02012-04-04 15:48:28 -0600756 map->lock(map);
Mark Brownb83a3132011-05-11 19:59:58 +0200757
Mark Brownb8fb5ab2012-02-21 19:12:47 +0000758 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);
Mark Brownb83a3132011-05-11 19:59:58 +0200762
Mark Brownb8fb5ab2012-02-21 19:12:47 +0000763 } 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 }
775
776 out:
Stephen Warrenbacdbe02012-04-04 15:48:28 -0600777 map->unlock(map);
Mark Brownb83a3132011-05-11 19:59:58 +0200778
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;
Lars-Peter Clausen82cd9962011-11-08 18:37:25 +0100799 bool vol = regmap_volatile_range(map, reg, val_count);
Dimitris Papastamos5d1729e2011-09-19 14:34:05 +0100800
Mark Brownb83a3132011-05-11 19:59:58 +0200801 if (!map->format.parse_val)
802 return -EINVAL;
803
Mark Brownde2d8082011-10-10 13:24:52 +0100804 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 }
Mark Brownb83a3132011-05-11 19:59:58 +0200818
819 return 0;
820}
821EXPORT_SYMBOL_GPL(regmap_bulk_read);
822
Mark Brown018690d2011-11-29 20:10:36 +0000823static int _regmap_update_bits(struct regmap *map, unsigned int reg,
824 unsigned int mask, unsigned int val,
825 bool *change)
Mark Brownb83a3132011-05-11 19:59:58 +0200826{
827 int ret;
Mark Brownd91e8db2011-11-18 16:03:50 +0000828 unsigned int tmp, orig;
Mark Brownb83a3132011-05-11 19:59:58 +0200829
Stephen Warrenbacdbe02012-04-04 15:48:28 -0600830 map->lock(map);
Mark Brownb83a3132011-05-11 19:59:58 +0200831
Mark Brownd91e8db2011-11-18 16:03:50 +0000832 ret = _regmap_read(map, reg, &orig);
Mark Brownb83a3132011-05-11 19:59:58 +0200833 if (ret != 0)
834 goto out;
835
Mark Brownd91e8db2011-11-18 16:03:50 +0000836 tmp = orig & ~mask;
Mark Brownb83a3132011-05-11 19:59:58 +0200837 tmp |= val & mask;
838
Mark Brown018690d2011-11-29 20:10:36 +0000839 if (tmp != orig) {
Mark Brownd91e8db2011-11-18 16:03:50 +0000840 ret = _regmap_write(map, reg, tmp);
Mark Brown018690d2011-11-29 20:10:36 +0000841 *change = true;
842 } else {
843 *change = false;
844 }
Mark Brownb83a3132011-05-11 19:59:58 +0200845
846out:
Stephen Warrenbacdbe02012-04-04 15:48:28 -0600847 map->unlock(map);
Mark Brownb83a3132011-05-11 19:59:58 +0200848
849 return ret;
850}
Mark Brown018690d2011-11-29 20:10:36 +0000851
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}
Mark Brownb83a3132011-05-11 19:59:58 +0200868EXPORT_SYMBOL_GPL(regmap_update_bits);
Mark Brown31244e32011-07-20 22:56:53 +0100869
Mark Brown018690d2011-11-29 20:10:36 +0000870/**
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
Mark Brown22f0d902012-01-21 12:01:14 +0000890/**
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
Stephen Warrenbacdbe02012-04-04 15:48:28 -0600914 map->lock(map);
Mark Brown22f0d902012-01-21 12:01:14 +0000915
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
Axel Lin2a14d7d2012-02-10 19:29:55 +0800930 map->patch = kcalloc(num_regs, sizeof(struct reg_default), GFP_KERNEL);
Mark Brown22f0d902012-01-21 12:01:14 +0000931 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
Stephen Warrenbacdbe02012-04-04 15:48:28 -0600942 map->unlock(map);
Mark Brown22f0d902012-01-21 12:01:14 +0000943
944 return ret;
945}
946EXPORT_SYMBOL_GPL(regmap_register_patch);
947
Mark Browneae4b512012-03-14 13:15:03 +0000948/*
Mark Browna6539c32012-02-17 14:20:14 -0800949 * 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
Mark Brown31244e32011-07-20 22:56:53 +0100963static int __init regmap_initcall(void)
964{
965 regmap_debugfs_initcall();
966
967 return 0;
968}
969postcore_initcall(regmap_initcall);