1 /* SPDX-License-Identifier: GPL-2.0-only */
3  * consumer.h -- SoC Regulator consumer support.
12  * Features:-
19  *   Dynamic Regulator operating Mode Switching (DRMS) - allows regulators
23  *   e.g. Devices x,y,z share regulator r. Device x and y draw 20mA each during
24  *   IO and 1mA at idle. Device z draws 100mA when under load and 5mA when
38 struct device;
112  * struct pre_voltage_change_data - Data sent with PRE_VOLTAGE_CHANGE event
127  * struct regulator_bulk_data - Data used for bulk regulator operations.
153 struct regulator *__must_check regulator_get(struct device *dev,
154 					     const char *id);
155 struct regulator *__must_check devm_regulator_get(struct device *dev,
156 					     const char *id);
157 struct regulator *__must_check regulator_get_exclusive(struct device *dev,
158 						       const char *id);
159 struct regulator *__must_check devm_regulator_get_exclusive(struct device *dev,
160 							const char *id);
161 struct regulator *__must_check regulator_get_optional(struct device *dev,
162 						      const char *id);
163 struct regulator *__must_check devm_regulator_get_optional(struct device *dev,
164 							   const char *id);
165 int devm_regulator_get_enable(struct device *dev, const char *id);
166 int devm_regulator_get_enable_optional(struct device *dev, const char *id);
167 int devm_regulator_get_enable_read_voltage(struct device *dev, const char *id);
171 int regulator_register_supply_alias(struct device *dev, const char *id,
172 				    struct device *alias_dev,
174 void regulator_unregister_supply_alias(struct device *dev, const char *id);
176 int regulator_bulk_register_supply_alias(struct device *dev,
177 					 const char *const *id,
178 					 struct device *alias_dev,
181 void regulator_bulk_unregister_supply_alias(struct device *dev,
182 					    const char * const *id, int num_id);
184 int devm_regulator_register_supply_alias(struct device *dev, const char *id,
185 					 struct device *alias_dev,
188 int devm_regulator_bulk_register_supply_alias(struct device *dev,
189 					      const char *const *id,
190 					      struct device *alias_dev,
201 int __must_check regulator_bulk_get(struct device *dev, int num_consumers,
203 int __must_check devm_regulator_bulk_get(struct device *dev, int num_consumers,
206 int __must_check devm_regulator_bulk_get_exclusive(struct device *dev, int num_consumers,
209 	struct device *dev, int num_consumers,
214 int devm_regulator_bulk_get_enable(struct device *dev, int num_consumers,
215 				   const char * const *id);
276 /* driver data - core doesn't touch */
294 static inline struct regulator *__must_check regulator_get(struct device *dev,  in regulator_get()
295 	const char *id)  in regulator_get()  argument
309 devm_regulator_get(struct device *dev, const char *id)  in devm_regulator_get()  argument
315 regulator_get_exclusive(struct device *dev, const char *id)  in regulator_get_exclusive()  argument
317 	return ERR_PTR(-ENODEV);  in regulator_get_exclusive()
321 devm_regulator_get_exclusive(struct device *dev, const char *id)  in devm_regulator_get_exclusive()  argument
323 	return ERR_PTR(-ENODEV);  in devm_regulator_get_exclusive()
326 static inline int devm_regulator_get_enable(struct device *dev, const char *id)  in devm_regulator_get_enable()  argument
331 static inline int devm_regulator_get_enable_optional(struct device *dev,  in devm_regulator_get_enable_optional()
332 						     const char *id)  in devm_regulator_get_enable_optional()  argument
337 static inline int devm_regulator_get_enable_read_voltage(struct device *dev,  in devm_regulator_get_enable_read_voltage()
338 							 const char *id)  in devm_regulator_get_enable_read_voltage()  argument
340 	return -ENODEV;  in devm_regulator_get_enable_read_voltage()
344 regulator_get_optional(struct device *dev, const char *id)  in regulator_get_optional()  argument
346 	return ERR_PTR(-ENODEV);  in regulator_get_optional()
351 devm_regulator_get_optional(struct device *dev, const char *id)  in devm_regulator_get_optional()  argument
353 	return ERR_PTR(-ENODEV);  in devm_regulator_get_optional()
368 static inline int regulator_register_supply_alias(struct device *dev,  in regulator_register_supply_alias()
369 						  const char *id,  in regulator_register_supply_alias()  argument
370 						  struct device *alias_dev,  in regulator_register_supply_alias()
376 static inline void regulator_unregister_supply_alias(struct device *dev,  in regulator_unregister_supply_alias()
377 						    const char *id)  in regulator_unregister_supply_alias()  argument
381 static inline int regulator_bulk_register_supply_alias(struct device *dev,  in regulator_bulk_register_supply_alias()
382 						const char *const *id,  in regulator_bulk_register_supply_alias()  argument
383 						struct device *alias_dev,  in regulator_bulk_register_supply_alias()
390 static inline void regulator_bulk_unregister_supply_alias(struct device *dev,  in regulator_bulk_unregister_supply_alias()
391 						const char * const *id,  in regulator_bulk_unregister_supply_alias()  argument
396 static inline int devm_regulator_register_supply_alias(struct device *dev,  in devm_regulator_register_supply_alias()
397 						       const char *id,  in devm_regulator_register_supply_alias()  argument
398 						       struct device *alias_dev,  in devm_regulator_register_supply_alias()
404 static inline int devm_regulator_bulk_register_supply_alias(struct device *dev,  in devm_regulator_bulk_register_supply_alias()
405 						const char *const *id,  in devm_regulator_bulk_register_supply_alias()  argument
406 						struct device *alias_dev,  in devm_regulator_bulk_register_supply_alias()
439 static inline int regulator_bulk_get(struct device *dev,  in regulator_bulk_get()
446 static inline int devm_regulator_bulk_get(struct device *dev, int num_consumers,  in devm_regulator_bulk_get()
453 	struct device *dev, int num_consumers,  in devm_regulator_bulk_get_const()
466 static inline int devm_regulator_bulk_get_enable(struct device *dev,  in devm_regulator_bulk_get_enable()
468 						 const char * const *id)  in devm_regulator_bulk_get_enable()  argument
504 	return -EINVAL;  in regulator_get_voltage()
509 	return -EINVAL;  in regulator_sync_voltage()
542 	return -EOPNOTSUPP;  in regulator_request_power_budget()
564 	return -EINVAL;  in regulator_get_error_flags()
580 	return ERR_PTR(-EOPNOTSUPP);  in regulator_get_regmap()
587 	return -EOPNOTSUPP;  in regulator_get_hardware_vsel_register()
593 	return -EOPNOTSUPP;  in regulator_list_hardware_vsel()
599 	return -EOPNOTSUPP;  in regulator_hardware_enable()
629 	return -EINVAL;  in regulator_suspend_enable()
635 	return -EINVAL;  in regulator_suspend_disable()
642 	return -EINVAL;  in regulator_set_suspend_voltage()
662 	return -EINVAL;  in regulator_list_voltage()
680 struct regulator *__must_check of_regulator_get_optional(struct device *dev,
682 							 const char *id);
683 struct regulator *__must_check devm_of_regulator_get_optional(struct device *dev,
685 							      const char *id);
686 int __must_check of_regulator_bulk_get_all(struct device *dev, struct device_node *np,
689 static inline struct regulator *__must_check of_regulator_get_optional(struct device *dev,  in of_regulator_get_optional()
691 								       const char *id)  in of_regulator_get_optional()  argument
693 	return ERR_PTR(-ENODEV);  in of_regulator_get_optional()
696 static inline struct regulator *__must_check devm_of_regulator_get_optional(struct device *dev,  in devm_of_regulator_get_optional()
698 									    const char *id)  in devm_of_regulator_get_optional()  argument
700 	return ERR_PTR(-ENODEV);  in devm_of_regulator_get_optional()
703 static inline int of_regulator_bulk_get_all(struct device *dev, struct device_node *np,  in of_regulator_bulk_get_all()
728 					     new_uV - tol_uV, new_uV + tol_uV);  in regulator_set_voltage_tol()
735 					      target_uV - tol_uV,  in regulator_is_supported_voltage_tol()