[mirror_ubuntu-focal-kernel.git] / include / linux / pm_domain.h

/*
 * pm_domain.h - Definitions and headers related to device power domains.
 *
 * Copyright (C) 2011 Rafael J. Wysocki <rjw@sisk.pl>, Renesas Electronics Corp.
 *
 * This file is released under the GPLv2.
 */

#ifndef _LINUX_PM_DOMAIN_H
#define _LINUX_PM_DOMAIN_H

#include <linux/device.h>

enum gpd_status {
	GPD_STATE_ACTIVE = 0,	/* PM domain is active */
	GPD_STATE_BUSY,		/* Something is happening to the PM domain */
	GPD_STATE_REPEAT,	/* Power off in progress, to be repeated */
	GPD_STATE_POWER_OFF,	/* PM domain is off */
};

struct dev_power_governor {
	bool (*power_down_ok)(struct dev_pm_domain *domain);
};

struct generic_pm_domain {
	struct dev_pm_domain domain;	/* PM domain operations */
	struct list_head gpd_list_node;	/* Node in the global PM domains list */
	struct list_head sd_node;	/* Node in the parent's subdomain list */
	struct generic_pm_domain *parent;	/* Parent PM domain */
	struct list_head sd_list;	/* List of dubdomains */
	struct list_head dev_list;	/* List of devices */
	struct mutex lock;
	struct dev_power_governor *gov;
	struct work_struct power_off_work;
	unsigned int in_progress;	/* Number of devices being suspended now */
	unsigned int sd_count;	/* Number of subdomains with power "on" */
	enum gpd_status status;	/* Current state of the domain */
	wait_queue_head_t status_wait_queue;
	struct task_struct *poweroff_task;	/* Powering off task */
	unsigned int resume_count;	/* Number of devices being resumed */
	unsigned int device_count;	/* Number of devices */
	unsigned int suspended_count;	/* System suspend device counter */
	unsigned int prepared_count;	/* Suspend counter of prepared devices */
	bool suspend_power_off;	/* Power status before system suspend */
	int (*power_off)(struct generic_pm_domain *domain);
	int (*power_on)(struct generic_pm_domain *domain);
	int (*start_device)(struct device *dev);
	int (*stop_device)(struct device *dev);
	bool (*active_wakeup)(struct device *dev);
};

static inline struct generic_pm_domain *pd_to_genpd(struct dev_pm_domain *pd)
{
	return container_of(pd, struct generic_pm_domain, domain);
}

struct dev_list_entry {
	struct list_head node;
	struct device *dev;
	bool need_restore;
};

#ifdef CONFIG_PM_GENERIC_DOMAINS
extern int pm_genpd_add_device(struct generic_pm_domain *genpd,
			       struct device *dev);
extern int pm_genpd_remove_device(struct generic_pm_domain *genpd,
				  struct device *dev);
extern int pm_genpd_add_subdomain(struct generic_pm_domain *genpd,
				  struct generic_pm_domain *new_subdomain);
extern int pm_genpd_remove_subdomain(struct generic_pm_domain *genpd,
				     struct generic_pm_domain *target);
extern void pm_genpd_init(struct generic_pm_domain *genpd,
			  struct dev_power_governor *gov, bool is_off);
extern int pm_genpd_poweron(struct generic_pm_domain *genpd);
extern void pm_genpd_poweroff_unused(void);
#else
static inline int pm_genpd_add_device(struct generic_pm_domain *genpd,
				      struct device *dev)
{
	return -ENOSYS;
}
static inline int pm_genpd_remove_device(struct generic_pm_domain *genpd,
					 struct device *dev)
{
	return -ENOSYS;
}
static inline int pm_genpd_add_subdomain(struct generic_pm_domain *genpd,
					 struct generic_pm_domain *new_sd)
{
	return -ENOSYS;
}
static inline int pm_genpd_remove_subdomain(struct generic_pm_domain *genpd,
					    struct generic_pm_domain *target)
{
	return -ENOSYS;
}
static inline void pm_genpd_init(struct generic_pm_domain *genpd,
				 struct dev_power_governor *gov, bool is_off) {}
static inline int pm_genpd_poweron(struct generic_pm_domain *genpd)
{
	return -ENOSYS;
}
static inline void pm_genpd_poweroff_unused(void) {}
#endif

#endif /* _LINUX_PM_DOMAIN_H */
Commit	Line	Data
f721889f RW	1	/*
	2	* pm_domain.h - Definitions and headers related to device power domains.
	3	*
	4	* Copyright (C) 2011 Rafael J. Wysocki <rjw@sisk.pl>, 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
17b75eca RW	14	enum gpd_status {
	15	GPD_STATE_ACTIVE = 0, /* PM domain is active */
	16	GPD_STATE_BUSY, /* Something is happening to the PM domain */
c6d22b37	17	GPD_STATE_REPEAT, /* Power off in progress, to be repeated */
17b75eca RW	18	GPD_STATE_POWER_OFF, /* PM domain is off */
17b75eca RW	19	};
596ba34b	20
f721889f RW	21	struct dev_power_governor {
	22	bool (power_down_ok)(struct dev_pm_domain domain);
	23	};
	24
	25	struct generic_pm_domain {
	26	struct dev_pm_domain domain; /* PM domain operations */
5125bbf3	27	struct list_head gpd_list_node; /* Node in the global PM domains list */
f721889f RW	28	struct list_head sd_node; /* Node in the parent's subdomain list */
	29	struct generic_pm_domain parent; / Parent PM domain */
	30	struct list_head sd_list; /* List of dubdomains */
	31	struct list_head dev_list; /* List of devices */
	32	struct mutex lock;
	33	struct dev_power_governor *gov;
	34	struct work_struct power_off_work;
	35	unsigned int in_progress; /* Number of devices being suspended now */
	36	unsigned int sd_count; /* Number of subdomains with power "on" */
17b75eca RW	37	enum gpd_status status; /* Current state of the domain */
17b75eca RW	38	wait_queue_head_t status_wait_queue;
c6d22b37 RW	39	struct task_struct poweroff_task; / Powering off task */
c6d22b37 RW	40	unsigned int resume_count; /* Number of devices being resumed */
596ba34b RW	41	unsigned int device_count; /* Number of devices */
	42	unsigned int suspended_count; /* System suspend device counter */
	43	unsigned int prepared_count; /* Suspend counter of prepared devices */
	44	bool suspend_power_off; /* Power status before system suspend */
f721889f RW	45	int (power_off)(struct generic_pm_domain domain);
	46	int (power_on)(struct generic_pm_domain domain);
	47	int (start_device)(struct device dev);
	48	int (stop_device)(struct device dev);
d4f2d87a	49	bool (active_wakeup)(struct device dev);
f721889f RW	50	};
f721889f RW	51
596ba34b RW	52	static inline struct generic_pm_domain pd_to_genpd(struct dev_pm_domain pd)
	53	{
	54	return container_of(pd, struct generic_pm_domain, domain);
	55	}
	56
f721889f RW	57	struct dev_list_entry {
	58	struct list_head node;
	59	struct device *dev;
	60	bool need_restore;
	61	};
	62
	63	#ifdef CONFIG_PM_GENERIC_DOMAINS
	64	extern int pm_genpd_add_device(struct generic_pm_domain *genpd,
	65	struct device *dev);
	66	extern int pm_genpd_remove_device(struct generic_pm_domain *genpd,
	67	struct device *dev);
	68	extern int pm_genpd_add_subdomain(struct generic_pm_domain *genpd,
	69	struct generic_pm_domain *new_subdomain);
	70	extern int pm_genpd_remove_subdomain(struct generic_pm_domain *genpd,
	71	struct generic_pm_domain *target);
	72	extern void pm_genpd_init(struct generic_pm_domain *genpd,
	73	struct dev_power_governor *gov, bool is_off);
18b4f3f5	74	extern int pm_genpd_poweron(struct generic_pm_domain *genpd);
5125bbf3	75	extern void pm_genpd_poweroff_unused(void);
f721889f RW	76	#else
	77	static inline int pm_genpd_add_device(struct generic_pm_domain *genpd,
	78	struct device *dev)
	79	{
	80	return -ENOSYS;
	81	}
	82	static inline int pm_genpd_remove_device(struct generic_pm_domain *genpd,
	83	struct device *dev)
	84	{
	85	return -ENOSYS;
	86	}
	87	static inline int pm_genpd_add_subdomain(struct generic_pm_domain *genpd,
	88	struct generic_pm_domain *new_sd)
	89	{
	90	return -ENOSYS;
	91	}
	92	static inline int pm_genpd_remove_subdomain(struct generic_pm_domain *genpd,
	93	struct generic_pm_domain *target)
	94	{
	95	return -ENOSYS;
	96	}
	97	static inline void pm_genpd_init(struct generic_pm_domain *genpd,
	98	struct dev_power_governor *gov, bool is_off) {}
18b4f3f5 MD	99	static inline int pm_genpd_poweron(struct generic_pm_domain *genpd)
	100	{
	101	return -ENOSYS;
	102	}
5125bbf3	103	static inline void pm_genpd_poweroff_unused(void) {}
f721889f RW	104	#endif
	105
	106	#endif /* _LINUX_PM_DOMAIN_H */