1/* SPDX-License-Identifier: GPL-2.0-only */
2/*
3 * TI Clock driver internal definitions
4 *
5 * Copyright (C) 2014 Texas Instruments, Inc
6 * Tero Kristo (t-kristo@ti.com)
7 */
8#ifndef __DRIVERS_CLK_TI_CLOCK__
9#define __DRIVERS_CLK_TI_CLOCK__
10
11struct clk_omap_divider {
12 struct clk_hw hw;
13 struct clk_omap_reg reg;
14 u8 shift;
15 u8 flags;
16 s8 latch;
17 u16 min;
18 u16 max;
19 u16 mask;
20 const struct clk_div_table *table;
21 u32 context;
22};
23
24#define to_clk_omap_divider(_hw) container_of(_hw, struct clk_omap_divider, hw)
25
26struct clk_omap_mux {
27 struct clk_hw hw;
28 struct clk_omap_reg reg;
29 u32 *table;
30 u32 mask;
31 u8 shift;
32 s8 latch;
33 u8 flags;
34 u8 saved_parent;
35};
36
37#define to_clk_omap_mux(_hw) container_of(_hw, struct clk_omap_mux, hw)
38
39enum {
40 TI_CLK_FIXED,
41 TI_CLK_MUX,
42 TI_CLK_DIVIDER,
43 TI_CLK_COMPOSITE,
44 TI_CLK_FIXED_FACTOR,
45 TI_CLK_GATE,
46 TI_CLK_DPLL,
47};
48
49/* Global flags */
50#define CLKF_INDEX_POWER_OF_TWO (1 << 0)
51#define CLKF_INDEX_STARTS_AT_ONE (1 << 1)
52#define CLKF_SET_RATE_PARENT (1 << 2)
53#define CLKF_OMAP3 (1 << 3)
54#define CLKF_AM35XX (1 << 4)
55
56/* Gate flags */
57#define CLKF_SET_BIT_TO_DISABLE (1 << 5)
58#define CLKF_INTERFACE (1 << 6)
59#define CLKF_SSI (1 << 7)
60#define CLKF_DSS (1 << 8)
61#define CLKF_HSOTGUSB (1 << 9)
62#define CLKF_WAIT (1 << 10)
63#define CLKF_NO_WAIT (1 << 11)
64#define CLKF_HSDIV (1 << 12)
65#define CLKF_CLKDM (1 << 13)
66
67/* DPLL flags */
68#define CLKF_LOW_POWER_STOP (1 << 5)
69#define CLKF_LOCK (1 << 6)
70#define CLKF_LOW_POWER_BYPASS (1 << 7)
71#define CLKF_PER (1 << 8)
72#define CLKF_CORE (1 << 9)
73#define CLKF_J_TYPE (1 << 10)
74
75/* CLKCTRL flags */
76#define CLKF_SW_SUP BIT(5)
77#define CLKF_HW_SUP BIT(6)
78#define CLKF_NO_IDLEST BIT(7)
79
80#define CLKF_SOC_MASK GENMASK(11, 8)
81
82#define CLKF_SOC_NONSEC BIT(8)
83#define CLKF_SOC_DRA72 BIT(9)
84#define CLKF_SOC_DRA74 BIT(10)
85#define CLKF_SOC_DRA76 BIT(11)
86
87#define CLK(dev, con, ck) \
88 { \
89 .lk = { \
90 .dev_id = dev, \
91 .con_id = con, \
92 }, \
93 .clk = ck, \
94 }
95
96struct ti_clk {
97 const char *name;
98 const char *clkdm_name;
99 int type;
100 void *data;
101 struct ti_clk *patch;
102 struct clk *clk;
103};
104
105struct ti_clk_mux {
106 u8 bit_shift;
107 int num_parents;
108 u16 reg;
109 u8 module;
110 const char * const *parents;
111 u16 flags;
112};
113
114struct ti_clk_divider {
115 const char *parent;
116 u8 bit_shift;
117 u16 max_div;
118 u16 reg;
119 u8 module;
120 int *dividers;
121 int num_dividers;
122 u16 flags;
123};
124
125struct ti_clk_gate {
126 const char *parent;
127 u8 bit_shift;
128 u16 reg;
129 u8 module;
130 u16 flags;
131};
132
133/* Composite clock component types */
134enum {
135 CLK_COMPONENT_TYPE_GATE = 0,
136 CLK_COMPONENT_TYPE_DIVIDER,
137 CLK_COMPONENT_TYPE_MUX,
138 CLK_COMPONENT_TYPE_MAX,
139};
140
141/**
142 * struct ti_dt_clk - OMAP DT clock alias declarations
143 * @lk: clock lookup definition
144 * @node_name: clock DT node to map to
145 */
146struct ti_dt_clk {
147 struct clk_lookup lk;
148 char *node_name;
149};
150
151#define DT_CLK(dev, con, name) \
152 { \
153 .lk = { \
154 .dev_id = dev, \
155 .con_id = con, \
156 }, \
157 .node_name = name, \
158 }
159
160/* CLKCTRL type definitions */
161struct omap_clkctrl_div_data {
162 const int *dividers;
163 int max_div;
164 u32 flags;
165};
166
167struct omap_clkctrl_bit_data {
168 u8 bit;
169 u8 type;
170 const char * const *parents;
171 const void *data;
172};
173
174struct omap_clkctrl_reg_data {
175 u16 offset;
176 const struct omap_clkctrl_bit_data *bit_data;
177 u16 flags;
178 const char *parent;
179 const char *clkdm_name;
180};
181
182struct omap_clkctrl_data {
183 u32 addr;
184 const struct omap_clkctrl_reg_data *regs;
185};
186
187extern const struct omap_clkctrl_data omap4_clkctrl_data[];
188extern const struct omap_clkctrl_data omap5_clkctrl_data[];
189extern const struct omap_clkctrl_data dra7_clkctrl_data[];
190extern const struct omap_clkctrl_data dra7_clkctrl_compat_data[];
191extern struct ti_dt_clk dra7xx_compat_clks[];
192extern const struct omap_clkctrl_data am3_clkctrl_data[];
193extern const struct omap_clkctrl_data am3_clkctrl_compat_data[];
194extern struct ti_dt_clk am33xx_compat_clks[];
195extern const struct omap_clkctrl_data am4_clkctrl_data[];
196extern const struct omap_clkctrl_data am438x_clkctrl_data[];
197extern const struct omap_clkctrl_data dm814_clkctrl_data[];
198extern const struct omap_clkctrl_data dm816_clkctrl_data[];
199
200typedef void (*ti_of_clk_init_cb_t)(void *, struct device_node *);
201
202struct clk *of_ti_clk_register(struct device_node *node, struct clk_hw *hw,
203 const char *con);
204struct clk *of_ti_clk_register_omap_hw(struct device_node *node,
205 struct clk_hw *hw, const char *con);
206const char *ti_dt_clk_name(struct device_node *np);
207int ti_clk_add_alias(struct clk *clk, const char *con);
208void ti_clk_add_aliases(void);
209
210void ti_clk_latch(struct clk_omap_reg *reg, s8 shift);
211
212struct clk_hw *ti_clk_build_component_mux(struct ti_clk_mux *setup);
213
214int ti_clk_parse_divider_data(int *div_table, int num_dividers, int max_div,
215 u8 flags, struct clk_omap_divider *div);
216
217int ti_clk_get_reg_addr(struct device_node *node, int index,
218 struct clk_omap_reg *reg);
219void ti_dt_clocks_register(struct ti_dt_clk *oclks);
220int ti_clk_retry_init(struct device_node *node, void *user,
221 ti_of_clk_init_cb_t func);
222int ti_clk_add_component(struct device_node *node, struct clk_hw *hw, int type);
223
224int of_ti_clk_autoidle_setup(struct device_node *node);
225void omap2_clk_enable_init_clocks(const char **clk_names, u8 num_clocks);
226
227extern const struct clk_hw_omap_ops clkhwops_omap3_dpll;
228extern const struct clk_hw_omap_ops clkhwops_omap4_dpllmx;
229extern const struct clk_hw_omap_ops clkhwops_wait;
230extern const struct clk_hw_omap_ops clkhwops_iclk;
231extern const struct clk_hw_omap_ops clkhwops_iclk_wait;
232extern const struct clk_hw_omap_ops clkhwops_omap2430_i2chs_wait;
233extern const struct clk_hw_omap_ops clkhwops_omap3430es2_dss_usbhost_wait;
234extern const struct clk_hw_omap_ops clkhwops_omap3430es2_iclk_hsotgusb_wait;
235extern const struct clk_hw_omap_ops clkhwops_omap3430es2_iclk_dss_usbhost_wait;
236extern const struct clk_hw_omap_ops clkhwops_omap3430es2_iclk_ssi_wait;
237extern const struct clk_hw_omap_ops clkhwops_am35xx_ipss_module_wait;
238extern const struct clk_hw_omap_ops clkhwops_am35xx_ipss_wait;
239
240extern const struct clk_ops ti_clk_divider_ops;
241extern const struct clk_ops ti_clk_mux_ops;
242extern const struct clk_ops omap_gate_clk_ops;
243
244extern struct ti_clk_features ti_clk_features;
245
246int omap2_init_clk_clkdm(struct clk_hw *hw);
247int omap2_clkops_enable_clkdm(struct clk_hw *hw);
248void omap2_clkops_disable_clkdm(struct clk_hw *hw);
249
250int omap2_dflt_clk_enable(struct clk_hw *hw);
251void omap2_dflt_clk_disable(struct clk_hw *hw);
252int omap2_dflt_clk_is_enabled(struct clk_hw *hw);
253void omap2_clk_dflt_find_companion(struct clk_hw_omap *clk,
254 struct clk_omap_reg *other_reg,
255 u8 *other_bit);
256void omap2_clk_dflt_find_idlest(struct clk_hw_omap *clk,
257 struct clk_omap_reg *idlest_reg,
258 u8 *idlest_bit, u8 *idlest_val);
259
260void omap2_clkt_iclk_allow_idle(struct clk_hw_omap *clk);
261void omap2_clkt_iclk_deny_idle(struct clk_hw_omap *clk);
262
263u8 omap2_init_dpll_parent(struct clk_hw *hw);
264int omap3_noncore_dpll_enable(struct clk_hw *hw);
265void omap3_noncore_dpll_disable(struct clk_hw *hw);
266int omap3_noncore_dpll_set_parent(struct clk_hw *hw, u8 index);
267int omap3_noncore_dpll_set_rate(struct clk_hw *hw, unsigned long rate,
268 unsigned long parent_rate);
269int omap3_noncore_dpll_set_rate_and_parent(struct clk_hw *hw,
270 unsigned long rate,
271 unsigned long parent_rate,
272 u8 index);
273int omap3_noncore_dpll_determine_rate(struct clk_hw *hw,
274 struct clk_rate_request *req);
275long omap2_dpll_round_rate(struct clk_hw *hw, unsigned long target_rate,
276 unsigned long *parent_rate);
277unsigned long omap3_clkoutx2_recalc(struct clk_hw *hw,
278 unsigned long parent_rate);
279
280/*
281 * OMAP3_DPLL5_FREQ_FOR_USBHOST: USBHOST and USBTLL are the only clocks
282 * that are sourced by DPLL5, and both of these require this clock
283 * to be at 120 MHz for proper operation.
284 */
285#define OMAP3_DPLL5_FREQ_FOR_USBHOST 120000000
286
287unsigned long omap3_dpll_recalc(struct clk_hw *hw, unsigned long parent_rate);
288int omap3_dpll4_set_rate(struct clk_hw *clk, unsigned long rate,
289 unsigned long parent_rate);
290int omap3_dpll4_set_rate_and_parent(struct clk_hw *hw, unsigned long rate,
291 unsigned long parent_rate, u8 index);
292int omap3_dpll5_set_rate(struct clk_hw *hw, unsigned long rate,
293 unsigned long parent_rate);
294void omap3_clk_lock_dpll5(void);
295
296unsigned long omap4_dpll_regm4xen_recalc(struct clk_hw *hw,
297 unsigned long parent_rate);
298long omap4_dpll_regm4xen_round_rate(struct clk_hw *hw,
299 unsigned long target_rate,
300 unsigned long *parent_rate);
301int omap4_dpll_regm4xen_determine_rate(struct clk_hw *hw,
302 struct clk_rate_request *req);
303int omap2_clk_for_each(int (*fn)(struct clk_hw_omap *hw));
304
305extern struct ti_clk_ll_ops *ti_clk_ll_ops;
306
307#endif
308

source code of linux/drivers/clk/ti/clock.h