include/linux/platform_data/ti-sysc.h

   1 /* SPDX-License-Identifier: GPL-2.0 */
   2
   3 #ifndef __TI_SYSC_DATA_H__
   4 #define __TI_SYSC_DATA_H__
   5
   6 enum ti_sysc_module_type {
   7         TI_SYSC_OMAP2,
   8         TI_SYSC_OMAP2_TIMER,
   9         TI_SYSC_OMAP3_SHAM,
  10         TI_SYSC_OMAP3_AES,
  11         TI_SYSC_OMAP4,
  12         TI_SYSC_OMAP4_TIMER,
  13         TI_SYSC_OMAP4_SIMPLE,
  14         TI_SYSC_OMAP34XX_SR,
  15         TI_SYSC_OMAP36XX_SR,
  16         TI_SYSC_OMAP4_SR,
  17         TI_SYSC_OMAP4_MCASP,
  18         TI_SYSC_OMAP4_USB_HOST_FS,
  19         TI_SYSC_DRA7_MCAN,
  20         TI_SYSC_PRUSS,
  21 };
  22
  23 struct ti_sysc_cookie {
  24         void *data;
  25         void *clkdm;
  26 };
  27
  28 /**
  29  * struct sysc_regbits - TI OCP_SYSCONFIG register field offsets
  30  * @midle_shift: Offset of the midle bit
  31  * @clkact_shift: Offset of the clockactivity bit
  32  * @sidle_shift: Offset of the sidle bit
  33  * @enwkup_shift: Offset of the enawakeup bit
  34  * @srst_shift: Offset of the softreset bit
  35  * @autoidle_shift: Offset of the autoidle bit
  36  * @dmadisable_shift: Offset of the dmadisable bit
  37  * @emufree_shift; Offset of the emufree bit
  38  *
  39  * Note that 0 is a valid shift, and for ti-sysc.c -ENODEV can be used if a
  40  * feature is not available.
  41  */
  42 struct sysc_regbits {
  43         s8 midle_shift;
  44         s8 clkact_shift;
  45         s8 sidle_shift;
  46         s8 enwkup_shift;
  47         s8 srst_shift;
  48         s8 autoidle_shift;
  49         s8 dmadisable_shift;
  50         s8 emufree_shift;
  51 };
  52
  53 #define SYSC_QUIRK_REINIT_ON_CTX_LOST   BIT(28)
  54 #define SYSC_QUIRK_REINIT_ON_RESUME     BIT(27)
  55 #define SYSC_QUIRK_GPMC_DEBUG           BIT(26)
  56 #define SYSC_MODULE_QUIRK_ENA_RESETDONE BIT(25)
  57 #define SYSC_MODULE_QUIRK_PRUSS         BIT(24)
  58 #define SYSC_MODULE_QUIRK_DSS_RESET     BIT(23)
  59 #define SYSC_MODULE_QUIRK_RTC_UNLOCK    BIT(22)
  60 #define SYSC_QUIRK_CLKDM_NOAUTO         BIT(21)
  61 #define SYSC_QUIRK_FORCE_MSTANDBY       BIT(20)
  62 #define SYSC_MODULE_QUIRK_AESS          BIT(19)
  63 #define SYSC_MODULE_QUIRK_SGX           BIT(18)
  64 #define SYSC_MODULE_QUIRK_HDQ1W         BIT(17)
  65 #define SYSC_MODULE_QUIRK_I2C           BIT(16)
  66 #define SYSC_MODULE_QUIRK_WDT           BIT(15)
  67 #define SYSS_QUIRK_RESETDONE_INVERTED   BIT(14)
  68 #define SYSC_QUIRK_SWSUP_MSTANDBY       BIT(13)
  69 #define SYSC_QUIRK_SWSUP_SIDLE_ACT      BIT(12)
  70 #define SYSC_QUIRK_SWSUP_SIDLE          BIT(11)
  71 #define SYSC_QUIRK_EXT_OPT_CLOCK        BIT(10)
  72 #define SYSC_QUIRK_LEGACY_IDLE          BIT(9)
  73 #define SYSC_QUIRK_RESET_STATUS         BIT(8)
  74 #define SYSC_QUIRK_NO_IDLE              BIT(7)
  75 #define SYSC_QUIRK_NO_IDLE_ON_INIT      BIT(6)
  76 #define SYSC_QUIRK_NO_RESET_ON_INIT     BIT(5)
  77 #define SYSC_QUIRK_OPT_CLKS_NEEDED      BIT(4)
  78 #define SYSC_QUIRK_OPT_CLKS_IN_RESET    BIT(3)
  79 #define SYSC_QUIRK_16BIT                BIT(2)
  80 #define SYSC_QUIRK_UNCACHED             BIT(1)
  81 #define SYSC_QUIRK_USE_CLOCKACT         BIT(0)
  82
  83 #define SYSC_NR_IDLEMODES               4
  84
  85 /**
  86  * struct sysc_capabilities - capabilities for an interconnect target module
  87  * @type: sysc type identifier for the module
  88  * @sysc_mask: bitmask of supported SYSCONFIG register bits
  89  * @regbits: bitmask of SYSCONFIG register bits
  90  * @mod_quirks: bitmask of module specific quirks
  91  */
  92 struct sysc_capabilities {
  93         const enum ti_sysc_module_type type;
  94         const u32 sysc_mask;
  95         const struct sysc_regbits *regbits;
  96         const u32 mod_quirks;
  97 };
  98
  99 /**
 100  * struct sysc_config - configuration for an interconnect target module
 101  * @sysc_val: configured value for sysc register
 102  * @syss_mask: configured mask value for SYSSTATUS register
 103  * @midlemodes: bitmask of supported master idle modes
 104  * @sidlemodes: bitmask of supported slave idle modes
 105  * @srst_udelay: optional delay needed after OCP soft reset
 106  * @quirks: bitmask of enabled quirks
 107  */
 108 struct sysc_config {
 109         u32 sysc_val;
 110         u32 syss_mask;
 111         u8 midlemodes;
 112         u8 sidlemodes;
 113         u8 srst_udelay;
 114         u32 quirks;
 115 };
 116
 117 enum sysc_registers {
 118         SYSC_REVISION,
 119         SYSC_SYSCONFIG,
 120         SYSC_SYSSTATUS,
 121         SYSC_MAX_REGS,
 122 };
 123
 124 /**
 125  * struct ti_sysc_module_data - ti-sysc to hwmod translation data for a module
 126  * @name: legacy "ti,hwmods" module name
 127  * @module_pa: physical address of the interconnect target module
 128  * @module_size: size of the interconnect target module
 129  * @offsets: array of register offsets as listed in enum sysc_registers
 130  * @nr_offsets: number of registers
 131  * @cap: interconnect target module capabilities
 132  * @cfg: interconnect target module configuration
 133  *
 134  * This data is enough to allocate a new struct omap_hwmod_class_sysconfig
 135  * based on device tree data parsed by ti-sysc driver.
 136  */
 137 struct ti_sysc_module_data {
 138         const char *name;
 139         u64 module_pa;
 140         u32 module_size;
 141         int *offsets;
 142         int nr_offsets;
 143         const struct sysc_capabilities *cap;
 144         struct sysc_config *cfg;
 145 };
 146
 147 struct device;
 148 struct clk;
 149
 150 struct ti_sysc_platform_data {
 151         struct of_dev_auxdata *auxdata;
 152         bool (*soc_type_gp)(void);
 153         int (*init_clockdomain)(struct device *dev, struct clk *fck,
 154                                 struct clk *ick, struct ti_sysc_cookie *cookie);
 155         void (*clkdm_deny_idle)(struct device *dev,
 156                                 const struct ti_sysc_cookie *cookie);
 157         void (*clkdm_allow_idle)(struct device *dev,
 158                                  const struct ti_sysc_cookie *cookie);
 159         int (*init_module)(struct device *dev,
 160                            const struct ti_sysc_module_data *data,
 161                            struct ti_sysc_cookie *cookie);
 162         int (*enable_module)(struct device *dev,
 163                              const struct ti_sysc_cookie *cookie);
 164         int (*idle_module)(struct device *dev,
 165                            const struct ti_sysc_cookie *cookie);
 166         int (*shutdown_module)(struct device *dev,
 167                                const struct ti_sysc_cookie *cookie);
 168 };
 169
 170 #endif  /* __TI_SYSC_DATA_H__ */