xref: /linux/drivers/regulator/internal.h (revision 06a130e42a5bfc84795464bff023bff4c16f58c5)
1 /* SPDX-License-Identifier: GPL-2.0-or-later */
2 /*
3  * internal.h  --  Voltage/Current Regulator framework internal code
4  *
5  * Copyright 2007, 2008 Wolfson Microelectronics PLC.
6  * Copyright 2008 SlimLogic Ltd.
7  *
8  * Author: Liam Girdwood <lrg@slimlogic.co.uk>
9  */
10 
11 #ifndef __REGULATOR_INTERNAL_H
12 #define __REGULATOR_INTERNAL_H
13 
14 #include <linux/suspend.h>
15 
16 #define REGULATOR_STATES_NUM	(PM_SUSPEND_MAX + 1)
17 
18 #define rdev_crit(rdev, fmt, ...)					\
19 	pr_crit("%s: " fmt, rdev_get_name(rdev), ##__VA_ARGS__)
20 #define rdev_err(rdev, fmt, ...)					\
21 	pr_err("%s: " fmt, rdev_get_name(rdev), ##__VA_ARGS__)
22 #define rdev_warn(rdev, fmt, ...)					\
23 	pr_warn("%s: " fmt, rdev_get_name(rdev), ##__VA_ARGS__)
24 #define rdev_info(rdev, fmt, ...)					\
25 	pr_info("%s: " fmt, rdev_get_name(rdev), ##__VA_ARGS__)
26 #define rdev_dbg(rdev, fmt, ...)					\
27 	pr_debug("%s: " fmt, rdev_get_name(rdev), ##__VA_ARGS__)
28 
29 struct regulator_voltage {
30 	int min_uV;
31 	int max_uV;
32 };
33 
34 /*
35  * struct regulator
36  *
37  * One for each consumer device.
38  * @voltage - a voltage array for each state of runtime, i.e.:
39  *            PM_SUSPEND_ON
40  *            PM_SUSPEND_TO_IDLE
41  *            PM_SUSPEND_STANDBY
42  *            PM_SUSPEND_MEM
43  *            PM_SUSPEND_MAX
44  */
45 struct regulator {
46 	struct device *dev;
47 	struct list_head list;
48 	unsigned int always_on:1;
49 	unsigned int bypass:1;
50 	unsigned int device_link:1;
51 	int uA_load;
52 	unsigned int enable_count;
53 	unsigned int deferred_disables;
54 	struct regulator_voltage voltage[REGULATOR_STATES_NUM];
55 	const char *supply_name;
56 	struct device_attribute dev_attr;
57 	struct regulator_dev *rdev;
58 	struct dentry *debugfs;
59 };
60 
61 extern const struct class regulator_class;
62 
63 static inline struct regulator_dev *dev_to_rdev(struct device *dev)
64 {
65 	return container_of(dev, struct regulator_dev, dev);
66 }
67 
68 #ifdef CONFIG_OF
69 struct regulator_dev *of_regulator_dev_lookup(struct device *dev,
70 					      const char *supply);
71 struct regulator_init_data *regulator_of_get_init_data(struct device *dev,
72 			         const struct regulator_desc *desc,
73 				 struct regulator_config *config,
74 				 struct device_node **node);
75 
76 struct regulator_dev *of_parse_coupled_regulator(struct regulator_dev *rdev,
77 						 int index);
78 
79 int of_get_n_coupled(struct regulator_dev *rdev);
80 
81 bool of_check_coupling_data(struct regulator_dev *rdev);
82 
83 #else
84 static inline struct regulator_dev *of_regulator_dev_lookup(struct device *dev,
85 							    const char *supply)
86 {
87 	return ERR_PTR(-ENODEV);
88 }
89 
90 static inline struct regulator_init_data *
91 regulator_of_get_init_data(struct device *dev,
92 			   const struct regulator_desc *desc,
93 			   struct regulator_config *config,
94 			   struct device_node **node)
95 {
96 	return NULL;
97 }
98 
99 static inline struct regulator_dev *
100 of_parse_coupled_regulator(struct regulator_dev *rdev,
101 			   int index)
102 {
103 	return NULL;
104 }
105 
106 static inline int of_get_n_coupled(struct regulator_dev *rdev)
107 {
108 	return 0;
109 }
110 
111 static inline bool of_check_coupling_data(struct regulator_dev *rdev)
112 {
113 	return false;
114 }
115 
116 #endif
117 enum regulator_get_type {
118 	NORMAL_GET,
119 	EXCLUSIVE_GET,
120 	OPTIONAL_GET,
121 	MAX_GET_TYPE
122 };
123 
124 int _regulator_get_common_check(struct device *dev, const char *id,
125 				enum regulator_get_type get_type);
126 struct regulator *_regulator_get_common(struct regulator_dev *rdev, struct device *dev,
127 					const char *id, enum regulator_get_type get_type);
128 struct regulator *_regulator_get(struct device *dev, const char *id,
129 				 enum regulator_get_type get_type);
130 int _regulator_bulk_get(struct device *dev, int num_consumers,
131 			struct regulator_bulk_data *consumers, enum regulator_get_type get_type);
132 #endif
133