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 | #ifndef MOD_FREESYNC_H_ |
27 | #define MOD_FREESYNC_H_ |
28 | |
29 | #include "mod_shared.h" |
30 | |
31 | // Access structures |
32 | struct mod_freesync { |
33 | int dummy; |
34 | }; |
35 | |
36 | // TODO: References to this should be removed |
37 | struct mod_freesync_caps { |
38 | bool supported; |
39 | unsigned int min_refresh_in_micro_hz; |
40 | unsigned int max_refresh_in_micro_hz; |
41 | }; |
42 | |
43 | enum mod_vrr_state { |
44 | VRR_STATE_UNSUPPORTED = 0, |
45 | VRR_STATE_DISABLED, |
46 | VRR_STATE_INACTIVE, |
47 | VRR_STATE_ACTIVE_VARIABLE, |
48 | VRR_STATE_ACTIVE_FIXED |
49 | }; |
50 | |
51 | struct mod_freesync_config { |
52 | enum mod_vrr_state state; |
53 | bool vsif_supported; |
54 | bool ramping; |
55 | bool btr; |
56 | unsigned int min_refresh_in_uhz; |
57 | unsigned int max_refresh_in_uhz; |
58 | unsigned int fixed_refresh_in_uhz; |
59 | |
60 | }; |
61 | |
62 | struct mod_vrr_params_btr { |
63 | bool btr_enabled; |
64 | bool btr_active; |
65 | uint32_t mid_point_in_us; |
66 | uint32_t inserted_duration_in_us; |
67 | uint32_t frames_to_insert; |
68 | uint32_t frame_counter; |
69 | uint32_t margin_in_us; |
70 | }; |
71 | |
72 | struct mod_vrr_params_fixed_refresh { |
73 | bool fixed_active; |
74 | bool ramping_active; |
75 | bool ramping_done; |
76 | uint32_t target_refresh_in_uhz; |
77 | uint32_t frame_counter; |
78 | }; |
79 | |
80 | struct mod_vrr_params_flip_interval { |
81 | bool flip_interval_workaround_active; |
82 | bool program_flip_interval_workaround; |
83 | bool do_flip_interval_workaround_cleanup; |
84 | uint32_t flip_interval_detect_counter; |
85 | uint32_t vsyncs_between_flip; |
86 | uint32_t vsync_to_flip_in_us; |
87 | uint32_t v_update_timestamp_in_us; |
88 | }; |
89 | |
90 | struct mod_vrr_params { |
91 | bool supported; |
92 | bool send_info_frame; |
93 | enum mod_vrr_state state; |
94 | |
95 | uint32_t min_refresh_in_uhz; |
96 | uint32_t max_duration_in_us; |
97 | uint32_t max_refresh_in_uhz; |
98 | uint32_t min_duration_in_us; |
99 | uint32_t fixed_refresh_in_uhz; |
100 | |
101 | struct dc_crtc_timing_adjust adjust; |
102 | |
103 | struct mod_vrr_params_fixed_refresh fixed; |
104 | |
105 | struct mod_vrr_params_btr btr; |
106 | |
107 | struct mod_vrr_params_flip_interval flip_interval; |
108 | }; |
109 | |
110 | struct mod_freesync *mod_freesync_create(struct dc *dc); |
111 | void mod_freesync_destroy(struct mod_freesync *mod_freesync); |
112 | |
113 | bool mod_freesync_get_vmin_vmax(struct mod_freesync *mod_freesync, |
114 | const struct dc_stream_state *stream, |
115 | unsigned int *vmin, |
116 | unsigned int *vmax); |
117 | |
118 | bool mod_freesync_get_v_position(struct mod_freesync *mod_freesync, |
119 | struct dc_stream_state *stream, |
120 | unsigned int *nom_v_pos, |
121 | unsigned int *v_pos); |
122 | |
123 | void mod_freesync_get_settings(struct mod_freesync *mod_freesync, |
124 | const struct mod_vrr_params *vrr, |
125 | unsigned int *v_total_min, unsigned int *v_total_max, |
126 | unsigned int *event_triggers, |
127 | unsigned int *window_min, unsigned int *window_max, |
128 | unsigned int *lfc_mid_point_in_us, |
129 | unsigned int *inserted_frames, |
130 | unsigned int *inserted_duration_in_us); |
131 | |
132 | void mod_freesync_build_vrr_infopacket(struct mod_freesync *mod_freesync, |
133 | const struct dc_stream_state *stream, |
134 | const struct mod_vrr_params *vrr, |
135 | enum vrr_packet_type packet_type, |
136 | enum color_transfer_func app_tf, |
137 | struct dc_info_packet *infopacket, |
138 | bool pack_sdp_v1_3); |
139 | |
140 | void mod_freesync_build_vrr_params(struct mod_freesync *mod_freesync, |
141 | const struct dc_stream_state *stream, |
142 | struct mod_freesync_config *in_config, |
143 | struct mod_vrr_params *in_out_vrr); |
144 | |
145 | void mod_freesync_handle_preflip(struct mod_freesync *mod_freesync, |
146 | const struct dc_plane_state *plane, |
147 | const struct dc_stream_state *stream, |
148 | unsigned int curr_time_stamp_in_us, |
149 | struct mod_vrr_params *in_out_vrr); |
150 | |
151 | void mod_freesync_handle_v_update(struct mod_freesync *mod_freesync, |
152 | const struct dc_stream_state *stream, |
153 | struct mod_vrr_params *in_out_vrr); |
154 | |
155 | unsigned long long mod_freesync_calc_nominal_field_rate( |
156 | const struct dc_stream_state *stream); |
157 | |
158 | unsigned long long mod_freesync_calc_field_rate_from_timing( |
159 | unsigned int vtotal, unsigned int htotal, unsigned int pix_clk); |
160 | |
161 | bool mod_freesync_is_valid_range(uint32_t min_refresh_cap_in_uhz, |
162 | uint32_t max_refresh_cap_in_uhz, |
163 | uint32_t nominal_field_rate_in_uhz); |
164 | |
165 | unsigned int mod_freesync_calc_v_total_from_refresh( |
166 | const struct dc_stream_state *stream, |
167 | unsigned int refresh_in_uhz); |
168 | |
169 | // Returns true when FreeSync is supported and enabled (even if it is inactive) |
170 | bool mod_freesync_get_freesync_enabled(struct mod_vrr_params *pVrr); |
171 | |
172 | #endif |
173 | |