xref: /linux/drivers/gpu/drm/i915/display/intel_cdclk.h (revision 3a2c4d55e32ad65efebdb6de44eef3bfa08bb49d)
1 /* SPDX-License-Identifier: MIT */
2 /*
3  * Copyright © 2019 Intel Corporation
4  */
5 
6 #ifndef __INTEL_CDCLK_H__
7 #define __INTEL_CDCLK_H__
8 
9 #include <linux/types.h>
10 
11 enum pipe;
12 struct intel_atomic_state;
13 struct intel_cdclk_state;
14 struct intel_crtc;
15 struct intel_crtc_state;
16 struct intel_display;
17 
18 struct intel_cdclk_config {
19 	unsigned int cdclk, vco, ref, bypass;
20 	u8 voltage_level;
21 	/* This field is only valid for Xe2LPD and above. */
22 	bool joined_mbus;
23 };
24 
25 int intel_cdclk_ppc(struct intel_display *display, bool double_wide);
26 void intel_cdclk_init_hw(struct intel_display *display);
27 void intel_cdclk_uninit_hw(struct intel_display *display);
28 void intel_init_cdclk_hooks(struct intel_display *display);
29 void intel_update_max_cdclk(struct intel_display *display);
30 void intel_update_cdclk(struct intel_display *display);
31 u32 intel_read_rawclk(struct intel_display *display);
32 bool intel_cdclk_clock_changed(const struct intel_cdclk_config *a,
33 			       const struct intel_cdclk_config *b);
34 int intel_mdclk_cdclk_ratio(struct intel_display *display,
35 			    const struct intel_cdclk_config *cdclk_config);
36 bool intel_cdclk_is_decreasing_later(struct intel_atomic_state *state);
37 void intel_set_cdclk_pre_plane_update(struct intel_atomic_state *state);
38 void intel_set_cdclk_post_plane_update(struct intel_atomic_state *state);
39 void intel_cdclk_dump_config(struct intel_display *display,
40 			     const struct intel_cdclk_config *cdclk_config,
41 			     const char *context);
42 void intel_cdclk_get_cdclk(struct intel_display *display,
43 			   struct intel_cdclk_config *cdclk_config);
44 int intel_cdclk_atomic_check(struct intel_atomic_state *state);
45 int intel_cdclk_state_set_joined_mbus(struct intel_atomic_state *state, bool joined_mbus);
46 struct intel_cdclk_state *
47 intel_atomic_get_cdclk_state(struct intel_atomic_state *state);
48 void intel_cdclk_update_hw_state(struct intel_display *display);
49 void intel_cdclk_crtc_disable_noatomic(struct intel_crtc *crtc);
50 int intel_cdclk_update_dbuf_bw_min_cdclk(struct intel_atomic_state *state,
51 					 int old_min_cdclk, int new_min_cdclk,
52 					 bool *need_cdclk_calc);
53 
54 #define to_intel_cdclk_state(global_state) \
55 	container_of_const((global_state), struct intel_cdclk_state, base)
56 
57 #define intel_atomic_get_old_cdclk_state(state) \
58 	to_intel_cdclk_state(intel_atomic_get_old_global_obj_state(state, &to_intel_display(state)->cdclk.obj))
59 #define intel_atomic_get_new_cdclk_state(state) \
60 	to_intel_cdclk_state(intel_atomic_get_new_global_obj_state(state, &to_intel_display(state)->cdclk.obj))
61 
62 int intel_cdclk_init(struct intel_display *display);
63 void intel_cdclk_debugfs_register(struct intel_display *display);
64 
65 int intel_cdclk_logical(const struct intel_cdclk_state *cdclk_state);
66 int intel_cdclk_actual(const struct intel_cdclk_state *cdclk_state);
67 int intel_cdclk_actual_voltage_level(const struct intel_cdclk_state *cdclk_state);
68 int intel_cdclk_min_cdclk(const struct intel_cdclk_state *cdclk_state, enum pipe pipe);
69 bool intel_cdclk_pmdemand_needs_update(struct intel_atomic_state *state);
70 void intel_cdclk_force_min_cdclk(struct intel_cdclk_state *cdclk_state, int force_min_cdclk);
71 void intel_cdclk_read_hw(struct intel_display *display);
72 
73 unsigned int intel_cdclk_prefill_adjustment(const struct intel_crtc_state *crtc_state);
74 unsigned int intel_cdclk_prefill_adjustment_worst(const struct intel_crtc_state *crtc_state);
75 int intel_cdclk_min_cdclk_for_prefill(const struct intel_crtc_state *crtc_state,
76 				      unsigned int prefill_lines_unadjusted,
77 				      unsigned int prefill_lines_available);
78 
79 int intel_crtc_min_cdclk(const struct intel_crtc_state *crtc_state);
80 
81 #endif /* __INTEL_CDCLK_H__ */
82