arch/arm/mach-ux500/clock.h

   1 /*
   2  *  Copyright (C) 2010 ST-Ericsson
   3  *  Copyright (C) 2009 STMicroelectronics
   4  *
   5  * This program is free software; you can redistribute it and/or modify
   6  * it under the terms of the GNU General Public License version 2 as
   7  * published by the Free Software Foundation.
   8  */
   9
  10 /**
  11  * struct clkops - ux500 clock operations
  12  * @enable:     function to enable the clock
  13  * @disable:    function to disable the clock
  14  * @get_rate:   function to get the current clock rate
  15  *
  16  * This structure contains function pointers to functions that will be used to
  17  * control the clock.  All of these functions are optional.  If get_rate is
  18  * NULL, the rate in the struct clk will be used.
  19  */
  20 struct clkops {
  21         void (*enable) (struct clk *);
  22         void (*disable) (struct clk *);
  23         unsigned long (*get_rate) (struct clk *);
  24 };
  25
  26 /**
  27  * struct clk - ux500 clock structure
  28  * @ops:                pointer to clkops struct used to control this clock
  29  * @name:               name, for debugging
  30  * @enabled:            refcount. positive if enabled, zero if disabled
  31  * @rate:               fixed rate for clocks which don't implement
  32  *                      ops->getrate
  33  * @prcmu_cg_off:       address offset of the combined enable/disable register
  34  *                      (used on u8500v1)
  35  * @prcmu_cg_bit:       bit in the combined enable/disable register (used on
  36  *                      u8500v1)
  37  * @prcmu_cg_mgt:       address of the enable/disable register (used on
  38  *                      u8500ed)
  39  * @cluster:            peripheral cluster number
  40  * @prcc_bus:           bit for the bus clock in the peripheral's CLKRST
  41  * @prcc_kernel:        bit for the kernel clock in the peripheral's CLKRST.
  42  *                      -1 if no kernel clock exists.
  43  * @parent_cluster:     pointer to parent's cluster clk struct
  44  * @parent_periph:      pointer to parent's peripheral clk struct
  45  *
  46  * Peripherals are organised into clusters, and each cluster has an associated
  47  * bus clock.  Some peripherals also have a parent peripheral clock.
  48  *
  49  * In order to enable a clock for a peripheral, we need to enable:
  50  *      (1) the parent cluster (bus) clock at the PRCMU level
  51  *      (2) the parent peripheral clock (if any) at the PRCMU level
  52  *      (3) the peripheral's bus & kernel clock at the PRCC level
  53  *
  54  * (1) and (2) are handled by defining clk structs (DEFINE_PRCMU_CLK) for each
  55  * of the cluster and peripheral clocks, and hooking these as the parents of
  56  * the individual peripheral clocks.
  57  *
  58  * (3) is handled by specifying the bits in the PRCC control registers required
  59  * to enable these clocks and modifying them in the ->enable and
  60  * ->disable callbacks of the peripheral clocks (DEFINE_PRCC_CLK).
  61  *
  62  * This structure describes both the PRCMU-level clocks and PRCC-level clocks.
  63  * The prcmu_* fields are only used for the PRCMU clocks, and the cluster,
  64  * prcc, and parent pointers are only used for the PRCC-level clocks.
  65  */
  66 struct clk {
  67         const struct clkops     *ops;
  68         const char              *name;
  69         unsigned int            enabled;
  70
  71         unsigned long           rate;
  72         struct list_head        list;
  73
  74         /* These three are only for PRCMU clks */
  75
  76         unsigned int            prcmu_cg_off;
  77         unsigned int            prcmu_cg_bit;
  78         unsigned int            prcmu_cg_mgt;
  79
  80         /* The rest are only for PRCC clks */
  81
  82         int                     cluster;
  83         unsigned int            prcc_bus;
  84         unsigned int            prcc_kernel;
  85
  86         struct clk              *parent_cluster;
  87         struct clk              *parent_periph;
  88 };
  89
  90 #define DEFINE_PRCMU_CLK(_name, _cg_off, _cg_bit, _reg)         \
  91 struct clk clk_##_name = {                                      \
  92                 .name           = #_name,                       \
  93                 .ops            = &clk_prcmu_ops,               \
  94                 .prcmu_cg_off   = _cg_off,                      \
  95                 .prcmu_cg_bit   = _cg_bit,                      \
  96                 .prcmu_cg_mgt   = PRCM_##_reg##_MGT             \
  97         }
  98
  99 #define DEFINE_PRCMU_CLK_RATE(_name, _cg_off, _cg_bit, _reg, _rate)     \
 100 struct clk clk_##_name = {                                              \
 101                 .name           = #_name,                               \
 102                 .ops            = &clk_prcmu_ops,                       \
 103                 .prcmu_cg_off   = _cg_off,                              \
 104                 .prcmu_cg_bit   = _cg_bit,                              \
 105                 .rate           = _rate,                                \
 106                 .prcmu_cg_mgt   = PRCM_##_reg##_MGT                     \
 107         }
 108
 109 #define DEFINE_PRCC_CLK(_pclust, _name, _bus_en, _kernel_en, _kernclk)  \
 110 struct clk clk_##_name = {                                              \
 111                 .name           = #_name,                               \
 112                 .ops            = &clk_prcc_ops,                        \
 113                 .cluster        = _pclust,                              \
 114                 .prcc_bus       = _bus_en,                              \
 115                 .prcc_kernel    = _kernel_en,                           \
 116                 .parent_cluster = &clk_per##_pclust##clk,               \
 117                 .parent_periph  = _kernclk                              \
 118         }
 119
 120 #define CLK(_clk, _devname, _conname)                   \
 121         {                                               \
 122                 .clk    = &clk_##_clk,                  \
 123                 .dev_id = _devname,                     \
 124                 .con_id = _conname,                     \
 125         }