drivers/gpu/drm/amd/display/modules/inc/mod_freesync.h

   1 /*
   2  * Copyright 2016 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  * Authors: AMD
  23  *
  24  */
  25
  26
  27
  28
  29 /*
  30  * Copyright 2016 Advanced Micro Devices, Inc.
  31  *
  32  * Permission is hereby granted, free of charge, to any person obtaining a
  33  * copy of this software and associated documentation files (the "Software"),
  34  * to deal in the Software without restriction, including without limitation
  35  * the rights to use, copy, modify, merge, publish, distribute, sublicense,
  36  * and/or sell copies of the Software, and to permit persons to whom the
  37  * Software is furnished to do so, subject to the following conditions:
  38  *
  39  * The above copyright notice and this permission notice shall be included in
  40  * all copies or substantial portions of the Software.
  41  *
  42  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  43  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  44  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
  45  * THE COPYRIGHT HOLDER(S) OR AUTHOR(S) BE LIABLE FOR ANY CLAIM, DAMAGES OR
  46  * OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
  47  * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
  48  * OTHER DEALINGS IN THE SOFTWARE.
  49  *
  50  * Authors: AMD
  51  *
  52  */
  53
  54 #ifndef MOD_FREESYNC_H_
  55 #define MOD_FREESYNC_H_
  56
  57 #include "mod_shared.h"
  58
  59 // Access structures
  60 struct mod_freesync {
  61         int dummy;
  62 };
  63
  64 // TODO: References to this should be removed
  65 struct mod_freesync_caps {
  66         bool supported;
  67         unsigned int min_refresh_in_micro_hz;
  68         unsigned int max_refresh_in_micro_hz;
  69 };
  70
  71 enum mod_vrr_state {
  72         VRR_STATE_UNSUPPORTED = 0,
  73         VRR_STATE_DISABLED,
  74         VRR_STATE_INACTIVE,
  75         VRR_STATE_ACTIVE_VARIABLE,
  76         VRR_STATE_ACTIVE_FIXED
  77 };
  78
  79 struct mod_freesync_config {
  80         enum mod_vrr_state state;
  81         bool vsif_supported;
  82         bool ramping;
  83         bool btr;
  84         unsigned int min_refresh_in_uhz;
  85         unsigned int max_refresh_in_uhz;
  86 };
  87
  88 struct mod_vrr_params_btr {
  89         bool btr_enabled;
  90         bool btr_active;
  91         uint32_t mid_point_in_us;
  92         uint32_t inserted_duration_in_us;
  93         uint32_t frames_to_insert;
  94         uint32_t frame_counter;
  95         uint32_t margin_in_us;
  96 };
  97
  98 struct mod_vrr_params_fixed_refresh {
  99         bool fixed_active;
 100         bool ramping_active;
 101         bool ramping_done;
 102         uint32_t target_refresh_in_uhz;
 103         uint32_t frame_counter;
 104 };
 105
 106 struct mod_vrr_params {
 107         bool supported;
 108         bool send_info_frame;
 109         enum mod_vrr_state state;
 110
 111         uint32_t min_refresh_in_uhz;
 112         uint32_t max_duration_in_us;
 113         uint32_t max_refresh_in_uhz;
 114         uint32_t min_duration_in_us;
 115
 116         struct dc_crtc_timing_adjust adjust;
 117
 118         struct mod_vrr_params_fixed_refresh fixed;
 119
 120         struct mod_vrr_params_btr btr;
 121 };
 122
 123 struct mod_freesync *mod_freesync_create(struct dc *dc);
 124 void mod_freesync_destroy(struct mod_freesync *mod_freesync);
 125
 126 bool mod_freesync_get_vmin_vmax(struct mod_freesync *mod_freesync,
 127                 const struct dc_stream_state *stream,
 128                 unsigned int *vmin,
 129                 unsigned int *vmax);
 130
 131 bool mod_freesync_get_v_position(struct mod_freesync *mod_freesync,
 132                 struct dc_stream_state *stream,
 133                 unsigned int *nom_v_pos,
 134                 unsigned int *v_pos);
 135
 136 void mod_freesync_get_settings(struct mod_freesync *mod_freesync,
 137                 const struct mod_vrr_params *vrr,
 138                 unsigned int *v_total_min, unsigned int *v_total_max,
 139                 unsigned int *event_triggers,
 140                 unsigned int *window_min, unsigned int *window_max,
 141                 unsigned int *lfc_mid_point_in_us,
 142                 unsigned int *inserted_frames,
 143                 unsigned int *inserted_duration_in_us);
 144
 145 void mod_freesync_build_vrr_infopacket(struct mod_freesync *mod_freesync,
 146                 const struct dc_stream_state *stream,
 147                 const struct mod_vrr_params *vrr,
 148                 enum vrr_packet_type packet_type,
 149                 enum color_transfer_func app_tf,
 150                 struct dc_info_packet *infopacket);
 151
 152 void mod_freesync_build_vrr_params(struct mod_freesync *mod_freesync,
 153                 const struct dc_stream_state *stream,
 154                 struct mod_freesync_config *in_config,
 155                 struct mod_vrr_params *in_out_vrr);
 156
 157 void mod_freesync_handle_preflip(struct mod_freesync *mod_freesync,
 158                 const struct dc_plane_state *plane,
 159                 const struct dc_stream_state *stream,
 160                 unsigned int curr_time_stamp_in_us,
 161                 struct mod_vrr_params *in_out_vrr);
 162
 163 void mod_freesync_handle_v_update(struct mod_freesync *mod_freesync,
 164                 const struct dc_stream_state *stream,
 165                 struct mod_vrr_params *in_out_vrr);
 166
 167 unsigned long long mod_freesync_calc_nominal_field_rate(
 168                         const struct dc_stream_state *stream);
 169
 170 bool mod_freesync_is_valid_range(struct mod_freesync *mod_freesync,
 171                 const struct dc_stream_state *stream,
 172                 uint32_t min_refresh_cap_in_uhz,
 173                 uint32_t max_refresh_cap_in_uhz,
 174                 uint32_t min_refresh_request_in_uhz,
 175                 uint32_t max_refresh_request_in_uhz);
 176
 177
 178
 179 #endif