of/irq: Add interrupts-names property to name an irq resource
[~shefty/rdma-dev.git] / Documentation / devicetree / bindings / resource-names.txt
1 Some properties contain an ordered list of 1 or more datum which are
2 normally accessed by index.  However, some devices will have multiple
3 values which are more naturally accessed by name.  Device nodes can
4 include a supplemental property for assigning names to each of the list
5 items.  The names property consists of a list of strings in the same
6 order as the data in the resource property.
7
8 The following supplemental names properties are defined.
9
10 Resource Property       Supplemental Names Property
11 -----------------       ---------------------------
12 reg                     reg-names
13 clocks                  clock-names
14 interrupts              interrupt-names
15
16 Usage:
17
18 The -names property must be used in conjunction with the normal resource
19 property. If not it will be ignored.
20
21 Examples:
22
23 l4-abe {
24         compatible = "simple-bus";
25         #address-cells = <2>;
26         #size-cells = <1>;
27         ranges = <0 0 0x48000000 0x00001000>, /* MPU path */
28                  <1 0 0x49000000 0x00001000>; /* L3 path */
29         mcasp {
30                 compatible = "ti,mcasp";
31                 reg = <0 0x10 0x10>, <0 0x20 0x10>,
32                       <1 0x10 0x10>, <1 0x20 0x10>;
33                 reg-names = "mpu", "dat",
34                             "dma", "dma_dat";
35                 interrupts = <11>, <12>;
36                 interrupt-names = "rx", "tx";
37         };
38
39         timer {
40                 compatible = "ti,timer";
41                 reg = <0 0x40 0x10>, <1 0x40 0x10>;
42                 reg-names = "mpu", "dma";
43         };
44 };
45
46
47 usb {
48         compatible = "ti,usb-host";
49         reg = <0x4a064000 0x800>, <0x4a064800 0x200>,
50               <0x4a064c00 0x200>;
51         reg-names = "config", "ohci", "ehci";
52         interrupts = <14>, <15>;
53         interrupt-names = "ohci", "ehci";
54 };