xref: /freebsd-src/sys/contrib/device-tree/Bindings/soc/fsl/guts.txt (revision c66ec88fed842fbaad62c30d510644ceb7bd2d71)
1*c66ec88fSEmmanuel Vadot* Global Utilities Block
2*c66ec88fSEmmanuel Vadot
3*c66ec88fSEmmanuel VadotThe global utilities block controls power management, I/O device
4*c66ec88fSEmmanuel Vadotenabling, power-on-reset configuration monitoring, general-purpose
5*c66ec88fSEmmanuel VadotI/O signal configuration, alternate function selection for multiplexed
6*c66ec88fSEmmanuel Vadotsignals, and clock control.
7*c66ec88fSEmmanuel Vadot
8*c66ec88fSEmmanuel VadotRequired properties:
9*c66ec88fSEmmanuel Vadot
10*c66ec88fSEmmanuel Vadot - compatible : Should define the compatible device type for
11*c66ec88fSEmmanuel Vadot   global-utilities.
12*c66ec88fSEmmanuel Vadot   Possible compatibles:
13*c66ec88fSEmmanuel Vadot	"fsl,qoriq-device-config-1.0"
14*c66ec88fSEmmanuel Vadot	"fsl,qoriq-device-config-2.0"
15*c66ec88fSEmmanuel Vadot	"fsl,<chip>-device-config"
16*c66ec88fSEmmanuel Vadot	"fsl,<chip>-guts"
17*c66ec88fSEmmanuel Vadot - reg : Offset and length of the register set for the device.
18*c66ec88fSEmmanuel Vadot
19*c66ec88fSEmmanuel VadotRecommended properties:
20*c66ec88fSEmmanuel Vadot
21*c66ec88fSEmmanuel Vadot - fsl,has-rstcr : Indicates that the global utilities register set
22*c66ec88fSEmmanuel Vadot   contains a functioning "reset control register" (i.e. the board
23*c66ec88fSEmmanuel Vadot   is wired to reset upon setting the HRESET_REQ bit in this register).
24*c66ec88fSEmmanuel Vadot
25*c66ec88fSEmmanuel Vadot - fsl,liodn-bits : Indicates the number of defined bits in the LIODN
26*c66ec88fSEmmanuel Vadot   registers, for those SOCs that have a PAMU device.
27*c66ec88fSEmmanuel Vadot
28*c66ec88fSEmmanuel Vadot - little-endian : Indicates that the global utilities block is little
29*c66ec88fSEmmanuel Vadot   endian. The default is big endian.
30*c66ec88fSEmmanuel Vadot
31*c66ec88fSEmmanuel VadotExamples:
32*c66ec88fSEmmanuel Vadot	global-utilities@e0000 {	/* global utilities block */
33*c66ec88fSEmmanuel Vadot		compatible = "fsl,mpc8548-guts";
34*c66ec88fSEmmanuel Vadot		reg = <e0000 1000>;
35*c66ec88fSEmmanuel Vadot		fsl,has-rstcr;
36*c66ec88fSEmmanuel Vadot	};
37*c66ec88fSEmmanuel Vadot
38*c66ec88fSEmmanuel Vadot	guts: global-utilities@e0000 {
39*c66ec88fSEmmanuel Vadot		compatible = "fsl,qoriq-device-config-1.0";
40*c66ec88fSEmmanuel Vadot		reg = <0xe0000 0xe00>;
41*c66ec88fSEmmanuel Vadot		fsl,has-rstcr;
42*c66ec88fSEmmanuel Vadot		#sleep-cells = <1>;
43*c66ec88fSEmmanuel Vadot		fsl,liodn-bits = <12>;
44*c66ec88fSEmmanuel Vadot	};
45