1 /*
2  * arch/arm/plat-omap/include/mach/clockdomain.h
3  *
4  * OMAP2/3 clockdomain framework functions
5  *
6  * Copyright (C) 2008 Texas Instruments, Inc.
7  * Copyright (C) 2008-2011 Nokia Corporation
8  *
9  * Paul Walmsley
10  *
11  * This program is free software; you can redistribute it and/or modify
12  * it under the terms of the GNU General Public License version 2 as
13  * published by the Free Software Foundation.
14  */
15 
16 #ifndef __ARCH_ARM_MACH_OMAP2_CLOCKDOMAIN_H
17 #define __ARCH_ARM_MACH_OMAP2_CLOCKDOMAIN_H
18 
19 #include <linux/init.h>
20 #include <linux/spinlock.h>
21 
22 #include "powerdomain.h"
23 #include <plat/clock.h>
24 #include <plat/omap_hwmod.h>
25 #include <plat/cpu.h>
26 
27 /*
28  * Clockdomain flags
29  *
30  * XXX Document CLKDM_CAN_* flags
31  *
32  * CLKDM_NO_AUTODEPS: Prevent "autodeps" from being added/removed from this
33  *     clockdomain.  (Currently, this applies to OMAP3 clockdomains only.)
34  */
35 #define CLKDM_CAN_FORCE_SLEEP			(1 << 0)
36 #define CLKDM_CAN_FORCE_WAKEUP			(1 << 1)
37 #define CLKDM_CAN_ENABLE_AUTO			(1 << 2)
38 #define CLKDM_CAN_DISABLE_AUTO			(1 << 3)
39 #define CLKDM_NO_AUTODEPS			(1 << 4)
40 
41 #define CLKDM_CAN_HWSUP		(CLKDM_CAN_ENABLE_AUTO | CLKDM_CAN_DISABLE_AUTO)
42 #define CLKDM_CAN_SWSUP		(CLKDM_CAN_FORCE_SLEEP | CLKDM_CAN_FORCE_WAKEUP)
43 #define CLKDM_CAN_HWSUP_SWSUP	(CLKDM_CAN_SWSUP | CLKDM_CAN_HWSUP)
44 
45 /**
46  * struct clkdm_autodep - clkdm deps to add when entering/exiting hwsup mode
47  * @clkdm: clockdomain to add wkdep+sleepdep on - set name member only
48  *
49  * A clockdomain that should have wkdeps and sleepdeps added when a
50  * clockdomain should stay active in hwsup mode; and conversely,
51  * removed when the clockdomain should be allowed to go inactive in
52  * hwsup mode.
53  *
54  * Autodeps are deprecated and should be removed after
55  * omap_hwmod-based fine-grained module idle control is added.
56  */
57 struct clkdm_autodep {
58 	union {
59 		const char *name;
60 		struct clockdomain *ptr;
61 	} clkdm;
62 };
63 
64 /**
65  * struct clkdm_dep - encode dependencies between clockdomains
66  * @clkdm_name: clockdomain name
67  * @clkdm: pointer to the struct clockdomain of @clkdm_name
68  * @wkdep_usecount: Number of wakeup dependencies causing this clkdm to wake
69  * @sleepdep_usecount: Number of sleep deps that could prevent clkdm from idle
70  *
71  * Statically defined.  @clkdm is resolved from @clkdm_name at runtime and
72  * should not be pre-initialized.
73  *
74  * XXX Should also include hardware (fixed) dependencies.
75  */
76 struct clkdm_dep {
77 	const char *clkdm_name;
78 	struct clockdomain *clkdm;
79 	atomic_t wkdep_usecount;
80 	atomic_t sleepdep_usecount;
81 };
82 
83 /* Possible flags for struct clockdomain._flags */
84 #define _CLKDM_FLAG_HWSUP_ENABLED		BIT(0)
85 
86 /**
87  * struct clockdomain - OMAP clockdomain
88  * @name: clockdomain name
89  * @pwrdm: powerdomain containing this clockdomain
90  * @clktrctrl_reg: CLKSTCTRL reg for the given clock domain
91  * @clktrctrl_mask: CLKTRCTRL/AUTOSTATE field mask in CM_CLKSTCTRL reg
92  * @flags: Clockdomain capability flags
93  * @_flags: Flags for use only by internal clockdomain code
94  * @dep_bit: Bit shift of this clockdomain's PM_WKDEP/CM_SLEEPDEP bit
95  * @prcm_partition: (OMAP4 only) PRCM partition ID for this clkdm's registers
96  * @cm_inst: (OMAP4 only) CM instance register offset
97  * @clkdm_offs: (OMAP4 only) CM clockdomain register offset
98  * @wkdep_srcs: Clockdomains that can be told to wake this powerdomain up
99  * @sleepdep_srcs: Clockdomains that can be told to keep this clkdm from inact
100  * @usecount: Usecount tracking
101  * @node: list_head to link all clockdomains together
102  *
103  * @prcm_partition should be a macro from mach-omap2/prcm44xx.h (OMAP4 only)
104  * @cm_inst should be a macro ending in _INST from the OMAP4 CM instance
105  *     definitions (OMAP4 only)
106  * @clkdm_offs should be a macro ending in _CDOFFS from the OMAP4 CM instance
107  *     definitions (OMAP4 only)
108  */
109 struct clockdomain {
110 	const char *name;
111 	union {
112 		const char *name;
113 		struct powerdomain *ptr;
114 	} pwrdm;
115 	const u16 clktrctrl_mask;
116 	const u8 flags;
117 	u8 _flags;
118 	const u8 dep_bit;
119 	const u8 prcm_partition;
120 	const s16 cm_inst;
121 	const u16 clkdm_offs;
122 	struct clkdm_dep *wkdep_srcs;
123 	struct clkdm_dep *sleepdep_srcs;
124 	atomic_t usecount;
125 	struct list_head node;
126 	spinlock_t lock;
127 };
128 
129 /**
130  * struct clkdm_ops - Arch specific function implementations
131  * @clkdm_add_wkdep: Add a wakeup dependency between clk domains
132  * @clkdm_del_wkdep: Delete a wakeup dependency between clk domains
133  * @clkdm_read_wkdep: Read wakeup dependency state between clk domains
134  * @clkdm_clear_all_wkdeps: Remove all wakeup dependencies from the clk domain
135  * @clkdm_add_sleepdep: Add a sleep dependency between clk domains
136  * @clkdm_del_sleepdep: Delete a sleep dependency between clk domains
137  * @clkdm_read_sleepdep: Read sleep dependency state between clk domains
138  * @clkdm_clear_all_sleepdeps: Remove all sleep dependencies from the clk domain
139  * @clkdm_sleep: Force a clockdomain to sleep
140  * @clkdm_wakeup: Force a clockdomain to wakeup
141  * @clkdm_allow_idle: Enable hw supervised idle transitions for clock domain
142  * @clkdm_deny_idle: Disable hw supervised idle transitions for clock domain
143  * @clkdm_clk_enable: Put the clkdm in right state for a clock enable
144  * @clkdm_clk_disable: Put the clkdm in right state for a clock disable
145  */
146 struct clkdm_ops {
147 	int	(*clkdm_add_wkdep)(struct clockdomain *clkdm1, struct clockdomain *clkdm2);
148 	int	(*clkdm_del_wkdep)(struct clockdomain *clkdm1, struct clockdomain *clkdm2);
149 	int	(*clkdm_read_wkdep)(struct clockdomain *clkdm1, struct clockdomain *clkdm2);
150 	int	(*clkdm_clear_all_wkdeps)(struct clockdomain *clkdm);
151 	int	(*clkdm_add_sleepdep)(struct clockdomain *clkdm1, struct clockdomain *clkdm2);
152 	int	(*clkdm_del_sleepdep)(struct clockdomain *clkdm1, struct clockdomain *clkdm2);
153 	int	(*clkdm_read_sleepdep)(struct clockdomain *clkdm1, struct clockdomain *clkdm2);
154 	int	(*clkdm_clear_all_sleepdeps)(struct clockdomain *clkdm);
155 	int	(*clkdm_sleep)(struct clockdomain *clkdm);
156 	int	(*clkdm_wakeup)(struct clockdomain *clkdm);
157 	void	(*clkdm_allow_idle)(struct clockdomain *clkdm);
158 	void	(*clkdm_deny_idle)(struct clockdomain *clkdm);
159 	int	(*clkdm_clk_enable)(struct clockdomain *clkdm);
160 	int	(*clkdm_clk_disable)(struct clockdomain *clkdm);
161 };
162 
163 int clkdm_register_platform_funcs(struct clkdm_ops *co);
164 int clkdm_register_autodeps(struct clkdm_autodep *ia);
165 int clkdm_register_clkdms(struct clockdomain **c);
166 int clkdm_complete_init(void);
167 
168 struct clockdomain *clkdm_lookup(const char *name);
169 
170 int clkdm_for_each(int (*fn)(struct clockdomain *clkdm, void *user),
171 			void *user);
172 struct powerdomain *clkdm_get_pwrdm(struct clockdomain *clkdm);
173 
174 int clkdm_add_wkdep(struct clockdomain *clkdm1, struct clockdomain *clkdm2);
175 int clkdm_del_wkdep(struct clockdomain *clkdm1, struct clockdomain *clkdm2);
176 int clkdm_read_wkdep(struct clockdomain *clkdm1, struct clockdomain *clkdm2);
177 int clkdm_clear_all_wkdeps(struct clockdomain *clkdm);
178 int clkdm_add_sleepdep(struct clockdomain *clkdm1, struct clockdomain *clkdm2);
179 int clkdm_del_sleepdep(struct clockdomain *clkdm1, struct clockdomain *clkdm2);
180 int clkdm_read_sleepdep(struct clockdomain *clkdm1, struct clockdomain *clkdm2);
181 int clkdm_clear_all_sleepdeps(struct clockdomain *clkdm);
182 
183 void clkdm_allow_idle(struct clockdomain *clkdm);
184 void clkdm_deny_idle(struct clockdomain *clkdm);
185 bool clkdm_in_hwsup(struct clockdomain *clkdm);
186 
187 int clkdm_wakeup(struct clockdomain *clkdm);
188 int clkdm_sleep(struct clockdomain *clkdm);
189 
190 int clkdm_clk_enable(struct clockdomain *clkdm, struct clk *clk);
191 int clkdm_clk_disable(struct clockdomain *clkdm, struct clk *clk);
192 int clkdm_hwmod_enable(struct clockdomain *clkdm, struct omap_hwmod *oh);
193 int clkdm_hwmod_disable(struct clockdomain *clkdm, struct omap_hwmod *oh);
194 
195 extern void __init omap242x_clockdomains_init(void);
196 extern void __init omap243x_clockdomains_init(void);
197 extern void __init omap3xxx_clockdomains_init(void);
198 extern void __init omap44xx_clockdomains_init(void);
199 extern void _clkdm_add_autodeps(struct clockdomain *clkdm);
200 extern void _clkdm_del_autodeps(struct clockdomain *clkdm);
201 
202 extern struct clkdm_ops omap2_clkdm_operations;
203 extern struct clkdm_ops omap3_clkdm_operations;
204 extern struct clkdm_ops omap4_clkdm_operations;
205 
206 extern struct clkdm_dep gfx_24xx_wkdeps[];
207 extern struct clkdm_dep dsp_24xx_wkdeps[];
208 extern struct clockdomain wkup_common_clkdm;
209 extern struct clockdomain prm_common_clkdm;
210 extern struct clockdomain cm_common_clkdm;
211 
212 #endif
213