1/* SPDX-License-Identifier: GPL-2.0 */
2/*
3 * Clock driver for TI Davinci PSC controllers
4 *
5 * Copyright (C) 2018 David Lechner <david@lechnology.com>
6 */
7
8#ifndef __CLK_DAVINCI_PLL_H___
9#define __CLK_DAVINCI_PLL_H___
10
11#include <linux/bitops.h>
12#include <linux/clk-provider.h>
13#include <linux/of.h>
14#include <linux/regmap.h>
15#include <linux/types.h>
16
17#define PLL_HAS_CLKMODE BIT(0) /* PLL has PLLCTL[CLKMODE] */
18#define PLL_HAS_PREDIV BIT(1) /* has prediv before PLL */
19#define PLL_PREDIV_ALWAYS_ENABLED BIT(2) /* don't clear DEN bit */
20#define PLL_PREDIV_FIXED_DIV BIT(3) /* fixed divider value */
21#define PLL_HAS_POSTDIV BIT(4) /* has postdiv after PLL */
22#define PLL_POSTDIV_ALWAYS_ENABLED BIT(5) /* don't clear DEN bit */
23#define PLL_POSTDIV_FIXED_DIV BIT(6) /* fixed divider value */
24#define PLL_HAS_EXTCLKSRC BIT(7) /* has selectable bypass */
25#define PLL_PLLM_2X BIT(8) /* PLLM value is 2x (DM365) */
26#define PLL_PREDIV_FIXED8 BIT(9) /* DM355 quirk */
27
28/** davinci_pll_clk_info - controller-specific PLL info
29 * @name: The name of the PLL
30 * @unlock_reg: Option CFGCHIP register for unlocking PLL
31 * @unlock_mask: Bitmask used with @unlock_reg
32 * @pllm_mask: Bitmask for PLLM[PLLM] value
33 * @pllm_min: Minimum allowable value for PLLM[PLLM]
34 * @pllm_max: Maximum allowable value for PLLM[PLLM]
35 * @pllout_min_rate: Minimum allowable rate for PLLOUT
36 * @pllout_max_rate: Maximum allowable rate for PLLOUT
37 * @flags: Bitmap of PLL_* flags.
38 */
39struct davinci_pll_clk_info {
40 const char *name;
41 u32 unlock_reg;
42 u32 unlock_mask;
43 u32 pllm_mask;
44 u32 pllm_min;
45 u32 pllm_max;
46 unsigned long pllout_min_rate;
47 unsigned long pllout_max_rate;
48 u32 flags;
49};
50
51#define SYSCLK_ARM_RATE BIT(0) /* Controls ARM rate */
52#define SYSCLK_ALWAYS_ENABLED BIT(1) /* Or bad things happen */
53#define SYSCLK_FIXED_DIV BIT(2) /* Fixed divider */
54
55/** davinci_pll_sysclk_info - SYSCLKn-specific info
56 * @name: The name of the clock
57 * @parent_name: The name of the parent clock
58 * @id: "n" in "SYSCLKn"
59 * @ratio_width: Width (in bits) of RATIO in PLLDIVn register
60 * @flags: Bitmap of SYSCLK_* flags.
61 */
62struct davinci_pll_sysclk_info {
63 const char *name;
64 const char *parent_name;
65 u32 id;
66 u32 ratio_width;
67 u32 flags;
68};
69
70#define SYSCLK(i, n, p, w, f) \
71static const struct davinci_pll_sysclk_info n = { \
72 .name = #n, \
73 .parent_name = #p, \
74 .id = (i), \
75 .ratio_width = (w), \
76 .flags = (f), \
77}
78
79/** davinci_pll_obsclk_info - OBSCLK-specific info
80 * @name: The name of the clock
81 * @parent_names: Array of names of the parent clocks
82 * @num_parents: Length of @parent_names
83 * @table: Array of values to write to OCSEL[OCSRC] cooresponding to
84 * @parent_names
85 * @ocsrc_mask: Bitmask for OCSEL[OCSRC]
86 */
87struct davinci_pll_obsclk_info {
88 const char *name;
89 const char * const *parent_names;
90 u8 num_parents;
91 u32 *table;
92 u32 ocsrc_mask;
93};
94
95struct clk *davinci_pll_clk_register(struct device *dev,
96 const struct davinci_pll_clk_info *info,
97 const char *parent_name,
98 void __iomem *base,
99 struct regmap *cfgchip);
100struct clk *davinci_pll_auxclk_register(struct device *dev,
101 const char *name,
102 void __iomem *base);
103struct clk *davinci_pll_sysclkbp_clk_register(struct device *dev,
104 const char *name,
105 void __iomem *base);
106struct clk *
107davinci_pll_obsclk_register(struct device *dev,
108 const struct davinci_pll_obsclk_info *info,
109 void __iomem *base);
110struct clk *
111davinci_pll_sysclk_register(struct device *dev,
112 const struct davinci_pll_sysclk_info *info,
113 void __iomem *base);
114
115int of_davinci_pll_init(struct device *dev, struct device_node *node,
116 const struct davinci_pll_clk_info *info,
117 const struct davinci_pll_obsclk_info *obsclk_info,
118 const struct davinci_pll_sysclk_info **div_info,
119 u8 max_sysclk_id,
120 void __iomem *base,
121 struct regmap *cfgchip);
122
123/* Platform-specific callbacks */
124
125int da850_pll1_init(struct device *dev, void __iomem *base, struct regmap *cfgchip);
126void of_da850_pll0_init(struct device_node *node);
127int of_da850_pll1_init(struct device *dev, void __iomem *base, struct regmap *cfgchip);
128
129#endif /* __CLK_DAVINCI_PLL_H___ */
130

source code of linux/drivers/clk/davinci/pll.h