Loading...
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#include "dm_services.h"
27#include "dc.h"
28#include "mod_freesync.h"
29#include "core_types.h"
30
31#define MOD_FREESYNC_MAX_CONCURRENT_STREAMS 32
32
33/* Refresh rate ramp at a fixed rate of 65 Hz/second */
34#define STATIC_SCREEN_RAMP_DELTA_REFRESH_RATE_PER_FRAME ((1000 / 60) * 65)
35/* Number of elements in the render times cache array */
36#define RENDER_TIMES_MAX_COUNT 10
37/* Threshold to exit BTR (to avoid frequent enter-exits at the lower limit) */
38#define BTR_EXIT_MARGIN 2000
39/* Number of consecutive frames to check before entering/exiting fixed refresh*/
40#define FIXED_REFRESH_ENTER_FRAME_COUNT 5
41#define FIXED_REFRESH_EXIT_FRAME_COUNT 5
42
43#define FREESYNC_REGISTRY_NAME "freesync_v1"
44
45#define FREESYNC_NO_STATIC_FOR_EXTERNAL_DP_REGKEY "DalFreeSyncNoStaticForExternalDp"
46
47#define FREESYNC_NO_STATIC_FOR_INTERNAL_REGKEY "DalFreeSyncNoStaticForInternal"
48
49#define FREESYNC_DEFAULT_REGKEY "LCDFreeSyncDefault"
50
51struct gradual_static_ramp {
52 bool ramp_is_active;
53 bool ramp_direction_is_up;
54 unsigned int ramp_current_frame_duration_in_ns;
55};
56
57struct freesync_time {
58 /* video (48Hz feature) related */
59 unsigned int update_duration_in_ns;
60
61 /* BTR/fixed refresh related */
62 unsigned int prev_time_stamp_in_us;
63
64 unsigned int min_render_time_in_us;
65 unsigned int max_render_time_in_us;
66
67 unsigned int render_times_index;
68 unsigned int render_times[RENDER_TIMES_MAX_COUNT];
69
70 unsigned int min_window;
71 unsigned int max_window;
72};
73
74struct below_the_range {
75 bool btr_active;
76 bool program_btr;
77
78 unsigned int mid_point_in_us;
79
80 unsigned int inserted_frame_duration_in_us;
81 unsigned int frames_to_insert;
82 unsigned int frame_counter;
83};
84
85struct fixed_refresh {
86 bool fixed_active;
87 bool program_fixed;
88 unsigned int frame_counter;
89};
90
91struct freesync_range {
92 unsigned int min_refresh;
93 unsigned int max_frame_duration;
94 unsigned int vmax;
95
96 unsigned int max_refresh;
97 unsigned int min_frame_duration;
98 unsigned int vmin;
99};
100
101struct freesync_state {
102 bool fullscreen;
103 bool static_screen;
104 bool video;
105
106 unsigned int vmin;
107 unsigned int vmax;
108
109 struct freesync_time time;
110
111 unsigned int nominal_refresh_rate_in_micro_hz;
112 bool windowed_fullscreen;
113
114 struct gradual_static_ramp static_ramp;
115 struct below_the_range btr;
116 struct fixed_refresh fixed_refresh;
117 struct freesync_range freesync_range;
118};
119
120struct freesync_entity {
121 struct dc_stream_state *stream;
122 struct mod_freesync_caps *caps;
123 struct freesync_state state;
124 struct mod_freesync_user_enable user_enable;
125};
126
127struct freesync_registry_options {
128 bool drr_external_supported;
129 bool drr_internal_supported;
130 bool lcd_freesync_default_set;
131 int lcd_freesync_default_value;
132};
133
134struct core_freesync {
135 struct mod_freesync public;
136 struct dc *dc;
137 struct freesync_registry_options opts;
138 struct freesync_entity *map;
139 int num_entities;
140};
141
142#define MOD_FREESYNC_TO_CORE(mod_freesync)\
143 container_of(mod_freesync, struct core_freesync, public)
144
145struct mod_freesync *mod_freesync_create(struct dc *dc)
146{
147 struct core_freesync *core_freesync =
148 kzalloc(sizeof(struct core_freesync), GFP_KERNEL);
149
150
151 struct persistent_data_flag flag;
152
153 int i, data = 0;
154
155 if (core_freesync == NULL)
156 goto fail_alloc_context;
157
158 core_freesync->map = kzalloc(sizeof(struct freesync_entity) * MOD_FREESYNC_MAX_CONCURRENT_STREAMS,
159 GFP_KERNEL);
160
161 if (core_freesync->map == NULL)
162 goto fail_alloc_map;
163
164 for (i = 0; i < MOD_FREESYNC_MAX_CONCURRENT_STREAMS; i++)
165 core_freesync->map[i].stream = NULL;
166
167 core_freesync->num_entities = 0;
168
169 if (dc == NULL)
170 goto fail_construct;
171
172 core_freesync->dc = dc;
173
174 /* Create initial module folder in registry for freesync enable data */
175 flag.save_per_edid = true;
176 flag.save_per_link = false;
177 dm_write_persistent_data(dc->ctx, NULL, FREESYNC_REGISTRY_NAME,
178 NULL, NULL, 0, &flag);
179 flag.save_per_edid = false;
180 flag.save_per_link = false;
181
182 if (dm_read_persistent_data(dc->ctx, NULL, NULL,
183 FREESYNC_NO_STATIC_FOR_INTERNAL_REGKEY,
184 &data, sizeof(data), &flag)) {
185 core_freesync->opts.drr_internal_supported =
186 (data & 1) ? false : true;
187 }
188
189 if (dm_read_persistent_data(dc->ctx, NULL, NULL,
190 FREESYNC_NO_STATIC_FOR_EXTERNAL_DP_REGKEY,
191 &data, sizeof(data), &flag)) {
192 core_freesync->opts.drr_external_supported =
193 (data & 1) ? false : true;
194 }
195
196 if (dm_read_persistent_data(dc->ctx, NULL, NULL,
197 FREESYNC_DEFAULT_REGKEY,
198 &data, sizeof(data), &flag)) {
199 core_freesync->opts.lcd_freesync_default_set = true;
200 core_freesync->opts.lcd_freesync_default_value = data;
201 } else {
202 core_freesync->opts.lcd_freesync_default_set = false;
203 core_freesync->opts.lcd_freesync_default_value = 0;
204 }
205
206 return &core_freesync->public;
207
208fail_construct:
209 kfree(core_freesync->map);
210
211fail_alloc_map:
212 kfree(core_freesync);
213
214fail_alloc_context:
215 return NULL;
216}
217
218void mod_freesync_destroy(struct mod_freesync *mod_freesync)
219{
220 if (mod_freesync != NULL) {
221 int i;
222 struct core_freesync *core_freesync =
223 MOD_FREESYNC_TO_CORE(mod_freesync);
224
225 for (i = 0; i < core_freesync->num_entities; i++)
226 if (core_freesync->map[i].stream)
227 dc_stream_release(core_freesync->map[i].stream);
228
229 kfree(core_freesync->map);
230
231 kfree(core_freesync);
232 }
233}
234
235/* Given a specific dc_stream* this function finds its equivalent
236 * on the core_freesync->map and returns the corresponding index
237 */
238static unsigned int map_index_from_stream(struct core_freesync *core_freesync,
239 struct dc_stream_state *stream)
240{
241 unsigned int index = 0;
242
243 for (index = 0; index < core_freesync->num_entities; index++) {
244 if (core_freesync->map[index].stream == stream) {
245 return index;
246 }
247 }
248 /* Could not find stream requested */
249 ASSERT(false);
250 return index;
251}
252
253bool mod_freesync_add_stream(struct mod_freesync *mod_freesync,
254 struct dc_stream_state *stream, struct mod_freesync_caps *caps)
255{
256 struct dc *dc = NULL;
257 struct core_freesync *core_freesync = NULL;
258 int persistent_freesync_enable = 0;
259 struct persistent_data_flag flag;
260 unsigned int nom_refresh_rate_uhz;
261 unsigned long long temp;
262
263 if (mod_freesync == NULL)
264 return false;
265
266 core_freesync = MOD_FREESYNC_TO_CORE(mod_freesync);
267 dc = core_freesync->dc;
268
269 flag.save_per_edid = true;
270 flag.save_per_link = false;
271
272 if (core_freesync->num_entities < MOD_FREESYNC_MAX_CONCURRENT_STREAMS) {
273
274 dc_stream_retain(stream);
275
276 temp = stream->timing.pix_clk_khz;
277 temp *= 1000ULL * 1000ULL * 1000ULL;
278 temp = div_u64(temp, stream->timing.h_total);
279 temp = div_u64(temp, stream->timing.v_total);
280
281 nom_refresh_rate_uhz = (unsigned int) temp;
282
283 core_freesync->map[core_freesync->num_entities].stream = stream;
284 core_freesync->map[core_freesync->num_entities].caps = caps;
285
286 core_freesync->map[core_freesync->num_entities].state.
287 fullscreen = false;
288 core_freesync->map[core_freesync->num_entities].state.
289 static_screen = false;
290 core_freesync->map[core_freesync->num_entities].state.
291 video = false;
292 core_freesync->map[core_freesync->num_entities].state.time.
293 update_duration_in_ns = 0;
294 core_freesync->map[core_freesync->num_entities].state.
295 static_ramp.ramp_is_active = false;
296
297 /* get persistent data from registry */
298 if (dm_read_persistent_data(dc->ctx, stream->sink,
299 FREESYNC_REGISTRY_NAME,
300 "userenable", &persistent_freesync_enable,
301 sizeof(int), &flag)) {
302 core_freesync->map[core_freesync->num_entities].user_enable.
303 enable_for_gaming =
304 (persistent_freesync_enable & 1) ? true : false;
305 core_freesync->map[core_freesync->num_entities].user_enable.
306 enable_for_static =
307 (persistent_freesync_enable & 2) ? true : false;
308 core_freesync->map[core_freesync->num_entities].user_enable.
309 enable_for_video =
310 (persistent_freesync_enable & 4) ? true : false;
311 /* If FreeSync display and LCDFreeSyncDefault is set, use as default values write back to userenable */
312 } else if (caps->supported && (core_freesync->opts.lcd_freesync_default_set)) {
313 core_freesync->map[core_freesync->num_entities].user_enable.enable_for_gaming =
314 (core_freesync->opts.lcd_freesync_default_value & 1) ? true : false;
315 core_freesync->map[core_freesync->num_entities].user_enable.enable_for_static =
316 (core_freesync->opts.lcd_freesync_default_value & 2) ? true : false;
317 core_freesync->map[core_freesync->num_entities].user_enable.enable_for_video =
318 (core_freesync->opts.lcd_freesync_default_value & 4) ? true : false;
319 dm_write_persistent_data(dc->ctx, stream->sink,
320 FREESYNC_REGISTRY_NAME,
321 "userenable", &core_freesync->opts.lcd_freesync_default_value,
322 sizeof(int), &flag);
323 } else {
324 core_freesync->map[core_freesync->num_entities].user_enable.
325 enable_for_gaming = false;
326 core_freesync->map[core_freesync->num_entities].user_enable.
327 enable_for_static = false;
328 core_freesync->map[core_freesync->num_entities].user_enable.
329 enable_for_video = false;
330 }
331
332 if (caps->supported &&
333 nom_refresh_rate_uhz >= caps->min_refresh_in_micro_hz &&
334 nom_refresh_rate_uhz <= caps->max_refresh_in_micro_hz)
335 stream->ignore_msa_timing_param = 1;
336
337 core_freesync->num_entities++;
338 return true;
339 }
340 return false;
341}
342
343bool mod_freesync_remove_stream(struct mod_freesync *mod_freesync,
344 struct dc_stream_state *stream)
345{
346 int i = 0;
347 struct core_freesync *core_freesync = NULL;
348 unsigned int index = 0;
349
350 if (mod_freesync == NULL)
351 return false;
352
353 core_freesync = MOD_FREESYNC_TO_CORE(mod_freesync);
354 index = map_index_from_stream(core_freesync, stream);
355
356 dc_stream_release(core_freesync->map[index].stream);
357 core_freesync->map[index].stream = NULL;
358 /* To remove this entity, shift everything after down */
359 for (i = index; i < core_freesync->num_entities - 1; i++)
360 core_freesync->map[i] = core_freesync->map[i + 1];
361 core_freesync->num_entities--;
362 return true;
363}
364
365static void adjust_vmin_vmax(struct core_freesync *core_freesync,
366 struct dc_stream_state **streams,
367 int num_streams,
368 int map_index,
369 unsigned int v_total_min,
370 unsigned int v_total_max)
371{
372 if (num_streams == 0 || streams == NULL || num_streams > 1)
373 return;
374
375 core_freesync->map[map_index].state.vmin = v_total_min;
376 core_freesync->map[map_index].state.vmax = v_total_max;
377
378 dc_stream_adjust_vmin_vmax(core_freesync->dc, streams,
379 num_streams, v_total_min,
380 v_total_max);
381}
382
383
384static void update_stream_freesync_context(struct core_freesync *core_freesync,
385 struct dc_stream_state *stream)
386{
387 unsigned int index;
388 struct freesync_context *ctx;
389
390 ctx = &stream->freesync_ctx;
391
392 index = map_index_from_stream(core_freesync, stream);
393
394 ctx->supported = core_freesync->map[index].caps->supported;
395 ctx->enabled = (core_freesync->map[index].user_enable.enable_for_gaming ||
396 core_freesync->map[index].user_enable.enable_for_video ||
397 core_freesync->map[index].user_enable.enable_for_static);
398 ctx->active = (core_freesync->map[index].state.fullscreen ||
399 core_freesync->map[index].state.video ||
400 core_freesync->map[index].state.static_ramp.ramp_is_active);
401 ctx->min_refresh_in_micro_hz =
402 core_freesync->map[index].caps->min_refresh_in_micro_hz;
403 ctx->nominal_refresh_in_micro_hz = core_freesync->
404 map[index].state.nominal_refresh_rate_in_micro_hz;
405
406}
407
408static void update_stream(struct core_freesync *core_freesync,
409 struct dc_stream_state *stream)
410{
411 unsigned int index = map_index_from_stream(core_freesync, stream);
412 if (core_freesync->map[index].caps->supported) {
413 stream->ignore_msa_timing_param = 1;
414 update_stream_freesync_context(core_freesync, stream);
415 }
416}
417
418static void calc_freesync_range(struct core_freesync *core_freesync,
419 struct dc_stream_state *stream,
420 struct freesync_state *state,
421 unsigned int min_refresh_in_uhz,
422 unsigned int max_refresh_in_uhz)
423{
424 unsigned int min_frame_duration_in_ns = 0, max_frame_duration_in_ns = 0;
425 unsigned int index = map_index_from_stream(core_freesync, stream);
426 uint32_t vtotal = stream->timing.v_total;
427
428 if ((min_refresh_in_uhz == 0) || (max_refresh_in_uhz == 0)) {
429 state->freesync_range.min_refresh =
430 state->nominal_refresh_rate_in_micro_hz;
431 state->freesync_range.max_refresh =
432 state->nominal_refresh_rate_in_micro_hz;
433
434 state->freesync_range.max_frame_duration = 0;
435 state->freesync_range.min_frame_duration = 0;
436
437 state->freesync_range.vmax = vtotal;
438 state->freesync_range.vmin = vtotal;
439
440 return;
441 }
442
443 min_frame_duration_in_ns = ((unsigned int) (div64_u64(
444 (1000000000ULL * 1000000),
445 max_refresh_in_uhz)));
446 max_frame_duration_in_ns = ((unsigned int) (div64_u64(
447 (1000000000ULL * 1000000),
448 min_refresh_in_uhz)));
449
450 state->freesync_range.min_refresh = min_refresh_in_uhz;
451 state->freesync_range.max_refresh = max_refresh_in_uhz;
452
453 state->freesync_range.max_frame_duration = max_frame_duration_in_ns;
454 state->freesync_range.min_frame_duration = min_frame_duration_in_ns;
455
456 state->freesync_range.vmax = div64_u64(div64_u64(((unsigned long long)(
457 max_frame_duration_in_ns) * stream->timing.pix_clk_khz),
458 stream->timing.h_total), 1000000);
459 state->freesync_range.vmin = div64_u64(div64_u64(((unsigned long long)(
460 min_frame_duration_in_ns) * stream->timing.pix_clk_khz),
461 stream->timing.h_total), 1000000);
462
463 /* vmin/vmax cannot be less than vtotal */
464 if (state->freesync_range.vmin < vtotal) {
465 /* Error of 1 is permissible */
466 ASSERT((state->freesync_range.vmin + 1) >= vtotal);
467 state->freesync_range.vmin = vtotal;
468 }
469
470 if (state->freesync_range.vmax < vtotal) {
471 /* Error of 1 is permissible */
472 ASSERT((state->freesync_range.vmax + 1) >= vtotal);
473 state->freesync_range.vmax = vtotal;
474 }
475
476 /* Determine whether BTR can be supported */
477 if (max_frame_duration_in_ns >=
478 2 * min_frame_duration_in_ns)
479 core_freesync->map[index].caps->btr_supported = true;
480 else
481 core_freesync->map[index].caps->btr_supported = false;
482
483 /* Cache the time variables */
484 state->time.max_render_time_in_us =
485 max_frame_duration_in_ns / 1000;
486 state->time.min_render_time_in_us =
487 min_frame_duration_in_ns / 1000;
488 state->btr.mid_point_in_us =
489 (max_frame_duration_in_ns +
490 min_frame_duration_in_ns) / 2000;
491}
492
493static void calc_v_total_from_duration(struct dc_stream_state *stream,
494 unsigned int duration_in_ns, int *v_total_nominal)
495{
496 *v_total_nominal = div64_u64(div64_u64(((unsigned long long)(
497 duration_in_ns) * stream->timing.pix_clk_khz),
498 stream->timing.h_total), 1000000);
499}
500
501static void calc_v_total_for_static_ramp(struct core_freesync *core_freesync,
502 struct dc_stream_state *stream,
503 unsigned int index, int *v_total)
504{
505 unsigned int frame_duration = 0;
506
507 struct gradual_static_ramp *static_ramp_variables =
508 &core_freesync->map[index].state.static_ramp;
509
510 /* Calc ratio between new and current frame duration with 3 digit */
511 unsigned int frame_duration_ratio = div64_u64(1000000,
512 (1000 + div64_u64(((unsigned long long)(
513 STATIC_SCREEN_RAMP_DELTA_REFRESH_RATE_PER_FRAME) *
514 static_ramp_variables->ramp_current_frame_duration_in_ns),
515 1000000000)));
516
517 /* Calculate delta between new and current frame duration in ns */
518 unsigned int frame_duration_delta = div64_u64(((unsigned long long)(
519 static_ramp_variables->ramp_current_frame_duration_in_ns) *
520 (1000 - frame_duration_ratio)), 1000);
521
522 /* Adjust frame duration delta based on ratio between current and
523 * standard frame duration (frame duration at 60 Hz refresh rate).
524 */
525 unsigned int ramp_rate_interpolated = div64_u64(((unsigned long long)(
526 frame_duration_delta) * static_ramp_variables->
527 ramp_current_frame_duration_in_ns), 16666666);
528
529 /* Going to a higher refresh rate (lower frame duration) */
530 if (static_ramp_variables->ramp_direction_is_up) {
531 /* reduce frame duration */
532 static_ramp_variables->ramp_current_frame_duration_in_ns -=
533 ramp_rate_interpolated;
534
535 /* min frame duration */
536 frame_duration = ((unsigned int) (div64_u64(
537 (1000000000ULL * 1000000),
538 core_freesync->map[index].state.
539 nominal_refresh_rate_in_micro_hz)));
540
541 /* adjust for frame duration below min */
542 if (static_ramp_variables->ramp_current_frame_duration_in_ns <=
543 frame_duration) {
544
545 static_ramp_variables->ramp_is_active = false;
546 static_ramp_variables->
547 ramp_current_frame_duration_in_ns =
548 frame_duration;
549 }
550 /* Going to a lower refresh rate (larger frame duration) */
551 } else {
552 /* increase frame duration */
553 static_ramp_variables->ramp_current_frame_duration_in_ns +=
554 ramp_rate_interpolated;
555
556 /* max frame duration */
557 frame_duration = ((unsigned int) (div64_u64(
558 (1000000000ULL * 1000000),
559 core_freesync->map[index].caps->min_refresh_in_micro_hz)));
560
561 /* adjust for frame duration above max */
562 if (static_ramp_variables->ramp_current_frame_duration_in_ns >=
563 frame_duration) {
564
565 static_ramp_variables->ramp_is_active = false;
566 static_ramp_variables->
567 ramp_current_frame_duration_in_ns =
568 frame_duration;
569 }
570 }
571
572 calc_v_total_from_duration(stream, static_ramp_variables->
573 ramp_current_frame_duration_in_ns, v_total);
574}
575
576static void reset_freesync_state_variables(struct freesync_state* state)
577{
578 state->static_ramp.ramp_is_active = false;
579 if (state->nominal_refresh_rate_in_micro_hz)
580 state->static_ramp.ramp_current_frame_duration_in_ns =
581 ((unsigned int) (div64_u64(
582 (1000000000ULL * 1000000),
583 state->nominal_refresh_rate_in_micro_hz)));
584
585 state->btr.btr_active = false;
586 state->btr.frame_counter = 0;
587 state->btr.frames_to_insert = 0;
588 state->btr.inserted_frame_duration_in_us = 0;
589 state->btr.program_btr = false;
590
591 state->fixed_refresh.fixed_active = false;
592 state->fixed_refresh.program_fixed = false;
593}
594/*
595 * Sets freesync mode on a stream depending on current freesync state.
596 */
597static bool set_freesync_on_streams(struct core_freesync *core_freesync,
598 struct dc_stream_state **streams, int num_streams)
599{
600 int v_total_nominal = 0, v_total_min = 0, v_total_max = 0;
601 unsigned int stream_idx, map_index = 0;
602 struct freesync_state *state;
603
604 if (num_streams == 0 || streams == NULL || num_streams > 1)
605 return false;
606
607 for (stream_idx = 0; stream_idx < num_streams; stream_idx++) {
608
609 map_index = map_index_from_stream(core_freesync,
610 streams[stream_idx]);
611
612 state = &core_freesync->map[map_index].state;
613
614 if (core_freesync->map[map_index].caps->supported) {
615
616 /* Fullscreen has the topmost priority. If the
617 * fullscreen bit is set, we are in a fullscreen
618 * application where it should not matter if it is
619 * static screen. We should not check the static_screen
620 * or video bit.
621 *
622 * Special cases of fullscreen include btr and fixed
623 * refresh. We program btr on every flip and involves
624 * programming full range right before the last inserted frame.
625 * However, we do not want to program the full freesync range
626 * when fixed refresh is active, because we only program
627 * that logic once and this will override it.
628 */
629 if (core_freesync->map[map_index].user_enable.
630 enable_for_gaming == true &&
631 state->fullscreen == true &&
632 state->fixed_refresh.fixed_active == false) {
633 /* Enable freesync */
634
635 v_total_min = state->freesync_range.vmin;
636 v_total_max = state->freesync_range.vmax;
637
638 /* Update the freesync context for the stream */
639 update_stream_freesync_context(core_freesync,
640 streams[stream_idx]);
641
642 adjust_vmin_vmax(core_freesync, streams,
643 num_streams, map_index,
644 v_total_min,
645 v_total_max);
646
647 return true;
648
649 } else if (core_freesync->map[map_index].user_enable.
650 enable_for_video && state->video == true) {
651 /* Enable 48Hz feature */
652
653 calc_v_total_from_duration(streams[stream_idx],
654 state->time.update_duration_in_ns,
655 &v_total_nominal);
656
657 /* Program only if v_total_nominal is in range*/
658 if (v_total_nominal >=
659 streams[stream_idx]->timing.v_total) {
660
661 /* Update the freesync context for
662 * the stream
663 */
664 update_stream_freesync_context(
665 core_freesync,
666 streams[stream_idx]);
667
668 adjust_vmin_vmax(
669 core_freesync, streams,
670 num_streams, map_index,
671 v_total_nominal,
672 v_total_nominal);
673 }
674 return true;
675
676 } else {
677 /* Disable freesync */
678 v_total_nominal = streams[stream_idx]->
679 timing.v_total;
680
681 /* Update the freesync context for
682 * the stream
683 */
684 update_stream_freesync_context(
685 core_freesync,
686 streams[stream_idx]);
687
688 adjust_vmin_vmax(core_freesync, streams,
689 num_streams, map_index,
690 v_total_nominal,
691 v_total_nominal);
692
693 /* Reset the cached variables */
694 reset_freesync_state_variables(state);
695
696 return true;
697 }
698 } else {
699 /* Disable freesync */
700 v_total_nominal = streams[stream_idx]->
701 timing.v_total;
702 /*
703 * we have to reset drr always even sink does
704 * not support freesync because a former stream has
705 * be programmed
706 */
707 adjust_vmin_vmax(core_freesync, streams,
708 num_streams, map_index,
709 v_total_nominal,
710 v_total_nominal);
711 /* Reset the cached variables */
712 reset_freesync_state_variables(state);
713 }
714
715 }
716
717 return false;
718}
719
720static void set_static_ramp_variables(struct core_freesync *core_freesync,
721 unsigned int index, bool enable_static_screen)
722{
723 unsigned int frame_duration = 0;
724 unsigned int nominal_refresh_rate = core_freesync->map[index].state.
725 nominal_refresh_rate_in_micro_hz;
726 unsigned int min_refresh_rate= core_freesync->map[index].caps->
727 min_refresh_in_micro_hz;
728 struct gradual_static_ramp *static_ramp_variables =
729 &core_freesync->map[index].state.static_ramp;
730
731 /* If we are ENABLING static screen, refresh rate should go DOWN.
732 * If we are DISABLING static screen, refresh rate should go UP.
733 */
734 if (enable_static_screen)
735 static_ramp_variables->ramp_direction_is_up = false;
736 else
737 static_ramp_variables->ramp_direction_is_up = true;
738
739 /* If ramp is not active, set initial frame duration depending on
740 * whether we are enabling/disabling static screen mode. If the ramp is
741 * already active, ramp should continue in the opposite direction
742 * starting with the current frame duration
743 */
744 if (!static_ramp_variables->ramp_is_active) {
745 if (enable_static_screen == true) {
746 /* Going to lower refresh rate, so start from max
747 * refresh rate (min frame duration)
748 */
749 frame_duration = ((unsigned int) (div64_u64(
750 (1000000000ULL * 1000000),
751 nominal_refresh_rate)));
752 } else {
753 /* Going to higher refresh rate, so start from min
754 * refresh rate (max frame duration)
755 */
756 frame_duration = ((unsigned int) (div64_u64(
757 (1000000000ULL * 1000000),
758 min_refresh_rate)));
759 }
760 static_ramp_variables->
761 ramp_current_frame_duration_in_ns = frame_duration;
762
763 static_ramp_variables->ramp_is_active = true;
764 }
765}
766
767void mod_freesync_handle_v_update(struct mod_freesync *mod_freesync,
768 struct dc_stream_state **streams, int num_streams)
769{
770 unsigned int index, v_total, inserted_frame_v_total = 0;
771 unsigned int min_frame_duration_in_ns, vmax, vmin = 0;
772 struct freesync_state *state;
773 struct core_freesync *core_freesync = NULL;
774 struct dc_static_screen_events triggers = {0};
775
776 if (mod_freesync == NULL)
777 return;
778
779 core_freesync = MOD_FREESYNC_TO_CORE(mod_freesync);
780
781 if (core_freesync->num_entities == 0)
782 return;
783
784 index = map_index_from_stream(core_freesync,
785 streams[0]);
786
787 if (core_freesync->map[index].caps->supported == false)
788 return;
789
790 state = &core_freesync->map[index].state;
791
792 /* Below the Range Logic */
793
794 /* Only execute if in fullscreen mode */
795 if (state->fullscreen == true &&
796 core_freesync->map[index].user_enable.enable_for_gaming &&
797 core_freesync->map[index].caps->btr_supported &&
798 state->btr.btr_active) {
799
800 /* TODO: pass in flag for Pre-DCE12 ASIC
801 * in order for frame variable duration to take affect,
802 * it needs to be done one VSYNC early, which is at
803 * frameCounter == 1.
804 * For DCE12 and newer updates to V_TOTAL_MIN/MAX
805 * will take affect on current frame
806 */
807 if (state->btr.frames_to_insert == state->btr.frame_counter) {
808
809 min_frame_duration_in_ns = ((unsigned int) (div64_u64(
810 (1000000000ULL * 1000000),
811 state->nominal_refresh_rate_in_micro_hz)));
812
813 vmin = state->freesync_range.vmin;
814
815 inserted_frame_v_total = vmin;
816
817 if (min_frame_duration_in_ns / 1000)
818 inserted_frame_v_total =
819 state->btr.inserted_frame_duration_in_us *
820 vmin / (min_frame_duration_in_ns / 1000);
821
822 /* Set length of inserted frames as v_total_max*/
823 vmax = inserted_frame_v_total;
824 vmin = inserted_frame_v_total;
825
826 /* Program V_TOTAL */
827 adjust_vmin_vmax(core_freesync, streams,
828 num_streams, index,
829 vmin, vmax);
830 }
831
832 if (state->btr.frame_counter > 0)
833 state->btr.frame_counter--;
834
835 /* Restore FreeSync */
836 if (state->btr.frame_counter == 0)
837 set_freesync_on_streams(core_freesync, streams, num_streams);
838 }
839
840 /* If in fullscreen freesync mode or in video, do not program
841 * static screen ramp values
842 */
843 if (state->fullscreen == true || state->video == true) {
844
845 state->static_ramp.ramp_is_active = false;
846
847 return;
848 }
849
850 /* Gradual Static Screen Ramping Logic */
851
852 /* Execute if ramp is active and user enabled freesync static screen*/
853 if (state->static_ramp.ramp_is_active &&
854 core_freesync->map[index].user_enable.enable_for_static) {
855
856 calc_v_total_for_static_ramp(core_freesync, streams[0],
857 index, &v_total);
858
859 /* Update the freesync context for the stream */
860 update_stream_freesync_context(core_freesync, streams[0]);
861
862 /* Program static screen ramp values */
863 adjust_vmin_vmax(core_freesync, streams,
864 num_streams, index,
865 v_total,
866 v_total);
867
868 triggers.overlay_update = true;
869 triggers.surface_update = true;
870
871 dc_stream_set_static_screen_events(core_freesync->dc, streams,
872 num_streams, &triggers);
873 }
874}
875
876void mod_freesync_update_state(struct mod_freesync *mod_freesync,
877 struct dc_stream_state **streams, int num_streams,
878 struct mod_freesync_params *freesync_params)
879{
880 bool freesync_program_required = false;
881 unsigned int stream_index;
882 struct freesync_state *state;
883 struct core_freesync *core_freesync = NULL;
884 struct dc_static_screen_events triggers = {0};
885
886 if (mod_freesync == NULL)
887 return;
888
889 core_freesync = MOD_FREESYNC_TO_CORE(mod_freesync);
890
891 if (core_freesync->num_entities == 0)
892 return;
893
894 for(stream_index = 0; stream_index < num_streams; stream_index++) {
895
896 unsigned int map_index = map_index_from_stream(core_freesync,
897 streams[stream_index]);
898
899 bool is_embedded = dc_is_embedded_signal(
900 streams[stream_index]->sink->sink_signal);
901
902 struct freesync_registry_options *opts = &core_freesync->opts;
903
904 state = &core_freesync->map[map_index].state;
905
906 switch (freesync_params->state){
907 case FREESYNC_STATE_FULLSCREEN:
908 state->fullscreen = freesync_params->enable;
909 freesync_program_required = true;
910 state->windowed_fullscreen =
911 freesync_params->windowed_fullscreen;
912 break;
913 case FREESYNC_STATE_STATIC_SCREEN:
914 /* Static screen ramp is disabled by default, but can
915 * be enabled through regkey.
916 */
917 if ((is_embedded && opts->drr_internal_supported) ||
918 (!is_embedded && opts->drr_external_supported))
919
920 if (state->static_screen !=
921 freesync_params->enable) {
922
923 /* Change the state flag */
924 state->static_screen =
925 freesync_params->enable;
926
927 /* Update static screen ramp */
928 set_static_ramp_variables(core_freesync,
929 map_index,
930 freesync_params->enable);
931 }
932 /* We program the ramp starting next VUpdate */
933 break;
934 case FREESYNC_STATE_VIDEO:
935 /* Change core variables only if there is a change*/
936 if(freesync_params->update_duration_in_ns !=
937 state->time.update_duration_in_ns) {
938
939 state->video = freesync_params->enable;
940 state->time.update_duration_in_ns =
941 freesync_params->update_duration_in_ns;
942
943 freesync_program_required = true;
944 }
945 break;
946 case FREESYNC_STATE_NONE:
947 /* handle here to avoid warning */
948 break;
949 }
950 }
951
952 /* Update mask */
953 triggers.overlay_update = true;
954 triggers.surface_update = true;
955
956 dc_stream_set_static_screen_events(core_freesync->dc, streams,
957 num_streams, &triggers);
958
959 if (freesync_program_required)
960 /* Program freesync according to current state*/
961 set_freesync_on_streams(core_freesync, streams, num_streams);
962}
963
964
965bool mod_freesync_get_state(struct mod_freesync *mod_freesync,
966 struct dc_stream_state *stream,
967 struct mod_freesync_params *freesync_params)
968{
969 unsigned int index = 0;
970 struct core_freesync *core_freesync = NULL;
971
972 if (mod_freesync == NULL)
973 return false;
974
975 core_freesync = MOD_FREESYNC_TO_CORE(mod_freesync);
976 index = map_index_from_stream(core_freesync, stream);
977
978 if (core_freesync->map[index].state.fullscreen) {
979 freesync_params->state = FREESYNC_STATE_FULLSCREEN;
980 freesync_params->enable = true;
981 } else if (core_freesync->map[index].state.static_screen) {
982 freesync_params->state = FREESYNC_STATE_STATIC_SCREEN;
983 freesync_params->enable = true;
984 } else if (core_freesync->map[index].state.video) {
985 freesync_params->state = FREESYNC_STATE_VIDEO;
986 freesync_params->enable = true;
987 } else {
988 freesync_params->state = FREESYNC_STATE_NONE;
989 freesync_params->enable = false;
990 }
991
992 freesync_params->update_duration_in_ns =
993 core_freesync->map[index].state.time.update_duration_in_ns;
994
995 freesync_params->windowed_fullscreen =
996 core_freesync->map[index].state.windowed_fullscreen;
997
998 return true;
999}
1000
1001bool mod_freesync_set_user_enable(struct mod_freesync *mod_freesync,
1002 struct dc_stream_state **streams, int num_streams,
1003 struct mod_freesync_user_enable *user_enable)
1004{
1005 unsigned int stream_index, map_index;
1006 int persistent_data = 0;
1007 struct persistent_data_flag flag;
1008 struct dc *dc = NULL;
1009 struct core_freesync *core_freesync = NULL;
1010
1011 if (mod_freesync == NULL)
1012 return false;
1013
1014 core_freesync = MOD_FREESYNC_TO_CORE(mod_freesync);
1015 dc = core_freesync->dc;
1016
1017 flag.save_per_edid = true;
1018 flag.save_per_link = false;
1019
1020 for(stream_index = 0; stream_index < num_streams;
1021 stream_index++){
1022
1023 map_index = map_index_from_stream(core_freesync,
1024 streams[stream_index]);
1025
1026 core_freesync->map[map_index].user_enable = *user_enable;
1027
1028 /* Write persistent data in registry*/
1029 if (core_freesync->map[map_index].user_enable.
1030 enable_for_gaming)
1031 persistent_data = persistent_data | 1;
1032 if (core_freesync->map[map_index].user_enable.
1033 enable_for_static)
1034 persistent_data = persistent_data | 2;
1035 if (core_freesync->map[map_index].user_enable.
1036 enable_for_video)
1037 persistent_data = persistent_data | 4;
1038
1039 dm_write_persistent_data(dc->ctx,
1040 streams[stream_index]->sink,
1041 FREESYNC_REGISTRY_NAME,
1042 "userenable",
1043 &persistent_data,
1044 sizeof(int),
1045 &flag);
1046 }
1047
1048 set_freesync_on_streams(core_freesync, streams, num_streams);
1049
1050 return true;
1051}
1052
1053bool mod_freesync_get_user_enable(struct mod_freesync *mod_freesync,
1054 struct dc_stream_state *stream,
1055 struct mod_freesync_user_enable *user_enable)
1056{
1057 unsigned int index = 0;
1058 struct core_freesync *core_freesync = NULL;
1059
1060 if (mod_freesync == NULL)
1061 return false;
1062
1063 core_freesync = MOD_FREESYNC_TO_CORE(mod_freesync);
1064 index = map_index_from_stream(core_freesync, stream);
1065
1066 *user_enable = core_freesync->map[index].user_enable;
1067
1068 return true;
1069}
1070
1071bool mod_freesync_get_static_ramp_active(struct mod_freesync *mod_freesync,
1072 struct dc_stream_state *stream,
1073 bool *is_ramp_active)
1074{
1075 unsigned int index = 0;
1076 struct core_freesync *core_freesync = NULL;
1077
1078 if (mod_freesync == NULL)
1079 return false;
1080
1081 core_freesync = MOD_FREESYNC_TO_CORE(mod_freesync);
1082 index = map_index_from_stream(core_freesync, stream);
1083
1084 *is_ramp_active =
1085 core_freesync->map[index].state.static_ramp.ramp_is_active;
1086
1087 return true;
1088}
1089
1090bool mod_freesync_override_min_max(struct mod_freesync *mod_freesync,
1091 struct dc_stream_state *streams,
1092 unsigned int min_refresh,
1093 unsigned int max_refresh,
1094 struct mod_freesync_caps *caps)
1095{
1096 unsigned int index = 0;
1097 struct core_freesync *core_freesync;
1098 struct freesync_state *state;
1099
1100 if (mod_freesync == NULL)
1101 return false;
1102
1103 core_freesync = MOD_FREESYNC_TO_CORE(mod_freesync);
1104 index = map_index_from_stream(core_freesync, streams);
1105 state = &core_freesync->map[index].state;
1106
1107 if (max_refresh == 0)
1108 max_refresh = state->nominal_refresh_rate_in_micro_hz;
1109
1110 if (min_refresh == 0) {
1111 /* Restore defaults */
1112 calc_freesync_range(core_freesync, streams, state,
1113 core_freesync->map[index].caps->
1114 min_refresh_in_micro_hz,
1115 state->nominal_refresh_rate_in_micro_hz);
1116 } else {
1117 calc_freesync_range(core_freesync, streams,
1118 state,
1119 min_refresh,
1120 max_refresh);
1121
1122 /* Program vtotal min/max */
1123 adjust_vmin_vmax(core_freesync, &streams, 1, index,
1124 state->freesync_range.vmin,
1125 state->freesync_range.vmax);
1126 }
1127
1128 if (min_refresh != 0 &&
1129 dc_is_embedded_signal(streams->sink->sink_signal) &&
1130 (max_refresh - min_refresh >= 10000000)) {
1131 caps->supported = true;
1132 caps->min_refresh_in_micro_hz = min_refresh;
1133 caps->max_refresh_in_micro_hz = max_refresh;
1134 }
1135
1136 /* Update the stream */
1137 update_stream(core_freesync, streams);
1138
1139 return true;
1140}
1141
1142bool mod_freesync_get_min_max(struct mod_freesync *mod_freesync,
1143 struct dc_stream_state *stream,
1144 unsigned int *min_refresh,
1145 unsigned int *max_refresh)
1146{
1147 unsigned int index = 0;
1148 struct core_freesync *core_freesync = NULL;
1149
1150 if (mod_freesync == NULL)
1151 return false;
1152
1153 core_freesync = MOD_FREESYNC_TO_CORE(mod_freesync);
1154 index = map_index_from_stream(core_freesync, stream);
1155
1156 *min_refresh =
1157 core_freesync->map[index].state.freesync_range.min_refresh;
1158 *max_refresh =
1159 core_freesync->map[index].state.freesync_range.max_refresh;
1160
1161 return true;
1162}
1163
1164bool mod_freesync_get_vmin_vmax(struct mod_freesync *mod_freesync,
1165 struct dc_stream_state *stream,
1166 unsigned int *vmin,
1167 unsigned int *vmax)
1168{
1169 unsigned int index = 0;
1170 struct core_freesync *core_freesync = NULL;
1171
1172 if (mod_freesync == NULL)
1173 return false;
1174
1175 core_freesync = MOD_FREESYNC_TO_CORE(mod_freesync);
1176 index = map_index_from_stream(core_freesync, stream);
1177
1178 *vmin =
1179 core_freesync->map[index].state.freesync_range.vmin;
1180 *vmax =
1181 core_freesync->map[index].state.freesync_range.vmax;
1182
1183 return true;
1184}
1185
1186bool mod_freesync_get_v_position(struct mod_freesync *mod_freesync,
1187 struct dc_stream_state *stream,
1188 unsigned int *nom_v_pos,
1189 unsigned int *v_pos)
1190{
1191 unsigned int index = 0;
1192 struct core_freesync *core_freesync = NULL;
1193 struct crtc_position position;
1194
1195 if (mod_freesync == NULL)
1196 return false;
1197
1198 core_freesync = MOD_FREESYNC_TO_CORE(mod_freesync);
1199 index = map_index_from_stream(core_freesync, stream);
1200
1201 if (dc_stream_get_crtc_position(core_freesync->dc, &stream, 1,
1202 &position.vertical_count,
1203 &position.nominal_vcount)) {
1204
1205 *nom_v_pos = position.nominal_vcount;
1206 *v_pos = position.vertical_count;
1207
1208 return true;
1209 }
1210
1211 return false;
1212}
1213
1214void mod_freesync_notify_mode_change(struct mod_freesync *mod_freesync,
1215 struct dc_stream_state **streams, int num_streams)
1216{
1217 unsigned int stream_index, map_index;
1218 struct freesync_state *state;
1219 struct core_freesync *core_freesync = NULL;
1220 struct dc_static_screen_events triggers = {0};
1221 unsigned long long temp = 0;
1222
1223 if (mod_freesync == NULL)
1224 return;
1225
1226 core_freesync = MOD_FREESYNC_TO_CORE(mod_freesync);
1227
1228 for (stream_index = 0; stream_index < num_streams; stream_index++) {
1229 map_index = map_index_from_stream(core_freesync,
1230 streams[stream_index]);
1231
1232 state = &core_freesync->map[map_index].state;
1233
1234 /* Update the field rate for new timing */
1235 temp = streams[stream_index]->timing.pix_clk_khz;
1236 temp *= 1000ULL * 1000ULL * 1000ULL;
1237 temp = div_u64(temp,
1238 streams[stream_index]->timing.h_total);
1239 temp = div_u64(temp,
1240 streams[stream_index]->timing.v_total);
1241 state->nominal_refresh_rate_in_micro_hz =
1242 (unsigned int) temp;
1243
1244 if (core_freesync->map[map_index].caps->supported) {
1245
1246 /* Update the stream */
1247 update_stream(core_freesync, streams[stream_index]);
1248
1249 /* Calculate vmin/vmax and refresh rate for
1250 * current mode
1251 */
1252 calc_freesync_range(core_freesync, *streams, state,
1253 core_freesync->map[map_index].caps->
1254 min_refresh_in_micro_hz,
1255 state->nominal_refresh_rate_in_micro_hz);
1256
1257 /* Update mask */
1258 triggers.overlay_update = true;
1259 triggers.surface_update = true;
1260
1261 dc_stream_set_static_screen_events(core_freesync->dc,
1262 streams, num_streams,
1263 &triggers);
1264 }
1265 }
1266
1267 /* Program freesync according to current state*/
1268 set_freesync_on_streams(core_freesync, streams, num_streams);
1269}
1270
1271/* Add the timestamps to the cache and determine whether BTR programming
1272 * is required, depending on the times calculated
1273 */
1274static void update_timestamps(struct core_freesync *core_freesync,
1275 const struct dc_stream_state *stream, unsigned int map_index,
1276 unsigned int last_render_time_in_us)
1277{
1278 struct freesync_state *state = &core_freesync->map[map_index].state;
1279
1280 state->time.render_times[state->time.render_times_index] =
1281 last_render_time_in_us;
1282 state->time.render_times_index++;
1283
1284 if (state->time.render_times_index >= RENDER_TIMES_MAX_COUNT)
1285 state->time.render_times_index = 0;
1286
1287 if (last_render_time_in_us + BTR_EXIT_MARGIN <
1288 state->time.max_render_time_in_us) {
1289
1290 /* Exit Below the Range */
1291 if (state->btr.btr_active) {
1292
1293 state->btr.program_btr = true;
1294 state->btr.btr_active = false;
1295 state->btr.frame_counter = 0;
1296
1297 /* Exit Fixed Refresh mode */
1298 } else if (state->fixed_refresh.fixed_active) {
1299
1300 state->fixed_refresh.frame_counter++;
1301
1302 if (state->fixed_refresh.frame_counter >
1303 FIXED_REFRESH_EXIT_FRAME_COUNT) {
1304 state->fixed_refresh.frame_counter = 0;
1305 state->fixed_refresh.program_fixed = true;
1306 state->fixed_refresh.fixed_active = false;
1307 }
1308 }
1309
1310 } else if (last_render_time_in_us > state->time.max_render_time_in_us) {
1311
1312 /* Enter Below the Range */
1313 if (!state->btr.btr_active &&
1314 core_freesync->map[map_index].caps->btr_supported) {
1315
1316 state->btr.program_btr = true;
1317 state->btr.btr_active = true;
1318
1319 /* Enter Fixed Refresh mode */
1320 } else if (!state->fixed_refresh.fixed_active &&
1321 !core_freesync->map[map_index].caps->btr_supported) {
1322
1323 state->fixed_refresh.frame_counter++;
1324
1325 if (state->fixed_refresh.frame_counter >
1326 FIXED_REFRESH_ENTER_FRAME_COUNT) {
1327 state->fixed_refresh.frame_counter = 0;
1328 state->fixed_refresh.program_fixed = true;
1329 state->fixed_refresh.fixed_active = true;
1330 }
1331 }
1332 }
1333
1334 /* When Below the Range is active, must react on every frame */
1335 if (state->btr.btr_active)
1336 state->btr.program_btr = true;
1337}
1338
1339static void apply_below_the_range(struct core_freesync *core_freesync,
1340 struct dc_stream_state *stream, unsigned int map_index,
1341 unsigned int last_render_time_in_us)
1342{
1343 unsigned int inserted_frame_duration_in_us = 0;
1344 unsigned int mid_point_frames_ceil = 0;
1345 unsigned int mid_point_frames_floor = 0;
1346 unsigned int frame_time_in_us = 0;
1347 unsigned int delta_from_mid_point_in_us_1 = 0xFFFFFFFF;
1348 unsigned int delta_from_mid_point_in_us_2 = 0xFFFFFFFF;
1349 unsigned int frames_to_insert = 0;
1350 unsigned int min_frame_duration_in_ns = 0;
1351 struct freesync_state *state = &core_freesync->map[map_index].state;
1352
1353 if (!state->btr.program_btr)
1354 return;
1355
1356 state->btr.program_btr = false;
1357
1358 min_frame_duration_in_ns = ((unsigned int) (div64_u64(
1359 (1000000000ULL * 1000000),
1360 state->nominal_refresh_rate_in_micro_hz)));
1361
1362 /* Program BTR */
1363
1364 /* BTR set to "not active" so disengage */
1365 if (!state->btr.btr_active)
1366
1367 /* Restore FreeSync */
1368 set_freesync_on_streams(core_freesync, &stream, 1);
1369
1370 /* BTR set to "active" so engage */
1371 else {
1372
1373 /* Calculate number of midPoint frames that could fit within
1374 * the render time interval- take ceil of this value
1375 */
1376 mid_point_frames_ceil = (last_render_time_in_us +
1377 state->btr.mid_point_in_us- 1) /
1378 state->btr.mid_point_in_us;
1379
1380 if (mid_point_frames_ceil > 0) {
1381
1382 frame_time_in_us = last_render_time_in_us /
1383 mid_point_frames_ceil;
1384 delta_from_mid_point_in_us_1 =
1385 (state->btr.mid_point_in_us >
1386 frame_time_in_us) ?
1387 (state->btr.mid_point_in_us - frame_time_in_us):
1388 (frame_time_in_us - state->btr.mid_point_in_us);
1389 }
1390
1391 /* Calculate number of midPoint frames that could fit within
1392 * the render time interval- take floor of this value
1393 */
1394 mid_point_frames_floor = last_render_time_in_us /
1395 state->btr.mid_point_in_us;
1396
1397 if (mid_point_frames_floor > 0) {
1398
1399 frame_time_in_us = last_render_time_in_us /
1400 mid_point_frames_floor;
1401 delta_from_mid_point_in_us_2 =
1402 (state->btr.mid_point_in_us >
1403 frame_time_in_us) ?
1404 (state->btr.mid_point_in_us - frame_time_in_us):
1405 (frame_time_in_us - state->btr.mid_point_in_us);
1406 }
1407
1408 /* Choose number of frames to insert based on how close it
1409 * can get to the mid point of the variable range.
1410 */
1411 if (delta_from_mid_point_in_us_1 < delta_from_mid_point_in_us_2)
1412 frames_to_insert = mid_point_frames_ceil;
1413 else
1414 frames_to_insert = mid_point_frames_floor;
1415
1416 /* Either we've calculated the number of frames to insert,
1417 * or we need to insert min duration frames
1418 */
1419 if (frames_to_insert > 0)
1420 inserted_frame_duration_in_us = last_render_time_in_us /
1421 frames_to_insert;
1422
1423 if (inserted_frame_duration_in_us <
1424 state->time.min_render_time_in_us)
1425
1426 inserted_frame_duration_in_us =
1427 state->time.min_render_time_in_us;
1428
1429 /* Cache the calculated variables */
1430 state->btr.inserted_frame_duration_in_us =
1431 inserted_frame_duration_in_us;
1432 state->btr.frames_to_insert = frames_to_insert;
1433 state->btr.frame_counter = frames_to_insert;
1434
1435 }
1436}
1437
1438static void apply_fixed_refresh(struct core_freesync *core_freesync,
1439 struct dc_stream_state *stream, unsigned int map_index)
1440{
1441 unsigned int vmin = 0, vmax = 0;
1442 struct freesync_state *state = &core_freesync->map[map_index].state;
1443
1444 if (!state->fixed_refresh.program_fixed)
1445 return;
1446
1447 state->fixed_refresh.program_fixed = false;
1448
1449 /* Program Fixed Refresh */
1450
1451 /* Fixed Refresh set to "not active" so disengage */
1452 if (!state->fixed_refresh.fixed_active) {
1453 set_freesync_on_streams(core_freesync, &stream, 1);
1454
1455 /* Fixed Refresh set to "active" so engage (fix to max) */
1456 } else {
1457
1458 vmin = state->freesync_range.vmin;
1459 vmax = vmin;
1460 adjust_vmin_vmax(core_freesync, &stream, map_index,
1461 1, vmin, vmax);
1462 }
1463}
1464
1465void mod_freesync_pre_update_plane_addresses(struct mod_freesync *mod_freesync,
1466 struct dc_stream_state **streams, int num_streams,
1467 unsigned int curr_time_stamp_in_us)
1468{
1469 unsigned int stream_index, map_index, last_render_time_in_us = 0;
1470 struct core_freesync *core_freesync = NULL;
1471
1472 if (mod_freesync == NULL)
1473 return;
1474
1475 core_freesync = MOD_FREESYNC_TO_CORE(mod_freesync);
1476
1477 for (stream_index = 0; stream_index < num_streams; stream_index++) {
1478
1479 map_index = map_index_from_stream(core_freesync,
1480 streams[stream_index]);
1481
1482 if (core_freesync->map[map_index].caps->supported) {
1483
1484 last_render_time_in_us = curr_time_stamp_in_us -
1485 core_freesync->map[map_index].state.time.
1486 prev_time_stamp_in_us;
1487
1488 /* Add the timestamps to the cache and determine
1489 * whether BTR program is required
1490 */
1491 update_timestamps(core_freesync, streams[stream_index],
1492 map_index, last_render_time_in_us);
1493
1494 if (core_freesync->map[map_index].state.fullscreen &&
1495 core_freesync->map[map_index].user_enable.
1496 enable_for_gaming) {
1497
1498 if (core_freesync->map[map_index].caps->btr_supported) {
1499
1500 apply_below_the_range(core_freesync,
1501 streams[stream_index], map_index,
1502 last_render_time_in_us);
1503 } else {
1504 apply_fixed_refresh(core_freesync,
1505 streams[stream_index], map_index);
1506 }
1507 }
1508
1509 core_freesync->map[map_index].state.time.
1510 prev_time_stamp_in_us = curr_time_stamp_in_us;
1511 }
1512
1513 }
1514}
1515
1516void mod_freesync_get_settings(struct mod_freesync *mod_freesync,
1517 struct dc_stream_state **streams, int num_streams,
1518 unsigned int *v_total_min, unsigned int *v_total_max,
1519 unsigned int *event_triggers,
1520 unsigned int *window_min, unsigned int *window_max,
1521 unsigned int *lfc_mid_point_in_us,
1522 unsigned int *inserted_frames,
1523 unsigned int *inserted_duration_in_us)
1524{
1525 unsigned int stream_index, map_index;
1526 struct core_freesync *core_freesync = NULL;
1527
1528 if (mod_freesync == NULL)
1529 return;
1530
1531 core_freesync = MOD_FREESYNC_TO_CORE(mod_freesync);
1532
1533 for (stream_index = 0; stream_index < num_streams; stream_index++) {
1534
1535 map_index = map_index_from_stream(core_freesync,
1536 streams[stream_index]);
1537
1538 if (core_freesync->map[map_index].caps->supported) {
1539 struct freesync_state state =
1540 core_freesync->map[map_index].state;
1541 *v_total_min = state.vmin;
1542 *v_total_max = state.vmax;
1543 *event_triggers = 0;
1544 *window_min = state.time.min_window;
1545 *window_max = state.time.max_window;
1546 *lfc_mid_point_in_us = state.btr.mid_point_in_us;
1547 *inserted_frames = state.btr.frames_to_insert;
1548 *inserted_duration_in_us =
1549 state.btr.inserted_frame_duration_in_us;
1550 }
1551
1552 }
1553}
1554
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#include <linux/slab.h>
27
28#include "dm_services.h"
29#include "dc.h"
30#include "mod_freesync.h"
31#include "core_types.h"
32
33#define MOD_FREESYNC_MAX_CONCURRENT_STREAMS 32
34
35#define MIN_REFRESH_RANGE_IN_US 10000000
36/* Refresh rate ramp at a fixed rate of 65 Hz/second */
37#define STATIC_SCREEN_RAMP_DELTA_REFRESH_RATE_PER_FRAME ((1000 / 60) * 65)
38/* Number of elements in the render times cache array */
39#define RENDER_TIMES_MAX_COUNT 10
40/* Threshold to exit BTR (to avoid frequent enter-exits at the lower limit) */
41#define BTR_EXIT_MARGIN 2000
42/* Threshold to change BTR multiplier (to avoid frequent changes) */
43#define BTR_DRIFT_MARGIN 2000
44/*Threshold to exit fixed refresh rate*/
45#define FIXED_REFRESH_EXIT_MARGIN_IN_HZ 4
46/* Number of consecutive frames to check before entering/exiting fixed refresh*/
47#define FIXED_REFRESH_ENTER_FRAME_COUNT 5
48#define FIXED_REFRESH_EXIT_FRAME_COUNT 5
49
50struct core_freesync {
51 struct mod_freesync public;
52 struct dc *dc;
53};
54
55#define MOD_FREESYNC_TO_CORE(mod_freesync)\
56 container_of(mod_freesync, struct core_freesync, public)
57
58struct mod_freesync *mod_freesync_create(struct dc *dc)
59{
60 struct core_freesync *core_freesync =
61 kzalloc(sizeof(struct core_freesync), GFP_KERNEL);
62
63 if (core_freesync == NULL)
64 goto fail_alloc_context;
65
66 if (dc == NULL)
67 goto fail_construct;
68
69 core_freesync->dc = dc;
70 return &core_freesync->public;
71
72fail_construct:
73 kfree(core_freesync);
74
75fail_alloc_context:
76 return NULL;
77}
78
79void mod_freesync_destroy(struct mod_freesync *mod_freesync)
80{
81 struct core_freesync *core_freesync = NULL;
82 if (mod_freesync == NULL)
83 return;
84 core_freesync = MOD_FREESYNC_TO_CORE(mod_freesync);
85 kfree(core_freesync);
86}
87
88#if 0 /* unused currently */
89static unsigned int calc_refresh_in_uhz_from_duration(
90 unsigned int duration_in_ns)
91{
92 unsigned int refresh_in_uhz =
93 ((unsigned int)(div64_u64((1000000000ULL * 1000000),
94 duration_in_ns)));
95 return refresh_in_uhz;
96}
97#endif
98
99static unsigned int calc_duration_in_us_from_refresh_in_uhz(
100 unsigned int refresh_in_uhz)
101{
102 unsigned int duration_in_us =
103 ((unsigned int)(div64_u64((1000000000ULL * 1000),
104 refresh_in_uhz)));
105 return duration_in_us;
106}
107
108static unsigned int calc_duration_in_us_from_v_total(
109 const struct dc_stream_state *stream,
110 const struct mod_vrr_params *in_vrr,
111 unsigned int v_total)
112{
113 unsigned int duration_in_us =
114 (unsigned int)(div64_u64(((unsigned long long)(v_total)
115 * 10000) * stream->timing.h_total,
116 stream->timing.pix_clk_100hz));
117
118 return duration_in_us;
119}
120
121static unsigned int calc_v_total_from_refresh(
122 const struct dc_stream_state *stream,
123 unsigned int refresh_in_uhz)
124{
125 unsigned int v_total = stream->timing.v_total;
126 unsigned int frame_duration_in_ns;
127
128 frame_duration_in_ns =
129 ((unsigned int)(div64_u64((1000000000ULL * 1000000),
130 refresh_in_uhz)));
131
132 v_total = div64_u64(div64_u64(((unsigned long long)(
133 frame_duration_in_ns) * (stream->timing.pix_clk_100hz / 10)),
134 stream->timing.h_total), 1000000);
135
136 /* v_total cannot be less than nominal */
137 if (v_total < stream->timing.v_total) {
138 ASSERT(v_total < stream->timing.v_total);
139 v_total = stream->timing.v_total;
140 }
141
142 return v_total;
143}
144
145static unsigned int calc_v_total_from_duration(
146 const struct dc_stream_state *stream,
147 const struct mod_vrr_params *vrr,
148 unsigned int duration_in_us)
149{
150 unsigned int v_total = 0;
151
152 if (duration_in_us < vrr->min_duration_in_us)
153 duration_in_us = vrr->min_duration_in_us;
154
155 if (duration_in_us > vrr->max_duration_in_us)
156 duration_in_us = vrr->max_duration_in_us;
157
158 v_total = div64_u64(div64_u64(((unsigned long long)(
159 duration_in_us) * (stream->timing.pix_clk_100hz / 10)),
160 stream->timing.h_total), 1000);
161
162 /* v_total cannot be less than nominal */
163 if (v_total < stream->timing.v_total) {
164 ASSERT(v_total < stream->timing.v_total);
165 v_total = stream->timing.v_total;
166 }
167
168 return v_total;
169}
170
171static void update_v_total_for_static_ramp(
172 struct core_freesync *core_freesync,
173 const struct dc_stream_state *stream,
174 struct mod_vrr_params *in_out_vrr)
175{
176 unsigned int v_total = 0;
177 unsigned int current_duration_in_us =
178 calc_duration_in_us_from_v_total(
179 stream, in_out_vrr,
180 in_out_vrr->adjust.v_total_max);
181 unsigned int target_duration_in_us =
182 calc_duration_in_us_from_refresh_in_uhz(
183 in_out_vrr->fixed.target_refresh_in_uhz);
184 bool ramp_direction_is_up = (current_duration_in_us >
185 target_duration_in_us) ? true : false;
186
187 /* Calc ratio between new and current frame duration with 3 digit */
188 unsigned int frame_duration_ratio = div64_u64(1000000,
189 (1000 + div64_u64(((unsigned long long)(
190 STATIC_SCREEN_RAMP_DELTA_REFRESH_RATE_PER_FRAME) *
191 current_duration_in_us),
192 1000000)));
193
194 /* Calculate delta between new and current frame duration in us */
195 unsigned int frame_duration_delta = div64_u64(((unsigned long long)(
196 current_duration_in_us) *
197 (1000 - frame_duration_ratio)), 1000);
198
199 /* Adjust frame duration delta based on ratio between current and
200 * standard frame duration (frame duration at 60 Hz refresh rate).
201 */
202 unsigned int ramp_rate_interpolated = div64_u64(((unsigned long long)(
203 frame_duration_delta) * current_duration_in_us), 16666);
204
205 /* Going to a higher refresh rate (lower frame duration) */
206 if (ramp_direction_is_up) {
207 /* reduce frame duration */
208 current_duration_in_us -= ramp_rate_interpolated;
209
210 /* adjust for frame duration below min */
211 if (current_duration_in_us <= target_duration_in_us) {
212 in_out_vrr->fixed.ramping_active = false;
213 in_out_vrr->fixed.ramping_done = true;
214 current_duration_in_us =
215 calc_duration_in_us_from_refresh_in_uhz(
216 in_out_vrr->fixed.target_refresh_in_uhz);
217 }
218 /* Going to a lower refresh rate (larger frame duration) */
219 } else {
220 /* increase frame duration */
221 current_duration_in_us += ramp_rate_interpolated;
222
223 /* adjust for frame duration above max */
224 if (current_duration_in_us >= target_duration_in_us) {
225 in_out_vrr->fixed.ramping_active = false;
226 in_out_vrr->fixed.ramping_done = true;
227 current_duration_in_us =
228 calc_duration_in_us_from_refresh_in_uhz(
229 in_out_vrr->fixed.target_refresh_in_uhz);
230 }
231 }
232
233 v_total = div64_u64(div64_u64(((unsigned long long)(
234 current_duration_in_us) * (stream->timing.pix_clk_100hz / 10)),
235 stream->timing.h_total), 1000);
236
237 in_out_vrr->adjust.v_total_min = v_total;
238 in_out_vrr->adjust.v_total_max = v_total;
239}
240
241static void apply_below_the_range(struct core_freesync *core_freesync,
242 const struct dc_stream_state *stream,
243 unsigned int last_render_time_in_us,
244 struct mod_vrr_params *in_out_vrr)
245{
246 unsigned int inserted_frame_duration_in_us = 0;
247 unsigned int mid_point_frames_ceil = 0;
248 unsigned int mid_point_frames_floor = 0;
249 unsigned int frame_time_in_us = 0;
250 unsigned int delta_from_mid_point_in_us_1 = 0xFFFFFFFF;
251 unsigned int delta_from_mid_point_in_us_2 = 0xFFFFFFFF;
252 unsigned int frames_to_insert = 0;
253 unsigned int min_frame_duration_in_ns = 0;
254 unsigned int max_render_time_in_us = in_out_vrr->max_duration_in_us;
255 unsigned int delta_from_mid_point_delta_in_us;
256
257 min_frame_duration_in_ns = ((unsigned int) (div64_u64(
258 (1000000000ULL * 1000000),
259 in_out_vrr->max_refresh_in_uhz)));
260
261 /* Program BTR */
262 if (last_render_time_in_us + BTR_EXIT_MARGIN < max_render_time_in_us) {
263 /* Exit Below the Range */
264 if (in_out_vrr->btr.btr_active) {
265 in_out_vrr->btr.frame_counter = 0;
266 in_out_vrr->btr.btr_active = false;
267 }
268 } else if (last_render_time_in_us > max_render_time_in_us) {
269 /* Enter Below the Range */
270 in_out_vrr->btr.btr_active = true;
271 }
272
273 /* BTR set to "not active" so disengage */
274 if (!in_out_vrr->btr.btr_active) {
275 in_out_vrr->btr.inserted_duration_in_us = 0;
276 in_out_vrr->btr.frames_to_insert = 0;
277 in_out_vrr->btr.frame_counter = 0;
278
279 /* Restore FreeSync */
280 in_out_vrr->adjust.v_total_min =
281 calc_v_total_from_refresh(stream,
282 in_out_vrr->max_refresh_in_uhz);
283 in_out_vrr->adjust.v_total_max =
284 calc_v_total_from_refresh(stream,
285 in_out_vrr->min_refresh_in_uhz);
286 /* BTR set to "active" so engage */
287 } else {
288
289 /* Calculate number of midPoint frames that could fit within
290 * the render time interval- take ceil of this value
291 */
292 mid_point_frames_ceil = (last_render_time_in_us +
293 in_out_vrr->btr.mid_point_in_us - 1) /
294 in_out_vrr->btr.mid_point_in_us;
295
296 if (mid_point_frames_ceil > 0) {
297 frame_time_in_us = last_render_time_in_us /
298 mid_point_frames_ceil;
299 delta_from_mid_point_in_us_1 =
300 (in_out_vrr->btr.mid_point_in_us >
301 frame_time_in_us) ?
302 (in_out_vrr->btr.mid_point_in_us - frame_time_in_us) :
303 (frame_time_in_us - in_out_vrr->btr.mid_point_in_us);
304 }
305
306 /* Calculate number of midPoint frames that could fit within
307 * the render time interval- take floor of this value
308 */
309 mid_point_frames_floor = last_render_time_in_us /
310 in_out_vrr->btr.mid_point_in_us;
311
312 if (mid_point_frames_floor > 0) {
313
314 frame_time_in_us = last_render_time_in_us /
315 mid_point_frames_floor;
316 delta_from_mid_point_in_us_2 =
317 (in_out_vrr->btr.mid_point_in_us >
318 frame_time_in_us) ?
319 (in_out_vrr->btr.mid_point_in_us - frame_time_in_us) :
320 (frame_time_in_us - in_out_vrr->btr.mid_point_in_us);
321 }
322
323 /* Choose number of frames to insert based on how close it
324 * can get to the mid point of the variable range.
325 */
326 if (delta_from_mid_point_in_us_1 < delta_from_mid_point_in_us_2) {
327 frames_to_insert = mid_point_frames_ceil;
328 delta_from_mid_point_delta_in_us = delta_from_mid_point_in_us_2 -
329 delta_from_mid_point_in_us_1;
330 } else {
331 frames_to_insert = mid_point_frames_floor;
332 delta_from_mid_point_delta_in_us = delta_from_mid_point_in_us_1 -
333 delta_from_mid_point_in_us_2;
334 }
335
336 /* Prefer current frame multiplier when BTR is enabled unless it drifts
337 * too far from the midpoint
338 */
339 if (in_out_vrr->btr.frames_to_insert != 0 &&
340 delta_from_mid_point_delta_in_us < BTR_DRIFT_MARGIN) {
341 if (((last_render_time_in_us / in_out_vrr->btr.frames_to_insert) <
342 in_out_vrr->max_duration_in_us) &&
343 ((last_render_time_in_us / in_out_vrr->btr.frames_to_insert) >
344 in_out_vrr->min_duration_in_us))
345 frames_to_insert = in_out_vrr->btr.frames_to_insert;
346 }
347
348 /* Either we've calculated the number of frames to insert,
349 * or we need to insert min duration frames
350 */
351 if (last_render_time_in_us / frames_to_insert <
352 in_out_vrr->min_duration_in_us){
353 frames_to_insert -= (frames_to_insert > 1) ?
354 1 : 0;
355 }
356
357 if (frames_to_insert > 0)
358 inserted_frame_duration_in_us = last_render_time_in_us /
359 frames_to_insert;
360
361 if (inserted_frame_duration_in_us < in_out_vrr->min_duration_in_us)
362 inserted_frame_duration_in_us = in_out_vrr->min_duration_in_us;
363
364 /* Cache the calculated variables */
365 in_out_vrr->btr.inserted_duration_in_us =
366 inserted_frame_duration_in_us;
367 in_out_vrr->btr.frames_to_insert = frames_to_insert;
368 in_out_vrr->btr.frame_counter = frames_to_insert;
369 }
370}
371
372static void apply_fixed_refresh(struct core_freesync *core_freesync,
373 const struct dc_stream_state *stream,
374 unsigned int last_render_time_in_us,
375 struct mod_vrr_params *in_out_vrr)
376{
377 bool update = false;
378 unsigned int max_render_time_in_us = in_out_vrr->max_duration_in_us;
379
380 //Compute the exit refresh rate and exit frame duration
381 unsigned int exit_refresh_rate_in_milli_hz = ((1000000000/max_render_time_in_us)
382 + (1000*FIXED_REFRESH_EXIT_MARGIN_IN_HZ));
383 unsigned int exit_frame_duration_in_us = 1000000000/exit_refresh_rate_in_milli_hz;
384
385 if (last_render_time_in_us < exit_frame_duration_in_us) {
386 /* Exit Fixed Refresh mode */
387 if (in_out_vrr->fixed.fixed_active) {
388 in_out_vrr->fixed.frame_counter++;
389
390 if (in_out_vrr->fixed.frame_counter >
391 FIXED_REFRESH_EXIT_FRAME_COUNT) {
392 in_out_vrr->fixed.frame_counter = 0;
393 in_out_vrr->fixed.fixed_active = false;
394 in_out_vrr->fixed.target_refresh_in_uhz = 0;
395 update = true;
396 }
397 }
398 } else if (last_render_time_in_us > max_render_time_in_us) {
399 /* Enter Fixed Refresh mode */
400 if (!in_out_vrr->fixed.fixed_active) {
401 in_out_vrr->fixed.frame_counter++;
402
403 if (in_out_vrr->fixed.frame_counter >
404 FIXED_REFRESH_ENTER_FRAME_COUNT) {
405 in_out_vrr->fixed.frame_counter = 0;
406 in_out_vrr->fixed.fixed_active = true;
407 in_out_vrr->fixed.target_refresh_in_uhz =
408 in_out_vrr->max_refresh_in_uhz;
409 update = true;
410 }
411 }
412 }
413
414 if (update) {
415 if (in_out_vrr->fixed.fixed_active) {
416 in_out_vrr->adjust.v_total_min =
417 calc_v_total_from_refresh(
418 stream, in_out_vrr->max_refresh_in_uhz);
419 in_out_vrr->adjust.v_total_max =
420 in_out_vrr->adjust.v_total_min;
421 } else {
422 in_out_vrr->adjust.v_total_min =
423 calc_v_total_from_refresh(stream,
424 in_out_vrr->max_refresh_in_uhz);
425 in_out_vrr->adjust.v_total_max =
426 calc_v_total_from_refresh(stream,
427 in_out_vrr->min_refresh_in_uhz);
428 }
429 }
430}
431
432static bool vrr_settings_require_update(struct core_freesync *core_freesync,
433 struct mod_freesync_config *in_config,
434 unsigned int min_refresh_in_uhz,
435 unsigned int max_refresh_in_uhz,
436 struct mod_vrr_params *in_vrr)
437{
438 if (in_vrr->state != in_config->state) {
439 return true;
440 } else if (in_vrr->state == VRR_STATE_ACTIVE_FIXED &&
441 in_vrr->fixed.target_refresh_in_uhz !=
442 in_config->min_refresh_in_uhz) {
443 return true;
444 } else if (in_vrr->min_refresh_in_uhz != min_refresh_in_uhz) {
445 return true;
446 } else if (in_vrr->max_refresh_in_uhz != max_refresh_in_uhz) {
447 return true;
448 }
449
450 return false;
451}
452
453bool mod_freesync_get_vmin_vmax(struct mod_freesync *mod_freesync,
454 const struct dc_stream_state *stream,
455 unsigned int *vmin,
456 unsigned int *vmax)
457{
458 *vmin = stream->adjust.v_total_min;
459 *vmax = stream->adjust.v_total_max;
460
461 return true;
462}
463
464bool mod_freesync_get_v_position(struct mod_freesync *mod_freesync,
465 struct dc_stream_state *stream,
466 unsigned int *nom_v_pos,
467 unsigned int *v_pos)
468{
469 struct core_freesync *core_freesync = NULL;
470 struct crtc_position position;
471
472 if (mod_freesync == NULL)
473 return false;
474
475 core_freesync = MOD_FREESYNC_TO_CORE(mod_freesync);
476
477 if (dc_stream_get_crtc_position(core_freesync->dc, &stream, 1,
478 &position.vertical_count,
479 &position.nominal_vcount)) {
480
481 *nom_v_pos = position.nominal_vcount;
482 *v_pos = position.vertical_count;
483
484 return true;
485 }
486
487 return false;
488}
489
490static void build_vrr_infopacket_data(const struct mod_vrr_params *vrr,
491 struct dc_info_packet *infopacket)
492{
493 /* PB1 = 0x1A (24bit AMD IEEE OUI (0x00001A) - Byte 0) */
494 infopacket->sb[1] = 0x1A;
495
496 /* PB2 = 0x00 (24bit AMD IEEE OUI (0x00001A) - Byte 1) */
497 infopacket->sb[2] = 0x00;
498
499 /* PB3 = 0x00 (24bit AMD IEEE OUI (0x00001A) - Byte 2) */
500 infopacket->sb[3] = 0x00;
501
502 /* PB4 = Reserved */
503
504 /* PB5 = Reserved */
505
506 /* PB6 = [Bits 7:3 = Reserved] */
507
508 /* PB6 = [Bit 0 = FreeSync Supported] */
509 if (vrr->state != VRR_STATE_UNSUPPORTED)
510 infopacket->sb[6] |= 0x01;
511
512 /* PB6 = [Bit 1 = FreeSync Enabled] */
513 if (vrr->state != VRR_STATE_DISABLED &&
514 vrr->state != VRR_STATE_UNSUPPORTED)
515 infopacket->sb[6] |= 0x02;
516
517 /* PB6 = [Bit 2 = FreeSync Active] */
518 if (vrr->state == VRR_STATE_ACTIVE_VARIABLE ||
519 vrr->state == VRR_STATE_ACTIVE_FIXED)
520 infopacket->sb[6] |= 0x04;
521
522 /* PB7 = FreeSync Minimum refresh rate (Hz) */
523 infopacket->sb[7] = (unsigned char)(vrr->min_refresh_in_uhz / 1000000);
524
525 /* PB8 = FreeSync Maximum refresh rate (Hz)
526 * Note: We should never go above the field rate of the mode timing set.
527 */
528 infopacket->sb[8] = (unsigned char)(vrr->max_refresh_in_uhz / 1000000);
529
530
531 //FreeSync HDR
532 infopacket->sb[9] = 0;
533 infopacket->sb[10] = 0;
534}
535
536static void build_vrr_infopacket_fs2_data(enum color_transfer_func app_tf,
537 struct dc_info_packet *infopacket)
538{
539 if (app_tf != TRANSFER_FUNC_UNKNOWN) {
540 infopacket->valid = true;
541
542 infopacket->sb[6] |= 0x08; // PB6 = [Bit 3 = Native Color Active]
543
544 if (app_tf == TRANSFER_FUNC_GAMMA_22) {
545 infopacket->sb[9] |= 0x04; // PB6 = [Bit 2 = Gamma 2.2 EOTF Active]
546 }
547 }
548}
549
550static void build_vrr_infopacket_header_v1(enum signal_type signal,
551 struct dc_info_packet *infopacket,
552 unsigned int *payload_size)
553{
554 if (dc_is_hdmi_signal(signal)) {
555
556 /* HEADER */
557
558 /* HB0 = Packet Type = 0x83 (Source Product
559 * Descriptor InfoFrame)
560 */
561 infopacket->hb0 = DC_HDMI_INFOFRAME_TYPE_SPD;
562
563 /* HB1 = Version = 0x01 */
564 infopacket->hb1 = 0x01;
565
566 /* HB2 = [Bits 7:5 = 0] [Bits 4:0 = Length = 0x08] */
567 infopacket->hb2 = 0x08;
568
569 *payload_size = 0x08;
570
571 } else if (dc_is_dp_signal(signal)) {
572
573 /* HEADER */
574
575 /* HB0 = Secondary-data Packet ID = 0 - Only non-zero
576 * when used to associate audio related info packets
577 */
578 infopacket->hb0 = 0x00;
579
580 /* HB1 = Packet Type = 0x83 (Source Product
581 * Descriptor InfoFrame)
582 */
583 infopacket->hb1 = DC_HDMI_INFOFRAME_TYPE_SPD;
584
585 /* HB2 = [Bits 7:0 = Least significant eight bits -
586 * For INFOFRAME, the value must be 1Bh]
587 */
588 infopacket->hb2 = 0x1B;
589
590 /* HB3 = [Bits 7:2 = INFOFRAME SDP Version Number = 0x1]
591 * [Bits 1:0 = Most significant two bits = 0x00]
592 */
593 infopacket->hb3 = 0x04;
594
595 *payload_size = 0x1B;
596 }
597}
598
599static void build_vrr_infopacket_header_v2(enum signal_type signal,
600 struct dc_info_packet *infopacket,
601 unsigned int *payload_size)
602{
603 if (dc_is_hdmi_signal(signal)) {
604
605 /* HEADER */
606
607 /* HB0 = Packet Type = 0x83 (Source Product
608 * Descriptor InfoFrame)
609 */
610 infopacket->hb0 = DC_HDMI_INFOFRAME_TYPE_SPD;
611
612 /* HB1 = Version = 0x02 */
613 infopacket->hb1 = 0x02;
614
615 /* HB2 = [Bits 7:5 = 0] [Bits 4:0 = Length = 0x09] */
616 infopacket->hb2 = 0x09;
617
618 *payload_size = 0x0A;
619
620 } else if (dc_is_dp_signal(signal)) {
621
622 /* HEADER */
623
624 /* HB0 = Secondary-data Packet ID = 0 - Only non-zero
625 * when used to associate audio related info packets
626 */
627 infopacket->hb0 = 0x00;
628
629 /* HB1 = Packet Type = 0x83 (Source Product
630 * Descriptor InfoFrame)
631 */
632 infopacket->hb1 = DC_HDMI_INFOFRAME_TYPE_SPD;
633
634 /* HB2 = [Bits 7:0 = Least significant eight bits -
635 * For INFOFRAME, the value must be 1Bh]
636 */
637 infopacket->hb2 = 0x1B;
638
639 /* HB3 = [Bits 7:2 = INFOFRAME SDP Version Number = 0x2]
640 * [Bits 1:0 = Most significant two bits = 0x00]
641 */
642 infopacket->hb3 = 0x08;
643
644 *payload_size = 0x1B;
645 }
646}
647
648static void build_vrr_infopacket_checksum(unsigned int *payload_size,
649 struct dc_info_packet *infopacket)
650{
651 /* Calculate checksum */
652 unsigned int idx = 0;
653 unsigned char checksum = 0;
654
655 checksum += infopacket->hb0;
656 checksum += infopacket->hb1;
657 checksum += infopacket->hb2;
658 checksum += infopacket->hb3;
659
660 for (idx = 1; idx <= *payload_size; idx++)
661 checksum += infopacket->sb[idx];
662
663 /* PB0 = Checksum (one byte complement) */
664 infopacket->sb[0] = (unsigned char)(0x100 - checksum);
665
666 infopacket->valid = true;
667}
668
669static void build_vrr_infopacket_v1(enum signal_type signal,
670 const struct mod_vrr_params *vrr,
671 struct dc_info_packet *infopacket)
672{
673 /* SPD info packet for FreeSync */
674 unsigned int payload_size = 0;
675
676 build_vrr_infopacket_header_v1(signal, infopacket, &payload_size);
677 build_vrr_infopacket_data(vrr, infopacket);
678 build_vrr_infopacket_checksum(&payload_size, infopacket);
679
680 infopacket->valid = true;
681}
682
683static void build_vrr_infopacket_v2(enum signal_type signal,
684 const struct mod_vrr_params *vrr,
685 enum color_transfer_func app_tf,
686 struct dc_info_packet *infopacket)
687{
688 unsigned int payload_size = 0;
689
690 build_vrr_infopacket_header_v2(signal, infopacket, &payload_size);
691 build_vrr_infopacket_data(vrr, infopacket);
692
693 build_vrr_infopacket_fs2_data(app_tf, infopacket);
694
695 build_vrr_infopacket_checksum(&payload_size, infopacket);
696
697 infopacket->valid = true;
698}
699
700void mod_freesync_build_vrr_infopacket(struct mod_freesync *mod_freesync,
701 const struct dc_stream_state *stream,
702 const struct mod_vrr_params *vrr,
703 enum vrr_packet_type packet_type,
704 enum color_transfer_func app_tf,
705 struct dc_info_packet *infopacket)
706{
707 /* SPD info packet for FreeSync
708 * VTEM info packet for HdmiVRR
709 * Check if Freesync is supported. Return if false. If true,
710 * set the corresponding bit in the info packet
711 */
712 if (!vrr->supported || (!vrr->send_info_frame))
713 return;
714
715 switch (packet_type) {
716 case PACKET_TYPE_FS2:
717 build_vrr_infopacket_v2(stream->signal, vrr, app_tf, infopacket);
718 break;
719 case PACKET_TYPE_VRR:
720 case PACKET_TYPE_FS1:
721 default:
722 build_vrr_infopacket_v1(stream->signal, vrr, infopacket);
723 }
724}
725
726void mod_freesync_build_vrr_params(struct mod_freesync *mod_freesync,
727 const struct dc_stream_state *stream,
728 struct mod_freesync_config *in_config,
729 struct mod_vrr_params *in_out_vrr)
730{
731 struct core_freesync *core_freesync = NULL;
732 unsigned long long nominal_field_rate_in_uhz = 0;
733 unsigned int refresh_range = 0;
734 unsigned long long min_refresh_in_uhz = 0;
735 unsigned long long max_refresh_in_uhz = 0;
736
737 if (mod_freesync == NULL)
738 return;
739
740 core_freesync = MOD_FREESYNC_TO_CORE(mod_freesync);
741
742 /* Calculate nominal field rate for stream */
743 nominal_field_rate_in_uhz =
744 mod_freesync_calc_nominal_field_rate(stream);
745
746 min_refresh_in_uhz = in_config->min_refresh_in_uhz;
747 max_refresh_in_uhz = in_config->max_refresh_in_uhz;
748
749 // Don't allow min > max
750 if (min_refresh_in_uhz > max_refresh_in_uhz)
751 min_refresh_in_uhz = max_refresh_in_uhz;
752
753 // Full range may be larger than current video timing, so cap at nominal
754 if (max_refresh_in_uhz > nominal_field_rate_in_uhz)
755 max_refresh_in_uhz = nominal_field_rate_in_uhz;
756
757 // Full range may be larger than current video timing, so cap at nominal
758 if (min_refresh_in_uhz > nominal_field_rate_in_uhz)
759 min_refresh_in_uhz = nominal_field_rate_in_uhz;
760
761 if (!vrr_settings_require_update(core_freesync,
762 in_config, (unsigned int)min_refresh_in_uhz, (unsigned int)max_refresh_in_uhz,
763 in_out_vrr))
764 return;
765
766 in_out_vrr->state = in_config->state;
767 in_out_vrr->send_info_frame = in_config->vsif_supported;
768
769 if (in_config->state == VRR_STATE_UNSUPPORTED) {
770 in_out_vrr->state = VRR_STATE_UNSUPPORTED;
771 in_out_vrr->supported = false;
772 in_out_vrr->adjust.v_total_min = stream->timing.v_total;
773 in_out_vrr->adjust.v_total_max = stream->timing.v_total;
774
775 return;
776
777 } else {
778 in_out_vrr->min_refresh_in_uhz = (unsigned int)min_refresh_in_uhz;
779 in_out_vrr->max_duration_in_us =
780 calc_duration_in_us_from_refresh_in_uhz(
781 (unsigned int)min_refresh_in_uhz);
782
783 in_out_vrr->max_refresh_in_uhz = (unsigned int)max_refresh_in_uhz;
784 in_out_vrr->min_duration_in_us =
785 calc_duration_in_us_from_refresh_in_uhz(
786 (unsigned int)max_refresh_in_uhz);
787
788 refresh_range = in_out_vrr->max_refresh_in_uhz -
789 in_out_vrr->min_refresh_in_uhz;
790
791 in_out_vrr->supported = true;
792 }
793
794 in_out_vrr->fixed.ramping_active = in_config->ramping;
795
796 in_out_vrr->btr.btr_enabled = in_config->btr;
797
798 if (in_out_vrr->max_refresh_in_uhz <
799 2 * in_out_vrr->min_refresh_in_uhz)
800 in_out_vrr->btr.btr_enabled = false;
801
802 in_out_vrr->btr.btr_active = false;
803 in_out_vrr->btr.inserted_duration_in_us = 0;
804 in_out_vrr->btr.frames_to_insert = 0;
805 in_out_vrr->btr.frame_counter = 0;
806 in_out_vrr->btr.mid_point_in_us =
807 (in_out_vrr->min_duration_in_us +
808 in_out_vrr->max_duration_in_us) / 2;
809
810 if (in_out_vrr->state == VRR_STATE_UNSUPPORTED) {
811 in_out_vrr->adjust.v_total_min = stream->timing.v_total;
812 in_out_vrr->adjust.v_total_max = stream->timing.v_total;
813 } else if (in_out_vrr->state == VRR_STATE_DISABLED) {
814 in_out_vrr->adjust.v_total_min = stream->timing.v_total;
815 in_out_vrr->adjust.v_total_max = stream->timing.v_total;
816 } else if (in_out_vrr->state == VRR_STATE_INACTIVE) {
817 in_out_vrr->adjust.v_total_min = stream->timing.v_total;
818 in_out_vrr->adjust.v_total_max = stream->timing.v_total;
819 } else if (in_out_vrr->state == VRR_STATE_ACTIVE_VARIABLE &&
820 refresh_range >= MIN_REFRESH_RANGE_IN_US) {
821 in_out_vrr->adjust.v_total_min =
822 calc_v_total_from_refresh(stream,
823 in_out_vrr->max_refresh_in_uhz);
824 in_out_vrr->adjust.v_total_max =
825 calc_v_total_from_refresh(stream,
826 in_out_vrr->min_refresh_in_uhz);
827 } else if (in_out_vrr->state == VRR_STATE_ACTIVE_FIXED) {
828 in_out_vrr->fixed.target_refresh_in_uhz =
829 in_out_vrr->min_refresh_in_uhz;
830 if (in_out_vrr->fixed.ramping_active &&
831 in_out_vrr->fixed.fixed_active) {
832 /* Do not update vtotals if ramping is already active
833 * in order to continue ramp from current refresh.
834 */
835 in_out_vrr->fixed.fixed_active = true;
836 } else {
837 in_out_vrr->fixed.fixed_active = true;
838 in_out_vrr->adjust.v_total_min =
839 calc_v_total_from_refresh(stream,
840 in_out_vrr->fixed.target_refresh_in_uhz);
841 in_out_vrr->adjust.v_total_max =
842 in_out_vrr->adjust.v_total_min;
843 }
844 } else {
845 in_out_vrr->state = VRR_STATE_INACTIVE;
846 in_out_vrr->adjust.v_total_min = stream->timing.v_total;
847 in_out_vrr->adjust.v_total_max = stream->timing.v_total;
848 }
849}
850
851void mod_freesync_handle_preflip(struct mod_freesync *mod_freesync,
852 const struct dc_plane_state *plane,
853 const struct dc_stream_state *stream,
854 unsigned int curr_time_stamp_in_us,
855 struct mod_vrr_params *in_out_vrr)
856{
857 struct core_freesync *core_freesync = NULL;
858 unsigned int last_render_time_in_us = 0;
859 unsigned int average_render_time_in_us = 0;
860
861 if (mod_freesync == NULL)
862 return;
863
864 core_freesync = MOD_FREESYNC_TO_CORE(mod_freesync);
865
866 if (in_out_vrr->supported &&
867 in_out_vrr->state == VRR_STATE_ACTIVE_VARIABLE) {
868 unsigned int i = 0;
869 unsigned int oldest_index = plane->time.index + 1;
870
871 if (oldest_index >= DC_PLANE_UPDATE_TIMES_MAX)
872 oldest_index = 0;
873
874 last_render_time_in_us = curr_time_stamp_in_us -
875 plane->time.prev_update_time_in_us;
876
877 // Sum off all entries except oldest one
878 for (i = 0; i < DC_PLANE_UPDATE_TIMES_MAX; i++) {
879 average_render_time_in_us +=
880 plane->time.time_elapsed_in_us[i];
881 }
882 average_render_time_in_us -=
883 plane->time.time_elapsed_in_us[oldest_index];
884
885 // Add render time for current flip
886 average_render_time_in_us += last_render_time_in_us;
887 average_render_time_in_us /= DC_PLANE_UPDATE_TIMES_MAX;
888
889 if (in_out_vrr->btr.btr_enabled) {
890 apply_below_the_range(core_freesync,
891 stream,
892 last_render_time_in_us,
893 in_out_vrr);
894 } else {
895 apply_fixed_refresh(core_freesync,
896 stream,
897 last_render_time_in_us,
898 in_out_vrr);
899 }
900
901 }
902}
903
904void mod_freesync_handle_v_update(struct mod_freesync *mod_freesync,
905 const struct dc_stream_state *stream,
906 struct mod_vrr_params *in_out_vrr)
907{
908 struct core_freesync *core_freesync = NULL;
909
910 if ((mod_freesync == NULL) || (stream == NULL) || (in_out_vrr == NULL))
911 return;
912
913 core_freesync = MOD_FREESYNC_TO_CORE(mod_freesync);
914
915 if (in_out_vrr->supported == false)
916 return;
917
918 /* Below the Range Logic */
919
920 /* Only execute if in fullscreen mode */
921 if (in_out_vrr->state == VRR_STATE_ACTIVE_VARIABLE &&
922 in_out_vrr->btr.btr_active) {
923 /* TODO: pass in flag for Pre-DCE12 ASIC
924 * in order for frame variable duration to take affect,
925 * it needs to be done one VSYNC early, which is at
926 * frameCounter == 1.
927 * For DCE12 and newer updates to V_TOTAL_MIN/MAX
928 * will take affect on current frame
929 */
930 if (in_out_vrr->btr.frames_to_insert ==
931 in_out_vrr->btr.frame_counter) {
932 in_out_vrr->adjust.v_total_min =
933 calc_v_total_from_duration(stream,
934 in_out_vrr,
935 in_out_vrr->btr.inserted_duration_in_us);
936 in_out_vrr->adjust.v_total_max =
937 in_out_vrr->adjust.v_total_min;
938 }
939
940 if (in_out_vrr->btr.frame_counter > 0)
941 in_out_vrr->btr.frame_counter--;
942
943 /* Restore FreeSync */
944 if (in_out_vrr->btr.frame_counter == 0) {
945 in_out_vrr->adjust.v_total_min =
946 calc_v_total_from_refresh(stream,
947 in_out_vrr->max_refresh_in_uhz);
948 in_out_vrr->adjust.v_total_max =
949 calc_v_total_from_refresh(stream,
950 in_out_vrr->min_refresh_in_uhz);
951 }
952 }
953
954 /* If in fullscreen freesync mode or in video, do not program
955 * static screen ramp values
956 */
957 if (in_out_vrr->state == VRR_STATE_ACTIVE_VARIABLE)
958 in_out_vrr->fixed.ramping_active = false;
959
960 /* Gradual Static Screen Ramping Logic */
961 /* Execute if ramp is active and user enabled freesync static screen*/
962 if (in_out_vrr->state == VRR_STATE_ACTIVE_FIXED &&
963 in_out_vrr->fixed.ramping_active) {
964 update_v_total_for_static_ramp(
965 core_freesync, stream, in_out_vrr);
966 }
967}
968
969void mod_freesync_get_settings(struct mod_freesync *mod_freesync,
970 const struct mod_vrr_params *vrr,
971 unsigned int *v_total_min, unsigned int *v_total_max,
972 unsigned int *event_triggers,
973 unsigned int *window_min, unsigned int *window_max,
974 unsigned int *lfc_mid_point_in_us,
975 unsigned int *inserted_frames,
976 unsigned int *inserted_duration_in_us)
977{
978 struct core_freesync *core_freesync = NULL;
979
980 if (mod_freesync == NULL)
981 return;
982
983 core_freesync = MOD_FREESYNC_TO_CORE(mod_freesync);
984
985 if (vrr->supported) {
986 *v_total_min = vrr->adjust.v_total_min;
987 *v_total_max = vrr->adjust.v_total_max;
988 *event_triggers = 0;
989 *lfc_mid_point_in_us = vrr->btr.mid_point_in_us;
990 *inserted_frames = vrr->btr.frames_to_insert;
991 *inserted_duration_in_us = vrr->btr.inserted_duration_in_us;
992 }
993}
994
995unsigned long long mod_freesync_calc_nominal_field_rate(
996 const struct dc_stream_state *stream)
997{
998 unsigned long long nominal_field_rate_in_uhz = 0;
999
1000 /* Calculate nominal field rate for stream */
1001 nominal_field_rate_in_uhz = stream->timing.pix_clk_100hz / 10;
1002 nominal_field_rate_in_uhz *= 1000ULL * 1000ULL * 1000ULL;
1003 nominal_field_rate_in_uhz = div_u64(nominal_field_rate_in_uhz,
1004 stream->timing.h_total);
1005 nominal_field_rate_in_uhz = div_u64(nominal_field_rate_in_uhz,
1006 stream->timing.v_total);
1007
1008 return nominal_field_rate_in_uhz;
1009}
1010
1011bool mod_freesync_is_valid_range(struct mod_freesync *mod_freesync,
1012 const struct dc_stream_state *stream,
1013 uint32_t min_refresh_cap_in_uhz,
1014 uint32_t max_refresh_cap_in_uhz,
1015 uint32_t min_refresh_request_in_uhz,
1016 uint32_t max_refresh_request_in_uhz)
1017{
1018 /* Calculate nominal field rate for stream */
1019 unsigned long long nominal_field_rate_in_uhz =
1020 mod_freesync_calc_nominal_field_rate(stream);
1021
1022 /* Typically nominal refresh calculated can have some fractional part.
1023 * Allow for some rounding error of actual video timing by taking floor
1024 * of caps and request. Round the nominal refresh rate.
1025 *
1026 * Dividing will convert everything to units in Hz although input
1027 * variable name is in uHz!
1028 *
1029 * Also note, this takes care of rounding error on the nominal refresh
1030 * so by rounding error we only expect it to be off by a small amount,
1031 * such as < 0.1 Hz. i.e. 143.9xxx or 144.1xxx.
1032 *
1033 * Example 1. Caps Min = 40 Hz, Max = 144 Hz
1034 * Request Min = 40 Hz, Max = 144 Hz
1035 * Nominal = 143.5x Hz rounded to 144 Hz
1036 * This function should allow this as valid request
1037 *
1038 * Example 2. Caps Min = 40 Hz, Max = 144 Hz
1039 * Request Min = 40 Hz, Max = 144 Hz
1040 * Nominal = 144.4x Hz rounded to 144 Hz
1041 * This function should allow this as valid request
1042 *
1043 * Example 3. Caps Min = 40 Hz, Max = 144 Hz
1044 * Request Min = 40 Hz, Max = 144 Hz
1045 * Nominal = 120.xx Hz rounded to 120 Hz
1046 * This function should return NOT valid since the requested
1047 * max is greater than current timing's nominal
1048 *
1049 * Example 4. Caps Min = 40 Hz, Max = 120 Hz
1050 * Request Min = 40 Hz, Max = 120 Hz
1051 * Nominal = 144.xx Hz rounded to 144 Hz
1052 * This function should return NOT valid since the nominal
1053 * is greater than the capability's max refresh
1054 */
1055 nominal_field_rate_in_uhz =
1056 div_u64(nominal_field_rate_in_uhz + 500000, 1000000);
1057 min_refresh_cap_in_uhz /= 1000000;
1058 max_refresh_cap_in_uhz /= 1000000;
1059 min_refresh_request_in_uhz /= 1000000;
1060 max_refresh_request_in_uhz /= 1000000;
1061
1062 // Check nominal is within range
1063 if (nominal_field_rate_in_uhz > max_refresh_cap_in_uhz ||
1064 nominal_field_rate_in_uhz < min_refresh_cap_in_uhz)
1065 return false;
1066
1067 // If nominal is less than max, limit the max allowed refresh rate
1068 if (nominal_field_rate_in_uhz < max_refresh_cap_in_uhz)
1069 max_refresh_cap_in_uhz = nominal_field_rate_in_uhz;
1070
1071 // Don't allow min > max
1072 if (min_refresh_request_in_uhz > max_refresh_request_in_uhz)
1073 return false;
1074
1075 // Check min is within range
1076 if (min_refresh_request_in_uhz > max_refresh_cap_in_uhz ||
1077 min_refresh_request_in_uhz < min_refresh_cap_in_uhz)
1078 return false;
1079
1080 // Check max is within range
1081 if (max_refresh_request_in_uhz > max_refresh_cap_in_uhz ||
1082 max_refresh_request_in_uhz < min_refresh_cap_in_uhz)
1083 return false;
1084
1085 // For variable range, check for at least 10 Hz range
1086 if ((max_refresh_request_in_uhz != min_refresh_request_in_uhz) &&
1087 (max_refresh_request_in_uhz - min_refresh_request_in_uhz < 10))
1088 return false;
1089
1090 return true;
1091}
1092