Files
linux-nvgpu/drivers/gpu/nvgpu/common/gr/gr_priv.h
Deepak Nibade cb110723a5 gpu: nvgpu: doxygen for GR private structures [2/2]
Add doxygen documentation for private GR structures defined in:
gr/gr_config_priv.h
gr/gr_falcon_priv.h
gr/gr_intr_priv.h
gr/gr_priv.h

Remove "p_va" field from struct nvgpu_ctxsw_ucode_info since it is
unused.

Compile out "pm_ctxsw_image_size" with flag CONFIG_NVGPU_DEBUGGER.
Compile out "preempt_image_size" with flag CONFIG_NVGPU_GRAPHICS.

Replace eUcodeHandshakeInitComplete enum value by macro
FALCON_UCODE_HANDSHAKE_INIT_COMPLETE. And remove enum value
eUcodeHandshakeMethodFinished since it is unused.

Compile "ctxsw_disable_mutex" and "ctxsw_disable_count" in struct
nvgpu_gr only if CONFIG_NVGPU_RECOVERY or CONFIG_NVGPU_DEBUGGER is
defined

Jira NVGPU-4028

Change-Id: Ie8769c1f3f8d313b479b182d3858a6715d49cd4c
Signed-off-by: Deepak Nibade <dnibade@nvidia.com>
Reviewed-on: https://git-master.nvidia.com/r/2201373
Reviewed-by: svc-mobile-coverity <svc-mobile-coverity@nvidia.com>
Reviewed-by: svc-mobile-misra <svc-mobile-misra@nvidia.com>
GVS: Gerrit_Virtual_Submit
Reviewed-by: Vinod Gopalakrishnakurup <vinodg@nvidia.com>
Reviewed-by: Alex Waterman <alexw@nvidia.com>
Reviewed-by: mobile promotions <svcmobile_promotions@nvidia.com>
Tested-by: mobile promotions <svcmobile_promotions@nvidia.com>
2020-12-15 14:05:52 -06:00

134 lines
3.3 KiB
C

/*
* Copyright (c) 2019, NVIDIA CORPORATION. All rights reserved.
*
* Permission is hereby granted, free of charge, to any person obtaining a
* copy of this software and associated documentation files (the "Software"),
* to deal in the Software without restriction, including without limitation
* the rights to use, copy, modify, merge, publish, distribute, sublicense,
* and/or sell copies of the Software, and to permit persons to whom the
* Software is furnished to do so, subject to the following conditions:
*
* The above copyright notice and this permission notice shall be included in
* all copies or substantial portions of the Software.
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
* THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
* FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
* DEALINGS IN THE SOFTWARE.
*/
#ifndef NVGPU_GR_PRIV_H
#define NVGPU_GR_PRIV_H
#include <nvgpu/types.h>
#include <nvgpu/cond.h>
struct nvgpu_gr_ctx_desc;
struct nvgpu_gr_global_ctx_buffer_desc;
struct nvgpu_gr_obj_ctx_golden_image;
struct nvgpu_gr_config;
#ifdef CONFIG_NVGPU_GRAPHICS
struct nvgpu_gr_zbc;
struct nvgpu_gr_zcull;
#endif
#ifdef CONFIG_NVGPU_DEBUGGER
struct nvgpu_gr_hwpm_map;
#endif
/**
* GR engine data structure.
*
* This is the parent structure to all other GR engine data structures,
* and holds a pointer to all of them. This structure also stores
* various fields to track GR engine initialization state.
*
* Pointer to this structure is maintained in GPU driver structure.
*/
struct nvgpu_gr {
/**
* Pointer to GPU driver struct.
*/
struct gk20a *g;
/**
* Condition variable for GR initialization.
* Waiters shall wait on this condition to ensure GR engine
* is initialized.
*/
struct nvgpu_cond init_wq;
/**
* Flag to indicate if GR engine is initialized.
*/
bool initialized;
/**
* Pointer to global context buffer descriptor structure.
*/
struct nvgpu_gr_global_ctx_buffer_desc *global_ctx_buffer;
/**
* Pointer to Golden context image structure.
*/
struct nvgpu_gr_obj_ctx_golden_image *golden_image;
/**
* Pointer to GR context descriptor structure.
*/
struct nvgpu_gr_ctx_desc *gr_ctx_desc;
/**
* Pointer to GR configuration structure.
*/
struct nvgpu_gr_config *config;
/**
* Pointer to GR falcon data structure.
*/
struct nvgpu_gr_falcon *falcon;
/**
* Pointer to GR interrupt data structure.
*/
struct nvgpu_gr_intr *intr;
/**
* Function pointer to remove GR s/w support.
*/
void (*remove_support)(struct gk20a *g);
/**
* Flag to indicate GR s/w has been initialized.
*/
bool sw_ready;
#ifdef CONFIG_NVGPU_DEBUGGER
struct nvgpu_gr_hwpm_map *hwpm_map;
#endif
#ifdef CONFIG_NVGPU_GRAPHICS
struct nvgpu_gr_zcull *zcull;
struct nvgpu_gr_zbc *zbc;
#endif
#ifdef CONFIG_NVGPU_NON_FUSA
u32 fecs_feature_override_ecc_val;
#endif
#ifdef CONFIG_NVGPU_CILP
u32 cilp_preempt_pending_chid;
#endif
#if defined(CONFIG_NVGPU_RECOVERY) || defined(CONFIG_NVGPU_DEBUGGER)
struct nvgpu_mutex ctxsw_disable_mutex;
int ctxsw_disable_count;
#endif
};
#endif /* NVGPU_GR_PRIV_H */