1 | /* SPDX-License-Identifier: GPL-2.0 */ |
2 | /* |
3 | * Register map access API internal header |
4 | * |
5 | * Copyright 2011 Wolfson Microelectronics plc |
6 | * |
7 | * Author: Mark Brown <broonie@opensource.wolfsonmicro.com> |
8 | */ |
9 | |
10 | #ifndef _REGMAP_INTERNAL_H |
11 | #define _REGMAP_INTERNAL_H |
12 | |
13 | #include <linux/device.h> |
14 | #include <linux/regmap.h> |
15 | #include <linux/fs.h> |
16 | #include <linux/list.h> |
17 | #include <linux/wait.h> |
18 | |
19 | struct regmap; |
20 | struct regcache_ops; |
21 | |
22 | struct regmap_debugfs_off_cache { |
23 | struct list_head list; |
24 | off_t min; |
25 | off_t max; |
26 | unsigned int base_reg; |
27 | unsigned int max_reg; |
28 | }; |
29 | |
30 | struct regmap_format { |
31 | size_t buf_size; |
32 | size_t reg_bytes; |
33 | size_t pad_bytes; |
34 | size_t val_bytes; |
35 | s8 reg_shift; |
36 | void (*format_write)(struct regmap *map, |
37 | unsigned int reg, unsigned int val); |
38 | void (*format_reg)(void *buf, unsigned int reg, unsigned int shift); |
39 | void (*format_val)(void *buf, unsigned int val, unsigned int shift); |
40 | unsigned int (*parse_val)(const void *buf); |
41 | void (*parse_inplace)(void *buf); |
42 | }; |
43 | |
44 | struct regmap_async { |
45 | struct list_head list; |
46 | struct regmap *map; |
47 | void *work_buf; |
48 | }; |
49 | |
50 | struct regmap { |
51 | union { |
52 | struct mutex mutex; |
53 | struct { |
54 | spinlock_t spinlock; |
55 | unsigned long spinlock_flags; |
56 | }; |
57 | struct { |
58 | raw_spinlock_t raw_spinlock; |
59 | unsigned long raw_spinlock_flags; |
60 | }; |
61 | }; |
62 | regmap_lock lock; |
63 | regmap_unlock unlock; |
64 | void *lock_arg; /* This is passed to lock/unlock functions */ |
65 | gfp_t alloc_flags; |
66 | unsigned int reg_base; |
67 | |
68 | struct device *dev; /* Device we do I/O on */ |
69 | void *work_buf; /* Scratch buffer used to format I/O */ |
70 | struct regmap_format format; /* Buffer format */ |
71 | const struct regmap_bus *bus; |
72 | void *bus_context; |
73 | const char *name; |
74 | |
75 | bool async; |
76 | spinlock_t async_lock; |
77 | wait_queue_head_t async_waitq; |
78 | struct list_head async_list; |
79 | struct list_head async_free; |
80 | int async_ret; |
81 | |
82 | #ifdef CONFIG_DEBUG_FS |
83 | bool debugfs_disable; |
84 | struct dentry *debugfs; |
85 | const char *debugfs_name; |
86 | |
87 | unsigned int debugfs_reg_len; |
88 | unsigned int debugfs_val_len; |
89 | unsigned int debugfs_tot_len; |
90 | |
91 | struct list_head debugfs_off_cache; |
92 | struct mutex cache_lock; |
93 | #endif |
94 | |
95 | unsigned int max_register; |
96 | bool (*writeable_reg)(struct device *dev, unsigned int reg); |
97 | bool (*readable_reg)(struct device *dev, unsigned int reg); |
98 | bool (*volatile_reg)(struct device *dev, unsigned int reg); |
99 | bool (*precious_reg)(struct device *dev, unsigned int reg); |
100 | bool (*writeable_noinc_reg)(struct device *dev, unsigned int reg); |
101 | bool (*readable_noinc_reg)(struct device *dev, unsigned int reg); |
102 | const struct regmap_access_table *wr_table; |
103 | const struct regmap_access_table *rd_table; |
104 | const struct regmap_access_table *volatile_table; |
105 | const struct regmap_access_table *precious_table; |
106 | const struct regmap_access_table *wr_noinc_table; |
107 | const struct regmap_access_table *rd_noinc_table; |
108 | |
109 | int (*reg_read)(void *context, unsigned int reg, unsigned int *val); |
110 | int (*reg_write)(void *context, unsigned int reg, unsigned int val); |
111 | int (*reg_update_bits)(void *context, unsigned int reg, |
112 | unsigned int mask, unsigned int val); |
113 | /* Bulk read/write */ |
114 | int (*read)(void *context, const void *reg_buf, size_t reg_size, |
115 | void *val_buf, size_t val_size); |
116 | int (*write)(void *context, const void *data, size_t count); |
117 | |
118 | bool defer_caching; |
119 | |
120 | unsigned long read_flag_mask; |
121 | unsigned long write_flag_mask; |
122 | |
123 | /* number of bits to (left) shift the reg value when formatting*/ |
124 | int reg_shift; |
125 | int reg_stride; |
126 | int reg_stride_order; |
127 | |
128 | /* If set, will always write field to HW. */ |
129 | bool force_write_field; |
130 | |
131 | /* regcache specific members */ |
132 | const struct regcache_ops *cache_ops; |
133 | enum regcache_type cache_type; |
134 | |
135 | /* number of bytes in reg_defaults_raw */ |
136 | unsigned int cache_size_raw; |
137 | /* number of bytes per word in reg_defaults_raw */ |
138 | unsigned int cache_word_size; |
139 | /* number of entries in reg_defaults */ |
140 | unsigned int num_reg_defaults; |
141 | /* number of entries in reg_defaults_raw */ |
142 | unsigned int num_reg_defaults_raw; |
143 | |
144 | /* if set, only the cache is modified not the HW */ |
145 | bool cache_only; |
146 | /* if set, only the HW is modified not the cache */ |
147 | bool cache_bypass; |
148 | /* if set, remember to free reg_defaults_raw */ |
149 | bool cache_free; |
150 | |
151 | struct reg_default *reg_defaults; |
152 | const void *reg_defaults_raw; |
153 | void *cache; |
154 | /* if set, the cache contains newer data than the HW */ |
155 | bool cache_dirty; |
156 | /* if set, the HW registers are known to match map->reg_defaults */ |
157 | bool no_sync_defaults; |
158 | |
159 | struct reg_sequence *patch; |
160 | int patch_regs; |
161 | |
162 | /* if set, converts bulk read to single read */ |
163 | bool use_single_read; |
164 | /* if set, converts bulk write to single write */ |
165 | bool use_single_write; |
166 | /* if set, the device supports multi write mode */ |
167 | bool can_multi_write; |
168 | |
169 | /* if set, raw reads/writes are limited to this size */ |
170 | size_t max_raw_read; |
171 | size_t max_raw_write; |
172 | |
173 | struct rb_root range_tree; |
174 | void *selector_work_buf; /* Scratch buffer used for selector */ |
175 | |
176 | struct hwspinlock *hwlock; |
177 | |
178 | /* if set, the regmap core can sleep */ |
179 | bool can_sleep; |
180 | }; |
181 | |
182 | struct regcache_ops { |
183 | const char *name; |
184 | enum regcache_type type; |
185 | int (*init)(struct regmap *map); |
186 | int (*exit)(struct regmap *map); |
187 | #ifdef CONFIG_DEBUG_FS |
188 | void (*debugfs_init)(struct regmap *map); |
189 | #endif |
190 | int (*read)(struct regmap *map, unsigned int reg, unsigned int *value); |
191 | int (*write)(struct regmap *map, unsigned int reg, unsigned int value); |
192 | int (*sync)(struct regmap *map, unsigned int min, unsigned int max); |
193 | int (*drop)(struct regmap *map, unsigned int min, unsigned int max); |
194 | }; |
195 | |
196 | bool regmap_cached(struct regmap *map, unsigned int reg); |
197 | bool regmap_writeable(struct regmap *map, unsigned int reg); |
198 | bool regmap_readable(struct regmap *map, unsigned int reg); |
199 | bool regmap_volatile(struct regmap *map, unsigned int reg); |
200 | bool regmap_precious(struct regmap *map, unsigned int reg); |
201 | bool regmap_writeable_noinc(struct regmap *map, unsigned int reg); |
202 | bool regmap_readable_noinc(struct regmap *map, unsigned int reg); |
203 | |
204 | int _regmap_write(struct regmap *map, unsigned int reg, |
205 | unsigned int val); |
206 | |
207 | struct regmap_range_node { |
208 | struct rb_node node; |
209 | const char *name; |
210 | struct regmap *map; |
211 | |
212 | unsigned int range_min; |
213 | unsigned int range_max; |
214 | |
215 | unsigned int selector_reg; |
216 | unsigned int selector_mask; |
217 | int selector_shift; |
218 | |
219 | unsigned int window_start; |
220 | unsigned int window_len; |
221 | }; |
222 | |
223 | struct regmap_field { |
224 | struct regmap *regmap; |
225 | unsigned int mask; |
226 | /* lsb */ |
227 | unsigned int shift; |
228 | unsigned int reg; |
229 | |
230 | unsigned int id_size; |
231 | unsigned int id_offset; |
232 | }; |
233 | |
234 | #ifdef CONFIG_DEBUG_FS |
235 | extern void regmap_debugfs_initcall(void); |
236 | extern void regmap_debugfs_init(struct regmap *map); |
237 | extern void regmap_debugfs_exit(struct regmap *map); |
238 | |
239 | static inline void regmap_debugfs_disable(struct regmap *map) |
240 | { |
241 | map->debugfs_disable = true; |
242 | } |
243 | |
244 | #else |
245 | static inline void regmap_debugfs_initcall(void) { } |
246 | static inline void regmap_debugfs_init(struct regmap *map) { } |
247 | static inline void regmap_debugfs_exit(struct regmap *map) { } |
248 | static inline void regmap_debugfs_disable(struct regmap *map) { } |
249 | #endif |
250 | |
251 | /* regcache core declarations */ |
252 | int regcache_init(struct regmap *map, const struct regmap_config *config); |
253 | void regcache_exit(struct regmap *map); |
254 | int regcache_read(struct regmap *map, |
255 | unsigned int reg, unsigned int *value); |
256 | int regcache_write(struct regmap *map, |
257 | unsigned int reg, unsigned int value); |
258 | int regcache_sync(struct regmap *map); |
259 | int regcache_sync_block(struct regmap *map, void *block, |
260 | unsigned long *cache_present, |
261 | unsigned int block_base, unsigned int start, |
262 | unsigned int end); |
263 | bool regcache_reg_needs_sync(struct regmap *map, unsigned int reg, |
264 | unsigned int val); |
265 | |
266 | static inline const void *regcache_get_val_addr(struct regmap *map, |
267 | const void *base, |
268 | unsigned int idx) |
269 | { |
270 | return base + (map->cache_word_size * idx); |
271 | } |
272 | |
273 | unsigned int regcache_get_val(struct regmap *map, const void *base, |
274 | unsigned int idx); |
275 | void regcache_set_val(struct regmap *map, void *base, unsigned int idx, |
276 | unsigned int val); |
277 | int regcache_lookup_reg(struct regmap *map, unsigned int reg); |
278 | int regcache_sync_val(struct regmap *map, unsigned int reg, unsigned int val); |
279 | |
280 | int _regmap_raw_write(struct regmap *map, unsigned int reg, |
281 | const void *val, size_t val_len, bool noinc); |
282 | |
283 | void regmap_async_complete_cb(struct regmap_async *async, int ret); |
284 | |
285 | enum regmap_endian regmap_get_val_endian(struct device *dev, |
286 | const struct regmap_bus *bus, |
287 | const struct regmap_config *config); |
288 | |
289 | extern struct regcache_ops regcache_rbtree_ops; |
290 | extern struct regcache_ops regcache_maple_ops; |
291 | extern struct regcache_ops regcache_flat_ops; |
292 | |
293 | static inline const char *regmap_name(const struct regmap *map) |
294 | { |
295 | if (map->dev) |
296 | return dev_name(dev: map->dev); |
297 | |
298 | return map->name; |
299 | } |
300 | |
301 | static inline unsigned int regmap_get_offset(const struct regmap *map, |
302 | unsigned int index) |
303 | { |
304 | if (map->reg_stride_order >= 0) |
305 | return index << map->reg_stride_order; |
306 | else |
307 | return index * map->reg_stride; |
308 | } |
309 | |
310 | static inline unsigned int regcache_get_index_by_order(const struct regmap *map, |
311 | unsigned int reg) |
312 | { |
313 | return reg >> map->reg_stride_order; |
314 | } |
315 | |
316 | struct regmap_ram_data { |
317 | unsigned int *vals; /* Allocatd by caller */ |
318 | bool *read; |
319 | bool *written; |
320 | enum regmap_endian reg_endian; |
321 | }; |
322 | |
323 | /* |
324 | * Create a test register map with data stored in RAM, not intended |
325 | * for practical use. |
326 | */ |
327 | struct regmap *__regmap_init_ram(const struct regmap_config *config, |
328 | struct regmap_ram_data *data, |
329 | struct lock_class_key *lock_key, |
330 | const char *lock_name); |
331 | |
332 | #define regmap_init_ram(config, data) \ |
333 | __regmap_lockdep_wrapper(__regmap_init_ram, #config, config, data) |
334 | |
335 | struct regmap *__regmap_init_raw_ram(const struct regmap_config *config, |
336 | struct regmap_ram_data *data, |
337 | struct lock_class_key *lock_key, |
338 | const char *lock_name); |
339 | |
340 | #define regmap_init_raw_ram(config, data) \ |
341 | __regmap_lockdep_wrapper(__regmap_init_raw_ram, #config, config, data) |
342 | |
343 | #endif |
344 | |