1 /* 2 * arch/arm/plat-spear/include/plat/clock.h 3 * 4 * Clock framework definitions for SPEAr platform 5 * 6 * Copyright (C) 2009 ST Microelectronics 7 * Viresh Kumar<viresh.kumar@st.com> 8 * 9 * This file is licensed under the terms of the GNU General Public 10 * License version 2. This program is licensed "as is" without any 11 * warranty of any kind, whether express or implied. 12 */ 13 14 #ifndef __PLAT_CLOCK_H 15 #define __PLAT_CLOCK_H 16 17 #include <linux/list.h> 18 #include <linux/clkdev.h> 19 #include <linux/types.h> 20 21 /* clk structure flags */ 22 #define ALWAYS_ENABLED (1 << 0) /* clock always enabled */ 23 #define RESET_TO_ENABLE (1 << 1) /* reset register bit to enable clk */ 24 #define ENABLED_ON_INIT (1 << 2) /* clocks enabled at init */ 25 26 /** 27 * struct clkops - clock operations 28 * @enable: pointer to clock enable function 29 * @disable: pointer to clock disable function 30 */ 31 struct clkops { 32 int (*enable) (struct clk *); 33 void (*disable) (struct clk *); 34 }; 35 36 /** 37 * struct pclk_info - parents info 38 * @pclk: pointer to parent clk 39 * @pclk_val: value to be written for selecting this parent 40 */ 41 struct pclk_info { 42 struct clk *pclk; 43 u8 pclk_val; 44 }; 45 46 /** 47 * struct pclk_sel - parents selection configuration 48 * @pclk_info: pointer to array of parent clock info 49 * @pclk_count: number of parents 50 * @pclk_sel_reg: register for selecting a parent 51 * @pclk_sel_mask: mask for selecting parent (can be used to clear bits also) 52 */ 53 struct pclk_sel { 54 struct pclk_info *pclk_info; 55 u8 pclk_count; 56 void __iomem *pclk_sel_reg; 57 unsigned int pclk_sel_mask; 58 }; 59 60 /** 61 * struct rate_config - clk rate configurations 62 * @tbls: array of device specific clk rate tables, in ascending order of rates 63 * @count: size of tbls array 64 * @default_index: default setting when originally disabled 65 */ 66 struct rate_config { 67 void *tbls; 68 u8 count; 69 u8 default_index; 70 }; 71 72 /** 73 * struct clk - clock structure 74 * @usage_count: num of users who enabled this clock 75 * @flags: flags for clock properties 76 * @rate: programmed clock rate in Hz 77 * @en_reg: clk enable/disable reg 78 * @en_reg_bit: clk enable/disable bit 79 * @ops: clk enable/disable ops - generic_clkops selected if NULL 80 * @recalc: pointer to clock rate recalculate function 81 * @set_rate: pointer to clock set rate function 82 * @calc_rate: pointer to clock get rate function for index 83 * @rate_config: rate configuration information, used by set_rate 84 * @div_factor: division factor to parent clock. 85 * @pclk: current parent clk 86 * @pclk_sel: pointer to parent selection structure 87 * @pclk_sel_shift: register shift for selecting parent of this clock 88 * @children: list for childrens or this clock 89 * @sibling: node for list of clocks having same parents 90 * @private_data: clock specific private data 91 * @node: list to maintain clocks linearly 92 * @cl: clocklook up associated with this clock 93 * @dent: object for debugfs 94 */ 95 struct clk { 96 unsigned int usage_count; 97 unsigned int flags; 98 unsigned long rate; 99 void __iomem *en_reg; 100 u8 en_reg_bit; 101 const struct clkops *ops; 102 int (*recalc) (struct clk *); 103 int (*set_rate) (struct clk *, unsigned long rate); 104 unsigned long (*calc_rate)(struct clk *, int index); 105 struct rate_config rate_config; 106 unsigned int div_factor; 107 108 struct clk *pclk; 109 struct pclk_sel *pclk_sel; 110 unsigned int pclk_sel_shift; 111 112 struct list_head children; 113 struct list_head sibling; 114 void *private_data; 115 #ifdef CONFIG_DEBUG_FS 116 struct list_head node; 117 struct clk_lookup *cl; 118 struct dentry *dent; 119 #endif 120 }; 121 122 /* pll configuration structure */ 123 struct pll_clk_masks { 124 u32 mode_mask; 125 u32 mode_shift; 126 127 u32 norm_fdbk_m_mask; 128 u32 norm_fdbk_m_shift; 129 u32 dith_fdbk_m_mask; 130 u32 dith_fdbk_m_shift; 131 u32 div_p_mask; 132 u32 div_p_shift; 133 u32 div_n_mask; 134 u32 div_n_shift; 135 }; 136 137 struct pll_clk_config { 138 void __iomem *mode_reg; 139 void __iomem *cfg_reg; 140 struct pll_clk_masks *masks; 141 }; 142 143 /* pll clk rate config structure */ 144 struct pll_rate_tbl { 145 u8 mode; 146 u16 m; 147 u8 n; 148 u8 p; 149 }; 150 151 /* ahb and apb bus configuration structure */ 152 struct bus_clk_masks { 153 u32 mask; 154 u32 shift; 155 }; 156 157 struct bus_clk_config { 158 void __iomem *reg; 159 struct bus_clk_masks *masks; 160 }; 161 162 /* ahb and apb clk bus rate config structure */ 163 struct bus_rate_tbl { 164 u8 div; 165 }; 166 167 /* Aux clk configuration structure: applicable to UART and FIRDA */ 168 struct aux_clk_masks { 169 u32 eq_sel_mask; 170 u32 eq_sel_shift; 171 u32 eq1_mask; 172 u32 eq2_mask; 173 u32 xscale_sel_mask; 174 u32 xscale_sel_shift; 175 u32 yscale_sel_mask; 176 u32 yscale_sel_shift; 177 }; 178 179 struct aux_clk_config { 180 void __iomem *synth_reg; 181 struct aux_clk_masks *masks; 182 }; 183 184 /* aux clk rate config structure */ 185 struct aux_rate_tbl { 186 u16 xscale; 187 u16 yscale; 188 u8 eq; 189 }; 190 191 /* GPT clk configuration structure */ 192 struct gpt_clk_masks { 193 u32 mscale_sel_mask; 194 u32 mscale_sel_shift; 195 u32 nscale_sel_mask; 196 u32 nscale_sel_shift; 197 }; 198 199 struct gpt_clk_config { 200 void __iomem *synth_reg; 201 struct gpt_clk_masks *masks; 202 }; 203 204 /* gpt clk rate config structure */ 205 struct gpt_rate_tbl { 206 u16 mscale; 207 u16 nscale; 208 }; 209 210 /* clcd clk configuration structure */ 211 struct clcd_synth_masks { 212 u32 div_factor_mask; 213 u32 div_factor_shift; 214 }; 215 216 struct clcd_clk_config { 217 void __iomem *synth_reg; 218 struct clcd_synth_masks *masks; 219 }; 220 221 /* clcd clk rate config structure */ 222 struct clcd_rate_tbl { 223 u16 div; 224 }; 225 226 /* platform specific clock functions */ 227 void clk_register(struct clk_lookup *cl); 228 void recalc_root_clocks(void); 229 230 /* clock recalc & set rate functions */ 231 int follow_parent(struct clk *clk); 232 unsigned long pll_calc_rate(struct clk *clk, int index); 233 int pll_clk_recalc(struct clk *clk); 234 int pll_clk_set_rate(struct clk *clk, unsigned long desired_rate); 235 unsigned long bus_calc_rate(struct clk *clk, int index); 236 int bus_clk_recalc(struct clk *clk); 237 int bus_clk_set_rate(struct clk *clk, unsigned long desired_rate); 238 unsigned long gpt_calc_rate(struct clk *clk, int index); 239 int gpt_clk_recalc(struct clk *clk); 240 int gpt_clk_set_rate(struct clk *clk, unsigned long desired_rate); 241 unsigned long aux_calc_rate(struct clk *clk, int index); 242 int aux_clk_recalc(struct clk *clk); 243 int aux_clk_set_rate(struct clk *clk, unsigned long desired_rate); 244 unsigned long clcd_calc_rate(struct clk *clk, int index); 245 int clcd_clk_recalc(struct clk *clk); 246 int clcd_clk_set_rate(struct clk *clk, unsigned long desired_rate); 247 248 #endif /* __PLAT_CLOCK_H */ 249