Documentation/devicetree/bindings/arm/atmel-sysregs.txt

   1 Atmel system registers
   2
   3 Chipid required properties:
   4 - compatible: Should be "atmel,sama5d2-chipid"
   5 - reg : Should contain registers location and length
   6
   7 PIT Timer required properties:
   8 - compatible: Should be "atmel,at91sam9260-pit"
   9 - reg: Should contain registers location and length
  10 - interrupts: Should contain interrupt for the PIT which is the IRQ line
  11   shared across all System Controller members.
  12
  13 PIT64B Timer required properties:
  14 - compatible: Should be "microchip,sam9x60-pit64b"
  15 - reg: Should contain registers location and length
  16 - interrupts: Should contain interrupt for PIT64B timer
  17 - clocks: Should contain the available clock sources for PIT64B timer.
  18
  19 System Timer (ST) required properties:
  20 - compatible: Should be "atmel,at91rm9200-st", "syscon", "simple-mfd"
  21 - reg: Should contain registers location and length
  22 - interrupts: Should contain interrupt for the ST which is the IRQ line
  23   shared across all System Controller members.
  24 - clocks: phandle to input clock.
  25 Its subnodes can be:
  26 - watchdog: compatible should be "atmel,at91rm9200-wdt"
  27
  28 RSTC Reset Controller required properties:
  29 - compatible: Should be "atmel,<chip>-rstc".
  30   <chip> can be "at91sam9260", "at91sam9g45", "sama5d3" or "samx7"
  31   it also can be "microchip,sam9x60-rstc"
  32 - reg: Should contain registers location and length
  33 - clocks: phandle to input clock.
  34
  35 Example:
  36
  37         rstc@fffffd00 {
  38                 compatible = "atmel,at91sam9260-rstc";
  39                 reg = <0xfffffd00 0x10>;
  40                 clocks = <&clk32k>;
  41         };
  42
  43 RAMC SDRAM/DDR Controller required properties:
  44 - compatible: Should be "atmel,at91rm9200-sdramc", "syscon"
  45                         "atmel,at91sam9260-sdramc",
  46                         "atmel,at91sam9g45-ddramc",
  47                         "atmel,sama5d3-ddramc",
  48 - reg: Should contain registers location and length
  49
  50 Examples:
  51
  52         ramc0: ramc@ffffe800 {
  53                 compatible = "atmel,at91sam9g45-ddramc";
  54                 reg = <0xffffe800 0x200>;
  55         };
  56
  57 SHDWC Shutdown Controller
  58
  59 required properties:
  60 - compatible: Should be "atmel,<chip>-shdwc".
  61   <chip> can be "at91sam9260", "at91sam9rl" or "at91sam9x5".
  62 - reg: Should contain registers location and length
  63 - clocks: phandle to input clock.
  64
  65 optional properties:
  66 - atmel,wakeup-mode: String, operation mode of the wakeup mode.
  67   Supported values are: "none", "high", "low", "any".
  68 - atmel,wakeup-counter: Counter on Wake-up 0 (between 0x0 and 0xf).
  69
  70 optional at91sam9260 properties:
  71 - atmel,wakeup-rtt-timer: boolean to enable Real-time Timer Wake-up.
  72
  73 optional at91sam9rl properties:
  74 - atmel,wakeup-rtc-timer: boolean to enable Real-time Clock Wake-up.
  75 - atmel,wakeup-rtt-timer: boolean to enable Real-time Timer Wake-up.
  76
  77 optional at91sam9x5 properties:
  78 - atmel,wakeup-rtc-timer: boolean to enable Real-time Clock Wake-up.
  79
  80 Example:
  81
  82         shdwc@fffffd10 {
  83                 compatible = "atmel,at91sam9260-shdwc";
  84                 reg = <0xfffffd10 0x10>;
  85                 clocks = <&clk32k>;
  86         };
  87
  88 SHDWC SAMA5D2-Compatible Shutdown Controller
  89
  90 1) shdwc node
  91
  92 required properties:
  93 - compatible: should be "atmel,sama5d2-shdwc" or "microchip,sam9x60-shdwc".
  94 - reg: should contain registers location and length
  95 - clocks: phandle to input clock.
  96 - #address-cells: should be one. The cell is the wake-up input index.
  97 - #size-cells: should be zero.
  98
  99 optional properties:
 100
 101 - debounce-delay-us: minimum wake-up inputs debouncer period in
 102   microseconds. It's usually a board-related property.
 103 - atmel,wakeup-rtc-timer: boolean to enable Real-Time Clock wake-up.
 104
 105 optional microchip,sam9x60-shdwc properties:
 106 - atmel,wakeup-rtt-timer: boolean to enable Real-time Timer Wake-up.
 107
 108 The node contains child nodes for each wake-up input that the platform uses.
 109
 110 2) input nodes
 111
 112 Wake-up input nodes are usually described in the "board" part of the Device
 113 Tree. Note also that input 0 is linked to the wake-up pin and is frequently
 114 used.
 115
 116 Required properties:
 117 - reg: should contain the wake-up input index [0 - 15].
 118
 119 Optional properties:
 120 - atmel,wakeup-active-high: boolean, the corresponding wake-up input described
 121   by the child, forces the wake-up of the core power supply on a high level.
 122   The default is to be active low.
 123
 124 Example:
 125
 126 On the SoC side:
 127         shdwc@f8048010 {
 128                 compatible = "atmel,sama5d2-shdwc";
 129                 reg = <0xf8048010 0x10>;
 130                 clocks = <&clk32k>;
 131                 #address-cells = <1>;
 132                 #size-cells = <0>;
 133                 atmel,wakeup-rtc-timer;
 134         };
 135
 136 On the board side:
 137         shdwc@f8048010 {
 138                 debounce-delay-us = <976>;
 139
 140                 input@0 {
 141                         reg = <0>;
 142                 };
 143
 144                 input@1 {
 145                         reg = <1>;
 146                         atmel,wakeup-active-high;
 147                 };
 148         };
 149
 150 Special Function Registers (SFR)
 151
 152 Special Function Registers (SFR) manage specific aspects of the integrated
 153 memory, bridge implementations, processor and other functionality not controlled
 154 elsewhere.
 155
 156 required properties:
 157 - compatible: Should be "atmel,<chip>-sfr", "syscon" or
 158         "atmel,<chip>-sfrbu", "syscon"
 159   <chip> can be "sama5d3", "sama5d4" or "sama5d2".
 160   It also can be "microchip,sam9x60-sfr", "syscon".
 161 - reg: Should contain registers location and length
 162
 163         sfr@f0038000 {
 164                 compatible = "atmel,sama5d3-sfr", "syscon";
 165                 reg = <0xf0038000 0x60>;
 166         };
 167
 168 Security Module (SECUMOD)
 169
 170 The Security Module macrocell provides all necessary secure functions to avoid
 171 voltage, temperature, frequency and mechanical attacks on the chip. It also
 172 embeds secure memories that can be scrambled.
 173
 174 The Security Module also offers the PIOBU pins which can be used as GPIO pins.
 175 Note that they maintain their voltage during Backup/Self-refresh.
 176
 177 required properties:
 178 - compatible: Should be "atmel,<chip>-secumod", "syscon".
 179   <chip> can be "sama5d2".
 180 - reg: Should contain registers location and length
 181 - gpio-controller:      Marks the port as GPIO controller.
 182 - #gpio-cells:          There are 2. The pin number is the
 183                         first, the second represents additional
 184                         parameters such as GPIO_ACTIVE_HIGH/LOW.
 185
 186
 187         secumod@fc040000 {
 188                 compatible = "atmel,sama5d2-secumod", "syscon";
 189                 reg = <0xfc040000 0x100>;
 190                 gpio-controller;
 191                 #gpio-cells = <2>;
 192         };