intel_cdclk.h

 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
11enum pipe;
12struct intel_atomic_state;
13struct intel_cdclk_state;
14struct intel_crtc;
15struct intel_crtc_state;
16struct intel_display;
17
18struct 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
25void intel_cdclk_init_hw(struct intel_display *display);
26void intel_cdclk_uninit_hw(struct intel_display *display);
27void intel_init_cdclk_hooks(struct intel_display *display);
28void intel_update_max_cdclk(struct intel_display *display);
29void intel_update_cdclk(struct intel_display *display);
30u32 intel_read_rawclk(struct intel_display *display);
31bool intel_cdclk_clock_changed(const struct intel_cdclk_config *a,
32			       const struct intel_cdclk_config *b);
33int intel_mdclk_cdclk_ratio(struct intel_display *display,
34			    const struct intel_cdclk_config *cdclk_config);
35bool intel_cdclk_is_decreasing_later(struct intel_atomic_state *state);
36void intel_set_cdclk_pre_plane_update(struct intel_atomic_state *state);
37void intel_set_cdclk_post_plane_update(struct intel_atomic_state *state);
38void intel_cdclk_dump_config(struct intel_display *display,
39			     const struct intel_cdclk_config *cdclk_config,
40			     const char *context);
41void intel_cdclk_get_cdclk(struct intel_display *display,
42			   struct intel_cdclk_config *cdclk_config);
43int intel_cdclk_atomic_check(struct intel_atomic_state *state);
44int intel_cdclk_state_set_joined_mbus(struct intel_atomic_state *state, bool joined_mbus);
45struct intel_cdclk_state *
46intel_atomic_get_cdclk_state(struct intel_atomic_state *state);
47void intel_cdclk_update_hw_state(struct intel_display *display);
48void intel_cdclk_crtc_disable_noatomic(struct intel_crtc *crtc);
49int intel_cdclk_update_dbuf_bw_min_cdclk(struct intel_atomic_state *state,
50					 int old_min_cdclk, int new_min_cdclk,
51					 bool *need_cdclk_calc);
52
53#define to_intel_cdclk_state(global_state) \
54	container_of_const((global_state), struct intel_cdclk_state, base)
55
56#define intel_atomic_get_old_cdclk_state(state) \
57	to_intel_cdclk_state(intel_atomic_get_old_global_obj_state(state, &to_intel_display(state)->cdclk.obj))
58#define intel_atomic_get_new_cdclk_state(state) \
59	to_intel_cdclk_state(intel_atomic_get_new_global_obj_state(state, &to_intel_display(state)->cdclk.obj))
60
61int intel_cdclk_init(struct intel_display *display);
62void intel_cdclk_debugfs_register(struct intel_display *display);
63
64int intel_cdclk_logical(const struct intel_cdclk_state *cdclk_state);
65int intel_cdclk_actual(const struct intel_cdclk_state *cdclk_state);
66int intel_cdclk_actual_voltage_level(const struct intel_cdclk_state *cdclk_state);
67int intel_cdclk_min_cdclk(const struct intel_cdclk_state *cdclk_state, enum pipe pipe);
68bool intel_cdclk_pmdemand_needs_update(struct intel_atomic_state *state);
69void intel_cdclk_force_min_cdclk(struct intel_cdclk_state *cdclk_state, int force_min_cdclk);
70void intel_cdclk_read_hw(struct intel_display *display);
71
72unsigned int intel_cdclk_prefill_adjustment(const struct intel_crtc_state *crtc_state);
73unsigned int intel_cdclk_prefill_adjustment_worst(const struct intel_crtc_state *crtc_state);
74int intel_cdclk_min_cdclk_for_prefill(const struct intel_crtc_state *crtc_state,
75				      unsigned int prefill_lines_unadjusted,
76				      unsigned int prefill_lines_available);
77
78int intel_crtc_min_cdclk(const struct intel_crtc_state *crtc_state);
79
80#endif /* __INTEL_CDCLK_H__ */