xref: /freebsd/sys/contrib/device-tree/Bindings/resource-names.txt (revision 7ef62cebc2f965b0f640263e179276928885e33d)
1Some properties contain an ordered list of 1 or more datum which are
2normally accessed by index.  However, some devices will have multiple
3values which are more naturally accessed by name.  Device nodes can
4include a supplemental property for assigning names to each of the list
5items.  The names property consists of a list of strings in the same
6order as the data in the resource property.
7
8The following supplemental names properties are defined.
9
10Resource Property	Supplemental Names Property
11-----------------	---------------------------
12reg			reg-names
13clocks			clock-names
14interrupts		interrupt-names
15
16Usage:
17
18The -names property must be used in conjunction with the normal resource
19property. If not it will be ignored.
20
21Examples:
22
23l4-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
47usb {
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};
55