运行时电源管理

Xe PM 实现了系统级挂起状态和机会运行时挂起状态的主要例程。

系统级挂起（S 状态）- 通常这是由 ACPI 驱动的操作系统发起的挂起，用于实现 S0ix（又名 S2idle、freeze）、S3（挂起到 RAM）、S4（挂起到磁盘）。这里的主要函数是 xe_pm_suspend 和 xe_pm_resume。它们是挂起和从这些状态恢复的主要入口点。

PCI 设备挂起（D 状态）- 这是机会性的 PCIe 设备低功耗状态 D3，由 PCI 子系统和 ACPI 在 runtime_pm 基础设施的帮助下控制。PCI D3 很特殊，可以表示 D3hot，其中 Vcc 电源开启以保持内存活动并实现更快的低延迟恢复，或者 D3Cold，其中 Vcc 电源关闭以实现更好的节能。PCI 层次结构的 Vcc 控制只能在 PCI 根端口级别进行控制，而设备驱动程序可能位于多个桥/交换机之后，并与其他设备配对。因此，PCI 子系统无法执行到 D3Cold 的转换。来自 PCI 子系统的最低运行时 PM 可能是 D3hot。然后，如果同一根端口中的所有这些配对设备都处于 D3hot 状态，ACPI 将在此处提供帮助并运行其自己的方法（_PR3 和 _OFF）以执行从 D3hot 到 D3cold 的转换。Xe 可能会通过在进入运行时挂起之前调用 pci_d3cold_disable(root_pdev) 来阻止此转换。这将基于运行时条件，例如 VRAM 使用情况，以便快速低延迟恢复。

运行时 PM - Linux 内核提供的此基础设施允许设备驱动程序指示何时可以运行时挂起，以便可以将设备置于 D3（如果支持）或允许更深层的软件包睡眠状态（PC 状态）和/或其他低级别电源状态。Xe PM 组件提供 xe_pm_runtime_suspend 和 xe_pm_runtime_resume 函数，PCI 子系统将在转换到/从运行时挂起之前调用这些函数。

此外，Xe PM 提供了 get 和 put 函数，Xe 驱动程序将使用它们来指示活动。为了避免与内存管理相关的锁定复杂性，只要有可能，这些 get 和 put 函数都需要从更高/更外层调用。需要从外层保护的主要情况是：IOCTL、sysfs、debugfs、dma-buf 共享、GPU 执行。

此组件不负责 GT 空闲（RC6）或 GT 频率管理（RPS）。

内部 API

bool xe_rpm_reclaim_safe(const struct xe_device *xe)

是否可以从回收上下文中完成运行时恢复

参数

const struct xe_device *xe

xe 设备。

返回

如果从回收上下文中运行时恢复是安全的，则返回 true。否则返回 false。

int xe_pm_suspend(struct xe_device *xe)

系统挂起的助手，即 S0->S3 / S0->S2idle

参数

struct xe_device *xe

xe 设备实例

返回

成功时返回 0

int xe_pm_resume(struct xe_device *xe)

系统恢复的助手 S3->S0 / S2idle->S0

参数

struct xe_device *xe

xe 设备实例

返回

成功时返回 0

int xe_pm_init(struct xe_device *xe)

初始化 Xe 电源管理

参数

struct xe_device *xe

xe 设备实例

描述

此组件负责系统和设备睡眠状态。

成功时返回 0，否则返回负错误代码。

void xe_pm_fini(struct xe_device *xe)

完成 PM

参数

struct xe_device *xe

xe 设备实例

bool xe_pm_runtime_suspended(struct xe_device *xe)

检查 runtime_pm 状态是否已挂起

参数

struct xe_device *xe

xe 设备实例

描述

这不提供任何保证设备将保持挂起状态，因为它可能与运行时状态转换竞争。它只能用作不可靠的断言，以确保我们在尝试访问某些内存时没有处于睡眠状态。

如果 PCI 设备已挂起，则返回 true，否则返回 false。

int xe_pm_runtime_suspend(struct xe_device *xe)

为 D3hot/D3Cold 准备我们的设备

参数

struct xe_device *xe

xe 设备实例

描述

成功时返回 0，否则返回负错误代码。

int xe_pm_runtime_resume(struct xe_device *xe)

从 D3hot/D3Cold 唤醒

参数

struct xe_device *xe

xe 设备实例

描述

成功时返回 0，否则返回负错误代码。

void xe_pm_runtime_get(struct xe_device *xe)

获取 runtime_pm 引用并同步恢复

参数

struct xe_device *xe

xe 设备实例

void xe_pm_runtime_put(struct xe_device *xe)

放回 runtime_pm 引用并标记为空闲

参数

struct xe_device *xe

xe 设备实例

int xe_pm_runtime_get_ioctl(struct xe_device *xe)

在 ioctl 之前获取 runtime_pm 引用

参数

struct xe_device *xe

xe 设备实例

返回

任何大于或等于 0 的数字表示成功，否则为负错误代码。

bool xe_pm_runtime_get_if_active(struct xe_device *xe)

如果设备处于活动状态，则获取 runtime_pm 引用

参数

struct xe_device *xe

xe 设备实例

返回

如果设备已唤醒（无论之前的引用数量如何）并且已获取新引用，则为 True，否则为 False。

bool xe_pm_runtime_get_if_in_use(struct xe_device *xe)

如果设备处于活动状态且已获取之前的引用，则获取新引用

参数

struct xe_device *xe

xe 设备实例

返回

如果设备已唤醒，之前已获取引用，并且现在已获取新引用，则为 True，否则为 False。

void xe_pm_runtime_get_noresume(struct xe_device *xe)

增加运行时 PM 使用计数器而不恢复

参数

struct xe_device *xe

xe 设备实例

描述

此函数应在内部位置使用，这些位置肯定已受到 xe_pm_runtime_get 的外部调用者的保护。如果未受保护，它将发出警告。无论如何，在此函数之后应放回引用，因为它总是会增加使用计数器。

bool xe_pm_runtime_resume_and_get(struct xe_device *xe)

恢复，然后如果已唤醒，则获取 runtime_pm 引用。

参数

struct xe_device *xe

xe 设备实例

返回

如果设备已唤醒并且已获取引用，则为 True，否则为 False。

void xe_pm_assert_unbounded_bridge(struct xe_device *xe)

在无界 pcie 父桥上禁用 PM

参数

struct xe_device *xe

xe 设备实例

int xe_pm_set_vram_threshold(struct xe_device *xe, u32 threshold)

设置用于允许/阻止 D3Cold 的 vram 阈值

参数

struct xe_device *xe

xe 设备实例

u32 threshold

D3cold 阈值的 VRAM 大小（以位为单位）

描述

成功时返回 0，否则返回负错误代码。

void xe_pm_d3cold_allowed_toggle(struct xe_device *xe)

检查切换 d3cold.allowed 的条件

参数

struct xe_device *xe

xe 设备实例

描述

在 runtime_pm 空闲回调期间调用。在运行时挂起之前检查所有 D3Cold 条件。

int xe_pm_module_init(void)

执行 xe_pm 特定的模块初始化。

参数

void

无参数

返回

成功时返回 0。当前不会失败。