275 lines
8.0 KiB
Plaintext
275 lines
8.0 KiB
Plaintext
Atmel AT91 device tree bindings.
|
|
================================
|
|
|
|
Boards with a SoC of the Atmel AT91 or SMART family shall have the following
|
|
properties:
|
|
|
|
Required root node properties:
|
|
compatible: must be one of:
|
|
* "atmel,at91rm9200"
|
|
|
|
* "atmel,at91sam9" for SoCs using an ARM926EJ-S core, shall be extended with
|
|
the specific SoC family or compatible:
|
|
o "atmel,at91sam9260"
|
|
o "atmel,at91sam9261"
|
|
o "atmel,at91sam9263"
|
|
o "atmel,at91sam9x5" for the 5 series, shall be extended with the specific
|
|
SoC compatible:
|
|
- "atmel,at91sam9g15"
|
|
- "atmel,at91sam9g25"
|
|
- "atmel,at91sam9g35"
|
|
- "atmel,at91sam9x25"
|
|
- "atmel,at91sam9x35"
|
|
o "atmel,at91sam9g20"
|
|
o "atmel,at91sam9g45"
|
|
o "atmel,at91sam9n12"
|
|
o "atmel,at91sam9rl"
|
|
o "atmel,at91sam9xe"
|
|
* "atmel,sama5" for SoCs using a Cortex-A5, shall be extended with the specific
|
|
SoC family:
|
|
o "atmel,sama5d2" shall be extended with the specific SoC compatible:
|
|
- "atmel,sama5d27"
|
|
o "atmel,sama5d3" shall be extended with the specific SoC compatible:
|
|
- "atmel,sama5d31"
|
|
- "atmel,sama5d33"
|
|
- "atmel,sama5d34"
|
|
- "atmel,sama5d35"
|
|
- "atmel,sama5d36"
|
|
o "atmel,sama5d4" shall be extended with the specific SoC compatible:
|
|
- "atmel,sama5d41"
|
|
- "atmel,sama5d42"
|
|
- "atmel,sama5d43"
|
|
- "atmel,sama5d44"
|
|
|
|
* "atmel,samv7" for MCUs using a Cortex-M7, shall be extended with the specific
|
|
SoC family:
|
|
o "atmel,sams70" shall be extended with the specific MCU compatible:
|
|
- "atmel,sams70j19"
|
|
- "atmel,sams70j20"
|
|
- "atmel,sams70j21"
|
|
- "atmel,sams70n19"
|
|
- "atmel,sams70n20"
|
|
- "atmel,sams70n21"
|
|
- "atmel,sams70q19"
|
|
- "atmel,sams70q20"
|
|
- "atmel,sams70q21"
|
|
o "atmel,samv70" shall be extended with the specific MCU compatible:
|
|
- "atmel,samv70j19"
|
|
- "atmel,samv70j20"
|
|
- "atmel,samv70n19"
|
|
- "atmel,samv70n20"
|
|
- "atmel,samv70q19"
|
|
- "atmel,samv70q20"
|
|
o "atmel,samv71" shall be extended with the specific MCU compatible:
|
|
- "atmel,samv71j19"
|
|
- "atmel,samv71j20"
|
|
- "atmel,samv71j21"
|
|
- "atmel,samv71n19"
|
|
- "atmel,samv71n20"
|
|
- "atmel,samv71n21"
|
|
- "atmel,samv71q19"
|
|
- "atmel,samv71q20"
|
|
- "atmel,samv71q21"
|
|
|
|
Chipid required properties:
|
|
- compatible: Should be "atmel,sama5d2-chipid"
|
|
- reg : Should contain registers location and length
|
|
|
|
PIT Timer required properties:
|
|
- compatible: Should be "atmel,at91sam9260-pit"
|
|
- reg: Should contain registers location and length
|
|
- interrupts: Should contain interrupt for the PIT which is the IRQ line
|
|
shared across all System Controller members.
|
|
|
|
System Timer (ST) required properties:
|
|
- compatible: Should be "atmel,at91rm9200-st", "syscon", "simple-mfd"
|
|
- reg: Should contain registers location and length
|
|
- interrupts: Should contain interrupt for the ST which is the IRQ line
|
|
shared across all System Controller members.
|
|
- clocks: phandle to input clock.
|
|
Its subnodes can be:
|
|
- watchdog: compatible should be "atmel,at91rm9200-wdt"
|
|
|
|
TC/TCLIB Timer required properties:
|
|
- compatible: Should be "atmel,<chip>-tcb".
|
|
<chip> can be "at91rm9200" or "at91sam9x5"
|
|
- reg: Should contain registers location and length
|
|
- interrupts: Should contain all interrupts for the TC block
|
|
Note that you can specify several interrupt cells if the TC
|
|
block has one interrupt per channel.
|
|
- clock-names: tuple listing input clock names.
|
|
Required elements: "t0_clk", "slow_clk"
|
|
Optional elements: "t1_clk", "t2_clk"
|
|
- clocks: phandles to input clocks.
|
|
|
|
Examples:
|
|
|
|
One interrupt per TC block:
|
|
tcb0: timer@fff7c000 {
|
|
compatible = "atmel,at91rm9200-tcb";
|
|
reg = <0xfff7c000 0x100>;
|
|
interrupts = <18 4>;
|
|
clocks = <&tcb0_clk>;
|
|
clock-names = "t0_clk";
|
|
};
|
|
|
|
One interrupt per TC channel in a TC block:
|
|
tcb1: timer@fffdc000 {
|
|
compatible = "atmel,at91rm9200-tcb";
|
|
reg = <0xfffdc000 0x100>;
|
|
interrupts = <26 4 27 4 28 4>;
|
|
clocks = <&tcb1_clk>;
|
|
clock-names = "t0_clk";
|
|
};
|
|
|
|
RSTC Reset Controller required properties:
|
|
- compatible: Should be "atmel,<chip>-rstc".
|
|
<chip> can be "at91sam9260" or "at91sam9g45" or "sama5d3"
|
|
- reg: Should contain registers location and length
|
|
- clocks: phandle to input clock.
|
|
|
|
Example:
|
|
|
|
rstc@fffffd00 {
|
|
compatible = "atmel,at91sam9260-rstc";
|
|
reg = <0xfffffd00 0x10>;
|
|
clocks = <&clk32k>;
|
|
};
|
|
|
|
RAMC SDRAM/DDR Controller required properties:
|
|
- compatible: Should be "atmel,at91rm9200-sdramc", "syscon"
|
|
"atmel,at91sam9260-sdramc",
|
|
"atmel,at91sam9g45-ddramc",
|
|
"atmel,sama5d3-ddramc",
|
|
- reg: Should contain registers location and length
|
|
|
|
Examples:
|
|
|
|
ramc0: ramc@ffffe800 {
|
|
compatible = "atmel,at91sam9g45-ddramc";
|
|
reg = <0xffffe800 0x200>;
|
|
};
|
|
|
|
SHDWC Shutdown Controller
|
|
|
|
required properties:
|
|
- compatible: Should be "atmel,<chip>-shdwc".
|
|
<chip> can be "at91sam9260", "at91sam9rl" or "at91sam9x5".
|
|
- reg: Should contain registers location and length
|
|
- clocks: phandle to input clock.
|
|
|
|
optional properties:
|
|
- atmel,wakeup-mode: String, operation mode of the wakeup mode.
|
|
Supported values are: "none", "high", "low", "any".
|
|
- atmel,wakeup-counter: Counter on Wake-up 0 (between 0x0 and 0xf).
|
|
|
|
optional at91sam9260 properties:
|
|
- atmel,wakeup-rtt-timer: boolean to enable Real-time Timer Wake-up.
|
|
|
|
optional at91sam9rl properties:
|
|
- atmel,wakeup-rtc-timer: boolean to enable Real-time Clock Wake-up.
|
|
- atmel,wakeup-rtt-timer: boolean to enable Real-time Timer Wake-up.
|
|
|
|
optional at91sam9x5 properties:
|
|
- atmel,wakeup-rtc-timer: boolean to enable Real-time Clock Wake-up.
|
|
|
|
Example:
|
|
|
|
shdwc@fffffd10 {
|
|
compatible = "atmel,at91sam9260-shdwc";
|
|
reg = <0xfffffd10 0x10>;
|
|
clocks = <&clk32k>;
|
|
};
|
|
|
|
SHDWC SAMA5D2-Compatible Shutdown Controller
|
|
|
|
1) shdwc node
|
|
|
|
required properties:
|
|
- compatible: should be "atmel,sama5d2-shdwc".
|
|
- reg: should contain registers location and length
|
|
- clocks: phandle to input clock.
|
|
- #address-cells: should be one. The cell is the wake-up input index.
|
|
- #size-cells: should be zero.
|
|
|
|
optional properties:
|
|
|
|
- debounce-delay-us: minimum wake-up inputs debouncer period in
|
|
microseconds. It's usually a board-related property.
|
|
- atmel,wakeup-rtc-timer: boolean to enable Real-Time Clock wake-up.
|
|
|
|
The node contains child nodes for each wake-up input that the platform uses.
|
|
|
|
2) input nodes
|
|
|
|
Wake-up input nodes are usually described in the "board" part of the Device
|
|
Tree. Note also that input 0 is linked to the wake-up pin and is frequently
|
|
used.
|
|
|
|
Required properties:
|
|
- reg: should contain the wake-up input index [0 - 15].
|
|
|
|
Optional properties:
|
|
- atmel,wakeup-active-high: boolean, the corresponding wake-up input described
|
|
by the child, forces the wake-up of the core power supply on a high level.
|
|
The default is to be active low.
|
|
|
|
Example:
|
|
|
|
On the SoC side:
|
|
shdwc@f8048010 {
|
|
compatible = "atmel,sama5d2-shdwc";
|
|
reg = <0xf8048010 0x10>;
|
|
clocks = <&clk32k>;
|
|
#address-cells = <1>;
|
|
#size-cells = <0>;
|
|
atmel,wakeup-rtc-timer;
|
|
};
|
|
|
|
On the board side:
|
|
shdwc@f8048010 {
|
|
debounce-delay-us = <976>;
|
|
|
|
input@0 {
|
|
reg = <0>;
|
|
};
|
|
|
|
input@1 {
|
|
reg = <1>;
|
|
atmel,wakeup-active-high;
|
|
};
|
|
};
|
|
|
|
Special Function Registers (SFR)
|
|
|
|
Special Function Registers (SFR) manage specific aspects of the integrated
|
|
memory, bridge implementations, processor and other functionality not controlled
|
|
elsewhere.
|
|
|
|
required properties:
|
|
- compatible: Should be "atmel,<chip>-sfr", "syscon" or
|
|
"atmel,<chip>-sfrbu", "syscon"
|
|
<chip> can be "sama5d3", "sama5d4" or "sama5d2".
|
|
- reg: Should contain registers location and length
|
|
|
|
sfr@f0038000 {
|
|
compatible = "atmel,sama5d3-sfr", "syscon";
|
|
reg = <0xf0038000 0x60>;
|
|
};
|
|
|
|
Security Module (SECUMOD)
|
|
|
|
The Security Module macrocell provides all necessary secure functions to avoid
|
|
voltage, temperature, frequency and mechanical attacks on the chip. It also
|
|
embeds secure memories that can be scrambled
|
|
|
|
required properties:
|
|
- compatible: Should be "atmel,<chip>-secumod", "syscon".
|
|
<chip> can be "sama5d2".
|
|
- reg: Should contain registers location and length
|
|
|
|
secumod@fc040000 {
|
|
compatible = "atmel,sama5d2-secumod", "syscon";
|
|
reg = <0xfc040000 0x100>;
|
|
};
|