regmap: Remove default cache sync implementation
[deliverable/linux.git] / drivers / base / regmap / regcache.c
CommitLineData
9fabe24e
DP
1/*
2 * Register cache access API
3 *
4 * Copyright 2011 Wolfson Microelectronics plc
5 *
6 * Author: Dimitris Papastamos <dp@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
13#include <linux/slab.h>
1b6bc32f 14#include <linux/export.h>
9fabe24e 15#include <trace/events/regmap.h>
f094fea6 16#include <linux/bsearch.h>
c08604b8 17#include <linux/sort.h>
9fabe24e
DP
18
19#include "internal.h"
20
21static const struct regcache_ops *cache_types[] = {
28644c80 22 &regcache_rbtree_ops,
2cbbb579 23 &regcache_lzo_ops,
9fabe24e
DP
24};
25
26static int regcache_hw_init(struct regmap *map)
27{
28 int i, j;
29 int ret;
30 int count;
31 unsigned int val;
32 void *tmp_buf;
33
34 if (!map->num_reg_defaults_raw)
35 return -EINVAL;
36
37 if (!map->reg_defaults_raw) {
38 dev_warn(map->dev, "No cache defaults, reading back from HW\n");
39 tmp_buf = kmalloc(map->cache_size_raw, GFP_KERNEL);
40 if (!tmp_buf)
41 return -EINVAL;
42 ret = regmap_bulk_read(map, 0, tmp_buf,
43 map->num_reg_defaults_raw);
44 if (ret < 0) {
45 kfree(tmp_buf);
46 return ret;
47 }
48 map->reg_defaults_raw = tmp_buf;
49 map->cache_free = 1;
50 }
51
52 /* calculate the size of reg_defaults */
53 for (count = 0, i = 0; i < map->num_reg_defaults_raw; i++) {
54 val = regcache_get_val(map->reg_defaults_raw,
55 i, map->cache_word_size);
56 if (!val)
57 continue;
58 count++;
59 }
60
61 map->reg_defaults = kmalloc(count * sizeof(struct reg_default),
62 GFP_KERNEL);
021cd616
LPC
63 if (!map->reg_defaults) {
64 ret = -ENOMEM;
65 goto err_free;
66 }
9fabe24e
DP
67
68 /* fill the reg_defaults */
69 map->num_reg_defaults = count;
70 for (i = 0, j = 0; i < map->num_reg_defaults_raw; i++) {
71 val = regcache_get_val(map->reg_defaults_raw,
72 i, map->cache_word_size);
73 if (!val)
74 continue;
75 map->reg_defaults[j].reg = i;
76 map->reg_defaults[j].def = val;
77 j++;
78 }
79
80 return 0;
021cd616
LPC
81
82err_free:
83 if (map->cache_free)
84 kfree(map->reg_defaults_raw);
85
86 return ret;
9fabe24e
DP
87}
88
e5e3b8ab 89int regcache_init(struct regmap *map, const struct regmap_config *config)
9fabe24e
DP
90{
91 int ret;
92 int i;
93 void *tmp_buf;
94
e7a6db30
MB
95 if (map->cache_type == REGCACHE_NONE) {
96 map->cache_bypass = true;
9fabe24e 97 return 0;
e7a6db30 98 }
9fabe24e
DP
99
100 for (i = 0; i < ARRAY_SIZE(cache_types); i++)
101 if (cache_types[i]->type == map->cache_type)
102 break;
103
104 if (i == ARRAY_SIZE(cache_types)) {
105 dev_err(map->dev, "Could not match compress type: %d\n",
106 map->cache_type);
107 return -EINVAL;
108 }
109
e5e3b8ab
LPC
110 map->num_reg_defaults = config->num_reg_defaults;
111 map->num_reg_defaults_raw = config->num_reg_defaults_raw;
112 map->reg_defaults_raw = config->reg_defaults_raw;
064d4db1
LPC
113 map->cache_word_size = DIV_ROUND_UP(config->val_bits, 8);
114 map->cache_size_raw = map->cache_word_size * config->num_reg_defaults_raw;
e5e3b8ab 115
9fabe24e
DP
116 map->cache = NULL;
117 map->cache_ops = cache_types[i];
118
119 if (!map->cache_ops->read ||
120 !map->cache_ops->write ||
121 !map->cache_ops->name)
122 return -EINVAL;
123
124 /* We still need to ensure that the reg_defaults
125 * won't vanish from under us. We'll need to make
126 * a copy of it.
127 */
720e4616 128 if (config->reg_defaults) {
9fabe24e
DP
129 if (!map->num_reg_defaults)
130 return -EINVAL;
720e4616 131 tmp_buf = kmemdup(config->reg_defaults, map->num_reg_defaults *
9fabe24e
DP
132 sizeof(struct reg_default), GFP_KERNEL);
133 if (!tmp_buf)
134 return -ENOMEM;
135 map->reg_defaults = tmp_buf;
8528bdd4 136 } else if (map->num_reg_defaults_raw) {
5fcd2560 137 /* Some devices such as PMICs don't have cache defaults,
9fabe24e
DP
138 * we cope with this by reading back the HW registers and
139 * crafting the cache defaults by hand.
140 */
141 ret = regcache_hw_init(map);
142 if (ret < 0)
143 return ret;
144 }
145
146 if (!map->max_register)
147 map->max_register = map->num_reg_defaults_raw;
148
149 if (map->cache_ops->init) {
150 dev_dbg(map->dev, "Initializing %s cache\n",
151 map->cache_ops->name);
bd061c78
LPC
152 ret = map->cache_ops->init(map);
153 if (ret)
154 goto err_free;
9fabe24e
DP
155 }
156 return 0;
bd061c78
LPC
157
158err_free:
159 kfree(map->reg_defaults);
160 if (map->cache_free)
161 kfree(map->reg_defaults_raw);
162
163 return ret;
9fabe24e
DP
164}
165
166void regcache_exit(struct regmap *map)
167{
168 if (map->cache_type == REGCACHE_NONE)
169 return;
170
171 BUG_ON(!map->cache_ops);
172
173 kfree(map->reg_defaults);
174 if (map->cache_free)
175 kfree(map->reg_defaults_raw);
176
177 if (map->cache_ops->exit) {
178 dev_dbg(map->dev, "Destroying %s cache\n",
179 map->cache_ops->name);
180 map->cache_ops->exit(map);
181 }
182}
183
184/**
185 * regcache_read: Fetch the value of a given register from the cache.
186 *
187 * @map: map to configure.
188 * @reg: The register index.
189 * @value: The value to be returned.
190 *
191 * Return a negative value on failure, 0 on success.
192 */
193int regcache_read(struct regmap *map,
194 unsigned int reg, unsigned int *value)
195{
bc7ee556
MB
196 int ret;
197
9fabe24e
DP
198 if (map->cache_type == REGCACHE_NONE)
199 return -ENOSYS;
200
201 BUG_ON(!map->cache_ops);
202
bc7ee556
MB
203 if (!regmap_volatile(map, reg)) {
204 ret = map->cache_ops->read(map, reg, value);
205
206 if (ret == 0)
207 trace_regmap_reg_read_cache(map->dev, reg, *value);
208
209 return ret;
210 }
9fabe24e
DP
211
212 return -EINVAL;
213}
214EXPORT_SYMBOL_GPL(regcache_read);
215
216/**
217 * regcache_write: Set the value of a given register in the cache.
218 *
219 * @map: map to configure.
220 * @reg: The register index.
221 * @value: The new register value.
222 *
223 * Return a negative value on failure, 0 on success.
224 */
225int regcache_write(struct regmap *map,
226 unsigned int reg, unsigned int value)
227{
228 if (map->cache_type == REGCACHE_NONE)
229 return 0;
230
231 BUG_ON(!map->cache_ops);
232
233 if (!regmap_writeable(map, reg))
234 return -EIO;
235
236 if (!regmap_volatile(map, reg))
237 return map->cache_ops->write(map, reg, value);
238
239 return 0;
240}
241EXPORT_SYMBOL_GPL(regcache_write);
242
243/**
244 * regcache_sync: Sync the register cache with the hardware.
245 *
246 * @map: map to configure.
247 *
248 * Any registers that should not be synced should be marked as
249 * volatile. In general drivers can choose not to use the provided
250 * syncing functionality if they so require.
251 *
252 * Return a negative value on failure, 0 on success.
253 */
254int regcache_sync(struct regmap *map)
255{
954757d7 256 int ret = 0;
954757d7 257 unsigned int i;
59360089 258 const char *name;
beb1a10f 259 unsigned int bypass;
59360089 260
c3ec2328 261 BUG_ON(!map->cache_ops || !map->cache_ops->sync);
9fabe24e 262
13753a90 263 mutex_lock(&map->lock);
beb1a10f
DP
264 /* Remember the initial bypass state */
265 bypass = map->cache_bypass;
954757d7
DP
266 dev_dbg(map->dev, "Syncing %s cache\n",
267 map->cache_ops->name);
268 name = map->cache_ops->name;
269 trace_regcache_sync(map->dev, name, "start");
22f0d90a 270
d9db7627
MB
271 if (!map->cache_dirty)
272 goto out;
273
22f0d90a 274 /* Apply any patch first */
8a892d69 275 map->cache_bypass = 1;
22f0d90a
MB
276 for (i = 0; i < map->patch_regs; i++) {
277 ret = _regmap_write(map, map->patch[i].reg, map->patch[i].def);
278 if (ret != 0) {
279 dev_err(map->dev, "Failed to write %x = %x: %d\n",
280 map->patch[i].reg, map->patch[i].def, ret);
281 goto out;
282 }
283 }
8a892d69 284 map->cache_bypass = 0;
22f0d90a 285
c3ec2328 286 ret = map->cache_ops->sync(map);
954757d7 287
954757d7
DP
288out:
289 trace_regcache_sync(map->dev, name, "stop");
beb1a10f
DP
290 /* Restore the bypass state */
291 map->cache_bypass = bypass;
13753a90 292 mutex_unlock(&map->lock);
954757d7
DP
293
294 return ret;
9fabe24e
DP
295}
296EXPORT_SYMBOL_GPL(regcache_sync);
297
92afb286
MB
298/**
299 * regcache_cache_only: Put a register map into cache only mode
300 *
301 * @map: map to configure
302 * @cache_only: flag if changes should be written to the hardware
303 *
304 * When a register map is marked as cache only writes to the register
305 * map API will only update the register cache, they will not cause
306 * any hardware changes. This is useful for allowing portions of
307 * drivers to act as though the device were functioning as normal when
308 * it is disabled for power saving reasons.
309 */
310void regcache_cache_only(struct regmap *map, bool enable)
311{
2cd148f1 312 mutex_lock(&map->lock);
ac77a765 313 WARN_ON(map->cache_bypass && enable);
92afb286 314 map->cache_only = enable;
2cd148f1 315 mutex_unlock(&map->lock);
92afb286
MB
316}
317EXPORT_SYMBOL_GPL(regcache_cache_only);
318
8ae0d7e8
MB
319/**
320 * regcache_mark_dirty: Mark the register cache as dirty
321 *
322 * @map: map to mark
323 *
324 * Mark the register cache as dirty, for example due to the device
325 * having been powered down for suspend. If the cache is not marked
326 * as dirty then the cache sync will be suppressed.
327 */
328void regcache_mark_dirty(struct regmap *map)
329{
330 mutex_lock(&map->lock);
331 map->cache_dirty = true;
332 mutex_unlock(&map->lock);
333}
334EXPORT_SYMBOL_GPL(regcache_mark_dirty);
335
6eb0f5e0
DP
336/**
337 * regcache_cache_bypass: Put a register map into cache bypass mode
338 *
339 * @map: map to configure
0eef6b04 340 * @cache_bypass: flag if changes should not be written to the hardware
6eb0f5e0
DP
341 *
342 * When a register map is marked with the cache bypass option, writes
343 * to the register map API will only update the hardware and not the
344 * the cache directly. This is useful when syncing the cache back to
345 * the hardware.
346 */
347void regcache_cache_bypass(struct regmap *map, bool enable)
348{
349 mutex_lock(&map->lock);
ac77a765 350 WARN_ON(map->cache_only && enable);
6eb0f5e0
DP
351 map->cache_bypass = enable;
352 mutex_unlock(&map->lock);
353}
354EXPORT_SYMBOL_GPL(regcache_cache_bypass);
355
9fabe24e
DP
356bool regcache_set_val(void *base, unsigned int idx,
357 unsigned int val, unsigned int word_size)
358{
359 switch (word_size) {
360 case 1: {
361 u8 *cache = base;
362 if (cache[idx] == val)
363 return true;
364 cache[idx] = val;
365 break;
366 }
367 case 2: {
368 u16 *cache = base;
369 if (cache[idx] == val)
370 return true;
371 cache[idx] = val;
372 break;
373 }
374 default:
375 BUG();
376 }
377 /* unreachable */
378 return false;
379}
380
381unsigned int regcache_get_val(const void *base, unsigned int idx,
382 unsigned int word_size)
383{
384 if (!base)
385 return -EINVAL;
386
387 switch (word_size) {
388 case 1: {
389 const u8 *cache = base;
390 return cache[idx];
391 }
392 case 2: {
393 const u16 *cache = base;
394 return cache[idx];
395 }
396 default:
397 BUG();
398 }
399 /* unreachable */
400 return -1;
401}
402
f094fea6 403static int regcache_default_cmp(const void *a, const void *b)
c08604b8
DP
404{
405 const struct reg_default *_a = a;
406 const struct reg_default *_b = b;
407
408 return _a->reg - _b->reg;
409}
410
f094fea6
MB
411int regcache_lookup_reg(struct regmap *map, unsigned int reg)
412{
413 struct reg_default key;
414 struct reg_default *r;
415
416 key.reg = reg;
417 key.def = 0;
418
419 r = bsearch(&key, map->reg_defaults, map->num_reg_defaults,
420 sizeof(struct reg_default), regcache_default_cmp);
421
422 if (r)
423 return r - map->reg_defaults;
424 else
6e6ace00 425 return -ENOENT;
f094fea6 426}
This page took 0.060339 seconds and 5 git commands to generate.