1 /* 2 * pm_domain.h - Definitions and headers related to device power domains. 3 * 4 * Copyright (C) 2011 Rafael J. Wysocki <[email protected]>, Renesas Electronics Corp. 5 * 6 * This file is released under the GPLv2. 7 */ 8 9 #ifndef _LINUX_PM_DOMAIN_H 10 #define _LINUX_PM_DOMAIN_H 11 12 #include <linux/device.h> 13 #include <linux/mutex.h> 14 #include <linux/pm.h> 15 #include <linux/err.h> 16 #include <linux/of.h> 17 #include <linux/notifier.h> 18 #include <linux/spinlock.h> 19 20 /* Defines used for the flags field in the struct generic_pm_domain */ 21 #define GENPD_FLAG_PM_CLK (1U << 0) /* PM domain uses PM clk */ 22 #define GENPD_FLAG_IRQ_SAFE (1U << 1) /* PM domain operates in atomic */ 23 #define GENPD_FLAG_ALWAYS_ON (1U << 2) /* PM domain is always powered on */ 24 25 enum gpd_status { 26 GPD_STATE_ACTIVE = 0, /* PM domain is active */ 27 GPD_STATE_POWER_OFF, /* PM domain is off */ 28 }; 29 30 struct dev_power_governor { 31 bool (*power_down_ok)(struct dev_pm_domain *domain); 32 bool (*suspend_ok)(struct device *dev); 33 }; 34 35 struct gpd_dev_ops { 36 int (*start)(struct device *dev); 37 int (*stop)(struct device *dev); 38 bool (*active_wakeup)(struct device *dev); 39 }; 40 41 struct genpd_power_state { 42 s64 power_off_latency_ns; 43 s64 power_on_latency_ns; 44 s64 residency_ns; 45 struct fwnode_handle *fwnode; 46 }; 47 48 struct genpd_lock_ops; 49 50 struct generic_pm_domain { 51 struct dev_pm_domain domain; /* PM domain operations */ 52 struct list_head gpd_list_node; /* Node in the global PM domains list */ 53 struct list_head master_links; /* Links with PM domain as a master */ 54 struct list_head slave_links; /* Links with PM domain as a slave */ 55 struct list_head dev_list; /* List of devices */ 56 struct dev_power_governor *gov; 57 struct work_struct power_off_work; 58 struct fwnode_handle *provider; /* Identity of the domain provider */ 59 bool has_provider; 60 const char *name; 61 atomic_t sd_count; /* Number of subdomains with power "on" */ 62 enum gpd_status status; /* Current state of the domain */ 63 unsigned int device_count; /* Number of devices */ 64 unsigned int suspended_count; /* System suspend device counter */ 65 unsigned int prepared_count; /* Suspend counter of prepared devices */ 66 int (*power_off)(struct generic_pm_domain *domain); 67 int (*power_on)(struct generic_pm_domain *domain); 68 struct gpd_dev_ops dev_ops; 69 s64 max_off_time_ns; /* Maximum allowed "suspended" time. */ 70 bool max_off_time_changed; 71 bool cached_power_down_ok; 72 int (*attach_dev)(struct generic_pm_domain *domain, 73 struct device *dev); 74 void (*detach_dev)(struct generic_pm_domain *domain, 75 struct device *dev); 76 unsigned int flags; /* Bit field of configs for genpd */ 77 struct genpd_power_state *states; 78 unsigned int state_count; /* number of states */ 79 unsigned int state_idx; /* state that genpd will go to when off */ 80 void *free; /* Free the state that was allocated for default */ 81 const struct genpd_lock_ops *lock_ops; 82 union { 83 struct mutex mlock; 84 struct { 85 spinlock_t slock; 86 unsigned long lock_flags; 87 }; 88 }; 89 90 }; 91 92 static inline struct generic_pm_domain *pd_to_genpd(struct dev_pm_domain *pd) 93 { 94 return container_of(pd, struct generic_pm_domain, domain); 95 } 96 97 struct gpd_link { 98 struct generic_pm_domain *master; 99 struct list_head master_node; 100 struct generic_pm_domain *slave; 101 struct list_head slave_node; 102 }; 103 104 struct gpd_timing_data { 105 s64 suspend_latency_ns; 106 s64 resume_latency_ns; 107 s64 effective_constraint_ns; 108 bool constraint_changed; 109 bool cached_suspend_ok; 110 }; 111 112 struct pm_domain_data { 113 struct list_head list_node; 114 struct device *dev; 115 }; 116 117 struct generic_pm_domain_data { 118 struct pm_domain_data base; 119 struct gpd_timing_data td; 120 struct notifier_block nb; 121 }; 122 123 #ifdef CONFIG_PM_GENERIC_DOMAINS 124 static inline struct generic_pm_domain_data *to_gpd_data(struct pm_domain_data *pdd) 125 { 126 return container_of(pdd, struct generic_pm_domain_data, base); 127 } 128 129 static inline struct generic_pm_domain_data *dev_gpd_data(struct device *dev) 130 { 131 return to_gpd_data(dev->power.subsys_data->domain_data); 132 } 133 134 extern int __pm_genpd_add_device(struct generic_pm_domain *genpd, 135 struct device *dev, 136 struct gpd_timing_data *td); 137 138 extern int pm_genpd_remove_device(struct generic_pm_domain *genpd, 139 struct device *dev); 140 extern int pm_genpd_add_subdomain(struct generic_pm_domain *genpd, 141 struct generic_pm_domain *new_subdomain); 142 extern int pm_genpd_remove_subdomain(struct generic_pm_domain *genpd, 143 struct generic_pm_domain *target); 144 extern int pm_genpd_init(struct generic_pm_domain *genpd, 145 struct dev_power_governor *gov, bool is_off); 146 extern int pm_genpd_remove(struct generic_pm_domain *genpd); 147 148 extern struct dev_power_governor simple_qos_governor; 149 extern struct dev_power_governor pm_domain_always_on_gov; 150 #else 151 152 static inline struct generic_pm_domain_data *dev_gpd_data(struct device *dev) 153 { 154 return ERR_PTR(-ENOSYS); 155 } 156 static inline int __pm_genpd_add_device(struct generic_pm_domain *genpd, 157 struct device *dev, 158 struct gpd_timing_data *td) 159 { 160 return -ENOSYS; 161 } 162 static inline int pm_genpd_remove_device(struct generic_pm_domain *genpd, 163 struct device *dev) 164 { 165 return -ENOSYS; 166 } 167 static inline int pm_genpd_add_subdomain(struct generic_pm_domain *genpd, 168 struct generic_pm_domain *new_sd) 169 { 170 return -ENOSYS; 171 } 172 static inline int pm_genpd_remove_subdomain(struct generic_pm_domain *genpd, 173 struct generic_pm_domain *target) 174 { 175 return -ENOSYS; 176 } 177 static inline int pm_genpd_init(struct generic_pm_domain *genpd, 178 struct dev_power_governor *gov, bool is_off) 179 { 180 return -ENOSYS; 181 } 182 static inline int pm_genpd_remove(struct generic_pm_domain *genpd) 183 { 184 return -ENOTSUPP; 185 } 186 187 #define simple_qos_governor (*(struct dev_power_governor *)(NULL)) 188 #define pm_domain_always_on_gov (*(struct dev_power_governor *)(NULL)) 189 #endif 190 191 static inline int pm_genpd_add_device(struct generic_pm_domain *genpd, 192 struct device *dev) 193 { 194 return __pm_genpd_add_device(genpd, dev, NULL); 195 } 196 197 #ifdef CONFIG_PM_GENERIC_DOMAINS_SLEEP 198 extern void pm_genpd_syscore_poweroff(struct device *dev); 199 extern void pm_genpd_syscore_poweron(struct device *dev); 200 #else 201 static inline void pm_genpd_syscore_poweroff(struct device *dev) {} 202 static inline void pm_genpd_syscore_poweron(struct device *dev) {} 203 #endif 204 205 /* OF PM domain providers */ 206 struct of_device_id; 207 208 struct genpd_onecell_data { 209 struct generic_pm_domain **domains; 210 unsigned int num_domains; 211 }; 212 213 #ifdef CONFIG_PM_GENERIC_DOMAINS_OF 214 int of_genpd_add_provider_simple(struct device_node *np, 215 struct generic_pm_domain *genpd); 216 int of_genpd_add_provider_onecell(struct device_node *np, 217 struct genpd_onecell_data *data); 218 void of_genpd_del_provider(struct device_node *np); 219 extern int of_genpd_add_device(struct of_phandle_args *args, 220 struct device *dev); 221 extern int of_genpd_add_subdomain(struct of_phandle_args *parent, 222 struct of_phandle_args *new_subdomain); 223 extern struct generic_pm_domain *of_genpd_remove_last(struct device_node *np); 224 extern int of_genpd_parse_idle_states(struct device_node *dn, 225 struct genpd_power_state **states, int *n); 226 227 int genpd_dev_pm_attach(struct device *dev); 228 #else /* !CONFIG_PM_GENERIC_DOMAINS_OF */ 229 static inline int of_genpd_add_provider_simple(struct device_node *np, 230 struct generic_pm_domain *genpd) 231 { 232 return -ENOTSUPP; 233 } 234 235 static inline int of_genpd_add_provider_onecell(struct device_node *np, 236 struct genpd_onecell_data *data) 237 { 238 return -ENOTSUPP; 239 } 240 241 static inline void of_genpd_del_provider(struct device_node *np) {} 242 243 static inline int of_genpd_add_device(struct of_phandle_args *args, 244 struct device *dev) 245 { 246 return -ENODEV; 247 } 248 249 static inline int of_genpd_add_subdomain(struct of_phandle_args *parent, 250 struct of_phandle_args *new_subdomain) 251 { 252 return -ENODEV; 253 } 254 255 static inline int of_genpd_parse_idle_states(struct device_node *dn, 256 struct genpd_power_state **states, int *n) 257 { 258 return -ENODEV; 259 } 260 261 static inline int genpd_dev_pm_attach(struct device *dev) 262 { 263 return -ENODEV; 264 } 265 266 static inline 267 struct generic_pm_domain *of_genpd_remove_last(struct device_node *np) 268 { 269 return ERR_PTR(-ENOTSUPP); 270 } 271 #endif /* CONFIG_PM_GENERIC_DOMAINS_OF */ 272 273 #ifdef CONFIG_PM 274 extern int dev_pm_domain_attach(struct device *dev, bool power_on); 275 extern void dev_pm_domain_detach(struct device *dev, bool power_off); 276 extern void dev_pm_domain_set(struct device *dev, struct dev_pm_domain *pd); 277 #else 278 static inline int dev_pm_domain_attach(struct device *dev, bool power_on) 279 { 280 return -ENODEV; 281 } 282 static inline void dev_pm_domain_detach(struct device *dev, bool power_off) {} 283 static inline void dev_pm_domain_set(struct device *dev, 284 struct dev_pm_domain *pd) {} 285 #endif 286 287 #endif /* _LINUX_PM_DOMAIN_H */ 288