kernel/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 };