xref: /linux/Documentation/devicetree/bindings/clock/mvebu-gated-clock.txt (revision 0337966d121ebebf73a1c346123e8112796e684e)
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
2223	crypto	CESA (crypto engine)
2325	tdm	Time Division Mplx
2428	ddr	DDR Cntrl
2530	sata1	SATA Host 0
26
27The following is a list of provided IDs for Armada 375:
28ID	Clock		Peripheral
29-----------------------------------
302	mu		Management Unit
313	pp		Packet Processor
324	ptp		PTP
335	pex0		PCIe 0 Clock out
346	pex1		PCIe 1 Clock out
358	audio		Audio Cntrl
3611	nd_clk		Nand Flash Cntrl
3714	sata0_link	SATA 0 Link
3815	sata0_core	SATA 0 Core
3916	usb3		USB3 Host
4017	sdio		SDHCI Host
4118	usb		USB Host
4219	gop		Gigabit Ethernet MAC
4320	sata1_link	SATA 1 Link
4421	sata1_core	SATA 1 Core
4522	xor0		XOR DMA 0
4623	xor1		XOR DMA 0
4724	copro		Coprocessor
4825	tdm		Time Division Mplx
4928	crypto0_enc	Cryptographic Unit Port 0 Encryption
5029	crypto0_core	Cryptographic Unit Port 0 Core
5130	crypto1_enc	Cryptographic Unit Port 1 Encryption
5231	crypto1_core	Cryptographic Unit Port 1 Core
53
54The following is a list of provided IDs for Armada 380/385:
55ID	Clock		Peripheral
56-----------------------------------
570	audio		Audio
582	ge2		Gigabit Ethernet 2
593	ge1		Gigabit Ethernet 1
604	ge0		Gigabit Ethernet 0
615	pex1		PCIe 1
626	pex2		PCIe 2
637	pex3		PCIe 3
648	pex0		PCIe 0
659	usb3h0		USB3 Host 0
6610	usb3h1		USB3 Host 1
6711	usb3d		USB3 Device
6813	bm		Buffer Management
6914	crypto0z	Cryptographic 0 Z
7015	sata0		SATA 0
7116	crypto1z	Cryptographic 1 Z
7217	sdio		SDIO
7318	usb2		USB 2
7421	crypto1		Cryptographic 1
7522	xor0		XOR 0
7623	crypto0		Cryptographic 0
7725	tdm		Time Division Multiplexing
7828	xor1		XOR 1
7930	sata1		SATA 1
80
81The following is a list of provided IDs for Armada 39x:
82ID	Clock		Peripheral
83-----------------------------------
845	pex1		PCIe 1
856	pex2		PCIe 2
867	pex3		PCIe 3
878	pex0		PCIe 0
889	usb3h0		USB3 Host 0
8910	usb3h1		USB3 Host 1
9015	sata0		SATA 0
9117	sdio		SDIO
9222	xor0		XOR 0
9328	xor1		XOR 1
94
95The following is a list of provided IDs for Armada XP:
96ID	Clock	Peripheral
97-----------------------------------
980	audio	Audio Cntrl
991	ge3	Gigabit Ethernet 3
1002	ge2	Gigabit Ethernet 2
1013	ge1	Gigabit Ethernet 1
1024	ge0	Gigabit Ethernet 0
1035	pex0	PCIe Cntrl 0
1046	pex1	PCIe Cntrl 1
1057	pex2	PCIe Cntrl 2
1068	pex3	PCIe Cntrl 3
10713	bp
10814	sata0lnk
10915	sata0	SATA Host 0
11016	lcd	LCD Cntrl
11117	sdio	SDHCI Host
11218	usb0	USB Host 0
11319	usb1	USB Host 1
11420	usb2	USB Host 2
11522	xor0	XOR DMA 0
11623	crypto	CESA engine
11725	tdm	Time Division Mplx
11828	xor1	XOR DMA 1
11929	sata1lnk
12030	sata1	SATA Host 1
121
122The following is a list of provided IDs for Dove:
123ID	Clock	Peripheral
124-----------------------------------
1250	usb0	USB Host 0
1261	usb1	USB Host 1
1272	ge	Gigabit Ethernet
1283	sata	SATA Host
1294	pex0	PCIe Cntrl 0
1305	pex1	PCIe Cntrl 1
1318	sdio0	SDHCI Host 0
1329	sdio1	SDHCI Host 1
13310	nand	NAND Cntrl
13411	camera	Camera Cntrl
13512	i2s0	I2S Cntrl 0
13613	i2s1	I2S Cntrl 1
13715	crypto	CESA engine
13821	ac97	AC97 Cntrl
13922	pdma	Peripheral DMA
14023	xor0	XOR DMA 0
14124	xor1	XOR DMA 1
14230	gephy	Gigabit Ethernel PHY
143Note: gephy(30) is implemented as a parent clock of ge(2)
144
145The following is a list of provided IDs for Kirkwood:
146ID	Clock	Peripheral
147-----------------------------------
1480	ge0	Gigabit Ethernet 0
1492	pex0	PCIe Cntrl 0
1503	usb0	USB Host 0
1514	sdio	SDIO Cntrl
1525	tsu	Transp. Stream Unit
1536	dunit	SDRAM Cntrl
1547	runit	Runit
1558	xor0	XOR DMA 0
1569	audio	I2S Cntrl 0
15714	sata0	SATA Host 0
15815	sata1	SATA Host 1
15916	xor1	XOR DMA 1
16017	crypto	CESA engine
16118	pex1	PCIe Cntrl 1
16219	ge1	Gigabit Ethernet 1
16320	tdm	Time Division Mplx
164
165Required properties:
166- compatible : shall be one of the following:
167	"marvell,armada-370-gating-clock" - for Armada 370 SoC clock gating
168	"marvell,armada-375-gating-clock" - for Armada 375 SoC clock gating
169	"marvell,armada-380-gating-clock" - for Armada 380/385 SoC clock gating
170	"marvell,armada-390-gating-clock" - for Armada 39x SoC clock gating
171	"marvell,armada-xp-gating-clock" - for Armada XP SoC clock gating
172	"marvell,dove-gating-clock" - for Dove SoC clock gating
173	"marvell,kirkwood-gating-clock" - for Kirkwood SoC clock gating
174- reg : shall be the register address of the Clock Gating Control register
175- #clock-cells : from common clock binding; shall be set to 1
176
177Optional properties:
178- clocks : default parent clock phandle (e.g. tclk)
179
180Example:
181
182gate_clk: clock-gating-control@d0038 {
183	compatible = "marvell,dove-gating-clock";
184	reg = <0xd0038 0x4>;
185	/* default parent clock is tclk */
186	clocks = <&core_clk 0>;
187	#clock-cells = <1>;
188};
189
190sdio0: sdio@92000 {
191	compatible = "marvell,dove-sdhci";
192	/* get clk gate bit 8 (sdio0) */
193	clocks = <&gate_clk 8>;
194};
195