linux/drivers/gpu/drm/xe/xe_uc.c

// SPDX-License-Identifier: MIT
/*
 * Copyright © 2022 Intel Corporation
 */

#include "xe_uc.h"

#include "xe_assert.h"
#include "xe_device.h"
#include "xe_gsc.h"
#include "xe_gsc_proxy.h"
#include "xe_gt.h"
#include "xe_gt_printk.h"
#include "xe_gt_sriov_vf.h"
#include "xe_guc.h"
#include "xe_guc_pc.h"
#include "xe_huc.h"
#include "xe_sriov.h"
#include "xe_uc_fw.h"
#include "xe_wopcm.h"

static struct xe_gt *
uc_to_gt(struct xe_uc *uc)
{ … }

static struct xe_device *
uc_to_xe(struct xe_uc *uc)
{ … }

/* Should be called once at driver load only */
int xe_uc_init(struct xe_uc *uc)
{ … }

/**
 * xe_uc_init_post_hwconfig - init Uc post hwconfig load
 * @uc: The UC object
 *
 * Return: 0 on success, negative error code on error.
 */
int xe_uc_init_post_hwconfig(struct xe_uc *uc)
{ … }

static int uc_reset(struct xe_uc *uc)
{ … }

static void xe_uc_sanitize(struct xe_uc *uc)
{ … }

int xe_uc_sanitize_reset(struct xe_uc *uc)
{ … }

/**
 * xe_uc_init_hwconfig - minimally init Uc, read and parse hwconfig
 * @uc: The UC object
 *
 * Return: 0 on success, negative error code on error.
 */
int xe_uc_init_hwconfig(struct xe_uc *uc)
{ … }

static int vf_uc_init_hw(struct xe_uc *uc)
{ … }

/*
 * Should be called during driver load, after every GT reset, and after every
 * suspend to reload / auth the firmwares.
 */
int xe_uc_init_hw(struct xe_uc *uc)
{ … }

int xe_uc_fini_hw(struct xe_uc *uc)
{ … }

int xe_uc_reset_prepare(struct xe_uc *uc)
{ … }

void xe_uc_gucrc_disable(struct xe_uc *uc)
{ … }

void xe_uc_stop_prepare(struct xe_uc *uc)
{ … }

void xe_uc_stop(struct xe_uc *uc)
{ … }

int xe_uc_start(struct xe_uc *uc)
{ … }

static void uc_reset_wait(struct xe_uc *uc)
{ … }

int xe_uc_suspend(struct xe_uc *uc)
{ … }

/**
 * xe_uc_remove() - Clean up the UC structures before driver removal
 * @uc: the UC object
 *
 * This function should only act on objects/structures that must be cleaned
 * before the driver removal callback is complete and therefore can't be
 * deferred to a drmm action.
 */
void xe_uc_remove(struct xe_uc *uc)
{ … }

/**
 * xe_uc_declare_wedged() - Declare UC wedged
 * @uc: the UC object
 *
 * Wedge the UC which stops all submission, saves desired debug state, and
 * cleans up anything which could timeout.
 */
void xe_uc_declare_wedged(struct xe_uc *uc)
{ … }