Use correct struct names, struct member names, and kernel-doc format to resolve most kernel-doc warnings:
Warning: include/uapi/drm/ethosu_accel.h:87 expecting prototype for struct drm_ethosu_gpu_info. Prototype was for struct drm_ethosu_npu_info instead Warning: include/uapi/drm/ethosu_accel.h:178 expecting prototype for struct drm_ethosu_wait_bo. Prototype was for struct drm_ethosu_bo_wait instead Warning: include/uapi/drm/ethosu_accel.h:214 struct member 'cmd_bo' not described in 'drm_ethosu_job' Warning: include/uapi/drm/ethosu_accel.h:214 struct member 'sram_size' not described in 'drm_ethosu_job' Warning: include/uapi/drm/ethosu_accel.h:214 struct member 'region_bo_handles' not described in 'drm_ethosu_job' Warning: include/uapi/drm/ethosu_accel.h:230 struct member 'jobs' not described in 'drm_ethosu_submit' Warning: include/uapi/drm/ethosu_accel.h:230 struct member 'job_count' not described in 'drm_ethosu_submit' Warning: include/uapi/drm/ethosu_accel.h:230 struct member 'perfmon_id' not described in 'drm_ethosu_submit' Warning: include/uapi/drm/ethosu_accel.h:274 struct member 'flags' not described in 'drm_ethosu_perfmon_set_global' Warning: include/uapi/drm/ethosu_accel.h:274 struct member 'id' not described in 'drm_ethosu_perfmon_set_global' Signed-off-by: Randy Dunlap <[email protected]> --- v2: rebase & resend v3: rebase & resend Cc: Rob Herring <[email protected]> Cc: Tomeu Vizoso <[email protected]> Cc: Maarten Lankhorst <[email protected]> Cc: Maxime Ripard <[email protected]> Cc: Thomas Zimmermann <[email protected]> Cc: David Airlie <[email protected]> Cc: Simona Vetter <[email protected]> include/uapi/drm/ethosu_accel.h | 25 +++++++++++++++---------- 1 file changed, 15 insertions(+), 10 deletions(-) --- linux-next-20260720.orig/include/uapi/drm/ethosu_accel.h +++ linux-next-20260720/include/uapi/drm/ethosu_accel.h @@ -65,7 +65,7 @@ enum drm_ethosu_dev_query_type { }; /** - * struct drm_ethosu_gpu_info - NPU information + * struct drm_ethosu_npu_info - NPU information * * Structure grouping all queryable information relating to the NPU. */ @@ -80,10 +80,12 @@ struct drm_ethosu_npu_info { #define DRM_ETHOSU_VERSION_MINOR(x) (((x) >> 4) & 0xff) #define DRM_ETHOSU_VERSION_STATUS(x) ((x) & 0xf) - /** @gpu_rev: GPU revision. */ + /** @config: NPU revision. */ __u32 config; + /** @sram_size: NPU SRAM size (KB) */ __u32 sram_size; + /** @pmu_counters: number of performance counters */ __u32 pmu_counters; }; @@ -165,7 +167,7 @@ struct drm_ethosu_bo_mmap_offset { }; /** - * struct drm_ethosu_wait_bo - ioctl argument for waiting for + * struct drm_ethosu_bo_wait - ioctl argument for waiting for * completion of the last DRM_ETHOSU_SUBMIT on a BO. * * This is useful for cases where multiple processes might be @@ -173,9 +175,12 @@ struct drm_ethosu_bo_mmap_offset { * completed. */ struct drm_ethosu_bo_wait { + /** @handle: BO handle */ __u32 handle; + /** @pad: Reserved, must be zero. */ __u32 pad; - __s64 timeout_ns; /* absolute */ + /** @timeout_ns: Absolute timeout in ns. */ + __s64 timeout_ns; }; struct drm_ethosu_cmdstream_bo_create { @@ -203,14 +208,14 @@ struct drm_ethosu_cmdstream_bo_create { * sequentially on the same core, to benefit from memory residency in SRAM. */ struct drm_ethosu_job { - /** Input: BO handle for cmdstream. */ + /** @cmd_bo: Input: BO handle for cmdstream. */ __u32 cmd_bo; - /** Input: Amount of SRAM to use. */ + /** @sram_size: Input: Amount of SRAM to use. */ __u32 sram_size; #define ETHOSU_MAX_REGIONS 8 - /** Input: Array of BO handles for each region. */ + /** @region_bo_handles: Input: Array of BO handles for each region. */ __u32 region_bo_handles[ETHOSU_MAX_REGIONS]; }; @@ -220,13 +225,13 @@ struct drm_ethosu_job { * The kernel will schedule the execution of these jobs in dependency order. */ struct drm_ethosu_submit { - /** Input: Pointer to an array of struct drm_ethosu_job. */ + /** @jobs: Input: Pointer to an array of struct drm_ethosu_job. */ __u64 jobs; - /** Input: Number of jobs passed in. */ + /** @job_count: Input: Number of jobs passed in. */ __u32 job_count; - /** Input: Id returned by DRM_ETHOSU_PERFMON_CREATE */ + /** @perfmon_id: Input: perfmon ID */ __u32 perfmon_id; };
