/* 
 | 
 * Copyright 2016 Advanced Micro Devices, Inc. 
 | 
 * 
 | 
 * 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 COPYRIGHT HOLDER(S) OR AUTHOR(S) 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. 
 | 
 * 
 | 
 * Authors: AMD 
 | 
 * 
 | 
 */ 
 | 
  
 | 
#ifndef DC_HW_TYPES_H 
 | 
#define DC_HW_TYPES_H 
 | 
  
 | 
#include "os_types.h" 
 | 
#include "fixed31_32.h" 
 | 
#include "signal_types.h" 
 | 
  
 | 
/****************************************************************************** 
 | 
 * Data types for Virtual HW Layer of DAL3. 
 | 
 * (see DAL3 design documents for HW Layer definition) 
 | 
 * 
 | 
 * The intended uses are: 
 | 
 * 1. Generation pseudocode sequences for HW programming. 
 | 
 * 2. Implementation of real HW programming by HW Sequencer of DAL3. 
 | 
 * 
 | 
 * Note: do *not* add any types which are *not* used for HW programming - this 
 | 
 * will ensure separation of Logic layer from HW layer. 
 | 
 ******************************************************************************/ 
 | 
  
 | 
union large_integer { 
 | 
    struct { 
 | 
        uint32_t low_part; 
 | 
        int32_t high_part; 
 | 
    }; 
 | 
  
 | 
    struct { 
 | 
        uint32_t low_part; 
 | 
        int32_t high_part; 
 | 
    } u; 
 | 
  
 | 
    int64_t quad_part; 
 | 
}; 
 | 
  
 | 
#define PHYSICAL_ADDRESS_LOC union large_integer 
 | 
  
 | 
enum dc_plane_addr_type { 
 | 
    PLN_ADDR_TYPE_GRAPHICS = 0, 
 | 
    PLN_ADDR_TYPE_GRPH_STEREO, 
 | 
    PLN_ADDR_TYPE_VIDEO_PROGRESSIVE, 
 | 
}; 
 | 
  
 | 
struct dc_plane_address { 
 | 
    enum dc_plane_addr_type type; 
 | 
    bool tmz_surface; 
 | 
    union { 
 | 
        struct{ 
 | 
            PHYSICAL_ADDRESS_LOC addr; 
 | 
            PHYSICAL_ADDRESS_LOC meta_addr; 
 | 
            union large_integer dcc_const_color; 
 | 
        } grph; 
 | 
  
 | 
        /*stereo*/ 
 | 
        struct { 
 | 
            PHYSICAL_ADDRESS_LOC left_addr; 
 | 
            PHYSICAL_ADDRESS_LOC left_meta_addr; 
 | 
            union large_integer left_dcc_const_color; 
 | 
  
 | 
            PHYSICAL_ADDRESS_LOC right_addr; 
 | 
            PHYSICAL_ADDRESS_LOC right_meta_addr; 
 | 
            union large_integer right_dcc_const_color; 
 | 
  
 | 
        } grph_stereo; 
 | 
  
 | 
        /*video  progressive*/ 
 | 
        struct { 
 | 
            PHYSICAL_ADDRESS_LOC luma_addr; 
 | 
            PHYSICAL_ADDRESS_LOC luma_meta_addr; 
 | 
            union large_integer luma_dcc_const_color; 
 | 
  
 | 
            PHYSICAL_ADDRESS_LOC chroma_addr; 
 | 
            PHYSICAL_ADDRESS_LOC chroma_meta_addr; 
 | 
            union large_integer chroma_dcc_const_color; 
 | 
        } video_progressive; 
 | 
    }; 
 | 
}; 
 | 
  
 | 
struct dc_size { 
 | 
    int width; 
 | 
    int height; 
 | 
}; 
 | 
  
 | 
struct rect { 
 | 
    int x; 
 | 
    int y; 
 | 
    int width; 
 | 
    int height; 
 | 
}; 
 | 
  
 | 
union plane_size { 
 | 
    /* Grph or Video will be selected 
 | 
     * based on format above: 
 | 
     * Use Video structure if 
 | 
     * format >= DalPixelFormat_VideoBegin 
 | 
     * else use Grph structure 
 | 
     */ 
 | 
    struct { 
 | 
        struct rect surface_size; 
 | 
        /* Graphic surface pitch in pixels. 
 | 
         * In LINEAR_GENERAL mode, pitch 
 | 
         * is 32 pixel aligned. 
 | 
         */ 
 | 
        int surface_pitch; 
 | 
    } grph; 
 | 
  
 | 
    struct { 
 | 
        struct rect luma_size; 
 | 
        /* Graphic surface pitch in pixels. 
 | 
         * In LINEAR_GENERAL mode, pitch is 
 | 
         * 32 pixel aligned. 
 | 
         */ 
 | 
        int luma_pitch; 
 | 
  
 | 
        struct rect chroma_size; 
 | 
        /* Graphic surface pitch in pixels. 
 | 
         * In LINEAR_GENERAL mode, pitch is 
 | 
         * 32 pixel aligned. 
 | 
         */ 
 | 
        int chroma_pitch; 
 | 
    } video; 
 | 
}; 
 | 
  
 | 
struct dc_plane_dcc_param { 
 | 
    bool enable; 
 | 
  
 | 
    union { 
 | 
        struct { 
 | 
            int meta_pitch; 
 | 
            bool independent_64b_blks; 
 | 
        } grph; 
 | 
  
 | 
        struct { 
 | 
            int meta_pitch_l; 
 | 
            bool independent_64b_blks_l; 
 | 
  
 | 
            int meta_pitch_c; 
 | 
            bool independent_64b_blks_c; 
 | 
        } video; 
 | 
    }; 
 | 
}; 
 | 
  
 | 
/*Displayable pixel format in fb*/ 
 | 
enum surface_pixel_format { 
 | 
    SURFACE_PIXEL_FORMAT_GRPH_BEGIN = 0, 
 | 
    /*TOBE REMOVED paletta 256 colors*/ 
 | 
    SURFACE_PIXEL_FORMAT_GRPH_PALETA_256_COLORS = 
 | 
        SURFACE_PIXEL_FORMAT_GRPH_BEGIN, 
 | 
    /*16 bpp*/ 
 | 
    SURFACE_PIXEL_FORMAT_GRPH_ARGB1555, 
 | 
    /*16 bpp*/ 
 | 
    SURFACE_PIXEL_FORMAT_GRPH_RGB565, 
 | 
    /*32 bpp*/ 
 | 
    SURFACE_PIXEL_FORMAT_GRPH_ARGB8888, 
 | 
    /*32 bpp swaped*/ 
 | 
    SURFACE_PIXEL_FORMAT_GRPH_ABGR8888, 
 | 
  
 | 
    SURFACE_PIXEL_FORMAT_GRPH_ARGB2101010, 
 | 
    /*swaped*/ 
 | 
    SURFACE_PIXEL_FORMAT_GRPH_ABGR2101010, 
 | 
    /*TOBE REMOVED swaped, XR_BIAS has no differance 
 | 
     * for pixel layout than previous and we can 
 | 
     * delete this after discusion*/ 
 | 
    SURFACE_PIXEL_FORMAT_GRPH_ABGR2101010_XR_BIAS, 
 | 
    /*64 bpp */ 
 | 
    SURFACE_PIXEL_FORMAT_GRPH_ARGB16161616, 
 | 
    /*float*/ 
 | 
    SURFACE_PIXEL_FORMAT_GRPH_ARGB16161616F, 
 | 
    /*swaped & float*/ 
 | 
    SURFACE_PIXEL_FORMAT_GRPH_ABGR16161616F, 
 | 
    /*grow graphics here if necessary */ 
 | 
    SURFACE_PIXEL_FORMAT_VIDEO_AYCrCb8888, 
 | 
    SURFACE_PIXEL_FORMAT_VIDEO_BEGIN, 
 | 
    SURFACE_PIXEL_FORMAT_VIDEO_420_YCbCr = 
 | 
        SURFACE_PIXEL_FORMAT_VIDEO_BEGIN, 
 | 
    SURFACE_PIXEL_FORMAT_VIDEO_420_YCrCb, 
 | 
    SURFACE_PIXEL_FORMAT_VIDEO_420_10bpc_YCbCr, 
 | 
    SURFACE_PIXEL_FORMAT_VIDEO_420_10bpc_YCrCb, 
 | 
        SURFACE_PIXEL_FORMAT_SUBSAMPLE_END, 
 | 
    SURFACE_PIXEL_FORMAT_INVALID 
 | 
  
 | 
    /*grow 444 video here if necessary */ 
 | 
}; 
 | 
  
 | 
  
 | 
  
 | 
/* Pixel format */ 
 | 
enum pixel_format { 
 | 
    /*graph*/ 
 | 
    PIXEL_FORMAT_UNINITIALIZED, 
 | 
    PIXEL_FORMAT_INDEX8, 
 | 
    PIXEL_FORMAT_RGB565, 
 | 
    PIXEL_FORMAT_ARGB8888, 
 | 
    PIXEL_FORMAT_ARGB2101010, 
 | 
    PIXEL_FORMAT_ARGB2101010_XRBIAS, 
 | 
    PIXEL_FORMAT_FP16, 
 | 
    /*video*/ 
 | 
    PIXEL_FORMAT_420BPP8, 
 | 
    PIXEL_FORMAT_420BPP10, 
 | 
    /*end of pixel format definition*/ 
 | 
    PIXEL_FORMAT_INVALID, 
 | 
  
 | 
    PIXEL_FORMAT_GRPH_BEGIN = PIXEL_FORMAT_INDEX8, 
 | 
    PIXEL_FORMAT_GRPH_END = PIXEL_FORMAT_FP16, 
 | 
    PIXEL_FORMAT_VIDEO_BEGIN = PIXEL_FORMAT_420BPP8, 
 | 
    PIXEL_FORMAT_VIDEO_END = PIXEL_FORMAT_420BPP10, 
 | 
    PIXEL_FORMAT_UNKNOWN 
 | 
}; 
 | 
  
 | 
enum tile_split_values { 
 | 
    DC_DISPLAY_MICRO_TILING = 0x0, 
 | 
    DC_THIN_MICRO_TILING = 0x1, 
 | 
    DC_DEPTH_MICRO_TILING = 0x2, 
 | 
    DC_ROTATED_MICRO_TILING = 0x3, 
 | 
}; 
 | 
  
 | 
/* TODO: These values come from hardware spec. We need to readdress this 
 | 
 * if they ever change. 
 | 
 */ 
 | 
enum array_mode_values { 
 | 
    DC_ARRAY_LINEAR_GENERAL = 0, 
 | 
    DC_ARRAY_LINEAR_ALLIGNED, 
 | 
    DC_ARRAY_1D_TILED_THIN1, 
 | 
    DC_ARRAY_1D_TILED_THICK, 
 | 
    DC_ARRAY_2D_TILED_THIN1, 
 | 
    DC_ARRAY_PRT_TILED_THIN1, 
 | 
    DC_ARRAY_PRT_2D_TILED_THIN1, 
 | 
    DC_ARRAY_2D_TILED_THICK, 
 | 
    DC_ARRAY_2D_TILED_X_THICK, 
 | 
    DC_ARRAY_PRT_TILED_THICK, 
 | 
    DC_ARRAY_PRT_2D_TILED_THICK, 
 | 
    DC_ARRAY_PRT_3D_TILED_THIN1, 
 | 
    DC_ARRAY_3D_TILED_THIN1, 
 | 
    DC_ARRAY_3D_TILED_THICK, 
 | 
    DC_ARRAY_3D_TILED_X_THICK, 
 | 
    DC_ARRAY_PRT_3D_TILED_THICK, 
 | 
}; 
 | 
  
 | 
enum tile_mode_values { 
 | 
    DC_ADDR_SURF_MICRO_TILING_DISPLAY = 0x0, 
 | 
    DC_ADDR_SURF_MICRO_TILING_NON_DISPLAY = 0x1, 
 | 
}; 
 | 
  
 | 
enum swizzle_mode_values { 
 | 
    DC_SW_LINEAR = 0, 
 | 
    DC_SW_256B_S = 1, 
 | 
    DC_SW_256_D = 2, 
 | 
    DC_SW_256_R = 3, 
 | 
    DC_SW_4KB_S = 5, 
 | 
    DC_SW_4KB_D = 6, 
 | 
    DC_SW_4KB_R = 7, 
 | 
    DC_SW_64KB_S = 9, 
 | 
    DC_SW_64KB_D = 10, 
 | 
    DC_SW_64KB_R = 11, 
 | 
    DC_SW_VAR_S = 13, 
 | 
    DC_SW_VAR_D = 14, 
 | 
    DC_SW_VAR_R = 15, 
 | 
    DC_SW_64KB_S_T = 17, 
 | 
    DC_SW_64KB_D_T = 18, 
 | 
    DC_SW_4KB_S_X = 21, 
 | 
    DC_SW_4KB_D_X = 22, 
 | 
    DC_SW_4KB_R_X = 23, 
 | 
    DC_SW_64KB_S_X = 25, 
 | 
    DC_SW_64KB_D_X = 26, 
 | 
    DC_SW_64KB_R_X = 27, 
 | 
    DC_SW_VAR_S_X = 29, 
 | 
    DC_SW_VAR_D_X = 30, 
 | 
    DC_SW_VAR_R_X = 31, 
 | 
    DC_SW_MAX 
 | 
}; 
 | 
  
 | 
union dc_tiling_info { 
 | 
  
 | 
    struct { 
 | 
        /* Specifies the number of memory banks for tiling 
 | 
         *    purposes. 
 | 
         * Only applies to 2D and 3D tiling modes. 
 | 
         *    POSSIBLE VALUES: 2,4,8,16 
 | 
         */ 
 | 
        unsigned int num_banks; 
 | 
        /* Specifies the number of tiles in the x direction 
 | 
         *    to be incorporated into the same bank. 
 | 
         * Only applies to 2D and 3D tiling modes. 
 | 
         *    POSSIBLE VALUES: 1,2,4,8 
 | 
         */ 
 | 
        unsigned int bank_width; 
 | 
        unsigned int bank_width_c; 
 | 
        /* Specifies the number of tiles in the y direction to 
 | 
         *    be incorporated into the same bank. 
 | 
         * Only applies to 2D and 3D tiling modes. 
 | 
         *    POSSIBLE VALUES: 1,2,4,8 
 | 
         */ 
 | 
        unsigned int bank_height; 
 | 
        unsigned int bank_height_c; 
 | 
        /* Specifies the macro tile aspect ratio. Only applies 
 | 
         * to 2D and 3D tiling modes. 
 | 
         */ 
 | 
        unsigned int tile_aspect; 
 | 
        unsigned int tile_aspect_c; 
 | 
        /* Specifies the number of bytes that will be stored 
 | 
         *    contiguously for each tile. 
 | 
         * If the tile data requires more storage than this 
 | 
         *    amount, it is split into multiple slices. 
 | 
         * This field must not be larger than 
 | 
         *    GB_ADDR_CONFIG.DRAM_ROW_SIZE. 
 | 
         * Only applies to 2D and 3D tiling modes. 
 | 
         * For color render targets, TILE_SPLIT >= 256B. 
 | 
         */ 
 | 
        enum tile_split_values tile_split; 
 | 
        enum tile_split_values tile_split_c; 
 | 
        /* Specifies the addressing within a tile. 
 | 
         *    0x0 - DISPLAY_MICRO_TILING 
 | 
         *    0x1 - THIN_MICRO_TILING 
 | 
         *    0x2 - DEPTH_MICRO_TILING 
 | 
         *    0x3 - ROTATED_MICRO_TILING 
 | 
         */ 
 | 
        enum tile_mode_values tile_mode; 
 | 
        enum tile_mode_values tile_mode_c; 
 | 
        /* Specifies the number of pipes and how they are 
 | 
         *    interleaved in the surface. 
 | 
         * Refer to memory addressing document for complete 
 | 
         *    details and constraints. 
 | 
         */ 
 | 
        unsigned int pipe_config; 
 | 
        /* Specifies the tiling mode of the surface. 
 | 
         * THIN tiles use an 8x8x1 tile size. 
 | 
         * THICK tiles use an 8x8x4 tile size. 
 | 
         * 2D tiling modes rotate banks for successive Z slices 
 | 
         * 3D tiling modes rotate pipes and banks for Z slices 
 | 
         * Refer to memory addressing document for complete 
 | 
         *    details and constraints. 
 | 
         */ 
 | 
        enum array_mode_values array_mode; 
 | 
    } gfx8; 
 | 
  
 | 
    struct { 
 | 
        unsigned int num_pipes; 
 | 
        unsigned int num_banks; 
 | 
        unsigned int pipe_interleave; 
 | 
        unsigned int num_shader_engines; 
 | 
        unsigned int num_rb_per_se; 
 | 
        unsigned int max_compressed_frags; 
 | 
        bool shaderEnable; 
 | 
  
 | 
        enum swizzle_mode_values swizzle; 
 | 
        bool meta_linear; 
 | 
        bool rb_aligned; 
 | 
        bool pipe_aligned; 
 | 
    } gfx9; 
 | 
}; 
 | 
  
 | 
/* Rotation angle */ 
 | 
enum dc_rotation_angle { 
 | 
    ROTATION_ANGLE_0 = 0, 
 | 
    ROTATION_ANGLE_90, 
 | 
    ROTATION_ANGLE_180, 
 | 
    ROTATION_ANGLE_270, 
 | 
    ROTATION_ANGLE_COUNT 
 | 
}; 
 | 
  
 | 
enum dc_scan_direction { 
 | 
    SCAN_DIRECTION_UNKNOWN = 0, 
 | 
    SCAN_DIRECTION_HORIZONTAL = 1,  /* 0, 180 rotation */ 
 | 
    SCAN_DIRECTION_VERTICAL = 2,    /* 90, 270 rotation */ 
 | 
}; 
 | 
  
 | 
struct dc_cursor_position { 
 | 
    uint32_t x; 
 | 
    uint32_t y; 
 | 
  
 | 
    uint32_t x_hotspot; 
 | 
    uint32_t y_hotspot; 
 | 
  
 | 
    /* 
 | 
     * This parameter indicates whether HW cursor should be enabled 
 | 
     */ 
 | 
    bool enable; 
 | 
  
 | 
}; 
 | 
  
 | 
struct dc_cursor_mi_param { 
 | 
    unsigned int pixel_clk_khz; 
 | 
    unsigned int ref_clk_khz; 
 | 
    struct rect viewport; 
 | 
    struct fixed31_32 h_scale_ratio; 
 | 
    struct fixed31_32 v_scale_ratio; 
 | 
    enum dc_rotation_angle rotation; 
 | 
    bool mirror; 
 | 
}; 
 | 
  
 | 
/* IPP related types */ 
 | 
  
 | 
enum { 
 | 
    GAMMA_RGB_256_ENTRIES = 256, 
 | 
    GAMMA_RGB_FLOAT_1024_ENTRIES = 1024, 
 | 
    GAMMA_CS_TFM_1D_ENTRIES = 4096, 
 | 
    GAMMA_CUSTOM_ENTRIES = 4096, 
 | 
    GAMMA_MAX_ENTRIES = 4096 
 | 
}; 
 | 
  
 | 
enum dc_gamma_type { 
 | 
    GAMMA_RGB_256 = 1, 
 | 
    GAMMA_RGB_FLOAT_1024 = 2, 
 | 
    GAMMA_CS_TFM_1D = 3, 
 | 
    GAMMA_CUSTOM = 4, 
 | 
}; 
 | 
  
 | 
struct dc_csc_transform { 
 | 
    uint16_t matrix[12]; 
 | 
    bool enable_adjustment; 
 | 
}; 
 | 
  
 | 
struct dc_gamma { 
 | 
    struct kref refcount; 
 | 
    enum dc_gamma_type type; 
 | 
    unsigned int num_entries; 
 | 
  
 | 
    struct dc_gamma_entries { 
 | 
        struct fixed31_32 red[GAMMA_MAX_ENTRIES]; 
 | 
        struct fixed31_32 green[GAMMA_MAX_ENTRIES]; 
 | 
        struct fixed31_32 blue[GAMMA_MAX_ENTRIES]; 
 | 
    } entries; 
 | 
  
 | 
    /* private to DC core */ 
 | 
    struct dc_context *ctx; 
 | 
  
 | 
    bool is_identity; 
 | 
}; 
 | 
  
 | 
/* Used by both ipp amd opp functions*/ 
 | 
/* TODO: to be consolidated with enum color_space */ 
 | 
  
 | 
/* 
 | 
 * This enum is for programming CURSOR_MODE register field. What this register 
 | 
 * should be programmed to depends on OS requested cursor shape flags and what 
 | 
 * we stored in the cursor surface. 
 | 
 */ 
 | 
enum dc_cursor_color_format { 
 | 
    CURSOR_MODE_MONO, 
 | 
    CURSOR_MODE_COLOR_1BIT_AND, 
 | 
    CURSOR_MODE_COLOR_PRE_MULTIPLIED_ALPHA, 
 | 
    CURSOR_MODE_COLOR_UN_PRE_MULTIPLIED_ALPHA 
 | 
}; 
 | 
  
 | 
/* 
 | 
 * This is all the parameters required by DAL in order to update the cursor 
 | 
 * attributes, including the new cursor image surface address, size, hotspot 
 | 
 * location, color format, etc. 
 | 
 */ 
 | 
  
 | 
union dc_cursor_attribute_flags { 
 | 
    struct { 
 | 
        uint32_t ENABLE_MAGNIFICATION:1; 
 | 
        uint32_t INVERSE_TRANSPARENT_CLAMPING:1; 
 | 
        uint32_t HORIZONTAL_MIRROR:1; 
 | 
        uint32_t VERTICAL_MIRROR:1; 
 | 
        uint32_t INVERT_PIXEL_DATA:1; 
 | 
        uint32_t ZERO_EXPANSION:1; 
 | 
        uint32_t MIN_MAX_INVERT:1; 
 | 
        uint32_t RESERVED:25; 
 | 
    } bits; 
 | 
    uint32_t value; 
 | 
}; 
 | 
  
 | 
struct dc_cursor_attributes { 
 | 
    PHYSICAL_ADDRESS_LOC address; 
 | 
    uint32_t pitch; 
 | 
  
 | 
    /* Width and height should correspond to cursor surface width x heigh */ 
 | 
    uint32_t width; 
 | 
    uint32_t height; 
 | 
  
 | 
    enum dc_cursor_color_format color_format; 
 | 
    uint32_t sdr_white_level; // for boosting (SDR) cursor in HDR mode 
 | 
  
 | 
    /* In case we support HW Cursor rotation in the future */ 
 | 
    enum dc_rotation_angle rotation_angle; 
 | 
  
 | 
    union dc_cursor_attribute_flags attribute_flags; 
 | 
}; 
 | 
  
 | 
struct dpp_cursor_attributes { 
 | 
    int bias; 
 | 
    int scale; 
 | 
}; 
 | 
  
 | 
/* OPP */ 
 | 
  
 | 
enum dc_color_space { 
 | 
    COLOR_SPACE_UNKNOWN, 
 | 
    COLOR_SPACE_SRGB, 
 | 
    COLOR_SPACE_XR_RGB, 
 | 
    COLOR_SPACE_SRGB_LIMITED, 
 | 
    COLOR_SPACE_MSREF_SCRGB, 
 | 
    COLOR_SPACE_YCBCR601, 
 | 
    COLOR_SPACE_YCBCR709, 
 | 
    COLOR_SPACE_XV_YCC_709, 
 | 
    COLOR_SPACE_XV_YCC_601, 
 | 
    COLOR_SPACE_YCBCR601_LIMITED, 
 | 
    COLOR_SPACE_YCBCR709_LIMITED, 
 | 
    COLOR_SPACE_2020_RGB_FULLRANGE, 
 | 
    COLOR_SPACE_2020_RGB_LIMITEDRANGE, 
 | 
    COLOR_SPACE_2020_YCBCR, 
 | 
    COLOR_SPACE_ADOBERGB, 
 | 
    COLOR_SPACE_DCIP3, 
 | 
    COLOR_SPACE_DISPLAYNATIVE, 
 | 
    COLOR_SPACE_DOLBYVISION, 
 | 
    COLOR_SPACE_APPCTRL, 
 | 
    COLOR_SPACE_CUSTOMPOINTS, 
 | 
}; 
 | 
  
 | 
enum dc_dither_option { 
 | 
    DITHER_OPTION_DEFAULT, 
 | 
    DITHER_OPTION_DISABLE, 
 | 
    DITHER_OPTION_FM6, 
 | 
    DITHER_OPTION_FM8, 
 | 
    DITHER_OPTION_FM10, 
 | 
    DITHER_OPTION_SPATIAL6_FRAME_RANDOM, 
 | 
    DITHER_OPTION_SPATIAL8_FRAME_RANDOM, 
 | 
    DITHER_OPTION_SPATIAL10_FRAME_RANDOM, 
 | 
    DITHER_OPTION_SPATIAL6, 
 | 
    DITHER_OPTION_SPATIAL8, 
 | 
    DITHER_OPTION_SPATIAL10, 
 | 
    DITHER_OPTION_TRUN6, 
 | 
    DITHER_OPTION_TRUN8, 
 | 
    DITHER_OPTION_TRUN10, 
 | 
    DITHER_OPTION_TRUN10_SPATIAL8, 
 | 
    DITHER_OPTION_TRUN10_SPATIAL6, 
 | 
    DITHER_OPTION_TRUN10_FM8, 
 | 
    DITHER_OPTION_TRUN10_FM6, 
 | 
    DITHER_OPTION_TRUN10_SPATIAL8_FM6, 
 | 
    DITHER_OPTION_SPATIAL10_FM8, 
 | 
    DITHER_OPTION_SPATIAL10_FM6, 
 | 
    DITHER_OPTION_TRUN8_SPATIAL6, 
 | 
    DITHER_OPTION_TRUN8_FM6, 
 | 
    DITHER_OPTION_SPATIAL8_FM6, 
 | 
    DITHER_OPTION_MAX = DITHER_OPTION_SPATIAL8_FM6, 
 | 
    DITHER_OPTION_INVALID 
 | 
}; 
 | 
  
 | 
enum dc_quantization_range { 
 | 
    QUANTIZATION_RANGE_UNKNOWN, 
 | 
    QUANTIZATION_RANGE_FULL, 
 | 
    QUANTIZATION_RANGE_LIMITED 
 | 
}; 
 | 
  
 | 
/* XFM */ 
 | 
  
 | 
/* used in  struct dc_plane_state */ 
 | 
struct scaling_taps { 
 | 
    uint32_t v_taps; 
 | 
    uint32_t h_taps; 
 | 
    uint32_t v_taps_c; 
 | 
    uint32_t h_taps_c; 
 | 
}; 
 | 
  
 | 
enum dc_timing_standard { 
 | 
    DC_TIMING_STANDARD_UNDEFINED, 
 | 
    DC_TIMING_STANDARD_DMT, 
 | 
    DC_TIMING_STANDARD_GTF, 
 | 
    DC_TIMING_STANDARD_CVT, 
 | 
    DC_TIMING_STANDARD_CVT_RB, 
 | 
    DC_TIMING_STANDARD_CEA770, 
 | 
    DC_TIMING_STANDARD_CEA861, 
 | 
    DC_TIMING_STANDARD_HDMI, 
 | 
    DC_TIMING_STANDARD_TV_NTSC, 
 | 
    DC_TIMING_STANDARD_TV_NTSC_J, 
 | 
    DC_TIMING_STANDARD_TV_PAL, 
 | 
    DC_TIMING_STANDARD_TV_PAL_M, 
 | 
    DC_TIMING_STANDARD_TV_PAL_CN, 
 | 
    DC_TIMING_STANDARD_TV_SECAM, 
 | 
    DC_TIMING_STANDARD_EXPLICIT, 
 | 
    /*!< For explicit timings from EDID, VBIOS, etc.*/ 
 | 
    DC_TIMING_STANDARD_USER_OVERRIDE, 
 | 
    /*!< For mode timing override by user*/ 
 | 
    DC_TIMING_STANDARD_MAX 
 | 
}; 
 | 
  
 | 
enum dc_color_depth { 
 | 
    COLOR_DEPTH_UNDEFINED, 
 | 
    COLOR_DEPTH_666, 
 | 
    COLOR_DEPTH_888, 
 | 
    COLOR_DEPTH_101010, 
 | 
    COLOR_DEPTH_121212, 
 | 
    COLOR_DEPTH_141414, 
 | 
    COLOR_DEPTH_161616, 
 | 
    COLOR_DEPTH_COUNT 
 | 
}; 
 | 
  
 | 
enum dc_pixel_encoding { 
 | 
    PIXEL_ENCODING_UNDEFINED, 
 | 
    PIXEL_ENCODING_RGB, 
 | 
    PIXEL_ENCODING_YCBCR422, 
 | 
    PIXEL_ENCODING_YCBCR444, 
 | 
    PIXEL_ENCODING_YCBCR420, 
 | 
    PIXEL_ENCODING_COUNT 
 | 
}; 
 | 
  
 | 
enum dc_aspect_ratio { 
 | 
    ASPECT_RATIO_NO_DATA, 
 | 
    ASPECT_RATIO_4_3, 
 | 
    ASPECT_RATIO_16_9, 
 | 
    ASPECT_RATIO_64_27, 
 | 
    ASPECT_RATIO_256_135, 
 | 
    ASPECT_RATIO_FUTURE 
 | 
}; 
 | 
  
 | 
enum scanning_type { 
 | 
    SCANNING_TYPE_NODATA = 0, 
 | 
    SCANNING_TYPE_OVERSCAN, 
 | 
    SCANNING_TYPE_UNDERSCAN, 
 | 
    SCANNING_TYPE_FUTURE, 
 | 
    SCANNING_TYPE_UNDEFINED 
 | 
}; 
 | 
  
 | 
struct dc_crtc_timing_flags { 
 | 
    uint32_t INTERLACE :1; 
 | 
    uint32_t HSYNC_POSITIVE_POLARITY :1; /* when set to 1, 
 | 
     it is positive polarity --reversed with dal1 or video bios define*/ 
 | 
    uint32_t VSYNC_POSITIVE_POLARITY :1; /* when set to 1, 
 | 
     it is positive polarity --reversed with dal1 or video bios define*/ 
 | 
  
 | 
    uint32_t HORZ_COUNT_BY_TWO:1; 
 | 
  
 | 
    uint32_t EXCLUSIVE_3D :1; /* if this bit set, 
 | 
     timing can be driven in 3D format only 
 | 
     and there is no corresponding 2D timing*/ 
 | 
    uint32_t RIGHT_EYE_3D_POLARITY :1; /* 1 - means right eye polarity 
 | 
     (right eye = '1', left eye = '0') */ 
 | 
    uint32_t SUB_SAMPLE_3D :1; /* 1 - means left/right  images subsampled 
 | 
     when mixed into 3D image. 0 - means summation (3D timing is doubled)*/ 
 | 
    uint32_t USE_IN_3D_VIEW_ONLY :1; /* Do not use this timing in 2D View, 
 | 
     because corresponding 2D timing also present in the list*/ 
 | 
    uint32_t STEREO_3D_PREFERENCE :1; /* Means this is 2D timing 
 | 
     and we want to match priority of corresponding 3D timing*/ 
 | 
    uint32_t Y_ONLY :1; 
 | 
  
 | 
    uint32_t YCBCR420 :1; /* TODO: shouldn't need this flag, should be a separate pixel format */ 
 | 
    uint32_t DTD_COUNTER :5; /* values 1 to 16 */ 
 | 
  
 | 
    uint32_t FORCE_HDR :1; 
 | 
  
 | 
    /* HDMI 2.0 - Support scrambling for TMDS character 
 | 
     * rates less than or equal to 340Mcsc */ 
 | 
    uint32_t LTE_340MCSC_SCRAMBLE:1; 
 | 
  
 | 
}; 
 | 
  
 | 
enum dc_timing_3d_format { 
 | 
    TIMING_3D_FORMAT_NONE, 
 | 
    TIMING_3D_FORMAT_FRAME_ALTERNATE, /* No stereosync at all*/ 
 | 
    TIMING_3D_FORMAT_INBAND_FA, /* Inband Frame Alternate (DVI/DP)*/ 
 | 
    TIMING_3D_FORMAT_DP_HDMI_INBAND_FA, /* Inband FA to HDMI Frame Pack*/ 
 | 
    /* for active DP-HDMI dongle*/ 
 | 
    TIMING_3D_FORMAT_SIDEBAND_FA, /* Sideband Frame Alternate (eDP)*/ 
 | 
    TIMING_3D_FORMAT_HW_FRAME_PACKING, 
 | 
    TIMING_3D_FORMAT_SW_FRAME_PACKING, 
 | 
    TIMING_3D_FORMAT_ROW_INTERLEAVE, 
 | 
    TIMING_3D_FORMAT_COLUMN_INTERLEAVE, 
 | 
    TIMING_3D_FORMAT_PIXEL_INTERLEAVE, 
 | 
    TIMING_3D_FORMAT_SIDE_BY_SIDE, 
 | 
    TIMING_3D_FORMAT_TOP_AND_BOTTOM, 
 | 
    TIMING_3D_FORMAT_SBS_SW_PACKED, 
 | 
    /* Side-by-side, packed by application/driver into 2D frame*/ 
 | 
    TIMING_3D_FORMAT_TB_SW_PACKED, 
 | 
    /* Top-and-bottom, packed by application/driver into 2D frame*/ 
 | 
  
 | 
    TIMING_3D_FORMAT_MAX, 
 | 
}; 
 | 
  
 | 
enum trigger_delay { 
 | 
    TRIGGER_DELAY_NEXT_PIXEL = 0, 
 | 
    TRIGGER_DELAY_NEXT_LINE, 
 | 
}; 
 | 
  
 | 
enum crtc_event { 
 | 
    CRTC_EVENT_VSYNC_RISING = 0, 
 | 
    CRTC_EVENT_VSYNC_FALLING 
 | 
}; 
 | 
  
 | 
struct crtc_trigger_info { 
 | 
    bool enabled; 
 | 
    struct dc_stream_state *event_source; 
 | 
    enum crtc_event event; 
 | 
    enum trigger_delay delay; 
 | 
}; 
 | 
  
 | 
enum vrr_state { 
 | 
    VRR_STATE_OFF = 0, 
 | 
    VRR_STATE_VARIABLE, 
 | 
    VRR_STATE_FIXED, 
 | 
}; 
 | 
  
 | 
struct dc_crtc_timing_adjust { 
 | 
    uint32_t v_total_min; 
 | 
    uint32_t v_total_max; 
 | 
}; 
 | 
  
 | 
struct dc_crtc_timing { 
 | 
    uint32_t h_total; 
 | 
    uint32_t h_border_left; 
 | 
    uint32_t h_addressable; 
 | 
    uint32_t h_border_right; 
 | 
    uint32_t h_front_porch; 
 | 
    uint32_t h_sync_width; 
 | 
  
 | 
    uint32_t v_total; 
 | 
    uint32_t v_border_top; 
 | 
    uint32_t v_addressable; 
 | 
    uint32_t v_border_bottom; 
 | 
    uint32_t v_front_porch; 
 | 
    uint32_t v_sync_width; 
 | 
  
 | 
    uint32_t pix_clk_khz; 
 | 
  
 | 
    uint32_t vic; 
 | 
    uint32_t hdmi_vic; 
 | 
    enum dc_timing_3d_format timing_3d_format; 
 | 
    enum dc_color_depth display_color_depth; 
 | 
    enum dc_pixel_encoding pixel_encoding; 
 | 
    enum dc_aspect_ratio aspect_ratio; 
 | 
    enum scanning_type scan_type; 
 | 
  
 | 
    struct dc_crtc_timing_flags flags; 
 | 
}; 
 | 
  
 | 
#define MAX_TG_COLOR_VALUE 0x3FF 
 | 
struct tg_color { 
 | 
    /* Maximum 10 bits color value */ 
 | 
    uint16_t color_r_cr; 
 | 
    uint16_t color_g_y; 
 | 
    uint16_t color_b_cb; 
 | 
}; 
 | 
  
 | 
#endif /* DC_HW_TYPES_H */ 
 |