1/* SPDX-License-Identifier: MIT */
2/*
3 * Copyright © 2022 Intel Corporation
4 */
5
6#ifndef _XE_PM_H_
7#define _XE_PM_H_
8
9#include <linux/cleanup.h>
10#include <linux/pm_runtime.h>
11
12#define DEFAULT_VRAM_THRESHOLD 300 /* in MB */
13
14struct xe_device;
15
16int xe_pm_suspend(struct xe_device *xe);
17int xe_pm_resume(struct xe_device *xe);
18
19int xe_pm_init_early(struct xe_device *xe);
20int xe_pm_init(struct xe_device *xe);
21void xe_pm_fini(struct xe_device *xe);
22bool xe_pm_runtime_suspended(struct xe_device *xe);
23int xe_pm_runtime_suspend(struct xe_device *xe);
24int xe_pm_runtime_resume(struct xe_device *xe);
25void xe_pm_runtime_get(struct xe_device *xe);
26int xe_pm_runtime_get_ioctl(struct xe_device *xe);
27void xe_pm_runtime_put(struct xe_device *xe);
28bool xe_pm_runtime_get_if_active(struct xe_device *xe);
29bool xe_pm_runtime_get_if_in_use(struct xe_device *xe);
30void xe_pm_runtime_get_noresume(struct xe_device *xe);
31bool xe_pm_runtime_resume_and_get(struct xe_device *xe);
32void xe_pm_assert_unbounded_bridge(struct xe_device *xe);
33int xe_pm_set_vram_threshold(struct xe_device *xe, u32 threshold);
34void xe_pm_d3cold_allowed_toggle(struct xe_device *xe);
35bool xe_rpm_reclaim_safe(const struct xe_device *xe);
36struct task_struct *xe_pm_read_callback_task(struct xe_device *xe);
37int xe_pm_block_on_suspend(struct xe_device *xe);
38void xe_pm_might_block_on_suspend(void);
39int xe_pm_module_init(void);
40
41static inline void __xe_pm_runtime_noop(struct xe_device *xe) {}
42
43DEFINE_GUARD(xe_pm_runtime, struct xe_device *,
44 xe_pm_runtime_get(_T), xe_pm_runtime_put(_T))
45DEFINE_GUARD(xe_pm_runtime_noresume, struct xe_device *,
46 xe_pm_runtime_get_noresume(_T), xe_pm_runtime_put(_T))
47DEFINE_GUARD_COND(xe_pm_runtime, _ioctl, xe_pm_runtime_get_ioctl(_T), _RET >= 0)
48
49/*
50 * Used when a function needs to release runtime PM in all possible cases
51 * and error paths, but the wakeref was already acquired by a different
52 * function (i.e., get() has already happened so only a put() is needed).
53 */
54DEFINE_GUARD(xe_pm_runtime_release_only, struct xe_device *,
55 __xe_pm_runtime_noop(_T), xe_pm_runtime_put(_T));
56
57#endif
58

source code of linux/drivers/gpu/drm/xe/xe_pm.h