nv-tegra-mirror/linux-nvgpu
1
0
Fork 0
mirror of git://nv-tegra.nvidia.com/linux-nvgpu.git synced 2025-12-24 02:22:34 +03:00
Code Issues Packages Projects Releases Wiki Activity

gpu: nvgpu: doxygen for gr/gr_utils.h

Browse Source 
Add doxygen documentation for gr/gr_utils.h header

Also move nvgpu_gr_checksum_u32() to gr_utils.c instead of declaring
it static inline in header file.

Jira NVGPU-4028

Change-Id: I383e06582b45ad50eef4b505ed8c57fb6620dff9
Signed-off-by: Deepak Nibade <dnibade@nvidia.com>
Reviewed-on: https://git-master.nvidia.com/r/2199508
Reviewed-by: svc-mobile-coverity <svc-mobile-coverity@nvidia.com>
Reviewed-by: svc-mobile-misra <svc-mobile-misra@nvidia.com>
Reviewed-by: Seshendra Gadagottu <sgadagottu@nvidia.com>
Reviewed-by: Alex Waterman <alexw@nvidia.com>
Reviewed-by: Vinod Gopalakrishnakurup <vinodg@nvidia.com>
GVS: Gerrit_Virtual_Submit
Reviewed-by: mobile promotions <svcmobile_promotions@nvidia.com>
Tested-by: mobile promotions <svcmobile_promotions@nvidia.com>
This commit is contained in:
Deepak Nibade
2019-09-16 18:26:27 +05:30
committed by Alex Waterman
parent 6849526d7f
commit a5f722a5ff
3 changed files with 57 additions and 6 deletions
Download Patch File Download Diff File Expand all files Collapse all files

5
drivers/gpu/nvgpu/common/gr/gr_utils.c
View File

@@ -28,6 +28,11 @@
#include "gr_priv.h"
u32 nvgpu_gr_checksum_u32(u32 a, u32 b)
{
return nvgpu_safe_cast_u64_to_u32(((u64)a + (u64)b) & (U32_MAX));
}
struct nvgpu_gr_falcon *nvgpu_gr_get_falcon_ptr(struct gk20a *g)
{
return g->gr->falcon;

1
drivers/gpu/nvgpu/include/nvgpu/gr/gr.h
View File

@@ -83,6 +83,7 @@
* + include/nvgpu/gr/obj_ctx.h
* + include/nvgpu/gr/gr_falcon.h
* + include/nvgpu/gr/gr_intr.h
* + include/nvgpu/gr/gr_utils.h
*
* Resource utilization
* --------------------

57
drivers/gpu/nvgpu/include/nvgpu/gr/gr_utils.h
View File

@@ -26,11 +26,18 @@
#include <nvgpu/types.h>
#include <nvgpu/static_analysis.h>
/**
* @file
*
* common.gr.utils unit interface
*/
struct gk20a;
struct nvgpu_gr_falcon;
struct nvgpu_gr_obj_ctx_golden_image;
struct nvgpu_gr_config;
struct nvgpu_gr_intr;
#ifdef CONFIG_NVGPU_DEBUGGER
struct nvgpu_gr_obj_ctx_golden_image;
#endif
#ifdef CONFIG_NVGPU_GRAPHICS
struct nvgpu_gr_zbc;
struct nvgpu_gr_zcull;
@@ -42,15 +49,53 @@ struct nvgpu_gr_hwpm_map;
struct nvgpu_gr_global_ctx_buffer_desc;
#endif
static inline u32 nvgpu_gr_checksum_u32(u32 a, u32 b)
{
return nvgpu_safe_cast_u64_to_u32(((u64)a + (u64)b) & (U32_MAX));
}
/**
* @brief Compute checksum.
*
* @param a[in] First unsigned integer.
* @param b[in] Second unsigned integer.
*
* This function will calculate checksum of two unsigned integers and
* return the result. This function is typically needed to calculate
* checksum of falcon ucode boot binary.
*
* @return Checksum of two unsigned integers.
*/
u32 nvgpu_gr_checksum_u32(u32 a, u32 b);
/* gr struct pointers */
/**
* @brief Get GR falcon data struct pointer.
*
* @param g[in] Pointer to GPU driver struct.
*
* This function returns pointer to #nvgpu_gr_falcon structure.
*
* @return Pointer to GR falcon data struct.
*/
struct nvgpu_gr_falcon *nvgpu_gr_get_falcon_ptr(struct gk20a *g);
/**
* @brief Get GR configuration struct pointer.
*
* @param g[in] Pointer to GPU driver struct.
*
* This function returns pointer to #nvgpu_gr_config structure.
*
* @return Pointer to GR configuration struct.
*/
struct nvgpu_gr_config *nvgpu_gr_get_config_ptr(struct gk20a *g);
/**
* @brief Get GR interrupt data struct pointer.
*
* @param g[in] Pointer to GPU driver struct.
*
* This function returns pointer to #nvgpu_gr_intr structure.
*
* @return Pointer to GR interrupt data struct.
*/
struct nvgpu_gr_intr *nvgpu_gr_get_intr_ptr(struct gk20a *g);
#ifdef CONFIG_NVGPU_NON_FUSA
/* gr variables */
u32 nvgpu_gr_get_override_ecc_val(struct gk20a *g);