xref: /linux/drivers/clk/versatile/icst.h (revision 5f1d8970)
1 /* SPDX-License-Identifier: GPL-2.0-only */
2 /*
3  *  Copyright (C) 2003 Deep Blue Solutions, Ltd, All Rights Reserved.
4  *
5  *  Support functions for calculating clocks/divisors for the ICST
6  *  clock generators.  See https://www.idt.com/ for more information
7  *  on these devices.
8  */
9 #ifndef ICST_H
10 #define ICST_H
11 
12 struct icst_params {
13 	unsigned long	ref;
14 	unsigned long	vco_max;	/* inclusive */
15 	unsigned long	vco_min;	/* exclusive */
16 	unsigned short	vd_min;		/* inclusive */
17 	unsigned short	vd_max;		/* inclusive */
18 	unsigned char	rd_min;		/* inclusive */
19 	unsigned char	rd_max;		/* inclusive */
20 	const unsigned char *s2div;	/* chip specific s2div array */
21 	const unsigned char *idx2s;	/* chip specific idx2s array */
22 };
23 
24 struct icst_vco {
25 	unsigned short	v;
26 	unsigned char	r;
27 	unsigned char	s;
28 };
29 
30 unsigned long icst_hz(const struct icst_params *p, struct icst_vco vco);
31 struct icst_vco icst_hz_to_vco(const struct icst_params *p, unsigned long freq);
32 
33 /*
34  * ICST307 VCO frequency must be between 6MHz and 200MHz (3.3 or 5V).
35  * This frequency is pre-output divider.
36  */
37 #define ICST307_VCO_MIN	6000000
38 #define ICST307_VCO_MAX	200000000
39 
40 extern const unsigned char icst307_s2div[];
41 extern const unsigned char icst307_idx2s[];
42 
43 /*
44  * ICST525 VCO frequency must be between 10MHz and 200MHz (3V) or 320MHz (5V).
45  * This frequency is pre-output divider.
46  */
47 #define ICST525_VCO_MIN		10000000
48 #define ICST525_VCO_MAX_3V	200000000
49 #define ICST525_VCO_MAX_5V	320000000
50 
51 extern const unsigned char icst525_s2div[];
52 extern const unsigned char icst525_idx2s[];
53 
54 #endif
55