2 * nvmem framework provider.
4 * Copyright (C) 2015 Srinivas Kandagatla <srinivas.kandagatla@linaro.org>
5 * Copyright (C) 2013 Maxime Ripard <maxime.ripard@free-electrons.com>
7 * This file is licensed under the terms of the GNU General Public
8 * License version 2. This program is licensed "as is" without any
9 * warranty of any kind, whether express or implied.
12 #ifndef _LINUX_NVMEM_PROVIDER_H
13 #define _LINUX_NVMEM_PROVIDER_H
15 #include <linux/err.h>
16 #include <linux/errno.h>
19 struct nvmem_cell_info;
20 typedef int (*nvmem_reg_read_t)(void *priv, unsigned int offset,
21 void *val, size_t bytes);
22 typedef int (*nvmem_reg_write_t)(void *priv, unsigned int offset,
23 void *val, size_t bytes);
26 * struct nvmem_config - NVMEM device configuration
28 * @dev: Parent device.
29 * @name: Optional name.
30 * @id: Optional device ID used in full name. Ignored if name is NULL.
31 * @owner: Pointer to exporter module. Used for refcounting.
32 * @cells: Optional array of pre-defined NVMEM cells.
33 * @ncells: Number of elements in cells.
34 * @read_only: Device is read-only.
35 * @root_only: Device is accessibly to root only.
36 * @reg_read: Callback to read data.
37 * @reg_write: Callback to write data.
39 * @word_size: Minimum read/write access granularity.
40 * @stride: Minimum read/write access stride.
41 * @priv: User context passed to read/write callbacks.
43 * Note: A default "nvmem<id>" name will be assigned to the device if
44 * no name is specified in its configuration. In such case "<id>" is
45 * generated with ida_simple_get() and provided id field is ignored.
47 * Note: Specifying name and setting id to -1 implies a unique device
48 * whose name is provided as-is (kept unaltered).
55 const struct nvmem_cell_info *cells;
59 nvmem_reg_read_t reg_read;
60 nvmem_reg_write_t reg_write;
65 /* To be only used by old driver/misc/eeprom drivers */
67 struct device *base_dev;
70 #if IS_ENABLED(CONFIG_NVMEM)
72 struct nvmem_device *nvmem_register(const struct nvmem_config *cfg);
73 int nvmem_unregister(struct nvmem_device *nvmem);
75 struct nvmem_device *devm_nvmem_register(struct device *dev,
76 const struct nvmem_config *cfg);
78 int devm_nvmem_unregister(struct device *dev, struct nvmem_device *nvmem);
82 static inline struct nvmem_device *nvmem_register(const struct nvmem_config *c)
84 return ERR_PTR(-ENOSYS);
87 static inline int nvmem_unregister(struct nvmem_device *nvmem)
92 static inline struct nvmem_device *
93 devm_nvmem_register(struct device *dev, const struct nvmem_config *c)
95 return nvmem_register(c);
99 devm_nvmem_unregister(struct device *dev, struct nvmem_device *nvmem)
101 return nvmem_unregister(nvmem);
104 #endif /* CONFIG_NVMEM */
105 #endif /* ifndef _LINUX_NVMEM_PROVIDER_H */