sys/boot/fdt/dts/bindings-localbus.txt

   1 $FreeBSD$
   2
   3 Marvell Device bus (localbus) configuration.
   4 ============================================
   5
   6 1. Properties for localbus nodes
   7
   8 1.1 ranges
   9
  10 Property:       ranges
  11
  12 Value type:     <prop-encoded-array> encoded as arbitrary number of localbus
  13                 nodes specifiers.
  14
  15 Description:    ranges property defines values used for mapping devices
  16                 connected to localbus, in Marvell devices it is used also for
  17                 setting decoding windows.
  18
  19                 a) child node address-cells:
  20                    - first cell: number of bank (chip select)
  21                    - second cell: (Marvell devices) Target ID for decoding
  22                         windows setup
  23
  24                 b) parent node address cells:
  25                    - address offset: used with parent's node base address to
  26                         specify base address of mapped device
  27
  28                 c) child node size-cells:
  29                    - size: defines amount of memory that should be reserved for
  30                         device
  31
  32 1.2 bank-count
  33
  34 Property:       bank-count
  35
  36 Value type:     <u32>
  37
  38 Description:    The bank_count property defines maximum number of banks on
  39                 localbus node. Bank is most often interpreted as device chip
  40                 select, but may also describe another device (e.g. SPI flash).
  41
  42 1.3 Example
  43
  44         localbus@0 {
  45                 #address-cells = <2>;
  46                 #size-cells = <1>;
  47                 compatible = "mrvl,lbc";
  48                 bank-count = <5>;
  49
  50                 /* This reflects CPU decode windows setup. */
  51                 ranges = <0x0 0x2f 0xb2200000 0x00100000
  52                           0x1 0x3e 0xb2100000 0x00100000
  53                           0x2 0x3d 0xb0000000 0x02000000
  54                           0x3 0x3b 0xb2000000 0x00100000>;
  55         };
  56
  57 2. Properties for localbus consumer nodes:
  58
  59 2.1 reg
  60
  61 Property:       reg
  62
  63 Value type:     <prop-encoded-array>
  64
  65 Description:    A standard property required for localbus child nodes. Defines
  66                 the device memory region.
  67
  68                 a) first cell: number of bank (chip select)
  69
  70                 b) address offset: used with address offset from parent's ranges
  71                         for corresponding bank to specify base address of
  72                         the device
  73
  74                 c) size: defines size of the device memory region
  75
  76 2.2 Example
  77
  78         nor@0,0 {
  79                 #address-cells = <1>;
  80                 #size-cells = <1>;
  81                 compatible = "cfi-flash";
  82                 reg = <0x0 0x0 0x00100000>;
  83         };