cablePowerDataOperation.h 9.3 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292
  1. /*
  2. * omap_hwmod macros, structures
  3. *
  4. * Copyright (C) 2009-2011 Nokia Corporation
  5. * Copyright (C) 2011-2012 Texas Instruments, Inc.
  6. * Paul Walmsley
  7. *
  8. * Created in collaboration with (alphabetical order): Benoît Cousson,
  9. * Kevin Hilman, Tony Lindgren, Rajendra Nayak, Vikram Pandita, Sakari
  10. * Poussa, Anand Sawant, Santosh Shilimkar, Richard Woodruff
  11. *
  12. * This program is free software; you can redistribute it and/or modify
  13. * it under the terms of the GNU General Public License version 2 as
  14. * published by the Free Software Foundation.
  15. *
  16. * These headers and macros are used to define OMAP on-chip module
  17. * data and their integration with other OMAP modules and Linux.
  18. * Copious documentation and references can also be found in the
  19. * omap_hwmod code, in arch/arm/mach-omap2/omap_hwmod.c (as of this
  20. * writing).
  21. *
  22. * To do:
  23. * - add interconnect error log structures
  24. * - add pinmuxing
  25. * - init_conn_id_bit (CONNID_BIT_VECTOR)
  26. * - implement default hwmod SMS/SDRC flags?
  27. * - move Linux-specific data ("non-ROM data") out
  28. *
  29. */
  30. #ifndef __ARCH_ARM_PLAT_OMAP_INCLUDE_MACH_OMAP_HWMOD_H
  31. #define __ARCH_ARM_PLAT_OMAP_INCLUDE_MACH_OMAP_HWMOD_H
  32. #include <linux/kernel.h>
  33. #include <linux/init.h>
  34. #include <linux/list.h>
  35. #include <linux/ioport.h>
  36. #include <linux/spinlock.h>
  37. struct omap_device;
  38. extern struct omap_hwmod_sysc_fields omap_hwmod_sysc_type1;
  39. extern struct omap_hwmod_sysc_fields omap_hwmod_sysc_type2;
  40. extern struct omap_hwmod_sysc_fields omap_hwmod_sysc_type3;
  41. /*
  42. * OCP SYSCONFIG bit shifts/masks TYPE1. These are for IPs compliant
  43. * with the original PRCM protocol defined for OMAP2420
  44. */
  45. #define SYSC_TYPE1_MIDLEMODE_SHIFT 12
  46. #define SYSC_TYPE1_MIDLEMODE_MASK (0x3 << SYSC_TYPE1_MIDLEMODE_SHIFT)
  47. #define SYSC_TYPE1_CLOCKACTIVITY_SHIFT 8
  48. #define SYSC_TYPE1_CLOCKACTIVITY_MASK (0x3 << SYSC_TYPE1_CLOCKACTIVITY_SHIFT)
  49. #define SYSC_TYPE1_SIDLEMODE_SHIFT 3
  50. #define SYSC_TYPE1_SIDLEMODE_MASK (0x3 << SYSC_TYPE1_SIDLEMODE_SHIFT)
  51. #define SYSC_TYPE1_ENAWAKEUP_SHIFT 2
  52. #define SYSC_TYPE1_ENAWAKEUP_MASK (1 << SYSC_TYPE1_ENAWAKEUP_SHIFT)
  53. #define SYSC_TYPE1_SOFTRESET_SHIFT 1
  54. #define SYSC_TYPE1_SOFTRESET_MASK (1 << SYSC_TYPE1_SOFTRESET_SHIFT)
  55. #define SYSC_TYPE1_AUTOIDLE_SHIFT 0
  56. #define SYSC_TYPE1_AUTOIDLE_MASK (1 << SYSC_TYPE1_AUTOIDLE_SHIFT)
  57. /*
  58. * OCP SYSCONFIG bit shifts/masks TYPE2. These are for IPs compliant
  59. * with the new PRCM protocol defined for new OMAP4 IPs.
  60. */
  61. #define SYSC_TYPE2_SOFTRESET_SHIFT 0
  62. #define SYSC_TYPE2_SOFTRESET_MASK (1 << SYSC_TYPE2_SOFTRESET_SHIFT)
  63. #define SYSC_TYPE2_SIDLEMODE_SHIFT 2
  64. #define SYSC_TYPE2_SIDLEMODE_MASK (0x3 << SYSC_TYPE2_SIDLEMODE_SHIFT)
  65. #define SYSC_TYPE2_MIDLEMODE_SHIFT 4
  66. #define SYSC_TYPE2_MIDLEMODE_MASK (0x3 << SYSC_TYPE2_MIDLEMODE_SHIFT)
  67. #define SYSC_TYPE2_DMADISABLE_SHIFT 16
  68. #define SYSC_TYPE2_DMADISABLE_MASK (0x1 << SYSC_TYPE2_DMADISABLE_SHIFT)
  69. /*
  70. * OCP SYSCONFIG bit shifts/masks TYPE3.
  71. * This is applicable for some IPs present in AM33XX
  72. */
  73. #define SYSC_TYPE3_SIDLEMODE_SHIFT 0
  74. #define SYSC_TYPE3_SIDLEMODE_MASK (0x3 << SYSC_TYPE3_SIDLEMODE_SHIFT)
  75. #define SYSC_TYPE3_MIDLEMODE_SHIFT 2
  76. #define SYSC_TYPE3_MIDLEMODE_MASK (0x3 << SYSC_TYPE3_MIDLEMODE_SHIFT)
  77. /* OCP SYSSTATUS bit shifts/masks */
  78. #define SYSS_RESETDONE_SHIFT 0
  79. #define SYSS_RESETDONE_MASK (1 << SYSS_RESETDONE_SHIFT)
  80. /* Master standby/slave idle mode flags */
  81. #define HWMOD_IDLEMODE_FORCE (1 << 0)
  82. #define HWMOD_IDLEMODE_NO (1 << 1)
  83. #define HWMOD_IDLEMODE_SMART (1 << 2)
  84. #define HWMOD_IDLEMODE_SMART_WKUP (1 << 3)
  85. /* modulemode control type (SW or HW) */
  86. #define MODULEMODE_HWCTRL 1
  87. #define MODULEMODE_SWCTRL 2
  88. /**
  89. * struct omap_hwmod_mux_info - hwmod specific mux configuration
  90. * @pads: array of omap_device_pad entries
  91. * @nr_pads: number of omap_device_pad entries
  92. *
  93. * Note that this is currently built during init as needed.
  94. */
  95. struct omap_hwmod_mux_info {
  96. int nr_pads;
  97. struct omap_device_pad *pads;
  98. int nr_pads_dynamic;
  99. struct omap_device_pad **pads_dynamic;
  100. int *irqs;
  101. bool enabled;
  102. };
  103. /**
  104. * struct omap_hwmod_irq_info - MPU IRQs used by the hwmod
  105. * @name: name of the IRQ channel (module local name)
  106. * @irq: IRQ channel ID (should be non-negative except -1 = terminator)
  107. *
  108. * @name should be something short, e.g., "tx" or "rx". It is for use
  109. * by platform_get_resource_byname(). It is defined locally to the
  110. * hwmod.
  111. */
  112. struct omap_hwmod_irq_info {
  113. const char *name;
  114. s16 irq;
  115. };
  116. /**
  117. * struct omap_hwmod_dma_info - DMA channels used by the hwmod
  118. * @name: name of the DMA channel (module local name)
  119. * @dma_req: DMA request ID (should be non-negative except -1 = terminator)
  120. *
  121. * @name should be something short, e.g., "tx" or "rx". It is for use
  122. * by platform_get_resource_byname(). It is defined locally to the
  123. * hwmod.
  124. */
  125. struct omap_hwmod_dma_info {
  126. const char *name;
  127. s16 dma_req;
  128. };
  129. /**
  130. * struct omap_hwmod_rst_info - IPs reset lines use by hwmod
  131. * @name: name of the reset line (module local name)
  132. * @rst_shift: Offset of the reset bit
  133. * @st_shift: Offset of the reset status bit (OMAP2/3 only)
  134. *
  135. * @name should be something short, e.g., "cpu0" or "rst". It is defined
  136. * locally to the hwmod.
  137. */
  138. struct omap_hwmod_rst_info {
  139. const char *name;
  140. u8 rst_shift;
  141. u8 st_shift;
  142. };
  143. /**
  144. * struct omap_hwmod_opt_clk - optional clocks used by this hwmod
  145. * @role: "sys", "32k", "tv", etc -- for use in clk_get()
  146. * @clk: opt clock: OMAP clock name
  147. * @_clk: pointer to the struct clk (filled in at runtime)
  148. *
  149. * The module's interface clock and main functional clock should not
  150. * be added as optional clocks.
  151. */
  152. struct omap_hwmod_opt_clk {
  153. const char *role;
  154. const char *clk;
  155. struct clk *_clk;
  156. };
  157. /* omap_hwmod_omap2_firewall.flags bits */
  158. #define OMAP_FIREWALL_L3 (1 << 0)
  159. #define OMAP_FIREWALL_L4 (1 << 1)
  160. /**
  161. * struct omap_hwmod_omap2_firewall - OMAP2/3 device firewall data
  162. * @l3_perm_bit: bit shift for L3_PM_*_PERMISSION_*
  163. * @l4_fw_region: L4 firewall region ID
  164. * @l4_prot_group: L4 protection group ID
  165. * @flags: (see omap_hwmod_omap2_firewall.flags macros above)
  166. */
  167. struct omap_hwmod_omap2_firewall {
  168. u8 l3_perm_bit;
  169. u8 l4_fw_region;
  170. u8 l4_prot_group;
  171. u8 flags;
  172. };
  173. /*
  174. * omap_hwmod_addr_space.flags bits
  175. *
  176. * ADDR_MAP_ON_INIT: Map this address space during omap_hwmod init.
  177. * ADDR_TYPE_RT: Address space contains module register target data.
  178. */
  179. #define ADDR_MAP_ON_INIT (1 << 0) /* XXX does not belong */
  180. #define ADDR_TYPE_RT (1 << 1)
  181. /**
  182. * struct omap_hwmod_addr_space - address space handled by the hwmod
  183. * @name: name of the address space
  184. * @pa_start: starting physical address
  185. * @pa_end: ending physical address
  186. * @flags: (see omap_hwmod_addr_space.flags macros above)
  187. *
  188. * Address space doesn't necessarily follow physical interconnect
  189. * structure. GPMC is one example.
  190. */
  191. struct omap_hwmod_addr_space {
  192. const char *name;
  193. u32 pa_start;
  194. u32 pa_end;
  195. u8 flags;
  196. };
  197. /*
  198. * omap_hwmod_ocp_if.user bits: these indicate the initiators that use this
  199. * interface to interact with the hwmod. Used to add sleep dependencies
  200. * when the module is enabled or disabled.
  201. */
  202. #define OCP_USER_MPU (1 << 0)
  203. #define OCP_USER_SDMA (1 << 1)
  204. #define OCP_USER_DSP (1 << 2)
  205. #define OCP_USER_IVA (1 << 3)
  206. /* omap_hwmod_ocp_if.flags bits */
  207. #define OCPIF_SWSUP_IDLE (1 << 0)
  208. #define OCPIF_CAN_BURST (1 << 1)
  209. /* omap_hwmod_ocp_if._int_flags possibilities */
  210. #define _OCPIF_INT_FLAGS_REGISTERED (1 << 0)
  211. /**
  212. * struct omap_hwmod_ocp_if - OCP interface data
  213. * @master: struct omap_hwmod that initiates OCP transactions on this link
  214. * @slave: struct omap_hwmod that responds to OCP transactions on this link
  215. * @addr: address space associated with this link
  216. * @clk: interface clock: OMAP clock name
  217. * @_clk: pointer to the interface struct clk (filled in at runtime)
  218. * @fw: interface firewall data
  219. * @width: OCP data width
  220. * @user: initiators using this interface (see OCP_USER_* macros above)
  221. * @flags: OCP interface flags (see OCPIF_* macros above)
  222. * @_int_flags: internal flags (see _OCPIF_INT_FLAGS* macros above)
  223. *
  224. * It may also be useful to add a tag_cnt field for OCP2.x devices.
  225. *
  226. * Parameter names beginning with an underscore are managed internally by
  227. * the omap_hwmod code and should not be set during initialization.
  228. */
  229. struct omap_hwmod_ocp_if {
  230. struct omap_hwmod *master;
  231. struct omap_hwmod *slave;
  232. struct omap_hwmod_addr_space *addr;
  233. const char *clk;
  234. struct clk *_clk;
  235. union {
  236. struct omap_hwmod_omap2_firewall omap2;
  237. } fw;
  238. u8 width;
  239. u8 user;
  240. u8 flags;
  241. u8 _int_flags;
  242. };
  243. /* Macros for use in struct omap_hwmod_sysconfig */
  244. /* Flags for use in omap_hwmod_sysconfig.idlemodes */
  245. #define MASTER_STANDBY_SHIFT 4
  246. #define SLAVE_IDLE_SHIFT 0
  247. #define SIDLE_FORCE (HWMOD_IDLEMODE_FORCE << SLAVE_IDLE_SHIFT)
  248. #define SIDLE_NO (HWMOD_IDLEMODE_NO << SLAVE_IDLE_SHIFT)
  249. #define SIDLE_SMART (HWMOD_IDLEMODE_SMART << SLAVE_IDLE_SHIFT)
  250. #define SIDLE_SMART_WKUP (HWMOD_IDLEMODE_SMART_WKUP << SLAVE_IDLE_SHIFT)
  251. #define MSTANDBY_FORCE (HWMOD_IDLEMODE_FORCE << MASTER_STANDBY_SHIFT)
  252. #define MSTANDBY_NO (HWMOD_IDLEMODE_NO << MASTER_STANDBY_SHIFT)
  253. #define MSTANDBY_SMART (HWMOD_IDLEMODE_SMART << MASTER_STANDBY_SHIFT)
  254. #define MSTANDBY_SMART_WKUP (HWMOD_IDLEMODE_SMART_WKUP << MASTER_STANDBY_SHIFT)
  255. /* omap_hwmod_sysconfig.sysc_flags capability flags */
  256. #define SYSC_HAS_AUTOIDLE (1 << 0)
  257. #define SYSC_HAS_SOFTRESET (1 << 1)
  258. #define SYSC_HAS_ENAWAKEUP (1 << 2)
  259. #define SYSC_HAS_EMUFREE (1 << 3)
  260. #define SYSC_HAS_CLOCKACTIVITY (1 << 4)
  261. #define SYSC_HAS_SIDLEMODE (1 << 5)