Commit | Line | Data |
---|---|---|
93de9124 MB |
1 | /* |
2 | * Register map access API internal header | |
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 | ||
13 | #ifndef _REGMAP_INTERNAL_H | |
14 | #define _REGMAP_INTERNAL_H | |
15 | ||
16 | #include <linux/regmap.h> | |
31244e39 | 17 | #include <linux/fs.h> |
5166b7c0 | 18 | #include <linux/list.h> |
0d509f2b | 19 | #include <linux/wait.h> |
93de9124 MB |
20 | |
21 | struct regmap; | |
9fabe24e | 22 | struct regcache_ops; |
93de9124 | 23 | |
5166b7c0 MB |
24 | struct regmap_debugfs_off_cache { |
25 | struct list_head list; | |
26 | off_t min; | |
27 | off_t max; | |
28 | unsigned int base_reg; | |
c2c1ee66 | 29 | unsigned int max_reg; |
5166b7c0 MB |
30 | }; |
31 | ||
93de9124 MB |
32 | struct regmap_format { |
33 | size_t buf_size; | |
34 | size_t reg_bytes; | |
82159ba8 | 35 | size_t pad_bytes; |
93de9124 MB |
36 | size_t val_bytes; |
37 | void (*format_write)(struct regmap *map, | |
38 | unsigned int reg, unsigned int val); | |
d939fb9a MR |
39 | void (*format_reg)(void *buf, unsigned int reg, unsigned int shift); |
40 | void (*format_val)(void *buf, unsigned int val, unsigned int shift); | |
93de9124 MB |
41 | unsigned int (*parse_val)(void *buf); |
42 | }; | |
43 | ||
0d509f2b MB |
44 | struct regmap_async { |
45 | struct list_head list; | |
46 | struct work_struct cleanup; | |
47 | struct regmap *map; | |
48 | void *work_buf; | |
49 | }; | |
50 | ||
93de9124 | 51 | struct regmap { |
bacdbe07 SW |
52 | struct mutex mutex; |
53 | spinlock_t spinlock; | |
54 | regmap_lock lock; | |
55 | regmap_unlock unlock; | |
0d4529c5 | 56 | void *lock_arg; /* This is passed to lock/unlock functions */ |
93de9124 MB |
57 | |
58 | struct device *dev; /* Device we do I/O on */ | |
59 | void *work_buf; /* Scratch buffer used to format I/O */ | |
60 | struct regmap_format format; /* Buffer format */ | |
61 | const struct regmap_bus *bus; | |
0135bbcc | 62 | void *bus_context; |
72b39f6f | 63 | const char *name; |
93de9124 | 64 | |
0d509f2b MB |
65 | spinlock_t async_lock; |
66 | wait_queue_head_t async_waitq; | |
67 | struct list_head async_list; | |
68 | int async_ret; | |
69 | ||
31244e39 MB |
70 | #ifdef CONFIG_DEBUG_FS |
71 | struct dentry *debugfs; | |
d3c242e1 | 72 | const char *debugfs_name; |
cbc1938b MB |
73 | |
74 | unsigned int debugfs_reg_len; | |
75 | unsigned int debugfs_val_len; | |
76 | unsigned int debugfs_tot_len; | |
5166b7c0 MB |
77 | |
78 | struct list_head debugfs_off_cache; | |
31244e39 MB |
79 | #endif |
80 | ||
93de9124 MB |
81 | unsigned int max_register; |
82 | bool (*writeable_reg)(struct device *dev, unsigned int reg); | |
83 | bool (*readable_reg)(struct device *dev, unsigned int reg); | |
84 | bool (*volatile_reg)(struct device *dev, unsigned int reg); | |
2efe1642 | 85 | bool (*precious_reg)(struct device *dev, unsigned int reg); |
76aad392 DC |
86 | const struct regmap_access_table *wr_table; |
87 | const struct regmap_access_table *rd_table; | |
88 | const struct regmap_access_table *volatile_table; | |
89 | const struct regmap_access_table *precious_table; | |
6f306441 | 90 | |
ad278406 | 91 | int (*reg_read)(void *context, unsigned int reg, unsigned int *val); |
07c320dc | 92 | int (*reg_write)(void *context, unsigned int reg, unsigned int val); |
ad278406 | 93 | |
d2a5884a AS |
94 | bool defer_caching; |
95 | ||
6f306441 LPC |
96 | u8 read_flag_mask; |
97 | u8 write_flag_mask; | |
9fabe24e | 98 | |
d939fb9a MR |
99 | /* number of bits to (left) shift the reg value when formatting*/ |
100 | int reg_shift; | |
f01ee60f | 101 | int reg_stride; |
d939fb9a | 102 | |
9fabe24e DP |
103 | /* regcache specific members */ |
104 | const struct regcache_ops *cache_ops; | |
105 | enum regcache_type cache_type; | |
106 | ||
107 | /* number of bytes in reg_defaults_raw */ | |
108 | unsigned int cache_size_raw; | |
109 | /* number of bytes per word in reg_defaults_raw */ | |
110 | unsigned int cache_word_size; | |
111 | /* number of entries in reg_defaults */ | |
112 | unsigned int num_reg_defaults; | |
113 | /* number of entries in reg_defaults_raw */ | |
114 | unsigned int num_reg_defaults_raw; | |
115 | ||
116 | /* if set, only the cache is modified not the HW */ | |
847fb6fd | 117 | u32 cache_only; |
9fabe24e | 118 | /* if set, only the HW is modified not the cache */ |
847fb6fd | 119 | u32 cache_bypass; |
9fabe24e | 120 | /* if set, remember to free reg_defaults_raw */ |
847fb6fd | 121 | bool cache_free; |
9fabe24e DP |
122 | |
123 | struct reg_default *reg_defaults; | |
124 | const void *reg_defaults_raw; | |
125 | void *cache; | |
847fb6fd | 126 | u32 cache_dirty; |
22f0d90a MB |
127 | |
128 | struct reg_default *patch; | |
129 | int patch_regs; | |
2e33caf1 AJ |
130 | |
131 | /* if set, converts bulk rw to single rw */ | |
132 | bool use_single_rw; | |
6863ca62 KG |
133 | |
134 | struct rb_root range_tree; | |
135 | void *selector_work_buf; /* Scratch buffer used for selector */ | |
9fabe24e DP |
136 | }; |
137 | ||
138 | struct regcache_ops { | |
139 | const char *name; | |
140 | enum regcache_type type; | |
141 | int (*init)(struct regmap *map); | |
142 | int (*exit)(struct regmap *map); | |
143 | int (*read)(struct regmap *map, unsigned int reg, unsigned int *value); | |
144 | int (*write)(struct regmap *map, unsigned int reg, unsigned int value); | |
ac8d91c8 | 145 | int (*sync)(struct regmap *map, unsigned int min, unsigned int max); |
93de9124 MB |
146 | }; |
147 | ||
8de2f081 MB |
148 | bool regmap_writeable(struct regmap *map, unsigned int reg); |
149 | bool regmap_readable(struct regmap *map, unsigned int reg); | |
150 | bool regmap_volatile(struct regmap *map, unsigned int reg); | |
151 | bool regmap_precious(struct regmap *map, unsigned int reg); | |
152 | ||
4d2dc095 DP |
153 | int _regmap_write(struct regmap *map, unsigned int reg, |
154 | unsigned int val); | |
155 | ||
6863ca62 KG |
156 | struct regmap_range_node { |
157 | struct rb_node node; | |
d058bb49 | 158 | const char *name; |
4b020b3f | 159 | struct regmap *map; |
6863ca62 KG |
160 | |
161 | unsigned int range_min; | |
162 | unsigned int range_max; | |
163 | ||
164 | unsigned int selector_reg; | |
165 | unsigned int selector_mask; | |
166 | int selector_shift; | |
167 | ||
168 | unsigned int window_start; | |
169 | unsigned int window_len; | |
170 | }; | |
171 | ||
31244e39 MB |
172 | #ifdef CONFIG_DEBUG_FS |
173 | extern void regmap_debugfs_initcall(void); | |
d3c242e1 | 174 | extern void regmap_debugfs_init(struct regmap *map, const char *name); |
31244e39 MB |
175 | extern void regmap_debugfs_exit(struct regmap *map); |
176 | #else | |
bbcf61ca | 177 | static inline void regmap_debugfs_initcall(void) { } |
abec95ad | 178 | static inline void regmap_debugfs_init(struct regmap *map, const char *name) { } |
bbcf61ca | 179 | static inline void regmap_debugfs_exit(struct regmap *map) { } |
31244e39 MB |
180 | #endif |
181 | ||
9fabe24e | 182 | /* regcache core declarations */ |
e5e3b8ab | 183 | int regcache_init(struct regmap *map, const struct regmap_config *config); |
9fabe24e DP |
184 | void regcache_exit(struct regmap *map); |
185 | int regcache_read(struct regmap *map, | |
186 | unsigned int reg, unsigned int *value); | |
187 | int regcache_write(struct regmap *map, | |
188 | unsigned int reg, unsigned int value); | |
189 | int regcache_sync(struct regmap *map); | |
190 | ||
879082c9 MB |
191 | unsigned int regcache_get_val(struct regmap *map, const void *base, |
192 | unsigned int idx); | |
193 | bool regcache_set_val(struct regmap *map, void *base, unsigned int idx, | |
194 | unsigned int val); | |
9fabe24e | 195 | int regcache_lookup_reg(struct regmap *map, unsigned int reg); |
9fabe24e | 196 | |
0d509f2b MB |
197 | void regmap_async_complete_cb(struct regmap_async *async, int ret); |
198 | ||
28644c80 | 199 | extern struct regcache_ops regcache_rbtree_ops; |
2cbbb579 | 200 | extern struct regcache_ops regcache_lzo_ops; |
2ac902ce | 201 | extern struct regcache_ops regcache_flat_ops; |
2cbbb579 | 202 | |
93de9124 | 203 | #endif |