65 lines
1.8 KiB
C
65 lines
1.8 KiB
C
|
/* SPDX-License-Identifier: MIT */
|
||
|
|
/*
|
||
|
|
* Copyright © 2022 Intel Corporation
|
||
|
|
*/
|
||
|
|
|
||
|
|
#ifndef _XE_FORCE_WAKE_H_
|
||
|
|
#define _XE_FORCE_WAKE_H_
|
||
|
|
|
||
|
|
#include "xe_assert.h"
|
||
|
|
#include "xe_force_wake_types.h"
|
||
|
|
|
||
|
|
struct xe_gt;
|
||
|
|
|
||
|
|
void xe_force_wake_init_gt(struct xe_gt *gt,
|
||
|
|
struct xe_force_wake *fw);
|
||
|
|
void xe_force_wake_init_engines(struct xe_gt *gt,
|
||
|
|
struct xe_force_wake *fw);
|
||
|
|
unsigned int __must_check xe_force_wake_get(struct xe_force_wake *fw,
|
||
|
|
enum xe_force_wake_domains domains);
|
||
|
|
void xe_force_wake_put(struct xe_force_wake *fw, unsigned int fw_ref);
|
||
|
|
|
||
|
|
static inline int
|
||
|
|
xe_force_wake_ref(struct xe_force_wake *fw,
|
||
|
|
enum xe_force_wake_domains domain)
|
||
|
|
{
|
||
|
|
xe_gt_assert(fw->gt, domain != XE_FORCEWAKE_ALL);
|
||
|
|
return fw->domains[ffs(domain) - 1].ref;
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* xe_force_wake_assert_held - asserts domain is awake
|
||
|
|
* @fw : xe_force_wake structure
|
||
|
|
* @domain: xe_force_wake_domains apart from XE_FORCEWAKE_ALL
|
||
|
|
*
|
||
|
|
* xe_force_wake_assert_held() is designed to confirm a particular
|
||
|
|
* forcewake domain's wakefulness; it doesn't verify the wakefulness of
|
||
|
|
* multiple domains. Make sure the caller doesn't input multiple
|
||
|
|
* domains(XE_FORCEWAKE_ALL) as a parameter.
|
||
|
|
*/
|
||
|
|
static inline void
|
||
|
|
xe_force_wake_assert_held(struct xe_force_wake *fw,
|
||
|
|
enum xe_force_wake_domains domain)
|
||
|
|
{
|
||
|
|
xe_gt_assert(fw->gt, domain != XE_FORCEWAKE_ALL);
|
||
|
|
xe_gt_assert(fw->gt, fw->awake_domains & domain);
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* xe_force_wake_ref_has_domain - verifies if the domains are in fw_ref
|
||
|
|
* @fw_ref : the force_wake reference
|
||
|
|
* @domain : forcewake domain to verify
|
||
|
|
*
|
||
|
|
* This function confirms whether the @fw_ref includes a reference to the
|
||
|
|
* specified @domain.
|
||
|
|
*
|
||
|
|
* Return: true if domain is refcounted.
|
||
|
|
*/
|
||
|
|
static inline bool
|
||
|
|
xe_force_wake_ref_has_domain(unsigned int fw_ref, enum xe_force_wake_domains domain)
|
||
|
|
{
|
||
|
|
return fw_ref & domain;
|
||
|
|
}
|
||
|
|
|
||
|
|
#endif
|