1Hisilicon mbigen device tree bindings.
2=======================================
3
4Mbigen means: message based interrupt generator.
5
6MBI is kind of msi interrupt only used on Non-PCI devices.
7
8To reduce the wired interrupt number connected to GIC,
9Hisilicon designed mbigen to collect and generate interrupt.
10
11
12Non-pci devices can connect to mbigen and generate the
13interrupt by writing ITS register.
14
15The mbigen chip and devices connect to mbigen have the following properties:
16
17Mbigen main node required properties:
18-------------------------------------------
19- compatible: Should be "hisilicon,mbigen-v2"
20
21- reg: Specifies the base physical address and size of the Mbigen
22  registers.
23
24Mbigen sub node required properties:
25------------------------------------------
26- interrupt controller: Identifies the node as an interrupt controller
27
28- msi-parent: Specifies the MSI controller this mbigen use.
29  For more detail information,please refer to the generic msi-parent binding in
30  Documentation/devicetree/bindings/interrupt-controller/msi.txt.
31
32- num-pins: the total number of pins implemented in this Mbigen
33  instance.
34
35- #interrupt-cells : Specifies the number of cells needed to encode an
36  interrupt source. The value must be 2.
37
38  The 1st cell is hardware pin number of the interrupt.This number is local to
39  each mbigen chip and in the range from 0 to the maximum interrupts number
40  of the mbigen.
41
42  The 2nd cell is the interrupt trigger type.
43	The value of this cell should be:
44	1: rising edge triggered
45	or
46	4: high level triggered
47
48Examples:
49
50	mbigen_chip_dsa {
51			compatible = "hisilicon,mbigen-v2";
52			reg = <0x0 0xc0080000 0x0 0x10000>;
53
54			mbigen_gmac:intc_gmac {
55				interrupt-controller;
56				msi-parent = <&its_dsa 0x40b1c>;
57				num-pins = <9>;
58				#interrupt-cells = <2>;
59			};
60
61			mbigen_i2c:intc_i2c {
62				interrupt-controller;
63				msi-parent = <&its_dsa 0x40b0e>;
64				num-pins = <2>;
65				#interrupt-cells = <2>;
66			};
67	};
68
69Devices connect to mbigen required properties:
70----------------------------------------------------
71-interrupt-parent: Specifies the mbigen device node which device connected.
72
73-interrupts:Specifies the interrupt source.
74 For the specific information of each cell in this property,please refer to
75 the "interrupt-cells" description mentioned above.
76
77Examples:
78	gmac0: ethernet@c2080000 {
79		#address-cells = <1>;
80		#size-cells = <0>;
81		reg = <0 0xc2080000 0 0x20000>,
82		      <0 0xc0000000 0 0x1000>;
83		interrupt-parent  = <&mbigen_device_gmac>;
84		interrupts =	<656 1>,
85				<657 1>;
86	};
87