xref: /openbmc/linux/drivers/gpu/drm/msm/dp/dp_parser.h (revision f4c3b83b)
1 /* SPDX-License-Identifier: GPL-2.0-only */
2 /*
3  * Copyright (c) 2012-2020, The Linux Foundation. All rights reserved.
4  */
5 
6 #ifndef _DP_PARSER_H_
7 #define _DP_PARSER_H_
8 
9 #include <linux/platform_device.h>
10 #include <linux/phy/phy.h>
11 #include <linux/phy/phy-dp.h>
12 
13 #include "dpu_io_util.h"
14 #include "msm_drv.h"
15 
16 #define DP_LABEL "MDSS DP DISPLAY"
17 #define DP_MAX_PIXEL_CLK_KHZ	675000
18 #define DP_MAX_NUM_DP_LANES	4
19 
20 enum dp_pm_type {
21 	DP_CORE_PM,
22 	DP_CTRL_PM,
23 	DP_STREAM_PM,
24 	DP_PHY_PM,
25 	DP_MAX_PM
26 };
27 
28 struct dss_io_data {
29 	u32 len;
30 	void __iomem *base;
31 };
32 
33 static inline const char *dp_parser_pm_name(enum dp_pm_type module)
34 {
35 	switch (module) {
36 	case DP_CORE_PM:	return "DP_CORE_PM";
37 	case DP_CTRL_PM:	return "DP_CTRL_PM";
38 	case DP_STREAM_PM:	return "DP_STREAM_PM";
39 	case DP_PHY_PM:		return "DP_PHY_PM";
40 	default:		return "???";
41 	}
42 }
43 
44 /**
45  * struct dp_display_data  - display related device tree data.
46  *
47  * @ctrl_node: referece to controller device
48  * @phy_node:  reference to phy device
49  * @is_active: is the controller currently active
50  * @name: name of the display
51  * @display_type: type of the display
52  */
53 struct dp_display_data {
54 	struct device_node *ctrl_node;
55 	struct device_node *phy_node;
56 	bool is_active;
57 	const char *name;
58 	const char *display_type;
59 };
60 
61 /**
62  * struct dp_ctrl_resource - controller's IO related data
63  *
64  * @dp_controller: Display Port controller mapped memory address
65  * @phy_io: phy's mapped memory address
66  */
67 struct dp_io {
68 	struct dss_io_data dp_controller;
69 	struct phy *phy;
70 	union phy_configure_opts phy_opts;
71 };
72 
73 /**
74  * struct dp_pinctrl - DP's pin control
75  *
76  * @pin: pin-controller's instance
77  * @state_active: active state pin control
78  * @state_hpd_active: hpd active state pin control
79  * @state_suspend: suspend state pin control
80  */
81 struct dp_pinctrl {
82 	struct pinctrl *pin;
83 	struct pinctrl_state *state_active;
84 	struct pinctrl_state *state_hpd_active;
85 	struct pinctrl_state *state_suspend;
86 };
87 
88 #define DP_DEV_REGULATOR_MAX	4
89 
90 /* Regulators for DP devices */
91 struct dp_reg_entry {
92 	char name[32];
93 	int enable_load;
94 	int disable_load;
95 };
96 
97 struct dp_regulator_cfg {
98 	int num;
99 	struct dp_reg_entry regs[DP_DEV_REGULATOR_MAX];
100 };
101 
102 /**
103  * struct dp_parser - DP parser's data exposed to clients
104  *
105  * @pdev: platform data of the client
106  * @mp: gpio, regulator and clock related data
107  * @pinctrl: pin-control related data
108  * @disp_data: controller's display related data
109  * @parse: function to be called by client to parse device tree.
110  */
111 struct dp_parser {
112 	struct platform_device *pdev;
113 	struct dss_module_power mp[DP_MAX_PM];
114 	struct dp_pinctrl pinctrl;
115 	struct dp_io io;
116 	struct dp_display_data disp_data;
117 	const struct dp_regulator_cfg *regulator_cfg;
118 	u32 max_dp_lanes;
119 
120 	int (*parse)(struct dp_parser *parser);
121 };
122 
123 /**
124  * dp_parser_get() - get the DP's device tree parser module
125  *
126  * @pdev: platform data of the client
127  * return: pointer to dp_parser structure.
128  *
129  * This function provides client capability to parse the
130  * device tree and populate the data structures. The data
131  * related to clock, regulators, pin-control and other
132  * can be parsed using this module.
133  */
134 struct dp_parser *dp_parser_get(struct platform_device *pdev);
135 
136 #endif
137