xref: /freebsd/sys/contrib/device-tree/Bindings/board/fsl-board.txt (revision c66ec88fed842fbaad62c30d510644ceb7bd2d71)
1*c66ec88fSEmmanuel VadotFreescale Reference Board Bindings
2*c66ec88fSEmmanuel Vadot
3*c66ec88fSEmmanuel VadotThis document describes device tree bindings for various devices that
4*c66ec88fSEmmanuel Vadotexist on some Freescale reference boards.
5*c66ec88fSEmmanuel Vadot
6*c66ec88fSEmmanuel Vadot* Board Control and Status (BCSR)
7*c66ec88fSEmmanuel Vadot
8*c66ec88fSEmmanuel VadotRequired properties:
9*c66ec88fSEmmanuel Vadot
10*c66ec88fSEmmanuel Vadot - compatible : Should be "fsl,<board>-bcsr"
11*c66ec88fSEmmanuel Vadot - reg : Offset and length of the register set for the device
12*c66ec88fSEmmanuel Vadot
13*c66ec88fSEmmanuel VadotExample:
14*c66ec88fSEmmanuel Vadot
15*c66ec88fSEmmanuel Vadot	bcsr@f8000000 {
16*c66ec88fSEmmanuel Vadot		compatible = "fsl,mpc8360mds-bcsr";
17*c66ec88fSEmmanuel Vadot		reg = <f8000000 8000>;
18*c66ec88fSEmmanuel Vadot	};
19*c66ec88fSEmmanuel Vadot
20*c66ec88fSEmmanuel Vadot* Freescale on-board FPGA
21*c66ec88fSEmmanuel Vadot
22*c66ec88fSEmmanuel VadotThis is the memory-mapped registers for on board FPGA.
23*c66ec88fSEmmanuel Vadot
24*c66ec88fSEmmanuel VadotRequired properties:
25*c66ec88fSEmmanuel Vadot- compatible: should be a board-specific string followed by a string
26*c66ec88fSEmmanuel Vadot  indicating the type of FPGA.  Example:
27*c66ec88fSEmmanuel Vadot	"fsl,<board>-fpga", "fsl,fpga-pixis", or
28*c66ec88fSEmmanuel Vadot	"fsl,<board>-fpga", "fsl,fpga-qixis"
29*c66ec88fSEmmanuel Vadot- reg: should contain the address and the length of the FPGA register set.
30*c66ec88fSEmmanuel Vadot
31*c66ec88fSEmmanuel VadotOptional properties:
32*c66ec88fSEmmanuel Vadot- interrupts: should specify event (wakeup) IRQ.
33*c66ec88fSEmmanuel Vadot
34*c66ec88fSEmmanuel VadotExample (P1022DS):
35*c66ec88fSEmmanuel Vadot
36*c66ec88fSEmmanuel Vadot	 board-control@3,0 {
37*c66ec88fSEmmanuel Vadot		 compatible = "fsl,p1022ds-fpga", "fsl,fpga-ngpixis";
38*c66ec88fSEmmanuel Vadot		 reg = <3 0 0x30>;
39*c66ec88fSEmmanuel Vadot		 interrupt-parent = <&mpic>;
40*c66ec88fSEmmanuel Vadot		 interrupts = <8 8 0 0>;
41*c66ec88fSEmmanuel Vadot	 };
42*c66ec88fSEmmanuel Vadot
43*c66ec88fSEmmanuel VadotExample (LS2080A-RDB):
44*c66ec88fSEmmanuel Vadot
45*c66ec88fSEmmanuel Vadot        cpld@3,0 {
46*c66ec88fSEmmanuel Vadot                compatible = "fsl,ls2080ardb-fpga", "fsl,fpga-qixis";
47*c66ec88fSEmmanuel Vadot                reg = <0x3 0 0x10000>;
48*c66ec88fSEmmanuel Vadot        };
49*c66ec88fSEmmanuel Vadot
50*c66ec88fSEmmanuel Vadot* Freescale on-board FPGA connected on I2C bus
51*c66ec88fSEmmanuel Vadot
52*c66ec88fSEmmanuel VadotSome Freescale boards like BSC9132QDS have on board FPGA connected on
53*c66ec88fSEmmanuel Vadotthe i2c bus.
54*c66ec88fSEmmanuel Vadot
55*c66ec88fSEmmanuel VadotRequired properties:
56*c66ec88fSEmmanuel Vadot- compatible: Should be a board-specific string followed by a string
57*c66ec88fSEmmanuel Vadot  indicating the type of FPGA.  Example:
58*c66ec88fSEmmanuel Vadot	"fsl,<board>-fpga", "fsl,fpga-qixis-i2c"
59*c66ec88fSEmmanuel Vadot- reg: Should contain the address of the FPGA
60*c66ec88fSEmmanuel Vadot
61*c66ec88fSEmmanuel VadotExample:
62*c66ec88fSEmmanuel Vadot	fpga: fpga@66 {
63*c66ec88fSEmmanuel Vadot		compatible = "fsl,bsc9132qds-fpga", "fsl,fpga-qixis-i2c";
64*c66ec88fSEmmanuel Vadot		reg = <0x66>;
65*c66ec88fSEmmanuel Vadot	};
66*c66ec88fSEmmanuel Vadot
67*c66ec88fSEmmanuel Vadot* Freescale on-board CPLD
68*c66ec88fSEmmanuel Vadot
69*c66ec88fSEmmanuel VadotSome Freescale boards like T1040RDB have an on board CPLD connected.
70*c66ec88fSEmmanuel Vadot
71*c66ec88fSEmmanuel VadotRequired properties:
72*c66ec88fSEmmanuel Vadot- compatible: Should be a board-specific string like "fsl,<board>-cpld"
73*c66ec88fSEmmanuel Vadot  Example:
74*c66ec88fSEmmanuel Vadot	"fsl,t1040rdb-cpld", "fsl,t1042rdb-cpld", "fsl,t1042rdb_pi-cpld"
75*c66ec88fSEmmanuel Vadot- reg: should describe CPLD registers
76*c66ec88fSEmmanuel Vadot
77*c66ec88fSEmmanuel VadotExample:
78*c66ec88fSEmmanuel Vadot	cpld@3,0 {
79*c66ec88fSEmmanuel Vadot		compatible = "fsl,t1040rdb-cpld";
80*c66ec88fSEmmanuel Vadot		reg = <3 0 0x300>;
81*c66ec88fSEmmanuel Vadot	};
82