[linux-2.6-block.git] / drivers / gpu / drm / amd / display / modules / inc / mod_freesync.h

/*
 * Copyright 2016 Advanced Micro Devices, Inc.
 *
 * Permission is hereby granted, free of charge, to any person obtaining a
 * copy of this software and associated documentation files (the "Software"),
 * to deal in the Software without restriction, including without limitation
 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
 * and/or sell copies of the Software, and to permit persons to whom the
 * Software is furnished to do so, subject to the following conditions:
 *
 * The above copyright notice and this permission notice shall be included in
 * all copies or substantial portions of the Software.
 *
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
 * THE COPYRIGHT HOLDER(S) OR AUTHOR(S) BE LIABLE FOR ANY CLAIM, DAMAGES OR
 * OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
 * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
 * OTHER DEALINGS IN THE SOFTWARE.
 *
 * Authors: AMD
 *
 */


/*
 * Copyright 2016 Advanced Micro Devices, Inc.
 *
 * Permission is hereby granted, free of charge, to any person obtaining a
 * copy of this software and associated documentation files (the "Software"),
 * to deal in the Software without restriction, including without limitation
 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
 * and/or sell copies of the Software, and to permit persons to whom the
 * Software is furnished to do so, subject to the following conditions:
 *
 * The above copyright notice and this permission notice shall be included in
 * all copies or substantial portions of the Software.
 *
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
 * THE COPYRIGHT HOLDER(S) OR AUTHOR(S) BE LIABLE FOR ANY CLAIM, DAMAGES OR
 * OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
 * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
 * OTHER DEALINGS IN THE SOFTWARE.
 *
 * Authors: AMD
 *
 */

#ifndef MOD_FREESYNC_H_
#define MOD_FREESYNC_H_

#include "dm_services.h"

struct mod_freesync *mod_freesync_create(struct dc *dc);
void mod_freesync_destroy(struct mod_freesync *mod_freesync);

struct mod_freesync {
	int dummy;
};

enum mod_freesync_state {
	FREESYNC_STATE_NONE,
	FREESYNC_STATE_FULLSCREEN,
	FREESYNC_STATE_STATIC_SCREEN,
	FREESYNC_STATE_VIDEO
};

enum mod_freesync_user_enable_mask {
	FREESYNC_USER_ENABLE_STATIC = 0x1,
	FREESYNC_USER_ENABLE_VIDEO = 0x2,
	FREESYNC_USER_ENABLE_GAMING = 0x4
};

struct mod_freesync_user_enable {
	bool enable_for_static;
	bool enable_for_video;
	bool enable_for_gaming;
};

struct mod_freesync_caps {
	bool supported;
	unsigned int min_refresh_in_micro_hz;
	unsigned int max_refresh_in_micro_hz;

	bool btr_supported;
};

struct mod_freesync_params {
	enum mod_freesync_state state;
	bool enable;
	unsigned int update_duration_in_ns;
	bool windowed_fullscreen;
};

/*
 * Add stream to be tracked by module
 */
bool mod_freesync_add_stream(struct mod_freesync *mod_freesync,
		const struct dc_stream *stream, struct mod_freesync_caps *caps);

/*
 * Remove stream to be tracked by module
 */
bool mod_freesync_remove_stream(struct mod_freesync *mod_freesync,
		const struct dc_stream *stream);

/*
 * Update the freesync state flags for each display and program
 * freesync accordingly
 */
void mod_freesync_update_state(struct mod_freesync *mod_freesync,
		const struct dc_stream **streams, int num_streams,
		struct mod_freesync_params *freesync_params);

bool mod_freesync_get_state(struct mod_freesync *mod_freesync,
		const struct dc_stream *stream,
		struct mod_freesync_params *freesync_params);

bool mod_freesync_set_user_enable(struct mod_freesync *mod_freesync,
		const struct dc_stream **streams, int num_streams,
		struct mod_freesync_user_enable *user_enable);

bool mod_freesync_get_user_enable(struct mod_freesync *mod_freesync,
		const struct dc_stream *stream,
		struct mod_freesync_user_enable *user_enable);

bool mod_freesync_override_min_max(struct mod_freesync *mod_freesync,
		const struct dc_stream *streams,
		unsigned int min_refresh,
		unsigned int max_refresh);

bool mod_freesync_get_min_max(struct mod_freesync *mod_freesync,
		const struct dc_stream *stream,
		unsigned int *min_refresh,
		unsigned int *max_refresh);

bool mod_freesync_get_vmin_vmax(struct mod_freesync *mod_freesync,
		const struct dc_stream *stream,
		unsigned int *vmin,
		unsigned int *vmax);

bool mod_freesync_get_v_position(struct mod_freesync *mod_freesync,
		const struct dc_stream *stream,
		unsigned int *nom_v_pos,
		unsigned int *v_pos);

void mod_freesync_handle_v_update(struct mod_freesync *mod_freesync,
		const struct dc_stream **streams, int num_streams);

void mod_freesync_notify_mode_change(struct mod_freesync *mod_freesync,
		const struct dc_stream **streams, int num_streams);

void mod_freesync_pre_update_plane_addresses(struct mod_freesync *mod_freesync,
		const struct dc_stream **streams, int num_streams,
		unsigned int curr_time_stamp);

#endif
Commit	Line	Data
4562236b HW	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 "dm_services.h"
	58
	59	struct mod_freesync mod_freesync_create(struct dc dc);
	60	void mod_freesync_destroy(struct mod_freesync *mod_freesync);
	61
	62	struct mod_freesync {
	63	int dummy;
	64	};
65
66	enum mod_freesync_state {
67	FREESYNC_STATE_NONE,
68	FREESYNC_STATE_FULLSCREEN,
69	FREESYNC_STATE_STATIC_SCREEN,
70	FREESYNC_STATE_VIDEO
71	};
72
73	enum mod_freesync_user_enable_mask {
74	FREESYNC_USER_ENABLE_STATIC = 0x1,
75	FREESYNC_USER_ENABLE_VIDEO = 0x2,
76	FREESYNC_USER_ENABLE_GAMING = 0x4
77	};
78
79	struct mod_freesync_user_enable {
80	bool enable_for_static;
81	bool enable_for_video;
82	bool enable_for_gaming;
83	};
84
85	struct mod_freesync_caps {
86	bool supported;
87	unsigned int min_refresh_in_micro_hz;
88	unsigned int max_refresh_in_micro_hz;
89
90	bool btr_supported;
91	};
92
93	struct mod_freesync_params {
94	enum mod_freesync_state state;
95	bool enable;
96	unsigned int update_duration_in_ns;
97	bool windowed_fullscreen;
98	};
99
100	/*
101	* Add stream to be tracked by module
102	*/
103	bool mod_freesync_add_stream(struct mod_freesync *mod_freesync,
104	const struct dc_stream stream, struct mod_freesync_caps caps);
105
106	/*
107	* Remove stream to be tracked by module
108	*/
109	bool mod_freesync_remove_stream(struct mod_freesync *mod_freesync,
110	const struct dc_stream *stream);
111
4562236b HW	112	/*
	113	* Update the freesync state flags for each display and program
	114	* freesync accordingly
	115	*/
	116	void mod_freesync_update_state(struct mod_freesync *mod_freesync,
	117	const struct dc_stream **streams, int num_streams,
	118	struct mod_freesync_params *freesync_params);
	119
	120	bool mod_freesync_get_state(struct mod_freesync *mod_freesync,
	121	const struct dc_stream *stream,
	122	struct mod_freesync_params *freesync_params);
	123
	124	bool mod_freesync_set_user_enable(struct mod_freesync *mod_freesync,
	125	const struct dc_stream **streams, int num_streams,
	126	struct mod_freesync_user_enable *user_enable);
	127
	128	bool mod_freesync_get_user_enable(struct mod_freesync *mod_freesync,
	129	const struct dc_stream *stream,
	130	struct mod_freesync_user_enable *user_enable);
	131
72ada5f7 EC	132	bool mod_freesync_override_min_max(struct mod_freesync *mod_freesync,
	133	const struct dc_stream *streams,
	134	unsigned int min_refresh,
	135	unsigned int max_refresh);
	136
	137	bool mod_freesync_get_min_max(struct mod_freesync *mod_freesync,
	138	const struct dc_stream *stream,
	139	unsigned int *min_refresh,
	140	unsigned int *max_refresh);
	141
	142	bool mod_freesync_get_vmin_vmax(struct mod_freesync *mod_freesync,
	143	const struct dc_stream *stream,
	144	unsigned int *vmin,
	145	unsigned int *vmax);
	146
	147	bool mod_freesync_get_v_position(struct mod_freesync *mod_freesync,
	148	const struct dc_stream *stream,
	149	unsigned int *nom_v_pos,
	150	unsigned int *v_pos);
	151
4562236b HW	152	void mod_freesync_handle_v_update(struct mod_freesync *mod_freesync,
	153	const struct dc_stream **streams, int num_streams);
	154
	155	void mod_freesync_notify_mode_change(struct mod_freesync *mod_freesync,
	156	const struct dc_stream **streams, int num_streams);
	157
	158	void mod_freesync_pre_update_plane_addresses(struct mod_freesync *mod_freesync,
	159	const struct dc_stream **streams, int num_streams,
	160	unsigned int curr_time_stamp);
	161
	162	#endif