1/* 2 * Copyright (C) 2014 Broadcom Corporation 3 * 4 * This program is free software; you can redistribute it and/or 5 * modify it under the terms of the GNU General Public License as 6 * published by the Free Software Foundation version 2. 7 * 8 * This program is distributed "as is" WITHOUT ANY WARRANTY of any 9 * kind, whether express or implied; without even the implied warranty 10 * of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 11 * GNU General Public License for more details. 12 */ 13 14#ifndef _CLK_IPROC_H 15#define _CLK_IPROC_H 16 17#include <linux/kernel.h> 18#include <linux/list.h> 19#include <linux/spinlock.h> 20#include <linux/slab.h> 21#include <linux/device.h> 22#include <linux/of.h> 23#include <linux/clk-provider.h> 24 25#define IPROC_CLK_NAME_LEN 25 26#define IPROC_CLK_INVALID_OFFSET 0xffffffff 27#define bit_mask(width) ((1 << (width)) - 1) 28 29/* clocks that should not be disabled at runtime */ 30#define IPROC_CLK_AON BIT(0) 31 32/* PLL that requires gating through ASIU */ 33#define IPROC_CLK_PLL_ASIU BIT(1) 34 35/* PLL that has fractional part of the NDIV */ 36#define IPROC_CLK_PLL_HAS_NDIV_FRAC BIT(2) 37 38/* 39 * Some of the iProc PLL/clocks may have an ASIC bug that requires read back 40 * of the same register following the write to flush the write transaction into 41 * the intended register 42 */ 43#define IPROC_CLK_NEEDS_READ_BACK BIT(3) 44 45/* 46 * Some PLLs require the PLL SW override bit to be set before changes can be 47 * applied to the PLL 48 */ 49#define IPROC_CLK_PLL_NEEDS_SW_CFG BIT(4) 50 51/* 52 * Some PLLs use a different way to control clock power, via the PWRDWN bit in 53 * the PLL control register 54 */ 55#define IPROC_CLK_EMBED_PWRCTRL BIT(5) 56 57/* 58 * Some PLLs have separate registers for Status and Control. Identify this to 59 * let the driver know if additional registers need to be used 60 */ 61#define IPROC_CLK_PLL_SPLIT_STAT_CTRL BIT(6) 62 63/* 64 * Some PLLs have an additional divide by 2 in master clock calculation; 65 * MCLK = VCO_freq / (Mdiv * 2). Identify this to let the driver know 66 * of modified calculations 67 */ 68#define IPROC_CLK_MCLK_DIV_BY_2 BIT(7) 69 70/* 71 * Some PLLs provide a look up table for the leaf clock frequencies and 72 * auto calculates VCO frequency parameters based on the provided leaf 73 * clock frequencies. They have a user mode that allows the divider 74 * controls to be determined by the user 75 */ 76#define IPROC_CLK_PLL_USER_MODE_ON BIT(8) 77 78/* 79 * Some PLLs have an active low reset 80 */ 81#define IPROC_CLK_PLL_RESET_ACTIVE_LOW BIT(9) 82 83/* 84 * Calculate the PLL parameters are runtime, instead of using table 85 */ 86#define IPROC_CLK_PLL_CALC_PARAM BIT(10) 87 88/* 89 * Parameters for VCO frequency configuration 90 * 91 * VCO frequency = 92 * ((ndiv_int + ndiv_frac / 2^20) * (ref freqeuncy / pdiv) 93 */ 94struct iproc_pll_vco_param { 95 unsigned long rate; 96 unsigned int ndiv_int; 97 unsigned int ndiv_frac; 98 unsigned int pdiv; 99}; 100 101struct iproc_clk_reg_op { 102 unsigned int offset; 103 unsigned int shift; 104 unsigned int width; 105}; 106 107/* 108 * Clock gating control at the top ASIU level 109 */ 110struct iproc_asiu_gate { 111 unsigned int offset; 112 unsigned int en_shift; 113}; 114 115/* 116 * Control of powering on/off of a PLL 117 * 118 * Before powering off a PLL, input isolation (ISO) needs to be enabled 119 */ 120struct iproc_pll_aon_pwr_ctrl { 121 unsigned int offset; 122 unsigned int pwr_width; 123 unsigned int pwr_shift; 124 unsigned int iso_shift; 125}; 126 127/* 128 * Control of the PLL reset 129 */ 130struct iproc_pll_reset_ctrl { 131 unsigned int offset; 132 unsigned int reset_shift; 133 unsigned int p_reset_shift; 134}; 135 136/* 137 * Control of the Ki, Kp, and Ka parameters 138 */ 139struct iproc_pll_dig_filter_ctrl { 140 unsigned int offset; 141 unsigned int ki_shift; 142 unsigned int ki_width; 143 unsigned int kp_shift; 144 unsigned int kp_width; 145 unsigned int ka_shift; 146 unsigned int ka_width; 147}; 148 149/* 150 * To enable SW control of the PLL 151 */ 152struct iproc_pll_sw_ctrl { 153 unsigned int offset; 154 unsigned int shift; 155}; 156 157struct iproc_pll_vco_ctrl { 158 unsigned int u_offset; 159 unsigned int l_offset; 160}; 161 162/* 163 * Main PLL control parameters 164 */ 165struct iproc_pll_ctrl { 166 unsigned long flags; 167 struct iproc_pll_aon_pwr_ctrl aon; 168 struct iproc_asiu_gate asiu; 169 struct iproc_pll_reset_ctrl reset; 170 struct iproc_pll_dig_filter_ctrl dig_filter; 171 struct iproc_pll_sw_ctrl sw_ctrl; 172 struct iproc_clk_reg_op ndiv_int; 173 struct iproc_clk_reg_op ndiv_frac; 174 struct iproc_clk_reg_op pdiv; 175 struct iproc_pll_vco_ctrl vco_ctrl; 176 struct iproc_clk_reg_op status; 177 struct iproc_clk_reg_op macro_mode; 178}; 179 180/* 181 * Controls enabling/disabling a PLL derived clock 182 */ 183struct iproc_clk_enable_ctrl { 184 unsigned int offset; 185 unsigned int enable_shift; 186 unsigned int hold_shift; 187 unsigned int bypass_shift; 188}; 189 190/* 191 * Main clock control parameters for clocks derived from the PLLs 192 */ 193struct iproc_clk_ctrl { 194 unsigned int channel; 195 unsigned long flags; 196 struct iproc_clk_enable_ctrl enable; 197 struct iproc_clk_reg_op mdiv; 198}; 199 200/* 201 * Divisor of the ASIU clocks 202 */ 203struct iproc_asiu_div { 204 unsigned int offset; 205 unsigned int en_shift; 206 unsigned int high_shift; 207 unsigned int high_width; 208 unsigned int low_shift; 209 unsigned int low_width; 210}; 211 212void iproc_armpll_setup(struct device_node *node); 213void iproc_pll_clk_setup(struct device_node *node, 214 const struct iproc_pll_ctrl *pll_ctrl, 215 const struct iproc_pll_vco_param *vco, 216 unsigned int num_vco_entries, 217 const struct iproc_clk_ctrl *clk_ctrl, 218 unsigned int num_clks); 219void iproc_asiu_setup(struct device_node *node, 220 const struct iproc_asiu_div *div, 221 const struct iproc_asiu_gate *gate, 222 unsigned int num_clks); 223 224#endif /* _CLK_IPROC_H */ 225