1* Gated Clock bindings for Marvell EBU SoCs
2
3Marvell Armada 370/375/380/385/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 XP:
81ID	Clock	Peripheral
82-----------------------------------
830	audio	Audio Cntrl
841	ge3	Gigabit Ethernet 3
852	ge2	Gigabit Ethernet 2
863	ge1	Gigabit Ethernet 1
874	ge0	Gigabit Ethernet 0
885	pex0	PCIe Cntrl 0
896	pex1	PCIe Cntrl 1
907	pex2	PCIe Cntrl 2
918	pex3	PCIe Cntrl 3
9213	bp
9314	sata0lnk
9415	sata0	SATA Host 0
9516	lcd	LCD Cntrl
9617	sdio	SDHCI Host
9718	usb0	USB Host 0
9819	usb1	USB Host 1
9920	usb2	USB Host 2
10022	xor0	XOR DMA 0
10123	crypto	CESA engine
10225	tdm	Time Division Mplx
10328	xor1	XOR DMA 1
10429	sata1lnk
10530	sata1	SATA Host 0
106
107The following is a list of provided IDs for Dove:
108ID	Clock	Peripheral
109-----------------------------------
1100	usb0	USB Host 0
1111	usb1	USB Host 1
1122	ge	Gigabit Ethernet
1133	sata	SATA Host
1144	pex0	PCIe Cntrl 0
1155	pex1	PCIe Cntrl 1
1168	sdio0	SDHCI Host 0
1179	sdio1	SDHCI Host 1
11810	nand	NAND Cntrl
11911	camera	Camera Cntrl
12012	i2s0	I2S Cntrl 0
12113	i2s1	I2S Cntrl 1
12215	crypto	CESA engine
12321	ac97	AC97 Cntrl
12422	pdma	Peripheral DMA
12523	xor0	XOR DMA 0
12624	xor1	XOR DMA 1
12730	gephy	Gigabit Ethernel PHY
128Note: gephy(30) is implemented as a parent clock of ge(2)
129
130The following is a list of provided IDs for Kirkwood:
131ID	Clock	Peripheral
132-----------------------------------
1330	ge0	Gigabit Ethernet 0
1342	pex0	PCIe Cntrl 0
1353	usb0	USB Host 0
1364	sdio	SDIO Cntrl
1375	tsu	Transp. Stream Unit
1386	dunit	SDRAM Cntrl
1397	runit	Runit
1408	xor0	XOR DMA 0
1419	audio	I2S Cntrl 0
14214	sata0	SATA Host 0
14315	sata1	SATA Host 1
14416	xor1	XOR DMA 1
14517	crypto	CESA engine
14618	pex1	PCIe Cntrl 1
14719	ge1	Gigabit Ethernet 1
14820	tdm	Time Division Mplx
149
150Required properties:
151- compatible : shall be one of the following:
152	"marvell,armada-370-gating-clock" - for Armada 370 SoC clock gating
153	"marvell,armada-375-gating-clock" - for Armada 375 SoC clock gating
154	"marvell,armada-380-gating-clock" - for Armada 380/385 SoC clock gating
155	"marvell,armada-xp-gating-clock" - for Armada XP SoC clock gating
156	"marvell,dove-gating-clock" - for Dove SoC clock gating
157	"marvell,kirkwood-gating-clock" - for Kirkwood SoC clock gating
158- reg : shall be the register address of the Clock Gating Control register
159- #clock-cells : from common clock binding; shall be set to 1
160
161Optional properties:
162- clocks : default parent clock phandle (e.g. tclk)
163
164Example:
165
166gate_clk: clock-gating-control@d0038 {
167	compatible = "marvell,dove-gating-clock";
168	reg = <0xd0038 0x4>;
169	/* default parent clock is tclk */
170	clocks = <&core_clk 0>;
171	#clock-cells = <1>;
172};
173
174sdio0: sdio@92000 {
175	compatible = "marvell,dove-sdhci";
176	/* get clk gate bit 8 (sdio0) */
177	clocks = <&gate_clk 8>;
178};
179