drivers/gpu/drm/amd/display/dc/inc/hw/stream_encoder.h

   1 /*
   2  * Copyright 2017 Advanced Micro Devices, Inc.
   3  *
   4  * Permission is hereby granted, free of charge, to any person obtaining a
   5  * copy of this software and associated documentation files (the "Software"),
   6  * to deal in the Software without restriction, including without limitation
   7  * the rights to use, copy, modify, merge, publish, distribute, sublicense,
   8  * and/or sell copies of the Software, and to permit persons to whom the
   9  * Software is furnished to do so, subject to the following conditions:
  10  *
  11  * The above copyright notice and this permission notice shall be included in
  12  * all copies or substantial portions of the Software.
  13  *
  14  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  15  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  16  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
  17  * THE COPYRIGHT HOLDER(S) OR AUTHOR(S) BE LIABLE FOR ANY CLAIM, DAMAGES OR
  18  * OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
  19  * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
  20  * OTHER DEALINGS IN THE SOFTWARE.
  21  *
  22  */
  23 /*
  24  * stream_encoder.h
  25  *
  26  */
  27
  28 #ifndef STREAM_ENCODER_H_
  29 #define STREAM_ENCODER_H_
  30
  31 #include "audio_types.h"
  32 #include "hw_shared.h"
  33
  34 struct dc_bios;
  35 struct dc_context;
  36 struct dc_crtc_timing;
  37
  38 enum dp_pixel_encoding_type {
  39         DP_PIXEL_ENCODING_TYPE_RGB444           = 0x00000000,
  40         DP_PIXEL_ENCODING_TYPE_YCBCR422         = 0x00000001,
  41         DP_PIXEL_ENCODING_TYPE_YCBCR444         = 0x00000002,
  42         DP_PIXEL_ENCODING_TYPE_RGB_WIDE_GAMUT   = 0x00000003,
  43         DP_PIXEL_ENCODING_TYPE_Y_ONLY           = 0x00000004,
  44         DP_PIXEL_ENCODING_TYPE_YCBCR420         = 0x00000005
  45 };
  46
  47 enum dp_component_depth {
  48         DP_COMPONENT_PIXEL_DEPTH_6BPC           = 0x00000000,
  49         DP_COMPONENT_PIXEL_DEPTH_8BPC           = 0x00000001,
  50         DP_COMPONENT_PIXEL_DEPTH_10BPC          = 0x00000002,
  51         DP_COMPONENT_PIXEL_DEPTH_12BPC          = 0x00000003,
  52         DP_COMPONENT_PIXEL_DEPTH_16BPC          = 0x00000004
  53 };
  54
  55 struct audio_clock_info {
  56         /* pixel clock frequency*/
  57         uint32_t pixel_clock_in_10khz;
  58         /* N - 32KHz audio */
  59         uint32_t n_32khz;
  60         /* CTS - 32KHz audio*/
  61         uint32_t cts_32khz;
  62         uint32_t n_44khz;
  63         uint32_t cts_44khz;
  64         uint32_t n_48khz;
  65         uint32_t cts_48khz;
  66 };
  67
  68 enum dynamic_metadata_mode {
  69         dmdata_dp,
  70         dmdata_hdmi,
  71         dmdata_dolby_vision
  72 };
  73
  74 struct enc_sdp_line_num {
  75         /* Adaptive Sync SDP */
  76         bool adaptive_sync_line_num_valid;
  77         uint32_t adaptive_sync_line_num;
  78 };
  79
  80 struct encoder_info_frame {
  81         /* auxiliary video information */
  82         struct dc_info_packet avi;
  83         struct dc_info_packet gamut;
  84         struct dc_info_packet vendor;
  85         struct dc_info_packet hfvsif;
  86         struct dc_info_packet vtem;
  87         /* source product description */
  88         struct dc_info_packet spd;
  89         /* video stream configuration */
  90         struct dc_info_packet vsc;
  91         /* HDR Static MetaData */
  92         struct dc_info_packet hdrsmd;
  93         /* Adaptive Sync SDP*/
  94         struct dc_info_packet adaptive_sync;
  95         struct enc_sdp_line_num sdp_line_num;
  96 };
  97
  98 struct encoder_unblank_param {
  99         struct dc_link_settings link_settings;
 100         struct dc_crtc_timing timing;
 101         int opp_cnt;
 102         uint32_t pix_per_cycle;
 103 };
 104
 105 struct encoder_set_dp_phy_pattern_param {
 106         enum dp_test_pattern dp_phy_pattern;
 107         const uint8_t *custom_pattern;
 108         uint32_t custom_pattern_size;
 109         enum dp_panel_mode dp_panel_mode;
 110 };
 111
 112 struct stream_encoder {
 113         const struct stream_encoder_funcs *funcs;
 114         struct dc_context *ctx;
 115         struct dc_bios *bp;
 116         enum engine_id id;
 117         uint32_t stream_enc_inst;
 118         struct vpg *vpg;
 119         struct afmt *afmt;
 120 };
 121
 122 struct enc_state {
 123         uint32_t dsc_mode;  // DISABLED  0; 1 or 2 indicate enabled state.
 124         uint32_t dsc_slice_width;
 125         uint32_t sec_gsp_pps_line_num;
 126         uint32_t vbid6_line_reference;
 127         uint32_t vbid6_line_num;
 128         uint32_t sec_gsp_pps_enable;
 129         uint32_t sec_stream_enable;
 130 };
 131
 132 struct stream_encoder_funcs {
 133         void (*dp_set_stream_attribute)(
 134                 struct stream_encoder *enc,
 135                 struct dc_crtc_timing *crtc_timing,
 136                 enum dc_color_space output_color_space,
 137                 bool use_vsc_sdp_for_colorimetry,
 138                 uint32_t enable_sdp_splitting);
 139
 140         void (*hdmi_set_stream_attribute)(
 141                 struct stream_encoder *enc,
 142                 struct dc_crtc_timing *crtc_timing,
 143                 int actual_pix_clk_khz,
 144                 bool enable_audio);
 145
 146         void (*dvi_set_stream_attribute)(
 147                 struct stream_encoder *enc,
 148                 struct dc_crtc_timing *crtc_timing,
 149                 bool is_dual_link);
 150
 151         void (*lvds_set_stream_attribute)(
 152                 struct stream_encoder *enc,
 153                 struct dc_crtc_timing *crtc_timing);
 154
 155         void (*set_throttled_vcp_size)(
 156                 struct stream_encoder *enc,
 157                 struct fixed31_32 avg_time_slots_per_mtp);
 158
 159         void (*update_hdmi_info_packets)(
 160                 struct stream_encoder *enc,
 161                 const struct encoder_info_frame *info_frame);
 162
 163         void (*stop_hdmi_info_packets)(
 164                 struct stream_encoder *enc);
 165
 166         void (*update_dp_info_packets_sdp_line_num)(
 167                 struct stream_encoder *enc,
 168                 struct encoder_info_frame *info_frame);
 169
 170         void (*update_dp_info_packets)(
 171                 struct stream_encoder *enc,
 172                 const struct encoder_info_frame *info_frame);
 173
 174         void (*send_immediate_sdp_message)(
 175                                 struct stream_encoder *enc,
 176                                 const uint8_t *custom_sdp_message,
 177                                 unsigned int sdp_message_size);
 178
 179         void (*stop_dp_info_packets)(
 180                 struct stream_encoder *enc);
 181
 182         void (*dp_blank)(
 183                 struct dc_link *link,
 184                 struct stream_encoder *enc);
 185
 186         void (*dp_unblank)(
 187                 struct dc_link *link,
 188                 struct stream_encoder *enc,
 189                 const struct encoder_unblank_param *param);
 190
 191         void (*audio_mute_control)(
 192                 struct stream_encoder *enc, bool mute);
 193
 194         void (*dp_audio_setup)(
 195                 struct stream_encoder *enc,
 196                 unsigned int az_inst,
 197                 struct audio_info *info);
 198
 199         void (*dp_audio_enable) (
 200                         struct stream_encoder *enc);
 201
 202         void (*dp_audio_disable) (
 203                         struct stream_encoder *enc);
 204
 205         void (*hdmi_audio_setup)(
 206                 struct stream_encoder *enc,
 207                 unsigned int az_inst,
 208                 struct audio_info *info,
 209                 struct audio_crtc_info *audio_crtc_info);
 210
 211         void (*hdmi_audio_disable) (
 212                         struct stream_encoder *enc);
 213
 214         void (*setup_stereo_sync) (
 215                         struct stream_encoder *enc,
 216                         int tg_inst,
 217                         bool enable);
 218
 219         void (*set_avmute)(
 220                 struct stream_encoder *enc, bool enable);
 221
 222         void (*dig_connect_to_otg)(
 223                 struct stream_encoder *enc,
 224                 int tg_inst);
 225
 226         void (*enable_stream)(
 227                 struct stream_encoder *enc,
 228                 enum signal_type signal,
 229                 bool enable);
 230
 231         void (*hdmi_reset_stream_attribute)(
 232                 struct stream_encoder *enc);
 233
 234         unsigned int (*dig_source_otg)(
 235                 struct stream_encoder *enc);
 236
 237         bool (*dp_get_pixel_format)(
 238                 struct stream_encoder *enc,
 239                 enum dc_pixel_encoding *encoding,
 240                 enum dc_color_depth *depth);
 241
 242         void (*enc_read_state)(struct stream_encoder *enc, struct enc_state *s);
 243
 244         void (*dp_set_dsc_config)(
 245                         struct stream_encoder *enc,
 246                         enum optc_dsc_mode dsc_mode,
 247                         uint32_t dsc_bytes_per_pixel,
 248                         uint32_t dsc_slice_width);
 249
 250         void (*dp_set_dsc_pps_info_packet)(struct stream_encoder *enc,
 251                                 bool enable,
 252                                 uint8_t *dsc_packed_pps,
 253                                 bool immediate_update);
 254
 255         void (*set_dynamic_metadata)(struct stream_encoder *enc,
 256                         bool enable,
 257                         uint32_t hubp_requestor_id,
 258                         enum dynamic_metadata_mode dmdata_mode);
 259
 260         /**
 261          * @dp_set_odm_combine: Sets up DP stream encoder for ODM.
 262          */
 263         void (*dp_set_odm_combine)(
 264                 struct stream_encoder *enc,
 265                 bool odm_combine);
 266
 267         uint32_t (*get_fifo_cal_average_level)(
 268                 struct stream_encoder *enc);
 269
 270         void (*set_input_mode)(
 271                 struct stream_encoder *enc, unsigned int pix_per_container);
 272         void (*enable_fifo)(struct stream_encoder *enc);
 273         void (*disable_fifo)(struct stream_encoder *enc);
 274         void (*map_stream_to_link)(struct stream_encoder *enc, uint32_t stream_enc_inst, uint32_t link_enc_inst);
 275 };
 276
 277 struct hpo_dp_stream_encoder_state {
 278         uint32_t stream_enc_enabled;
 279         uint32_t vid_stream_enabled;
 280         uint32_t otg_inst;
 281         uint32_t pixel_encoding;
 282         uint32_t component_depth;
 283         uint32_t compressed_format;
 284         uint32_t sdp_enabled;
 285         uint32_t mapped_to_link_enc;
 286 };
 287
 288 struct hpo_dp_stream_encoder {
 289         const struct hpo_dp_stream_encoder_funcs *funcs;
 290         struct dc_context *ctx;
 291         struct dc_bios *bp;
 292         uint32_t inst;
 293         enum engine_id id;
 294         struct vpg *vpg;
 295         struct apg *apg;
 296 };
 297
 298 struct hpo_dp_stream_encoder_funcs {
 299         void (*enable_stream)(
 300                         struct hpo_dp_stream_encoder *enc);
 301
 302         void (*dp_unblank)(
 303                         struct hpo_dp_stream_encoder *enc,
 304                         uint32_t stream_source);
 305
 306         void (*dp_blank)(
 307                         struct hpo_dp_stream_encoder *enc);
 308
 309         void (*disable)(
 310                         struct hpo_dp_stream_encoder *enc);
 311
 312         void (*set_stream_attribute)(
 313                 struct hpo_dp_stream_encoder *enc,
 314                 struct dc_crtc_timing *crtc_timing,
 315                 enum dc_color_space output_color_space,
 316                 bool use_vsc_sdp_for_colorimetry,
 317                 bool compressed_format,
 318                 bool double_buffer_en);
 319
 320         void (*update_dp_info_packets_sdp_line_num)(
 321                 struct hpo_dp_stream_encoder *enc,
 322                 struct encoder_info_frame *info_frame);
 323
 324         void (*update_dp_info_packets)(
 325                 struct hpo_dp_stream_encoder *enc,
 326                 const struct encoder_info_frame *info_frame);
 327
 328         void (*stop_dp_info_packets)(
 329                 struct hpo_dp_stream_encoder *enc);
 330
 331         void (*dp_set_dsc_pps_info_packet)(
 332                         struct hpo_dp_stream_encoder *enc,
 333                         bool enable,
 334                         uint8_t *dsc_packed_pps,
 335                         bool immediate_update);
 336
 337         void (*map_stream_to_link)(
 338                         struct hpo_dp_stream_encoder *enc,
 339                         uint32_t stream_enc_inst,
 340                         uint32_t link_enc_inst);
 341
 342         void (*dp_audio_setup)(
 343                         struct hpo_dp_stream_encoder *enc,
 344                         unsigned int az_inst,
 345                         struct audio_info *info);
 346
 347         void (*dp_audio_enable)(
 348                         struct hpo_dp_stream_encoder *enc);
 349
 350         void (*dp_audio_disable)(
 351                         struct hpo_dp_stream_encoder *enc);
 352
 353         void (*read_state)(
 354                         struct hpo_dp_stream_encoder *enc,
 355                         struct hpo_dp_stream_encoder_state *state);
 356
 357         void (*set_hblank_min_symbol_width)(
 358                         struct hpo_dp_stream_encoder *enc,
 359                         uint16_t width);
 360 };
 361
 362 #endif /* STREAM_ENCODER_H_ */