dsi_pll.h 5.4 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237
  1. /* SPDX-License-Identifier: GPL-2.0-only */
  2. /*
  3. * Copyright (c) 2020, The Linux Foundation. All rights reserved.
  4. */
  5. #ifndef __DSI_PLL_H
  6. #define __DSI_PLL_H
  7. #include <linux/clk-provider.h>
  8. #include <linux/io.h>
  9. #include <linux/clk.h>
  10. #include <linux/clkdev.h>
  11. #include <linux/regmap.h>
  12. #include "clk-regmap.h"
  13. #include "clk-regmap-divider.h"
  14. #include "clk-regmap-mux.h"
  15. #include "dsi_defs.h"
  16. #define DSI_PLL_DBG(p, fmt, ...) DRM_DEV_DEBUG(NULL, "[msm-dsi-debug]: DSI_PLL_%d: "\
  17. fmt, p ? p->index : -1, ##__VA_ARGS__)
  18. #define DSI_PLL_ERR(p, fmt, ...) DRM_DEV_ERROR(NULL, "[msm-dsi-error]: DSI_PLL_%d: "\
  19. fmt, p ? p->index : -1, ##__VA_ARGS__)
  20. #define DSI_PLL_INFO(p, fmt, ...) DRM_DEV_INFO(NULL, "[msm-dsi-info]: DSI_PLL_%d: "\
  21. fmt, p ? p->index : -1, ##__VA_ARGS__)
  22. #define DSI_PLL_WARN(p, fmt, ...) DRM_WARN("[msm-dsi-warn]: DSI_PLL_%d: "\
  23. fmt, p ? p->index : -1, ##__VA_ARGS__)
  24. #define DSI_PLL_REG_W(base, offset, data) \
  25. writel_relaxed((data), (base) + (offset))
  26. #define DSI_PLL_REG_R(base, offset) readl_relaxed((base) + (offset))
  27. #define PLL_CALC_DATA(addr0, addr1, data0, data1) \
  28. (((data1) << 24) | ((((addr1) / 4) & 0xFF) << 16) | \
  29. ((data0) << 8) | (((addr0) / 4) & 0xFF))
  30. #define DSI_DYN_PLL_REG_W(base, offset, addr0, addr1, data0, data1) \
  31. writel_relaxed(PLL_CALC_DATA(addr0, addr1, data0, data1), \
  32. (base) + (offset))
  33. #define upper_8_bit(x) ((((x) >> 2) & 0x100) >> 8)
  34. #define DFPS_MAX_NUM_OF_FRAME_RATES 16
  35. #define MAX_DSI_PLL_EN_SEQS 10
  36. /* Register offsets for 5nm PHY PLL */
  37. #define MMSS_DSI_PHY_PLL_PLL_CNTRL (0x0014)
  38. #define MMSS_DSI_PHY_PLL_PLL_BKG_KVCO_CAL_EN (0x002C)
  39. #define MMSS_DSI_PHY_PLL_PLLLOCK_CMP_EN (0x009C)
  40. struct lpfr_cfg {
  41. unsigned long vco_rate;
  42. u32 r;
  43. };
  44. enum {
  45. DSI_PLL_5NM,
  46. DSI_PLL_10NM,
  47. DSI_UNKNOWN_PLL,
  48. };
  49. struct dfps_pll_codes {
  50. uint32_t pll_codes_1;
  51. uint32_t pll_codes_2;
  52. uint32_t pll_codes_3;
  53. };
  54. struct dfps_codes_info {
  55. uint32_t is_valid;
  56. uint32_t clk_rate; /* hz */
  57. struct dfps_pll_codes pll_codes;
  58. };
  59. struct dfps_info {
  60. uint32_t vco_rate_cnt;
  61. struct dfps_codes_info codes_dfps[DFPS_MAX_NUM_OF_FRAME_RATES];
  62. };
  63. struct dsi_pll_resource {
  64. /*
  65. * dsi base register, phy, gdsc and dynamic refresh
  66. * register mapping
  67. */
  68. void __iomem *pll_base;
  69. void __iomem *phy_base;
  70. void __iomem *gdsc_base;
  71. void __iomem *dyn_pll_base;
  72. s64 vco_current_rate;
  73. s64 vco_locking_rate;
  74. s64 vco_ref_clk_rate;
  75. /*
  76. * Certain pll's needs to update the same vco rate after resume in
  77. * suspend/resume scenario. Cached the vco rate for such plls.
  78. */
  79. unsigned long vco_cached_rate;
  80. u32 cached_cfg0;
  81. u32 cached_cfg1;
  82. u32 cached_outdiv;
  83. u32 cached_postdiv1;
  84. u32 cached_postdiv3;
  85. u32 pll_revision;
  86. /* HW recommended delay during configuration of vco clock rate */
  87. u32 vco_delay;
  88. /*
  89. * Certain plls' do not allow vco rate update if it is on. Keep track of
  90. * status for them to turn on/off after set rate success.
  91. */
  92. bool pll_on;
  93. /*
  94. * handoff_status is true of pll is already enabled by bootloader with
  95. * continuous splash enable case. Clock API will call the handoff API
  96. * to enable the status. It is disabled if continuous splash
  97. * feature is disabled.
  98. */
  99. bool handoff_resources;
  100. /*
  101. * caching the pll trim codes in the case of dynamic refresh
  102. */
  103. int cache_pll_trim_codes[3];
  104. /*
  105. * for maintaining the status of saving trim codes
  106. */
  107. bool reg_upd;
  108. /*
  109. * PLL index if multiple index are available. Eg. in case of
  110. * DSI we have 2 plls.
  111. */
  112. uint32_t index;
  113. bool ssc_en; /* share pll with master */
  114. bool ssc_center; /* default is down spread */
  115. u32 ssc_freq;
  116. u32 ssc_ppm;
  117. struct dsi_pll_resource *slave;
  118. /*
  119. * target pll revision information
  120. */
  121. int revision;
  122. void *priv;
  123. /*
  124. * dynamic refresh pll codes stored in this structure
  125. */
  126. struct dfps_info *dfps;
  127. /*
  128. * for cases where dfps trigger happens before first
  129. * suspend/resume and handoff is not finished.
  130. */
  131. bool dfps_trigger;
  132. };
  133. struct dsi_pll_vco_clk {
  134. struct clk_hw hw;
  135. unsigned long ref_clk_rate;
  136. u64 min_rate;
  137. u64 max_rate;
  138. u32 pll_en_seq_cnt;
  139. struct lpfr_cfg *lpfr_lut;
  140. u32 lpfr_lut_size;
  141. void *priv;
  142. int (*pll_enable_seqs[MAX_DSI_PLL_EN_SEQS])
  143. (struct dsi_pll_resource *pll_res);
  144. };
  145. struct dsi_pll_vco_calc {
  146. s32 div_frac_start1;
  147. s32 div_frac_start2;
  148. s32 div_frac_start3;
  149. s64 dec_start1;
  150. s64 dec_start2;
  151. s64 pll_plllock_cmp1;
  152. s64 pll_plllock_cmp2;
  153. s64 pll_plllock_cmp3;
  154. };
  155. static inline bool is_gdsc_disabled(struct dsi_pll_resource *pll_res)
  156. {
  157. if (!pll_res->gdsc_base) {
  158. WARN(1, "gdsc_base register is not defined\n");
  159. return true;
  160. }
  161. return readl_relaxed(pll_res->gdsc_base) & BIT(31) ? false : true;
  162. }
  163. static inline int dsi_pll_div_prepare(struct clk_hw *hw)
  164. {
  165. struct clk_hw *parent_hw = clk_hw_get_parent(hw);
  166. /* Restore the divider's value */
  167. return hw->init->ops->set_rate(hw, clk_hw_get_rate(hw),
  168. clk_hw_get_rate(parent_hw));
  169. }
  170. static inline int dsi_set_mux_sel(void *context, unsigned int reg,
  171. unsigned int val)
  172. {
  173. return 0;
  174. }
  175. static inline int dsi_get_mux_sel(void *context, unsigned int reg,
  176. unsigned int *val)
  177. {
  178. *val = 0;
  179. return 0;
  180. }
  181. static inline struct dsi_pll_vco_clk *to_vco_clk_hw(struct clk_hw *hw)
  182. {
  183. return container_of(hw, struct dsi_pll_vco_clk, hw);
  184. }
  185. int dsi_pll_clock_register_5nm(struct platform_device *pdev,
  186. struct dsi_pll_resource *pll_res);
  187. int dsi_pll_clock_register_10nm(struct platform_device *pdev,
  188. struct dsi_pll_resource *pll_res);
  189. int dsi_pll_init(struct platform_device *pdev,
  190. struct dsi_pll_resource **pll_res);
  191. #endif