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