xref: /kernel/linux/linux-6.6/drivers/gpu/drm/msm/dsi/dsi.h (revision 62306a36)
1/* SPDX-License-Identifier: GPL-2.0-only */
2/*
3 * Copyright (c) 2015, The Linux Foundation. All rights reserved.
4 */
5
6#ifndef __DSI_CONNECTOR_H__
7#define __DSI_CONNECTOR_H__
8
9#include <linux/of_platform.h>
10#include <linux/platform_device.h>
11
12#include <drm/drm_bridge.h>
13#include <drm/drm_crtc.h>
14#include <drm/drm_mipi_dsi.h>
15
16#include "msm_drv.h"
17#include "disp/msm_disp_snapshot.h"
18
19#define DSI_0	0
20#define DSI_1	1
21#define DSI_MAX	2
22
23struct msm_dsi_phy_shared_timings;
24struct msm_dsi_phy_clk_request;
25
26enum msm_dsi_phy_usecase {
27	MSM_DSI_PHY_STANDALONE,
28	MSM_DSI_PHY_MASTER,
29	MSM_DSI_PHY_SLAVE,
30};
31
32#define DSI_BUS_CLK_MAX		4
33
34struct msm_dsi {
35	struct drm_device *dev;
36	struct platform_device *pdev;
37
38	/* internal dsi bridge attached to MDP interface */
39	struct drm_bridge *bridge;
40
41	struct mipi_dsi_host *host;
42	struct msm_dsi_phy *phy;
43
44	/*
45	 * external_bridge connected to dsi bridge output
46	 */
47	struct drm_bridge *external_bridge;
48
49	struct device *phy_dev;
50	bool phy_enabled;
51
52	/* the encoder we are hooked to (outside of dsi block) */
53	struct drm_encoder *encoder;
54
55	int id;
56};
57
58/* dsi manager */
59struct drm_bridge *msm_dsi_manager_bridge_init(u8 id);
60void msm_dsi_manager_bridge_destroy(struct drm_bridge *bridge);
61int msm_dsi_manager_ext_bridge_init(u8 id);
62int msm_dsi_manager_cmd_xfer(int id, const struct mipi_dsi_msg *msg);
63bool msm_dsi_manager_cmd_xfer_trigger(int id, u32 dma_base, u32 len);
64int msm_dsi_manager_register(struct msm_dsi *msm_dsi);
65void msm_dsi_manager_unregister(struct msm_dsi *msm_dsi);
66void msm_dsi_manager_tpg_enable(void);
67
68/* msm dsi */
69static inline bool msm_dsi_device_connected(struct msm_dsi *msm_dsi)
70{
71	return msm_dsi->external_bridge;
72}
73
74/* dsi host */
75struct msm_dsi_host;
76int msm_dsi_host_xfer_prepare(struct mipi_dsi_host *host,
77					const struct mipi_dsi_msg *msg);
78void msm_dsi_host_xfer_restore(struct mipi_dsi_host *host,
79					const struct mipi_dsi_msg *msg);
80int msm_dsi_host_cmd_tx(struct mipi_dsi_host *host,
81					const struct mipi_dsi_msg *msg);
82int msm_dsi_host_cmd_rx(struct mipi_dsi_host *host,
83					const struct mipi_dsi_msg *msg);
84void msm_dsi_host_cmd_xfer_commit(struct mipi_dsi_host *host,
85					u32 dma_base, u32 len);
86int msm_dsi_host_enable(struct mipi_dsi_host *host);
87int msm_dsi_host_disable(struct mipi_dsi_host *host);
88void msm_dsi_host_enable_irq(struct mipi_dsi_host *host);
89void msm_dsi_host_disable_irq(struct mipi_dsi_host *host);
90int msm_dsi_host_power_on(struct mipi_dsi_host *host,
91			struct msm_dsi_phy_shared_timings *phy_shared_timings,
92			bool is_bonded_dsi, struct msm_dsi_phy *phy);
93int msm_dsi_host_power_off(struct mipi_dsi_host *host);
94int msm_dsi_host_set_display_mode(struct mipi_dsi_host *host,
95				  const struct drm_display_mode *mode);
96enum drm_mode_status msm_dsi_host_check_dsc(struct mipi_dsi_host *host,
97					    const struct drm_display_mode *mode);
98unsigned long msm_dsi_host_get_mode_flags(struct mipi_dsi_host *host);
99int msm_dsi_host_register(struct mipi_dsi_host *host);
100void msm_dsi_host_unregister(struct mipi_dsi_host *host);
101void msm_dsi_host_set_phy_mode(struct mipi_dsi_host *host,
102			struct msm_dsi_phy *src_phy);
103int msm_dsi_host_set_src_pll(struct mipi_dsi_host *host,
104			struct msm_dsi_phy *src_phy);
105void msm_dsi_host_reset_phy(struct mipi_dsi_host *host);
106void msm_dsi_host_get_phy_clk_req(struct mipi_dsi_host *host,
107	struct msm_dsi_phy_clk_request *clk_req,
108	bool is_bonded_dsi);
109void msm_dsi_host_destroy(struct mipi_dsi_host *host);
110int msm_dsi_host_modeset_init(struct mipi_dsi_host *host,
111					struct drm_device *dev);
112int msm_dsi_host_init(struct msm_dsi *msm_dsi);
113int msm_dsi_runtime_suspend(struct device *dev);
114int msm_dsi_runtime_resume(struct device *dev);
115int dsi_link_clk_set_rate_6g(struct msm_dsi_host *msm_host);
116int dsi_link_clk_set_rate_v2(struct msm_dsi_host *msm_host);
117int dsi_link_clk_enable_6g(struct msm_dsi_host *msm_host);
118int dsi_link_clk_enable_v2(struct msm_dsi_host *msm_host);
119void dsi_link_clk_disable_6g(struct msm_dsi_host *msm_host);
120void dsi_link_clk_disable_v2(struct msm_dsi_host *msm_host);
121unsigned long dsi_byte_clk_get_rate(struct mipi_dsi_host *host, bool is_bonded_dsi,
122				    const struct drm_display_mode *mode);
123int dsi_tx_buf_alloc_6g(struct msm_dsi_host *msm_host, int size);
124int dsi_tx_buf_alloc_v2(struct msm_dsi_host *msm_host, int size);
125void *dsi_tx_buf_get_6g(struct msm_dsi_host *msm_host);
126void *dsi_tx_buf_get_v2(struct msm_dsi_host *msm_host);
127void dsi_tx_buf_put_6g(struct msm_dsi_host *msm_host);
128void msm_dsi_tx_buf_free(struct mipi_dsi_host *mipi_host);
129int dsi_dma_base_get_6g(struct msm_dsi_host *msm_host, uint64_t *iova);
130int dsi_dma_base_get_v2(struct msm_dsi_host *msm_host, uint64_t *iova);
131int dsi_clk_init_v2(struct msm_dsi_host *msm_host);
132int dsi_clk_init_6g_v2(struct msm_dsi_host *msm_host);
133int dsi_calc_clk_rate_v2(struct msm_dsi_host *msm_host, bool is_bonded_dsi);
134int dsi_calc_clk_rate_6g(struct msm_dsi_host *msm_host, bool is_bonded_dsi);
135void msm_dsi_host_snapshot(struct msm_disp_state *disp_state, struct mipi_dsi_host *host);
136void msm_dsi_host_test_pattern_en(struct mipi_dsi_host *host);
137struct drm_dsc_config *msm_dsi_host_get_dsc_config(struct mipi_dsi_host *host);
138
139/* dsi phy */
140struct msm_dsi_phy;
141struct msm_dsi_phy_shared_timings {
142	u32 clk_post;
143	u32 clk_pre;
144	bool clk_pre_inc_by_2;
145	bool byte_intf_clk_div_2;
146};
147
148struct msm_dsi_phy_clk_request {
149	unsigned long bitclk_rate;
150	unsigned long escclk_rate;
151};
152
153void msm_dsi_phy_driver_register(void);
154void msm_dsi_phy_driver_unregister(void);
155int msm_dsi_phy_enable(struct msm_dsi_phy *phy,
156			struct msm_dsi_phy_clk_request *clk_req,
157			struct msm_dsi_phy_shared_timings *shared_timings);
158void msm_dsi_phy_disable(struct msm_dsi_phy *phy);
159void msm_dsi_phy_set_usecase(struct msm_dsi_phy *phy,
160			     enum msm_dsi_phy_usecase uc);
161void msm_dsi_phy_pll_save_state(struct msm_dsi_phy *phy);
162int msm_dsi_phy_pll_restore_state(struct msm_dsi_phy *phy);
163void msm_dsi_phy_snapshot(struct msm_disp_state *disp_state, struct msm_dsi_phy *phy);
164bool msm_dsi_phy_set_continuous_clock(struct msm_dsi_phy *phy, bool enable);
165
166#endif /* __DSI_CONNECTOR_H__ */
167
168