mirror of
https://github.com/torvalds/linux.git
synced 2026-04-22 00:33:58 -04:00
a50d877715
Correct and add kernel-doc comments to eliminate all warnings: Warning: ../drivers/gpu/drm/msm/disp/mdp_format.h:27 This comment starts with '/**', but isn't a kernel-doc comment. Warning: ../drivers/gpu/drm/msm/disp/mdp_format.h:64 struct member 'bpc_a' not described in 'msm_format' Warning: ../drivers/gpu/drm/msm/disp/mdp_format.h:64 struct member 'bpc_b_cb' not described in 'msm_format' Warning: ../drivers/gpu/drm/msm/disp/mdp_format.h:64 struct member 'bpc_g_y' not described in 'msm_format' Warning: ../drivers/gpu/drm/msm/disp/mdp_format.h:64 struct member 'bpc_r_cr' not described in 'msm_format' Signed-off-by: Randy Dunlap <rdunlap@infradead.org> Reviewed-by: Dmitry Baryshkov <dmitry.baryshkov@oss.qualcomm.com> Patchwork: https://patchwork.freedesktop.org/patch/695650/ Link: https://lore.kernel.org/r/20251219184638.1813181-2-rdunlap@infradead.org Signed-off-by: Dmitry Baryshkov <dmitry.baryshkov@oss.qualcomm.com>
82 lines
2.4 KiB
C
82 lines
2.4 KiB
C
/* SPDX-License-Identifier: GPL-2.0-only */
|
|
/*
|
|
* Copyright (c) 2016-2018, The Linux Foundation. All rights reserved.
|
|
* Copyright (C) 2013 Red Hat
|
|
* Author: Rob Clark <robdclark@gmail.com>
|
|
*/
|
|
|
|
#ifndef __MSM_FORMAT_H__
|
|
#define __MSM_FORMAT_H__
|
|
|
|
#include "mdp_common.xml.h"
|
|
|
|
enum msm_format_flags {
|
|
MSM_FORMAT_FLAG_YUV_BIT,
|
|
MSM_FORMAT_FLAG_DX_BIT,
|
|
MSM_FORMAT_FLAG_COMPRESSED_BIT,
|
|
MSM_FORMAT_FLAG_UNPACK_TIGHT_BIT,
|
|
MSM_FORMAT_FLAG_UNPACK_ALIGN_MSB_BIT,
|
|
};
|
|
|
|
#define MSM_FORMAT_FLAG_YUV BIT(MSM_FORMAT_FLAG_YUV_BIT)
|
|
#define MSM_FORMAT_FLAG_DX BIT(MSM_FORMAT_FLAG_DX_BIT)
|
|
#define MSM_FORMAT_FLAG_COMPRESSED BIT(MSM_FORMAT_FLAG_COMPRESSED_BIT)
|
|
#define MSM_FORMAT_FLAG_UNPACK_TIGHT BIT(MSM_FORMAT_FLAG_UNPACK_TIGHT_BIT)
|
|
#define MSM_FORMAT_FLAG_UNPACK_ALIGN_MSB BIT(MSM_FORMAT_FLAG_UNPACK_ALIGN_MSB_BIT)
|
|
|
|
/*
|
|
* DPU HW,Component order color map
|
|
*/
|
|
enum {
|
|
C0_G_Y = 0,
|
|
C1_B_Cb = 1,
|
|
C2_R_Cr = 2,
|
|
C3_ALPHA = 3
|
|
};
|
|
|
|
/**
|
|
* struct msm_format: defines the format configuration
|
|
* @pixel_format: format fourcc
|
|
* @bpc_g_y: element bit widths: BPC for G or Y
|
|
* @bpc_b_cb: element bit widths: BPC for B or Cb
|
|
* @bpc_r_cr: element bit widths: BPC for R or Cr
|
|
* @bpc_a: element bit widths: BPC for the alpha channel
|
|
* @element: element color ordering
|
|
* @fetch_type: how the color components are packed in pixel format
|
|
* @chroma_sample: chroma sub-samplng type
|
|
* @alpha_enable: whether the format has an alpha channel
|
|
* @unpack_count: number of the components to unpack
|
|
* @bpp: bytes per pixel
|
|
* @flags: usage bit flags
|
|
* @num_planes: number of planes (including meta data planes)
|
|
* @fetch_mode: linear, tiled, or ubwc hw fetch behavior
|
|
* @tile_height: format tile height
|
|
*/
|
|
struct msm_format {
|
|
uint32_t pixel_format;
|
|
enum mdp_bpc bpc_g_y, bpc_b_cb, bpc_r_cr;
|
|
enum mdp_bpc_alpha bpc_a;
|
|
u8 element[4];
|
|
enum mdp_fetch_type fetch_type;
|
|
enum mdp_chroma_samp_type chroma_sample;
|
|
bool alpha_enable;
|
|
u8 unpack_count;
|
|
u8 bpp;
|
|
unsigned long flags;
|
|
u8 num_planes;
|
|
enum mdp_fetch_mode fetch_mode;
|
|
u16 tile_height;
|
|
};
|
|
|
|
#define MSM_FORMAT_IS_YUV(X) ((X)->flags & MSM_FORMAT_FLAG_YUV)
|
|
#define MSM_FORMAT_IS_DX(X) ((X)->flags & MSM_FORMAT_FLAG_DX)
|
|
#define MSM_FORMAT_IS_LINEAR(X) ((X)->fetch_mode == MDP_FETCH_LINEAR)
|
|
#define MSM_FORMAT_IS_TILE(X) \
|
|
(((X)->fetch_mode == MDP_FETCH_UBWC) && \
|
|
!((X)->flags & MSM_FORMAT_FLAG_COMPRESSED))
|
|
#define MSM_FORMAT_IS_UBWC(X) \
|
|
(((X)->fetch_mode == MDP_FETCH_UBWC) && \
|
|
((X)->flags & MSM_FORMAT_FLAG_COMPRESSED))
|
|
|
|
#endif
|