[deliverable/linux.git] / Documentation / devicetree / bindings / board / fsl-board.txt

Freescale Reference Board Bindings

This document describes device tree bindings for various devices that
exist on some Freescale reference boards.

* Board Control and Status (BCSR)

Required properties:

 - compatible : Should be "fsl,<board>-bcsr"
 - reg : Offset and length of the register set for the device

Example:

	bcsr@f8000000 {
		compatible = "fsl,mpc8360mds-bcsr";
		reg = <f8000000 8000>;
	};

* Freescale on-board FPGA

This is the memory-mapped registers for on board FPGA.

Required properties:
- compatible: should be a board-specific string followed by a string
  indicating the type of FPGA.  Example:
	"fsl,<board>-fpga", "fsl,fpga-pixis", or
	"fsl,<board>-fpga", "fsl,fpga-qixis"
- reg: should contain the address and the length of the FPGA register set.

Optional properties:
- interrupt-parent: should specify phandle for the interrupt controller.
- interrupts: should specify event (wakeup) IRQ.

Example (P1022DS):

	 board-control@3,0 {
		 compatible = "fsl,p1022ds-fpga", "fsl,fpga-ngpixis";
		 reg = <3 0 0x30>;
		 interrupt-parent = <&mpic>;
		 interrupts = <8 8 0 0>;
	 };

Example (LS2080A-RDB):

        cpld@3,0 {
                compatible = "fsl,ls2080ardb-fpga", "fsl,fpga-qixis";
                reg = <0x3 0 0x10000>;
        };

* Freescale BCSR GPIO banks

Some BCSR registers act as simple GPIO controllers, each such
register can be represented by the gpio-controller node.

Required properities:
- compatible : Should be "fsl,<board>-bcsr-gpio".
- reg : Should contain the address and the length of the GPIO bank
  register.
- #gpio-cells : Should be two. The first cell is the pin number and the
  second cell is used to specify optional parameters (currently unused).
- gpio-controller : Marks the port as GPIO controller.

Example:

	bcsr@1,0 {
		#address-cells = <1>;
		#size-cells = <1>;
		compatible = "fsl,mpc8360mds-bcsr";
		reg = <1 0 0x8000>;
		ranges = <0 1 0 0x8000>;

		bcsr13: gpio-controller@d {
			#gpio-cells = <2>;
			compatible = "fsl,mpc8360mds-bcsr-gpio";
			reg = <0xd 1>;
			gpio-controller;
		};
	};

* Freescale on-board FPGA connected on I2C bus

Some Freescale boards like BSC9132QDS have on board FPGA connected on
the i2c bus.

Required properties:
- compatible: Should be a board-specific string followed by a string
  indicating the type of FPGA.  Example:
	"fsl,<board>-fpga", "fsl,fpga-qixis-i2c"
- reg: Should contain the address of the FPGA

Example:
	fpga: fpga@66 {
		compatible = "fsl,bsc9132qds-fpga", "fsl,fpga-qixis-i2c";
		reg = <0x66>;
	};

* Freescale on-board CPLD

Some Freescale boards like T1040RDB have an on board CPLD connected.

Required properties:
- compatible: Should be a board-specific string like "fsl,<board>-cpld"
  Example:
	"fsl,t1040rdb-cpld", "fsl,t1042rdb-cpld", "fsl,t1042rdb_pi-cpld"
- reg: should describe CPLD registers

Example:
	cpld@3,0 {
		compatible = "fsl,t1040rdb-cpld";
		reg = <3 0 0x300>;
	};
Commit	Line	Data
499ccb27 TT	1	Freescale Reference Board Bindings
	2
	3	This document describes device tree bindings for various devices that
	4	exist on some Freescale reference boards.
	5
d0fc2eaa KG	6	* Board Control and Status (BCSR)
	7
	8	Required properties:
	9
fd657efc	10	- compatible : Should be "fsl,<board>-bcsr"
d0fc2eaa KG	11	- reg : Offset and length of the register set for the device
	12
	13	Example:
	14
	15	bcsr@f8000000 {
fd657efc	16	compatible = "fsl,mpc8360mds-bcsr";
d0fc2eaa KG	17	reg = <f8000000 8000>;
	18	};
	19
499ccb27	20	* Freescale on-board FPGA
d0fc2eaa KG	21
	22	This is the memory-mapped registers for on board FPGA.
	23
a2cce7a9	24	Required properties:
499ccb27 TT	25	- compatible: should be a board-specific string followed by a string
499ccb27 TT	26	indicating the type of FPGA. Example:
a2cce7a9 BS	27	"fsl,<board>-fpga", "fsl,fpga-pixis", or
a2cce7a9 BS	28	"fsl,<board>-fpga", "fsl,fpga-qixis"
499ccb27	29	- reg: should contain the address and the length of the FPGA register set.
a2cce7a9 BS	30
a2cce7a9 BS	31	Optional properties:
8c68e2f7	32	- interrupt-parent: should specify phandle for the interrupt controller.
499ccb27	33	- interrupts: should specify event (wakeup) IRQ.
d0fc2eaa	34
499ccb27	35	Example (P1022DS):
d0fc2eaa	36
499ccb27 TT	37	board-control@3,0 {
	38	compatible = "fsl,p1022ds-fpga", "fsl,fpga-ngpixis";
	39	reg = <3 0 0x30>;
	40	interrupt-parent = <&mpic>;
	41	interrupts = <8 8 0 0>;
	42	};
94409d6e	43
a2cce7a9 BS	44	Example (LS2080A-RDB):
	45
	46	cpld@3,0 {
	47	compatible = "fsl,ls2080ardb-fpga", "fsl,fpga-qixis";
	48	reg = <0x3 0 0x10000>;
	49	};
	50
94409d6e AV	51	* Freescale BCSR GPIO banks
	52
	53	Some BCSR registers act as simple GPIO controllers, each such
	54	register can be represented by the gpio-controller node.
	55
	56	Required properities:
	57	- compatible : Should be "fsl,<board>-bcsr-gpio".
	58	- reg : Should contain the address and the length of the GPIO bank
	59	register.
	60	- #gpio-cells : Should be two. The first cell is the pin number and the
98a1708d	61	second cell is used to specify optional parameters (currently unused).
94409d6e AV	62	- gpio-controller : Marks the port as GPIO controller.
	63
	64	Example:
	65
	66	bcsr@1,0 {
	67	#address-cells = <1>;
	68	#size-cells = <1>;
	69	compatible = "fsl,mpc8360mds-bcsr";
	70	reg = <1 0 0x8000>;
	71	ranges = <0 1 0 0x8000>;
	72
	73	bcsr13: gpio-controller@d {
	74	#gpio-cells = <2>;
	75	compatible = "fsl,mpc8360mds-bcsr-gpio";
	76	reg = <0xd 1>;
	77	gpio-controller;
	78	};
	79	};
1be62c6c	80
	81	* Freescale on-board FPGA connected on I2C bus
	82
	83	Some Freescale boards like BSC9132QDS have on board FPGA connected on
	84	the i2c bus.
	85
	86	Required properties:
	87	- compatible: Should be a board-specific string followed by a string
	88	indicating the type of FPGA. Example:
	89	"fsl,<board>-fpga", "fsl,fpga-qixis-i2c"
	90	- reg: Should contain the address of the FPGA
	91
	92	Example:
	93	fpga: fpga@66 {
	94	compatible = "fsl,bsc9132qds-fpga", "fsl,fpga-qixis-i2c";
	95	reg = <0x66>;
	96	};
dd2b04fc PJ	97
	98	* Freescale on-board CPLD
	99
	100	Some Freescale boards like T1040RDB have an on board CPLD connected.
	101
	102	Required properties:
	103	- compatible: Should be a board-specific string like "fsl,<board>-cpld"
	104	Example:
	105	"fsl,t1040rdb-cpld", "fsl,t1042rdb-cpld", "fsl,t1042rdb_pi-cpld"
	106	- reg: should describe CPLD registers
	107
	108	Example:
	109	cpld@3,0 {
	110	compatible = "fsl,t1040rdb-cpld";
	111	reg = <3 0 0x300>;
	112	};