drivers/clk/qcom/clk-rcg.h

   1 /*
   2  * Copyright (c) 2013, The Linux Foundation. All rights reserved.
   3  *
   4  * This software is licensed under the terms of the GNU General Public
   5  * License version 2, as published by the Free Software Foundation, and
   6  * may be copied, distributed, and modified under those terms.
   7  *
   8  * This program is distributed in the hope that it will be useful,
   9  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  10  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  11  * GNU General Public License for more details.
  12  */
  13
  14 #ifndef __QCOM_CLK_RCG_H__
  15 #define __QCOM_CLK_RCG_H__
  16
  17 #include <linux/clk-provider.h>
  18 #include "clk-regmap.h"
  19
  20 struct freq_tbl {
  21         unsigned long freq;
  22         u8 src;
  23         u8 pre_div;
  24         u16 m;
  25         u16 n;
  26 };
  27
  28 /**
  29  * struct mn - M/N:D counter
  30  * @mnctr_en_bit: bit to enable mn counter
  31  * @mnctr_reset_bit: bit to assert mn counter reset
  32  * @mnctr_mode_shift: lowest bit of mn counter mode field
  33  * @n_val_shift: lowest bit of n value field
  34  * @m_val_shift: lowest bit of m value field
  35  * @width: number of bits in m/n/d values
  36  * @reset_in_cc: true if the mnctr_reset_bit is in the CC register
  37  */
  38 struct mn {
  39         u8              mnctr_en_bit;
  40         u8              mnctr_reset_bit;
  41         u8              mnctr_mode_shift;
  42 #define MNCTR_MODE_DUAL 0x2
  43 #define MNCTR_MODE_MASK 0x3
  44         u8              n_val_shift;
  45         u8              m_val_shift;
  46         u8              width;
  47         bool            reset_in_cc;
  48 };
  49
  50 /**
  51  * struct pre_div - pre-divider
  52  * @pre_div_shift: lowest bit of pre divider field
  53  * @pre_div_width: number of bits in predivider
  54  */
  55 struct pre_div {
  56         u8              pre_div_shift;
  57         u8              pre_div_width;
  58 };
  59
  60 /**
  61  * struct src_sel - source selector
  62  * @src_sel_shift: lowest bit of source selection field
  63  * @parent_map: map from software's parent index to hardware's src_sel field
  64  */
  65 struct src_sel {
  66         u8              src_sel_shift;
  67 #define SRC_SEL_MASK    0x7
  68         const u8        *parent_map;
  69 };
  70
  71 /**
  72  * struct clk_rcg - root clock generator
  73  *
  74  * @ns_reg: NS register
  75  * @md_reg: MD register
  76  * @mn: mn counter
  77  * @p: pre divider
  78  * @s: source selector
  79  * @freq_tbl: frequency table
  80  * @clkr: regmap clock handle
  81  * @lock: register lock
  82  *
  83  */
  84 struct clk_rcg {
  85         u32             ns_reg;
  86         u32             md_reg;
  87
  88         struct mn       mn;
  89         struct pre_div  p;
  90         struct src_sel  s;
  91
  92         const struct freq_tbl   *freq_tbl;
  93
  94         struct clk_regmap       clkr;
  95 };
  96
  97 extern const struct clk_ops clk_rcg_ops;
  98
  99 #define to_clk_rcg(_hw) container_of(to_clk_regmap(_hw), struct clk_rcg, clkr)
 100
 101 /**
 102  * struct clk_dyn_rcg - root clock generator with glitch free mux
 103  *
 104  * @mux_sel_bit: bit to switch glitch free mux
 105  * @ns_reg: NS register
 106  * @md_reg: MD0 and MD1 register
 107  * @mn: mn counter (banked)
 108  * @s: source selector (banked)
 109  * @freq_tbl: frequency table
 110  * @clkr: regmap clock handle
 111  * @lock: register lock
 112  *
 113  */
 114 struct clk_dyn_rcg {
 115         u32     ns_reg;
 116         u32     md_reg[2];
 117
 118         u8      mux_sel_bit;
 119
 120         struct mn       mn[2];
 121         struct pre_div  p[2];
 122         struct src_sel  s[2];
 123
 124         const struct freq_tbl *freq_tbl;
 125
 126         struct clk_regmap clkr;
 127 };
 128
 129 extern const struct clk_ops clk_dyn_rcg_ops;
 130
 131 #define to_clk_dyn_rcg(_hw) \
 132         container_of(to_clk_regmap(_hw), struct clk_dyn_rcg, clkr)
 133
 134 /**
 135  * struct clk_rcg2 - root clock generator
 136  *
 137  * @cmd_rcgr: corresponds to *_CMD_RCGR
 138  * @mnd_width: number of bits in m/n/d values
 139  * @hid_width: number of bits in half integer divider
 140  * @parent_map: map from software's parent index to hardware's src_sel field
 141  * @freq_tbl: frequency table
 142  * @clkr: regmap clock handle
 143  * @lock: register lock
 144  *
 145  */
 146 struct clk_rcg2 {
 147         u32                     cmd_rcgr;
 148         u8                      mnd_width;
 149         u8                      hid_width;
 150         const u8                *parent_map;
 151         const struct freq_tbl   *freq_tbl;
 152         struct clk_regmap       clkr;
 153 };
 154
 155 #define to_clk_rcg2(_hw) container_of(to_clk_regmap(_hw), struct clk_rcg2, clkr)
 156
 157 extern const struct clk_ops clk_rcg2_ops;
 158
 159 #endif