root/drivers/clk/renesas/renesas-cpg-mssr.h

INCLUDED FROM

   1 /* SPDX-License-Identifier: GPL-2.0 */
   2 /*
   3  * Renesas Clock Pulse Generator / Module Standby and Software Reset
   4  *
   5  * Copyright (C) 2015 Glider bvba
   6  */
   7 
   8 #ifndef __CLK_RENESAS_CPG_MSSR_H__
   9 #define __CLK_RENESAS_CPG_MSSR_H__
  10 
  11     /*
  12      * Definitions of CPG Core Clocks
  13      *
  14      * These include:
  15      *   - Clock outputs exported to DT
  16      *   - External input clocks
  17      *   - Internal CPG clocks
  18      */
  19 
  20 struct cpg_core_clk {
  21         /* Common */
  22         const char *name;
  23         unsigned int id;
  24         unsigned int type;
  25         /* Depending on type */
  26         unsigned int parent;    /* Core Clocks only */
  27         unsigned int div;
  28         unsigned int mult;
  29         unsigned int offset;
  30 };
  31 
  32 enum clk_types {
  33         /* Generic */
  34         CLK_TYPE_IN,            /* External Clock Input */
  35         CLK_TYPE_FF,            /* Fixed Factor Clock */
  36         CLK_TYPE_DIV6P1,        /* DIV6 Clock with 1 parent clock */
  37         CLK_TYPE_DIV6_RO,       /* DIV6 Clock read only with extra divisor */
  38         CLK_TYPE_FR,            /* Fixed Rate Clock */
  39 
  40         /* Custom definitions start here */
  41         CLK_TYPE_CUSTOM,
  42 };
  43 
  44 #define DEF_TYPE(_name, _id, _type...)  \
  45         { .name = _name, .id = _id, .type = _type }
  46 #define DEF_BASE(_name, _id, _type, _parent...) \
  47         DEF_TYPE(_name, _id, _type, .parent = _parent)
  48 
  49 #define DEF_INPUT(_name, _id) \
  50         DEF_TYPE(_name, _id, CLK_TYPE_IN)
  51 #define DEF_FIXED(_name, _id, _parent, _div, _mult)     \
  52         DEF_BASE(_name, _id, CLK_TYPE_FF, _parent, .div = _div, .mult = _mult)
  53 #define DEF_DIV6P1(_name, _id, _parent, _offset)        \
  54         DEF_BASE(_name, _id, CLK_TYPE_DIV6P1, _parent, .offset = _offset)
  55 #define DEF_DIV6_RO(_name, _id, _parent, _offset, _div) \
  56         DEF_BASE(_name, _id, CLK_TYPE_DIV6_RO, _parent, .offset = _offset, .div = _div, .mult = 1)
  57 #define DEF_RATE(_name, _id, _rate)     \
  58         DEF_TYPE(_name, _id, CLK_TYPE_FR, .mult = _rate)
  59 
  60     /*
  61      * Definitions of Module Clocks
  62      */
  63 
  64 struct mssr_mod_clk {
  65         const char *name;
  66         unsigned int id;
  67         unsigned int parent;    /* Add MOD_CLK_BASE for Module Clocks */
  68 };
  69 
  70 /* Convert from sparse base-100 to packed index space */
  71 #define MOD_CLK_PACK(x) ((x) - ((x) / 100) * (100 - 32))
  72 
  73 #define MOD_CLK_ID(x)   (MOD_CLK_BASE + MOD_CLK_PACK(x))
  74 
  75 #define DEF_MOD(_name, _mod, _parent...)        \
  76         { .name = _name, .id = MOD_CLK_ID(_mod), .parent = _parent }
  77 
  78 /* Convert from sparse base-10 to packed index space */
  79 #define MOD_CLK_PACK_10(x)      ((x / 10) * 32 + (x % 10))
  80 
  81 #define MOD_CLK_ID_10(x)        (MOD_CLK_BASE + MOD_CLK_PACK_10(x))
  82 
  83 #define DEF_MOD_STB(_name, _mod, _parent...)    \
  84         { .name = _name, .id = MOD_CLK_ID_10(_mod), .parent = _parent }
  85 
  86 struct device_node;
  87 
  88     /**
  89      * SoC-specific CPG/MSSR Description
  90      *
  91      * @early_core_clks: Array of Early Core Clock definitions
  92      * @num_early_core_clks: Number of entries in early_core_clks[]
  93      * @early_mod_clks: Array of Early Module Clock definitions
  94      * @num_early_mod_clks: Number of entries in early_mod_clks[]
  95      *
  96      * @core_clks: Array of Core Clock definitions
  97      * @num_core_clks: Number of entries in core_clks[]
  98      * @last_dt_core_clk: ID of the last Core Clock exported to DT
  99      * @num_total_core_clks: Total number of Core Clocks (exported + internal)
 100      *
 101      * @mod_clks: Array of Module Clock definitions
 102      * @num_mod_clks: Number of entries in mod_clks[]
 103      * @num_hw_mod_clks: Number of Module Clocks supported by the hardware
 104      *
 105      * @crit_mod_clks: Array with Module Clock IDs of critical clocks that
 106      *                 should not be disabled without a knowledgeable driver
 107      * @num_crit_mod_clks: Number of entries in crit_mod_clks[]
 108      *
 109      * @core_pm_clks: Array with IDs of Core Clocks that are suitable for Power
 110      *                Management, in addition to Module Clocks
 111      * @num_core_pm_clks: Number of entries in core_pm_clks[]
 112      *
 113      * @init: Optional callback to perform SoC-specific initialization
 114      * @cpg_clk_register: Optional callback to handle special Core Clock types
 115      *
 116      * @stbyctrl: This device has Standby Control Registers which are 8-bits
 117      *            wide, no status registers (MSTPSR) and have different address
 118      *            offsets.
 119      */
 120 
 121 struct cpg_mssr_info {
 122         /* Early Clocks */
 123         const struct cpg_core_clk *early_core_clks;
 124         unsigned int num_early_core_clks;
 125         const struct mssr_mod_clk *early_mod_clks;
 126         unsigned int num_early_mod_clks;
 127 
 128         /* Core Clocks */
 129         const struct cpg_core_clk *core_clks;
 130         unsigned int num_core_clks;
 131         unsigned int last_dt_core_clk;
 132         unsigned int num_total_core_clks;
 133         bool stbyctrl;
 134 
 135         /* Module Clocks */
 136         const struct mssr_mod_clk *mod_clks;
 137         unsigned int num_mod_clks;
 138         unsigned int num_hw_mod_clks;
 139 
 140         /* Critical Module Clocks that should not be disabled */
 141         const unsigned int *crit_mod_clks;
 142         unsigned int num_crit_mod_clks;
 143 
 144         /* Core Clocks suitable for PM, in addition to the Module Clocks */
 145         const unsigned int *core_pm_clks;
 146         unsigned int num_core_pm_clks;
 147 
 148         /* Callbacks */
 149         int (*init)(struct device *dev);
 150         struct clk *(*cpg_clk_register)(struct device *dev,
 151                                         const struct cpg_core_clk *core,
 152                                         const struct cpg_mssr_info *info,
 153                                         struct clk **clks, void __iomem *base,
 154                                         struct raw_notifier_head *notifiers);
 155 };
 156 
 157 extern const struct cpg_mssr_info r7s9210_cpg_mssr_info;
 158 extern const struct cpg_mssr_info r8a7743_cpg_mssr_info;
 159 extern const struct cpg_mssr_info r8a7745_cpg_mssr_info;
 160 extern const struct cpg_mssr_info r8a77470_cpg_mssr_info;
 161 extern const struct cpg_mssr_info r8a774a1_cpg_mssr_info;
 162 extern const struct cpg_mssr_info r8a774c0_cpg_mssr_info;
 163 extern const struct cpg_mssr_info r8a7790_cpg_mssr_info;
 164 extern const struct cpg_mssr_info r8a7791_cpg_mssr_info;
 165 extern const struct cpg_mssr_info r8a7792_cpg_mssr_info;
 166 extern const struct cpg_mssr_info r8a7794_cpg_mssr_info;
 167 extern const struct cpg_mssr_info r8a7795_cpg_mssr_info;
 168 extern const struct cpg_mssr_info r8a7796_cpg_mssr_info;
 169 extern const struct cpg_mssr_info r8a77965_cpg_mssr_info;
 170 extern const struct cpg_mssr_info r8a77970_cpg_mssr_info;
 171 extern const struct cpg_mssr_info r8a77980_cpg_mssr_info;
 172 extern const struct cpg_mssr_info r8a77990_cpg_mssr_info;
 173 extern const struct cpg_mssr_info r8a77995_cpg_mssr_info;
 174 
 175 void __init cpg_mssr_early_init(struct device_node *np,
 176                                 const struct cpg_mssr_info *info);
 177 
 178     /*
 179      * Helpers for fixing up clock tables depending on SoC revision
 180      */
 181 
 182 struct mssr_mod_reparent {
 183         unsigned int clk, parent;
 184 };
 185 
 186 
 187 extern void cpg_core_nullify_range(struct cpg_core_clk *core_clks,
 188                                    unsigned int num_core_clks,
 189                                    unsigned int first_clk,
 190                                    unsigned int last_clk);
 191 extern void mssr_mod_nullify(struct mssr_mod_clk *mod_clks,
 192                              unsigned int num_mod_clks,
 193                              const unsigned int *clks, unsigned int n);
 194 extern void mssr_mod_reparent(struct mssr_mod_clk *mod_clks,
 195                               unsigned int num_mod_clks,
 196                               const struct mssr_mod_reparent *clks,
 197                               unsigned int n);
 198 #endif