Linux Audio

Check our new training course

Loading...
  1/*
  2 * Copyright 2012-15 Advanced Micro Devices, Inc.
  3 *
  4 * Permission is hereby granted, free of charge, to any person obtaining a
  5 * copy of this software and associated documentation files (the "Software"),
  6 * to deal in the Software without restriction, including without limitation
  7 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
  8 * and/or sell copies of the Software, and to permit persons to whom the
  9 * Software is furnished to do so, subject to the following conditions:
 10 *
 11 * The above copyright notice and this permission notice shall be included in
 12 * all copies or substantial portions of the Software.
 13 *
 14 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 15 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 16 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
 17 * THE COPYRIGHT HOLDER(S) OR AUTHOR(S) BE LIABLE FOR ANY CLAIM, DAMAGES OR
 18 * OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
 19 * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
 20 * OTHER DEALINGS IN THE SOFTWARE.
 21 *
 22 * Authors: AMD
 23 *
 24 */
 25
 26#ifndef __DAL_HUBP_H__
 27#define __DAL_HUBP_H__
 28
 29/**
 30 * DOC: overview
 31 *
 32 * Display Controller Hub (DCHUB) is the gateway between the Scalable Data Port
 33 * (SDP) and DCN. This component has multiple features, such as memory
 34 * arbitration, rotation, and cursor manipulation.
 35 *
 36 * There is one HUBP allocated per pipe, which fetches data and converts
 37 * different pixel formats (i.e. ARGB8888, NV12, etc) into linear, interleaved
 38 * and fixed-depth streams of pixel data.
 39 */
 40
 41#include "mem_input.h"
 42#include "cursor_reg_cache.h"
 43
 44#define OPP_ID_INVALID 0xf
 45#define MAX_TTU 0xffffff
 46
 47enum cursor_pitch {
 48	CURSOR_PITCH_64_PIXELS = 0,
 49	CURSOR_PITCH_128_PIXELS,
 50	CURSOR_PITCH_256_PIXELS
 51};
 52
 53enum cursor_lines_per_chunk {
 54	CURSOR_LINE_PER_CHUNK_1 = 0, /* new for DCN2 */
 55	CURSOR_LINE_PER_CHUNK_2 = 1,
 56	CURSOR_LINE_PER_CHUNK_4,
 57	CURSOR_LINE_PER_CHUNK_8,
 58	CURSOR_LINE_PER_CHUNK_16
 59};
 60
 61enum hubp_ind_block_size {
 62	hubp_ind_block_unconstrained = 0,
 63	hubp_ind_block_64b,
 64	hubp_ind_block_128b,
 65	hubp_ind_block_64b_no_128bcl,
 66};
 67
 68struct hubp {
 69	const struct hubp_funcs *funcs;
 70	struct dc_context *ctx;
 71	struct dc_plane_address request_address;
 72	int inst;
 73
 74	/* run time states */
 75	int opp_id;
 76	int mpcc_id;
 77	struct dc_cursor_attributes curs_attr;
 78	struct dc_cursor_position curs_pos;
 79	bool power_gated;
 80
 81	struct cursor_position_cache_hubp  pos;
 82	struct cursor_attribute_cache_hubp att;
 83	struct cursor_rect cur_rect;
 84};
 85
 86struct surface_flip_registers {
 87	uint32_t DCSURF_SURFACE_CONTROL;
 88	uint32_t DCSURF_PRIMARY_META_SURFACE_ADDRESS_HIGH;
 89	uint32_t DCSURF_PRIMARY_META_SURFACE_ADDRESS;
 90	uint32_t DCSURF_PRIMARY_SURFACE_ADDRESS_HIGH;
 91	uint32_t DCSURF_PRIMARY_SURFACE_ADDRESS;
 92	uint32_t DCSURF_PRIMARY_META_SURFACE_ADDRESS_HIGH_C;
 93	uint32_t DCSURF_PRIMARY_META_SURFACE_ADDRESS_C;
 94	uint32_t DCSURF_PRIMARY_SURFACE_ADDRESS_HIGH_C;
 95	uint32_t DCSURF_PRIMARY_SURFACE_ADDRESS_C;
 96	uint32_t DCSURF_SECONDARY_META_SURFACE_ADDRESS_HIGH;
 97	uint32_t DCSURF_SECONDARY_META_SURFACE_ADDRESS;
 98	uint32_t DCSURF_SECONDARY_SURFACE_ADDRESS_HIGH;
 99	uint32_t DCSURF_SECONDARY_SURFACE_ADDRESS;
100	bool tmz_surface;
101	bool immediate;
102	uint8_t vmid;
103	bool grph_stereo;
104};
105
106struct hubp_funcs {
107	void (*hubp_setup)(
108			struct hubp *hubp,
109			struct _vcs_dpi_display_dlg_regs_st *dlg_regs,
110			struct _vcs_dpi_display_ttu_regs_st *ttu_regs,
111			struct _vcs_dpi_display_rq_regs_st *rq_regs,
112			struct _vcs_dpi_display_pipe_dest_params_st *pipe_dest);
113
114	void (*hubp_setup_interdependent)(
115			struct hubp *hubp,
116			struct _vcs_dpi_display_dlg_regs_st *dlg_regs,
117			struct _vcs_dpi_display_ttu_regs_st *ttu_regs);
118
119	void (*dcc_control)(struct hubp *hubp, bool enable,
120			enum hubp_ind_block_size blk_size);
121
122	void (*mem_program_viewport)(
123			struct hubp *hubp,
124			const struct rect *viewport,
125			const struct rect *viewport_c);
126
127	bool (*hubp_program_surface_flip_and_addr)(
128		struct hubp *hubp,
129		const struct dc_plane_address *address,
130		bool flip_immediate);
131
132	void (*hubp_program_pte_vm)(
133		struct hubp *hubp,
134		enum surface_pixel_format format,
135		union dc_tiling_info *tiling_info,
136		enum dc_rotation_angle rotation);
137
138	void (*hubp_set_vm_system_aperture_settings)(
139			struct hubp *hubp,
140			struct vm_system_aperture_param *apt);
141
142	void (*hubp_set_vm_context0_settings)(
143			struct hubp *hubp,
144			const struct vm_context0_param *vm0);
145
146	void (*hubp_program_surface_config)(
147		struct hubp *hubp,
148		enum surface_pixel_format format,
149		union dc_tiling_info *tiling_info,
150		struct plane_size *plane_size,
151		enum dc_rotation_angle rotation,
152		struct dc_plane_dcc_param *dcc,
153		bool horizontal_mirror,
154		unsigned int compa_level);
155
156	bool (*hubp_is_flip_pending)(struct hubp *hubp);
157
158	void (*set_blank)(struct hubp *hubp, bool blank);
159	void (*set_blank_regs)(struct hubp *hubp, bool blank);
160	void (*phantom_hubp_post_enable)(struct hubp *hubp);
161	void (*set_hubp_blank_en)(struct hubp *hubp, bool blank);
162
163	void (*set_cursor_attributes)(
164			struct hubp *hubp,
165			const struct dc_cursor_attributes *attr);
166
167	void (*set_cursor_position)(
168			struct hubp *hubp,
169			const struct dc_cursor_position *pos,
170			const struct dc_cursor_mi_param *param);
171
172	void (*hubp_disconnect)(struct hubp *hubp);
173
174	void (*hubp_clk_cntl)(struct hubp *hubp, bool enable);
175	void (*hubp_vtg_sel)(struct hubp *hubp, uint32_t otg_inst);
176	void (*hubp_read_state)(struct hubp *hubp);
177	void (*hubp_clear_underflow)(struct hubp *hubp);
178	void (*hubp_disable_control)(struct hubp *hubp, bool disable_hubp);
179	unsigned int (*hubp_get_underflow_status)(struct hubp *hubp);
180	void (*hubp_init)(struct hubp *hubp);
181
182	void (*dmdata_set_attributes)(
183			struct hubp *hubp,
184			const struct dc_dmdata_attributes *attr);
185
186	void (*dmdata_load)(
187			struct hubp *hubp,
188			uint32_t dmdata_sw_size,
189			const uint32_t *dmdata_sw_data);
190	bool (*dmdata_status_done)(struct hubp *hubp);
191	void (*hubp_enable_tripleBuffer)(
192		struct hubp *hubp,
193		bool enable);
194
195	bool (*hubp_is_triplebuffer_enabled)(
196		struct hubp *hubp);
197
198	void (*hubp_set_flip_control_surface_gsl)(
199		struct hubp *hubp,
200		bool enable);
201
202	void (*validate_dml_output)(
203			struct hubp *hubp,
204			struct dc_context *ctx,
205			struct _vcs_dpi_display_rq_regs_st *dml_rq_regs,
206			struct _vcs_dpi_display_dlg_regs_st *dml_dlg_attr,
207			struct _vcs_dpi_display_ttu_regs_st *dml_ttu_attr);
208	void (*set_unbounded_requesting)(
209		struct hubp *hubp,
210		bool enable);
211	bool (*hubp_in_blank)(struct hubp *hubp);
212	void (*hubp_soft_reset)(struct hubp *hubp, bool reset);
213
214	void (*hubp_update_force_pstate_disallow)(struct hubp *hubp, bool allow);
215	void (*hubp_update_force_cursor_pstate_disallow)(struct hubp *hubp, bool allow);
216	void (*hubp_update_mall_sel)(struct hubp *hubp, uint32_t mall_sel, bool c_cursor);
217	void (*hubp_prepare_subvp_buffering)(struct hubp *hubp, bool enable);
218
219	void (*hubp_set_flip_int)(struct hubp *hubp);
220
221	void (*program_extended_blank)(struct hubp *hubp,
222			unsigned int min_dst_y_next_start_optimized);
223
224	void (*hubp_wait_pipe_read_start)(struct hubp *hubp);
225};
226
227#endif