1/* SPDX-License-Identifier: GPL-2.0-only */
2/*
3 * Copyright (c) 2015, The Linux Foundation. All rights reserved.
4 */
5
6#ifndef __DSI_PHY_H__
7#define __DSI_PHY_H__
8
9#include <linux/clk-provider.h>
10#include <linux/delay.h>
11#include <linux/regulator/consumer.h>
12
13#include "dsi.h"
14
15#define dsi_phy_read(offset) msm_readl((offset))
16#define dsi_phy_write(offset, data) msm_writel((data), (offset))
17#define dsi_phy_write_udelay(offset, data, delay_us) { msm_writel((data), (offset)); udelay(delay_us); }
18#define dsi_phy_write_ndelay(offset, data, delay_ns) { msm_writel((data), (offset)); ndelay(delay_ns); }
19
20struct msm_dsi_phy_ops {
21 int (*pll_init)(struct msm_dsi_phy *phy);
22 int (*enable)(struct msm_dsi_phy *phy,
23 struct msm_dsi_phy_clk_request *clk_req);
24 void (*disable)(struct msm_dsi_phy *phy);
25 void (*save_pll_state)(struct msm_dsi_phy *phy);
26 int (*restore_pll_state)(struct msm_dsi_phy *phy);
27 bool (*set_continuous_clock)(struct msm_dsi_phy *phy, bool enable);
28 int (*parse_dt_properties)(struct msm_dsi_phy *phy);
29};
30
31struct msm_dsi_phy_cfg {
32 const struct regulator_bulk_data *regulator_data;
33 int num_regulators;
34 struct msm_dsi_phy_ops ops;
35
36 unsigned long min_pll_rate;
37 unsigned long max_pll_rate;
38
39 const resource_size_t io_start[DSI_MAX];
40 const int num_dsi_phy;
41 const int quirks;
42 bool has_phy_regulator;
43 bool has_phy_lane;
44};
45
46extern const struct msm_dsi_phy_cfg dsi_phy_28nm_hpm_cfgs;
47extern const struct msm_dsi_phy_cfg dsi_phy_28nm_hpm_famb_cfgs;
48extern const struct msm_dsi_phy_cfg dsi_phy_28nm_lp_cfgs;
49extern const struct msm_dsi_phy_cfg dsi_phy_28nm_8226_cfgs;
50extern const struct msm_dsi_phy_cfg dsi_phy_28nm_8960_cfgs;
51extern const struct msm_dsi_phy_cfg dsi_phy_20nm_cfgs;
52extern const struct msm_dsi_phy_cfg dsi_phy_14nm_cfgs;
53extern const struct msm_dsi_phy_cfg dsi_phy_14nm_660_cfgs;
54extern const struct msm_dsi_phy_cfg dsi_phy_14nm_2290_cfgs;
55extern const struct msm_dsi_phy_cfg dsi_phy_14nm_8953_cfgs;
56extern const struct msm_dsi_phy_cfg dsi_phy_10nm_cfgs;
57extern const struct msm_dsi_phy_cfg dsi_phy_10nm_8998_cfgs;
58extern const struct msm_dsi_phy_cfg dsi_phy_7nm_cfgs;
59extern const struct msm_dsi_phy_cfg dsi_phy_7nm_6375_cfgs;
60extern const struct msm_dsi_phy_cfg dsi_phy_7nm_8150_cfgs;
61extern const struct msm_dsi_phy_cfg dsi_phy_7nm_7280_cfgs;
62extern const struct msm_dsi_phy_cfg dsi_phy_5nm_8350_cfgs;
63extern const struct msm_dsi_phy_cfg dsi_phy_5nm_8450_cfgs;
64extern const struct msm_dsi_phy_cfg dsi_phy_4nm_8550_cfgs;
65extern const struct msm_dsi_phy_cfg dsi_phy_4nm_8650_cfgs;
66
67struct msm_dsi_dphy_timing {
68 u32 clk_zero;
69 u32 clk_trail;
70 u32 clk_prepare;
71 u32 hs_exit;
72 u32 hs_zero;
73 u32 hs_prepare;
74 u32 hs_trail;
75 u32 hs_rqst;
76 u32 ta_go;
77 u32 ta_sure;
78 u32 ta_get;
79
80 struct msm_dsi_phy_shared_timings shared_timings;
81
82 /* For PHY v2 only */
83 u32 hs_rqst_ckln;
84 u32 hs_prep_dly;
85 u32 hs_prep_dly_ckln;
86 u8 hs_halfbyte_en;
87 u8 hs_halfbyte_en_ckln;
88};
89
90#define DSI_BYTE_PLL_CLK 0
91#define DSI_PIXEL_PLL_CLK 1
92#define NUM_PROVIDED_CLKS 2
93
94#define DSI_LANE_MAX 5
95
96struct msm_dsi_phy {
97 struct platform_device *pdev;
98 void __iomem *base;
99 void __iomem *pll_base;
100 void __iomem *reg_base;
101 void __iomem *lane_base;
102 phys_addr_t base_size;
103 phys_addr_t pll_size;
104 phys_addr_t reg_size;
105 phys_addr_t lane_size;
106 int id;
107
108 struct clk *ahb_clk;
109 struct regulator_bulk_data *supplies;
110
111 struct msm_dsi_dphy_timing timing;
112 const struct msm_dsi_phy_cfg *cfg;
113 void *tuning_cfg;
114
115 enum msm_dsi_phy_usecase usecase;
116 bool regulator_ldo_mode;
117 bool cphy_mode;
118
119 struct clk_hw *vco_hw;
120 bool pll_on;
121
122 struct clk_hw_onecell_data *provided_clocks;
123
124 bool state_saved;
125};
126
127/*
128 * PHY internal functions
129 */
130int msm_dsi_dphy_timing_calc(struct msm_dsi_dphy_timing *timing,
131 struct msm_dsi_phy_clk_request *clk_req);
132int msm_dsi_dphy_timing_calc_v2(struct msm_dsi_dphy_timing *timing,
133 struct msm_dsi_phy_clk_request *clk_req);
134int msm_dsi_dphy_timing_calc_v3(struct msm_dsi_dphy_timing *timing,
135 struct msm_dsi_phy_clk_request *clk_req);
136int msm_dsi_dphy_timing_calc_v4(struct msm_dsi_dphy_timing *timing,
137 struct msm_dsi_phy_clk_request *clk_req);
138int msm_dsi_cphy_timing_calc_v4(struct msm_dsi_dphy_timing *timing,
139 struct msm_dsi_phy_clk_request *clk_req);
140
141#endif /* __DSI_PHY_H__ */
142

source code of linux/drivers/gpu/drm/msm/dsi/phy/dsi_phy.h