Documentation/devicetree/bindings/arm/samsung/exynos-srom.txt

   1 SAMSUNG Exynos SoCs SROM Controller driver.
   2
   3 Required properties:
   4 - compatible : Should contain "samsung,exynos-srom".
   5
   6 - reg: offset and length of the register set
   7
   8 Optional properties:
   9 The SROM controller can be used to attach external peripherals. In this case
  10 extra properties, describing the bus behind it, should be specified as below:
  11
  12 - #address-cells: Must be set to 2 to allow device address translation.
  13                   Address is specified as (bank#, offset).
  14
  15 - #size-cells: Must be set to 1 to allow device size passing
  16
  17 - ranges: Must be set up to reflect the memory layout with four integer values
  18           per bank:
  19                 <bank-number> 0 <parent address of bank> <size>
  20
  21 Sub-nodes:
  22 The actual device nodes should be added as subnodes to the SROMc node. These
  23 subnodes, except regular device specification, should contain the following
  24 properties, describing configuration of the relevant SROM bank:
  25
  26 Required properties:
  27 - reg: bank number, base address (relative to start of the bank) and size of
  28        the memory mapped for the device. Note that base address will be
  29        typically 0 as this is the start of the bank.
  30
  31 - samsung,srom-timing : array of 6 integers, specifying bank timings in the
  32                         following order: Tacp, Tcah, Tcoh, Tacc, Tcos, Tacs.
  33                         Each value is specified in cycles and has the following
  34                         meaning and valid range:
  35                         Tacp : Page mode access cycle at Page mode (0 - 15)
  36                         Tcah : Address holding time after CSn (0 - 15)
  37                         Tcoh : Chip selection hold on OEn (0 - 15)
  38                         Tacc : Access cycle (0 - 31, the actual time is N + 1)
  39                         Tcos : Chip selection set-up before OEn (0 - 15)
  40                         Tacs : Address set-up before CSn (0 - 15)
  41
  42 Optional properties:
  43 - reg-io-width : data width in bytes (1 or 2). If omitted, default of 1 is used.
  44
  45 - samsung,srom-page-mode : page mode configuration for the bank:
  46                            0 - normal (one data)
  47                            1 - four data
  48                            If omitted, default of 0 is used.
  49
  50 Example: basic definition, no banks are configured
  51         sromc@12570000 {
  52                 compatible = "samsung,exynos-srom";
  53                 reg = <0x12570000 0x14>;
  54         };
  55
  56 Example: SROMc with SMSC911x ethernet chip on bank 3
  57         sromc@12570000 {
  58                 #address-cells = <2>;
  59                 #size-cells = <1>;
  60                 ranges = <0 0 0x04000000 0x20000   // Bank0
  61                           1 0 0x05000000 0x20000   // Bank1
  62                           2 0 0x06000000 0x20000   // Bank2
  63                           3 0 0x07000000 0x20000>; // Bank3
  64
  65                 compatible = "samsung,exynos-srom";
  66                 reg = <0x12570000 0x14>;
  67
  68                 ethernet@3,0 {
  69                         compatible = "smsc,lan9115";
  70                         reg = <3 0 0x10000>;       // Bank 3, offset = 0
  71                         phy-mode = "mii";
  72                         interrupt-parent = <&gpx0>;
  73                         interrupts = <5 8>;
  74                         reg-io-width = <2>;
  75                         smsc,irq-push-pull;
  76                         smsc,force-internal-phy;
  77
  78                         samsung,srom-page-mode = <1>;
  79                         samsung,srom-timing = <9 12 1 9 1 1>;
  80                 };
  81         };