[deliverable/linux.git] / arch / arm / plat-samsung / include / plat / cpu-freq-core.h

/* arch/arm/plat-samsung/include/plat/cpu-freq-core.h
 *
 * Copyright (c) 2006-2009 Simtec Electronics
 *	http://armlinux.simtec.co.uk/
 *	Ben Dooks <ben@simtec.co.uk>
 *
 * S3C CPU frequency scaling support - core support
 *
 * This program is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License version 2 as
 * published by the Free Software Foundation.
*/

#include <plat/cpu-freq.h>

struct seq_file;

#define MAX_BANKS (8)
#define S3C2412_MAX_IO	(8)

/**
 * struct s3c2410_iobank_timing - IO bank timings for S3C2410 style timings
 * @bankcon: The cached version of settings in this structure.
 * @tacp:
 * @tacs: Time from address valid to nCS asserted.
 * @tcos: Time from nCS asserted to nOE or nWE asserted.
 * @tacc: Time that nOE or nWE is asserted.
 * @tcoh: Time nCS is held after nOE or nWE are released.
 * @tcah: Time address is held for after
 * @nwait_en: Whether nWAIT is enabled for this bank.
 *
 * This structure represents the IO timings for a S3C2410 style IO bank
 * used by the CPU frequency support if it needs to change the settings
 * of the IO.
 */
struct s3c2410_iobank_timing {
	unsigned long	bankcon;
	unsigned int	tacp;
	unsigned int	tacs;
	unsigned int	tcos;
	unsigned int	tacc;
	unsigned int	tcoh;		/* nCS hold afrer nOE/nWE */
	unsigned int	tcah;		/* Address hold after nCS */
	unsigned char	nwait_en;	/* nWait enabled for bank. */
};

/**
 * struct s3c2412_iobank_timing - io timings for PL092 (S3C2412) style IO
 * @idcy: The idle cycle time between transactions.
 * @wstrd: nCS release to end of read cycle.
 * @wstwr: nCS release to end of write cycle.
 * @wstoen: nCS assertion to nOE assertion time.
 * @wstwen: nCS assertion to nWE assertion time.
 * @wstbrd: Burst ready delay.
 * @smbidcyr: Register cache for smbidcyr value.
 * @smbwstrd: Register cache for smbwstrd value.
 * @smbwstwr: Register cache for smbwstwr value.
 * @smbwstoen: Register cache for smbwstoen value.
 * @smbwstwen: Register cache for smbwstwen value.
 * @smbwstbrd: Register cache for smbwstbrd value.
 *
 * Timing information for a IO bank on an S3C2412 or similar system which
 * uses a PL093 block.
 */
struct s3c2412_iobank_timing {
	unsigned int	idcy;
	unsigned int	wstrd;
	unsigned int	wstwr;
	unsigned int	wstoen;
	unsigned int	wstwen;
	unsigned int	wstbrd;

	/* register cache */
	unsigned char	smbidcyr;
	unsigned char	smbwstrd;
	unsigned char	smbwstwr;
	unsigned char	smbwstoen;
	unsigned char	smbwstwen;
	unsigned char	smbwstbrd;
};

union s3c_iobank {
	struct s3c2410_iobank_timing	*io_2410;
	struct s3c2412_iobank_timing	*io_2412;
};

/**
 * struct s3c_iotimings - Chip IO timings holder
 * @bank: The timings for each IO bank.
 */
struct s3c_iotimings {
	union s3c_iobank	bank[MAX_BANKS];
};

/**
 * struct s3c_plltab - PLL table information.
 * @vals: List of PLL values.
 * @size: Size of the PLL table @vals.
 */
struct s3c_plltab {
	struct s3c_pllval	*vals;
	int			 size;
};

/**
 * struct s3c_cpufreq_config - current cpu frequency configuration
 * @freq: The current settings for the core clocks.
 * @max: Maxium settings, derived from core, board and user settings.
 * @pll: The PLL table entry for the current PLL settings.
 * @divs: The divisor settings for the core clocks.
 * @info: The current core driver information.
 * @board: The information for the board we are running on.
 * @lock_pll: Set if the PLL settings cannot be changed.
 *
 * This is for the core drivers that need to know information about
 * the current settings and values. It should not be needed by any
 * device drivers.
*/
struct s3c_cpufreq_config {
	struct s3c_freq		freq;
	struct s3c_freq		max;
	struct clk		*mpll;
	struct cpufreq_frequency_table pll;
	struct s3c_clkdivs	divs;
	struct s3c_cpufreq_info *info;	/* for core, not drivers */
	struct s3c_cpufreq_board *board;

	unsigned int	lock_pll:1;
};

/**
 * struct s3c_cpufreq_info - Information for the CPU frequency driver.
 * @name: The name of this implementation.
 * @max: The maximum frequencies for the system.
 * @latency: Transition latency to give to cpufreq.
 * @locktime_m: The lock-time in uS for the MPLL.
 * @locktime_u: The lock-time in uS for the UPLL.
 * @locttime_bits: The number of bits each LOCKTIME field.
 * @need_pll: Set if this driver needs to change the PLL values to achieve
 *	any frequency changes. This is really only need by devices like the
 *	S3C2410 where there is no or limited divider between the PLL and the
 *	ARMCLK.
 * @get_iotiming: Get the current IO timing data, mainly for use at start.
 * @set_iotiming: Update the IO timings from the cached copies calculated
 *	from the @calc_iotiming entry when changing the frequency.
 * @calc_iotiming: Calculate and update the cached copies of the IO timings
 *	from the newly calculated frequencies.
 * @calc_freqtable: Calculate (fill in) the given frequency table from the
 *	current frequency configuration. If the table passed in is NULL,
 *	then the return is the number of elements to be filled for allocation
 *	of the table.
 * @set_refresh: Set the memory refresh configuration.
 * @set_fvco: Set the PLL frequencies.
 * @set_divs: Update the clock divisors.
 * @calc_divs: Calculate the clock divisors.
 */
struct s3c_cpufreq_info {
	const char		*name;
	struct s3c_freq		max;

	unsigned int		latency;

	unsigned int		locktime_m;
	unsigned int		locktime_u;
	unsigned char		locktime_bits;

	unsigned int		need_pll:1;

	/* driver routines */

	int		(*get_iotiming)(struct s3c_cpufreq_config *cfg,
					struct s3c_iotimings *timings);

	void		(*set_iotiming)(struct s3c_cpufreq_config *cfg,
					struct s3c_iotimings *timings);

	int		(*calc_iotiming)(struct s3c_cpufreq_config *cfg,
					 struct s3c_iotimings *timings);

	int		(*calc_freqtable)(struct s3c_cpufreq_config *cfg,
					  struct cpufreq_frequency_table *t,
					  size_t table_size);

	void		(*debug_io_show)(struct seq_file *seq,
					 struct s3c_cpufreq_config *cfg,
					 union s3c_iobank *iob);

	void		(*set_refresh)(struct s3c_cpufreq_config *cfg);
	void		(*set_fvco)(struct s3c_cpufreq_config *cfg);
	void		(*set_divs)(struct s3c_cpufreq_config *cfg);
	int		(*calc_divs)(struct s3c_cpufreq_config *cfg);
};

extern int s3c_cpufreq_register(struct s3c_cpufreq_info *info);

extern int s3c_plltab_register(struct cpufreq_frequency_table *plls,
			       unsigned int plls_no);

/* exports and utilities for debugfs */
extern struct s3c_cpufreq_config *s3c_cpufreq_getconfig(void);
extern struct s3c_iotimings *s3c_cpufreq_getiotimings(void);

#ifdef CONFIG_ARM_S3C24XX_CPUFREQ_DEBUGFS
#define s3c_cpufreq_debugfs_call(x) x
#else
#define s3c_cpufreq_debugfs_call(x) NULL
#endif

/* Useful utility functions. */

extern struct clk *s3c_cpufreq_clk_get(struct device *, const char *);

/* S3C2410 and compatible exported functions */

extern void s3c2410_cpufreq_setrefresh(struct s3c_cpufreq_config *cfg);
extern void s3c2410_set_fvco(struct s3c_cpufreq_config *cfg);

#ifdef CONFIG_S3C2410_IOTIMING
extern void s3c2410_iotiming_debugfs(struct seq_file *seq,
				     struct s3c_cpufreq_config *cfg,
				     union s3c_iobank *iob);

extern int s3c2410_iotiming_calc(struct s3c_cpufreq_config *cfg,
				 struct s3c_iotimings *iot);

extern int s3c2410_iotiming_get(struct s3c_cpufreq_config *cfg,
				struct s3c_iotimings *timings);

extern void s3c2410_iotiming_set(struct s3c_cpufreq_config *cfg,
				 struct s3c_iotimings *iot);
#else
#define s3c2410_iotiming_debugfs NULL
#define s3c2410_iotiming_calc NULL
#define s3c2410_iotiming_get NULL
#define s3c2410_iotiming_set NULL
#endif /* CONFIG_S3C2410_IOTIMING */

/* S3C2412 compatible routines */

#ifdef CONFIG_S3C2412_IOTIMING
extern void s3c2412_iotiming_debugfs(struct seq_file *seq,
				     struct s3c_cpufreq_config *cfg,
				     union s3c_iobank *iob);

extern int s3c2412_iotiming_get(struct s3c_cpufreq_config *cfg,
				struct s3c_iotimings *timings);

extern int s3c2412_iotiming_calc(struct s3c_cpufreq_config *cfg,
				 struct s3c_iotimings *iot);

extern void s3c2412_iotiming_set(struct s3c_cpufreq_config *cfg,
				 struct s3c_iotimings *iot);
#else
#define s3c2412_iotiming_debugfs NULL
#define s3c2412_iotiming_calc NULL
#define s3c2412_iotiming_get NULL
#define s3c2412_iotiming_set NULL
#endif /* CONFIG_S3C2412_IOTIMING */

#ifdef CONFIG_ARM_S3C24XX_CPUFREQ_DEBUG
#define s3c_freq_dbg(x...) printk(KERN_INFO x)
#else
#define s3c_freq_dbg(x...) do { if (0) printk(x); } while (0)
#endif /* CONFIG_ARM_S3C24XX_CPUFREQ_DEBUG */

#ifdef CONFIG_ARM_S3C24XX_CPUFREQ_IODEBUG
#define s3c_freq_iodbg(x...) printk(KERN_INFO x)
#else
#define s3c_freq_iodbg(x...) do { if (0) printk(x); } while (0)
#endif /* CONFIG_ARM_S3C24XX_CPUFREQ_IODEBUG */

static inline int s3c_cpufreq_addfreq(struct cpufreq_frequency_table *table,
				      int index, size_t table_size,
				      unsigned int freq)
{
	if (index < 0)
		return index;

	if (table) {
		if (index >= table_size)
			return -ENOMEM;

		s3c_freq_dbg("%s: { %d = %u kHz }\n",
			     __func__, index, freq);

		table[index].driver_data = index;
		table[index].frequency = freq;
	}

	return index + 1;
}
Commit	Line	Data
dc98e414	1	/* arch/arm/plat-samsung/include/plat/cpu-freq-core.h
2e4ea6e8	2	*
ccae941e	3	* Copyright (c) 2006-2009 Simtec Electronics
2e4ea6e8 BD	4	* http://armlinux.simtec.co.uk/
	5	* Ben Dooks <ben@simtec.co.uk>
	6	*
	7	* S3C CPU frequency scaling support - core support
	8	*
	9	* This program is free software; you can redistribute it and/or modify
	10	* it under the terms of the GNU General Public License version 2 as
	11	* published by the Free Software Foundation.
	12	*/
	13
	14	#include <plat/cpu-freq.h>
	15
e6d197a6 BD	16	struct seq_file;
e6d197a6 BD	17
2e4ea6e8 BD	18	#define MAX_BANKS (8)
	19	#define S3C2412_MAX_IO (8)
	20
	21	/**
	22	* struct s3c2410_iobank_timing - IO bank timings for S3C2410 style timings
	23	* @bankcon: The cached version of settings in this structure.
	24	* @tacp:
	25	* @tacs: Time from address valid to nCS asserted.
	26	* @tcos: Time from nCS asserted to nOE or nWE asserted.
	27	* @tacc: Time that nOE or nWE is asserted.
	28	* @tcoh: Time nCS is held after nOE or nWE are released.
	29	* @tcah: Time address is held for after
	30	* @nwait_en: Whether nWAIT is enabled for this bank.
	31	*
	32	* This structure represents the IO timings for a S3C2410 style IO bank
	33	* used by the CPU frequency support if it needs to change the settings
	34	* of the IO.
	35	*/
	36	struct s3c2410_iobank_timing {
	37	unsigned long bankcon;
	38	unsigned int tacp;
	39	unsigned int tacs;
	40	unsigned int tcos;
	41	unsigned int tacc;
	42	unsigned int tcoh; /* nCS hold afrer nOE/nWE */
	43	unsigned int tcah; /* Address hold after nCS */
	44	unsigned char nwait_en; /* nWait enabled for bank. */
	45	};
	46
140780ab BD	47	/**
	48	* struct s3c2412_iobank_timing - io timings for PL092 (S3C2412) style IO
	49	* @idcy: The idle cycle time between transactions.
	50	* @wstrd: nCS release to end of read cycle.
	51	* @wstwr: nCS release to end of write cycle.
	52	* @wstoen: nCS assertion to nOE assertion time.
	53	* @wstwen: nCS assertion to nWE assertion time.
	54	* @wstbrd: Burst ready delay.
	55	* @smbidcyr: Register cache for smbidcyr value.
	56	* @smbwstrd: Register cache for smbwstrd value.
	57	* @smbwstwr: Register cache for smbwstwr value.
	58	* @smbwstoen: Register cache for smbwstoen value.
	59	* @smbwstwen: Register cache for smbwstwen value.
	60	* @smbwstbrd: Register cache for smbwstbrd value.
	61	*
	62	* Timing information for a IO bank on an S3C2412 or similar system which
	63	* uses a PL093 block.
	64	*/
	65	struct s3c2412_iobank_timing {
	66	unsigned int idcy;
	67	unsigned int wstrd;
	68	unsigned int wstwr;
	69	unsigned int wstoen;
	70	unsigned int wstwen;
	71	unsigned int wstbrd;
	72
	73	/* register cache */
	74	unsigned char smbidcyr;
	75	unsigned char smbwstrd;
	76	unsigned char smbwstwr;
	77	unsigned char smbwstoen;
	78	unsigned char smbwstwen;
	79	unsigned char smbwstbrd;
	80	};
	81
2e4ea6e8	82	union s3c_iobank {
140780ab BD	83	struct s3c2410_iobank_timing *io_2410;
140780ab BD	84	struct s3c2412_iobank_timing *io_2412;
2e4ea6e8 BD	85	};
	86
	87	/**
	88	* struct s3c_iotimings - Chip IO timings holder
	89	* @bank: The timings for each IO bank.
	90	*/
	91	struct s3c_iotimings {
	92	union s3c_iobank bank[MAX_BANKS];
	93	};
	94
	95	/**
	96	* struct s3c_plltab - PLL table information.
	97	* @vals: List of PLL values.
	98	* @size: Size of the PLL table @vals.
	99	*/
	100	struct s3c_plltab {
	101	struct s3c_pllval *vals;
	102	int size;
	103	};
	104
d6fc87d3 BD	105	/**
	106	* struct s3c_cpufreq_config - current cpu frequency configuration
	107	* @freq: The current settings for the core clocks.
	108	* @max: Maxium settings, derived from core, board and user settings.
	109	* @pll: The PLL table entry for the current PLL settings.
	110	* @divs: The divisor settings for the core clocks.
	111	* @info: The current core driver information.
	112	* @board: The information for the board we are running on.
	113	* @lock_pll: Set if the PLL settings cannot be changed.
	114	*
	115	* This is for the core drivers that need to know information about
	116	* the current settings and values. It should not be needed by any
	117	* device drivers.
	118	*/
	119	struct s3c_cpufreq_config {
	120	struct s3c_freq freq;
	121	struct s3c_freq max;
d8b53257	122	struct clk *mpll;
d6fc87d3 BD	123	struct cpufreq_frequency_table pll;
	124	struct s3c_clkdivs divs;
	125	struct s3c_cpufreq_info info; / for core, not drivers */
	126	struct s3c_cpufreq_board *board;
	127
	128	unsigned int lock_pll:1;
	129	};
	130
2e4ea6e8 BD	131	/**
	132	* struct s3c_cpufreq_info - Information for the CPU frequency driver.
	133	* @name: The name of this implementation.
	134	* @max: The maximum frequencies for the system.
	135	* @latency: Transition latency to give to cpufreq.
	136	* @locktime_m: The lock-time in uS for the MPLL.
	137	* @locktime_u: The lock-time in uS for the UPLL.
	138	* @locttime_bits: The number of bits each LOCKTIME field.
3ad2f3fb	139	* @need_pll: Set if this driver needs to change the PLL values to achieve
2e4ea6e8 BD	140	* any frequency changes. This is really only need by devices like the
	141	* S3C2410 where there is no or limited divider between the PLL and the
	142	* ARMCLK.
2e4ea6e8 BD	143	* @get_iotiming: Get the current IO timing data, mainly for use at start.
	144	* @set_iotiming: Update the IO timings from the cached copies calculated
	145	* from the @calc_iotiming entry when changing the frequency.
	146	* @calc_iotiming: Calculate and update the cached copies of the IO timings
	147	* from the newly calculated frequencies.
	148	* @calc_freqtable: Calculate (fill in) the given frequency table from the
	149	* current frequency configuration. If the table passed in is NULL,
	150	* then the return is the number of elements to be filled for allocation
	151	* of the table.
	152	* @set_refresh: Set the memory refresh configuration.
	153	* @set_fvco: Set the PLL frequencies.
	154	* @set_divs: Update the clock divisors.
	155	* @calc_divs: Calculate the clock divisors.
	156	*/
	157	struct s3c_cpufreq_info {
	158	const char *name;
	159	struct s3c_freq max;
	160
	161	unsigned int latency;
	162
	163	unsigned int locktime_m;
	164	unsigned int locktime_u;
	165	unsigned char locktime_bits;
	166
	167	unsigned int need_pll:1;
	168
	169	/* driver routines */
	170
2e4ea6e8 BD	171	int (get_iotiming)(struct s3c_cpufreq_config cfg,
	172	struct s3c_iotimings *timings);
	173
	174	void (set_iotiming)(struct s3c_cpufreq_config cfg,
	175	struct s3c_iotimings *timings);
	176
	177	int (calc_iotiming)(struct s3c_cpufreq_config cfg,
	178	struct s3c_iotimings *timings);
	179
	180	int (calc_freqtable)(struct s3c_cpufreq_config cfg,
	181	struct cpufreq_frequency_table *t,
	182	size_t table_size);
	183
e6d197a6 BD	184	void (debug_io_show)(struct seq_file seq,
	185	struct s3c_cpufreq_config *cfg,
	186	union s3c_iobank *iob);
	187
2e4ea6e8 BD	188	void (set_refresh)(struct s3c_cpufreq_config cfg);
	189	void (set_fvco)(struct s3c_cpufreq_config cfg);
	190	void (set_divs)(struct s3c_cpufreq_config cfg);
	191	int (calc_divs)(struct s3c_cpufreq_config cfg);
	192	};
	193
	194	extern int s3c_cpufreq_register(struct s3c_cpufreq_info *info);
	195
dc98e414 KK	196	extern int s3c_plltab_register(struct cpufreq_frequency_table *plls,
dc98e414 KK	197	unsigned int plls_no);
2e4ea6e8	198
e6d197a6 BD	199	/* exports and utilities for debugfs */
	200	extern struct s3c_cpufreq_config *s3c_cpufreq_getconfig(void);
	201	extern struct s3c_iotimings *s3c_cpufreq_getiotimings(void);
	202
f023f8dd	203	#ifdef CONFIG_ARM_S3C24XX_CPUFREQ_DEBUGFS
e6d197a6 BD	204	#define s3c_cpufreq_debugfs_call(x) x
	205	#else
	206	#define s3c_cpufreq_debugfs_call(x) NULL
	207	#endif
	208
2e4ea6e8 BD	209	/* Useful utility functions. */
	210
	211	extern struct clk s3c_cpufreq_clk_get(struct device , const char *);
	212
	213	/* S3C2410 and compatible exported functions */
	214
	215	extern void s3c2410_cpufreq_setrefresh(struct s3c_cpufreq_config *cfg);
2e31de65	216	extern void s3c2410_set_fvco(struct s3c_cpufreq_config *cfg);
2e4ea6e8	217
2e31de65	218	#ifdef CONFIG_S3C2410_IOTIMING
baaf939d DK	219	extern void s3c2410_iotiming_debugfs(struct seq_file *seq,
	220	struct s3c_cpufreq_config *cfg,
	221	union s3c_iobank *iob);
	222
2e4ea6e8 BD	223	extern int s3c2410_iotiming_calc(struct s3c_cpufreq_config *cfg,
	224	struct s3c_iotimings *iot);
	225
	226	extern int s3c2410_iotiming_get(struct s3c_cpufreq_config *cfg,
	227	struct s3c_iotimings *timings);
	228
	229	extern void s3c2410_iotiming_set(struct s3c_cpufreq_config *cfg,
	230	struct s3c_iotimings *iot);
2e31de65	231	#else
baaf939d	232	#define s3c2410_iotiming_debugfs NULL
2e31de65 BD	233	#define s3c2410_iotiming_calc NULL
	234	#define s3c2410_iotiming_get NULL
	235	#define s3c2410_iotiming_set NULL
	236	#endif /* CONFIG_S3C2410_IOTIMING */
2e4ea6e8	237
140780ab BD	238	/* S3C2412 compatible routines */
140780ab BD	239
baaf939d DK	240	#ifdef CONFIG_S3C2412_IOTIMING
	241	extern void s3c2412_iotiming_debugfs(struct seq_file *seq,
	242	struct s3c_cpufreq_config *cfg,
	243	union s3c_iobank *iob);
140780ab BD	244
	245	extern int s3c2412_iotiming_get(struct s3c_cpufreq_config *cfg,
	246	struct s3c_iotimings *timings);
	247
	248	extern int s3c2412_iotiming_calc(struct s3c_cpufreq_config *cfg,
	249	struct s3c_iotimings *iot);
	250
	251	extern void s3c2412_iotiming_set(struct s3c_cpufreq_config *cfg,
	252	struct s3c_iotimings *iot);
baaf939d DK	253	#else
	254	#define s3c2412_iotiming_debugfs NULL
	255	#define s3c2412_iotiming_calc NULL
	256	#define s3c2412_iotiming_get NULL
	257	#define s3c2412_iotiming_set NULL
	258	#endif /* CONFIG_S3C2412_IOTIMING */
140780ab	259
f023f8dd	260	#ifdef CONFIG_ARM_S3C24XX_CPUFREQ_DEBUG
2e4ea6e8 BD	261	#define s3c_freq_dbg(x...) printk(KERN_INFO x)
	262	#else
	263	#define s3c_freq_dbg(x...) do { if (0) printk(x); } while (0)
f023f8dd	264	#endif /* CONFIG_ARM_S3C24XX_CPUFREQ_DEBUG */
2e4ea6e8	265
f023f8dd	266	#ifdef CONFIG_ARM_S3C24XX_CPUFREQ_IODEBUG
2e4ea6e8 BD	267	#define s3c_freq_iodbg(x...) printk(KERN_INFO x)
	268	#else
	269	#define s3c_freq_iodbg(x...) do { if (0) printk(x); } while (0)
f023f8dd	270	#endif /* CONFIG_ARM_S3C24XX_CPUFREQ_IODEBUG */
2e4ea6e8 BD	271
	272	static inline int s3c_cpufreq_addfreq(struct cpufreq_frequency_table *table,
	273	int index, size_t table_size,
	274	unsigned int freq)
	275	{
	276	if (index < 0)
	277	return index;
	278
	279	if (table) {
	280	if (index >= table_size)
	281	return -ENOMEM;
	282
	283	s3c_freq_dbg("%s: { %d = %u kHz }\n",
	284	__func__, index, freq);
	285
50701588	286	table[index].driver_data = index;
2e4ea6e8 BD	287	table[index].frequency = freq;
	288	}
	289
	290	return index + 1;
	291	}