1* Gated Clock bindings for Marvell EBU SoCs
2
3Marvell Armada 370/375/380/385/39x/XP, Dove and Kirkwood allow some
4peripheral clocks to be gated to save some power. The clock consumer
5should specify the desired clock by having the clock ID in its
6"clocks" phandle cell. The clock ID is directly mapped to the
7corresponding clock gating control bit in HW to ease manual clock
8lookup in datasheet.
9
10The following is a list of provided IDs for Armada 370:
11ID	Clock	Peripheral
12-----------------------------------
130	Audio	AC97 Cntrl
141	pex0_en	PCIe 0 Clock out
152	pex1_en	PCIe 1 Clock out
163	ge1	Gigabit Ethernet 1
174	ge0	Gigabit Ethernet 0
185	pex0	PCIe Cntrl 0
199	pex1	PCIe Cntrl 1
2015	sata0	SATA Host 0
2117	sdio	SDHCI Host
2225	tdm	Time Division Mplx
2328	ddr	DDR Cntrl
2430	sata1	SATA Host 0
25
26The following is a list of provided IDs for Armada 375:
27ID	Clock		Peripheral
28-----------------------------------
292	mu		Management Unit
303	pp		Packet Processor
314	ptp		PTP
325	pex0		PCIe 0 Clock out
336	pex1		PCIe 1 Clock out
348	audio		Audio Cntrl
3511	nd_clk		Nand Flash Cntrl
3614	sata0_link	SATA 0 Link
3715	sata0_core	SATA 0 Core
3816	usb3		USB3 Host
3917	sdio		SDHCI Host
4018	usb		USB Host
4119	gop		Gigabit Ethernet MAC
4220	sata1_link	SATA 1 Link
4321	sata1_core	SATA 1 Core
4422	xor0		XOR DMA 0
4523	xor1		XOR DMA 0
4624	copro		Coprocessor
4725	tdm		Time Division Mplx
4828	crypto0_enc	Cryptographic Unit Port 0 Encryption
4929	crypto0_core	Cryptographic Unit Port 0 Core
5030	crypto1_enc	Cryptographic Unit Port 1 Encryption
5131	crypto1_core	Cryptographic Unit Port 1 Core
52
53The following is a list of provided IDs for Armada 380/385:
54ID	Clock		Peripheral
55-----------------------------------
560	audio		Audio
572	ge2		Gigabit Ethernet 2
583	ge1		Gigabit Ethernet 1
594	ge0		Gigabit Ethernet 0
605	pex1		PCIe 1
616	pex2		PCIe 2
627	pex3		PCIe 3
638	pex0		PCIe 0
649	usb3h0		USB3 Host 0
6510	usb3h1		USB3 Host 1
6611	usb3d		USB3 Device
6713	bm		Buffer Management
6814	crypto0z	Cryptographic 0 Z
6915	sata0		SATA 0
7016	crypto1z	Cryptographic 1 Z
7117	sdio		SDIO
7218	usb2		USB 2
7321	crypto1		Cryptographic 1
7422	xor0		XOR 0
7523	crypto0		Cryptographic 0
7625	tdm		Time Division Multiplexing
7728	xor1		XOR 1
7830	sata1		SATA 1
79
80The following is a list of provided IDs for Armada 39x:
81ID	Clock		Peripheral
82-----------------------------------
835	pex1		PCIe 1
846	pex2		PCIe 2
857	pex3		PCIe 3
868	pex0		PCIe 0
879	usb3h0		USB3 Host 0
8817	sdio		SDIO
8922	xor0		XOR 0
9028	xor1		XOR 1
91
92The following is a list of provided IDs for Armada XP:
93ID	Clock	Peripheral
94-----------------------------------
950	audio	Audio Cntrl
961	ge3	Gigabit Ethernet 3
972	ge2	Gigabit Ethernet 2
983	ge1	Gigabit Ethernet 1
994	ge0	Gigabit Ethernet 0
1005	pex0	PCIe Cntrl 0
1016	pex1	PCIe Cntrl 1
1027	pex2	PCIe Cntrl 2
1038	pex3	PCIe Cntrl 3
10413	bp
10514	sata0lnk
10615	sata0	SATA Host 0
10716	lcd	LCD Cntrl
10817	sdio	SDHCI Host
10918	usb0	USB Host 0
11019	usb1	USB Host 1
11120	usb2	USB Host 2
11222	xor0	XOR DMA 0
11323	crypto	CESA engine
11425	tdm	Time Division Mplx
11528	xor1	XOR DMA 1
11629	sata1lnk
11730	sata1	SATA Host 0
118
119The following is a list of provided IDs for Dove:
120ID	Clock	Peripheral
121-----------------------------------
1220	usb0	USB Host 0
1231	usb1	USB Host 1
1242	ge	Gigabit Ethernet
1253	sata	SATA Host
1264	pex0	PCIe Cntrl 0
1275	pex1	PCIe Cntrl 1
1288	sdio0	SDHCI Host 0
1299	sdio1	SDHCI Host 1
13010	nand	NAND Cntrl
13111	camera	Camera Cntrl
13212	i2s0	I2S Cntrl 0
13313	i2s1	I2S Cntrl 1
13415	crypto	CESA engine
13521	ac97	AC97 Cntrl
13622	pdma	Peripheral DMA
13723	xor0	XOR DMA 0
13824	xor1	XOR DMA 1
13930	gephy	Gigabit Ethernel PHY
140Note: gephy(30) is implemented as a parent clock of ge(2)
141
142The following is a list of provided IDs for Kirkwood:
143ID	Clock	Peripheral
144-----------------------------------
1450	ge0	Gigabit Ethernet 0
1462	pex0	PCIe Cntrl 0
1473	usb0	USB Host 0
1484	sdio	SDIO Cntrl
1495	tsu	Transp. Stream Unit
1506	dunit	SDRAM Cntrl
1517	runit	Runit
1528	xor0	XOR DMA 0
1539	audio	I2S Cntrl 0
15414	sata0	SATA Host 0
15515	sata1	SATA Host 1
15616	xor1	XOR DMA 1
15717	crypto	CESA engine
15818	pex1	PCIe Cntrl 1
15919	ge1	Gigabit Ethernet 1
16020	tdm	Time Division Mplx
161
162Required properties:
163- compatible : shall be one of the following:
164	"marvell,armada-370-gating-clock" - for Armada 370 SoC clock gating
165	"marvell,armada-375-gating-clock" - for Armada 375 SoC clock gating
166	"marvell,armada-380-gating-clock" - for Armada 380/385 SoC clock gating
167	"marvell,armada-390-gating-clock" - for Armada 39x SoC clock gating
168	"marvell,armada-xp-gating-clock" - for Armada XP SoC clock gating
169	"marvell,dove-gating-clock" - for Dove SoC clock gating
170	"marvell,kirkwood-gating-clock" - for Kirkwood SoC clock gating
171- reg : shall be the register address of the Clock Gating Control register
172- #clock-cells : from common clock binding; shall be set to 1
173
174Optional properties:
175- clocks : default parent clock phandle (e.g. tclk)
176
177Example:
178
179gate_clk: clock-gating-control@d0038 {
180	compatible = "marvell,dove-gating-clock";
181	reg = <0xd0038 0x4>;
182	/* default parent clock is tclk */
183	clocks = <&core_clk 0>;
184	#clock-cells = <1>;
185};
186
187sdio0: sdio@92000 {
188	compatible = "marvell,dove-sdhci";
189	/* get clk gate bit 8 (sdio0) */
190	clocks = <&gate_clk 8>;
191};
192